@pdfvector/instance-contract 0.0.26 → 0.0.28

package/.tsc/lib/router/admin/get-usage-records.d.ts

@@ -17,6 +17,7 @@ export declare const getUsageRecords: import("@orpc/contract").ContractProcedure
         operation: z.ZodString;
         pageCount: z.ZodNullable<z.ZodNumber>;
         requestedModel: z.ZodString;
+        actualModel: z.ZodNullable<z.ZodString>;
         apiKey: z.ZodNullable<z.ZodString>;
         workspaceId: z.ZodNullable<z.ZodNumber>;
         createdAt: z.ZodNumber;

package/.tsc/lib/router/admin/get-usage-records.js

@@ -14,6 +14,7 @@ const usageRecordSchema = z.object({
     operation: z.string(),
     pageCount: z.number().nullable(),
     requestedModel: z.string(),
+    actualModel: z.string().nullable(),
     apiKey: z.string().nullable(),
     workspaceId: z.number().nullable(),
     createdAt: z.number(),

package/.tsc/lib/router/bankStatement/ask.js

@@ -1,6 +1,7 @@
 import { oc } from "@orpc/contract";
 import { z } from "zod";
 import { pdfvectorModelSchema } from "../../pdfvector-model-schema";
+import { outputAskModelDescription, specializedAskModelDescription, supportedFileFormatsDescription, supportedFileMimes, supportedFileTypesLong, } from "../../supported-mimes";
 import { getDefaultSpec } from "./get-default-spec";
 const specializedModelSchema = z
     .enum(["auto", ...pdfvectorModelSchema.options])
@@ -12,17 +13,9 @@ const askInputSchema = z.object({
         .describe("URL of the bank statement file to fetch and parse"),
     file: z
         .file()
-        .mime([
-        "application/pdf",
-        "application/vnd.openxmlformats-officedocument.wordprocessingml.document",
-        "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet",
-        "text/csv",
-        "application/csv",
-        "image/png",
-        "image/jpeg",
-    ])
+        .mime([...supportedFileMimes])
         .optional()
-        .describe("Bank statement file upload via multipart form-data (PDF, DOCX, XLSX, CSV, PNG, JPG)"),
+        .describe(`Bank statement file upload via multipart form-data (${supportedFileFormatsDescription})`),
     base64: z
         .string()
         .optional()
@@ -31,12 +24,7 @@ const askInputSchema = z.object({
         .string()
         .min(4, "question must be at least 4 characters")
         .describe("The question to answer about the bank statement"),
-    model: specializedModelSchema.describe("Model tier for answering the question. " +
-        "'auto' (default): Automatically selects the best tier. " +
-        "'nano': Uses lightweight models. " +
-        "'mini': Uses mid-range models. " +
-        "'pro': Uses capable models. " +
-        "'max': Uses the most powerful models."),
+    model: specializedModelSchema.describe(specializedAskModelDescription),
     callback: z
         .object({
         url: z
@@ -56,11 +44,11 @@ const askInputSchema = z.object({
 const askOutputSchema = z.object({
     markdown: z.string().describe("The answer to the question"),
     pageCount: z.number().int().describe("Total number of pages in the document"),
-    model: pdfvectorModelSchema.describe("Model tier used to answer the question"),
+    model: pdfvectorModelSchema.describe(outputAskModelDescription),
     credits: z
         .number()
         .int()
-        .describe("Number of credits consumed by this API call"),
+        .describe("Number of credits consumed by this API call. Cost per page: nano=6, mini=10, pro=14, max=18."),
     requestId: z
         .number()
         .int()
@@ -82,7 +70,7 @@ const requestExamples = {
 export const ask = oc
     .route({
     summary: "Ask a question about a bank statement",
-    description: "Parse a bank statement and answer a question about its content using AI. Supports PDF, Word (.docx), Excel (.xlsx), CSV, and Image (.png, .jpg) files. Provide the document via file upload, a public URL, or a base64-encoded string.",
+    description: `Parse a bank statement and answer a question about its content using AI. Supports ${supportedFileTypesLong}. Provide the document via file upload, a public URL, or a base64-encoded string.`,
     tags: ["Bank Statement"],
     spec: (op) => getDefaultSpec(op, requestExamples),
 })

package/.tsc/lib/router/bankStatement/extract.js

@@ -1,6 +1,7 @@
 import { oc } from "@orpc/contract";
 import { z } from "zod";
 import { pdfvectorModelSchema } from "../../pdfvector-model-schema";
+import { outputExtractModelDescription, specializedExtractModelDescription, supportedFileFormatsDescription, supportedFileMimes, supportedFileTypesLong, } from "../../supported-mimes";
 import { getDefaultSpec } from "./get-default-spec";
 const specializedModelSchema = z
     .enum(["auto", ...pdfvectorModelSchema.options])
@@ -12,17 +13,9 @@ const extractInputSchema = z.object({
         .describe("URL of the bank statement file to fetch and parse"),
     file: z
         .file()
-        .mime([
-        "application/pdf",
-        "application/vnd.openxmlformats-officedocument.wordprocessingml.document",
-        "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet",
-        "text/csv",
-        "application/csv",
-        "image/png",
-        "image/jpeg",
-    ])
+        .mime([...supportedFileMimes])
         .optional()
-        .describe("Bank statement file upload via multipart form-data (PDF, DOCX, XLSX, CSV, PNG, JPG)"),
+        .describe(`Bank statement file upload via multipart form-data (${supportedFileFormatsDescription})`),
     base64: z
         .string()
         .optional()
@@ -40,7 +33,7 @@ const extractInputSchema = z.object({
                 const parsed = JSON.parse(trimmed);
                 if (typeof parsed !== "object" || parsed === null) {
                     ctx.addIssue({
-                        code: z.ZodIssueCode.custom,
+                        code: "custom",
                         message: "Schema must be a JSON object",
                     });
                     return z.NEVER;
@@ -49,7 +42,7 @@ const extractInputSchema = z.object({
             }
             catch {
                 ctx.addIssue({
-                    code: z.ZodIssueCode.custom,
+                    code: "custom",
                     message: "Invalid JSON string for schema",
                 });
                 return z.NEVER;
@@ -57,12 +50,7 @@ const extractInputSchema = z.object({
         }),
     ])
         .describe("JSON Schema describing the structure of the data to extract from the bank statement. Can be a JSON object or a JSON string."),
-    model: specializedModelSchema.describe("Model tier for extracting structured data. " +
-        "'auto' (default): Automatically selects the best tier. " +
-        "'nano': Uses lightweight models. " +
-        "'mini': Uses mid-range models. " +
-        "'pro': Uses capable models. " +
-        "'max': Uses the most powerful models."),
+    model: specializedModelSchema.describe(specializedExtractModelDescription),
     callback: z
         .object({
         url: z
@@ -86,11 +74,11 @@ const extractOutputSchema = z.object({
         (typeof val !== "object" || Object.keys(val).length > 0), { message: "Extracted data must not be empty" })
         .describe("Extracted structured data matching the provided JSON Schema"),
     pageCount: z.number().int().describe("Total number of pages in the document"),
-    model: pdfvectorModelSchema.describe("Model tier used to extract the data"),
+    model: pdfvectorModelSchema.describe(outputExtractModelDescription),
     credits: z
         .number()
         .int()
-        .describe("Number of credits consumed by this API call"),
+        .describe("Number of credits consumed by this API call. Cost per page: nano=6, mini=10, pro=14, max=18."),
     requestId: z
         .number()
         .int()
@@ -131,7 +119,7 @@ const requestExamples = {
 export const extract = oc
     .route({
     summary: "Extract structured data from a bank statement",
-    description: "Parse a bank statement and extract structured data matching a provided JSON Schema using AI. Supports PDF, Word (.docx), Excel (.xlsx), CSV, and Image (.png, .jpg) files. Provide the document via file upload, a public URL, or a base64-encoded string.",
+    description: `Parse a bank statement and extract structured data matching a provided JSON Schema using AI. Supports ${supportedFileTypesLong}. Provide the document via file upload, a public URL, or a base64-encoded string.`,
     tags: ["Bank Statement"],
     spec: (op) => getDefaultSpec(op, requestExamples),
 })

package/.tsc/lib/router/bankStatement/parse.js

@@ -1,5 +1,6 @@
 import { oc } from "@orpc/contract";
 import { z } from "zod";
+import { specializedParseModelDescription, supportedFileFormatsDescription, supportedFileMimes, supportedFileTypesLong, } from "../../supported-mimes";
 import { getDefaultSpec } from "./get-default-spec";
 const specializedParseModelSchema = z
     .enum(["pro", "max", "auto"], {
@@ -13,25 +14,14 @@ const parseInputSchema = z.object({
         .describe("URL of the bank statement file to fetch and parse"),
     file: z
         .file()
-        .mime([
-        "application/pdf",
-        "application/vnd.openxmlformats-officedocument.wordprocessingml.document",
-        "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet",
-        "text/csv",
-        "application/csv",
-        "image/png",
-        "image/jpeg",
-    ])
+        .mime([...supportedFileMimes])
         .optional()
-        .describe("Bank statement file upload via multipart form-data (PDF, DOCX, XLSX, CSV, PNG, JPG)"),
+        .describe(`Bank statement file upload via multipart form-data (${supportedFileFormatsDescription})`),
     base64: z
         .string()
         .optional()
         .describe("Base64-encoded bank statement file content"),
-    model: specializedParseModelSchema.describe("Model tier for parsing. " +
-        "'auto' (default): Automatically selects the best parsing strategy with intelligent fallback. " +
-        "'pro': Extracts structured bank statement fields with standard accuracy. " +
-        "'max': Extracts structured bank statement fields with highest accuracy and fallback."),
+    model: specializedParseModelSchema.describe(specializedParseModelDescription("bank statement")),
     callback: z
         .object({
         url: z
@@ -59,7 +49,7 @@ const parseOutputSchema = z.object({
     credits: z
         .number()
         .int()
-        .describe("Number of credits consumed by this API call"),
+        .describe("Number of credits consumed by this API call. Cost per page: pro=6, max=10."),
     requestId: z
         .number()
         .int()
@@ -97,7 +87,7 @@ const requestExamples = {
 export const parse = oc
     .route({
     summary: "Parse a bank statement",
-    description: "Extract text and structured data from a bank statement. Supports PDF, Word (.docx), Excel (.xlsx), CSV, and Image (.png, .jpg) files. Provide the document via file upload, a public URL, or a base64-encoded string.",
+    description: `Extract text and structured data from a bank statement. Supports ${supportedFileTypesLong}. Provide the document via file upload, a public URL, or a base64-encoded string.`,
     tags: ["Bank Statement"],
     spec: (op) => getDefaultSpec(op, requestExamples),
 })

package/.tsc/lib/router/document/ask.js

@@ -1,6 +1,7 @@
 import { oc } from "@orpc/contract";
 import { z } from "zod";
 import { pdfvectorModelSchema } from "../../pdfvector-model-schema";
+import { documentAskModelDescription, outputAskModelDescription, supportedFileFormatsDescription, supportedFileMimes, supportedFileTypesLong, } from "../../supported-mimes";
 import { getDefaultSpec } from "./get-default-spec";
 const askInputSchema = z.object({
     url: z
@@ -9,17 +10,9 @@ const askInputSchema = z.object({
         .describe("URL of the document file to fetch and parse"),
     file: z
         .file()
-        .mime([
-        "application/pdf",
-        "application/vnd.openxmlformats-officedocument.wordprocessingml.document",
-        "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet",
-        "text/csv",
-        "application/csv",
-        "image/png",
-        "image/jpeg",
-    ])
+        .mime([...supportedFileMimes])
         .optional()
-        .describe("Document file upload via multipart form-data (PDF, DOCX, XLSX, CSV, PNG, JPG)"),
+        .describe(`Document file upload via multipart form-data (${supportedFileFormatsDescription})`),
     base64: z
         .string()
         .optional()
@@ -32,12 +25,7 @@ const askInputSchema = z.object({
         .enum(["auto", ...pdfvectorModelSchema.options])
         .optional()
         .default("auto")
-        .describe("Model tier for answering the question. " +
-        "'auto' (default): Automatically selects the best tier based on document page count and document complexity. " +
-        "'nano': Uses lightweight models (likely better than GPT-5-nano). Supports PDF, Word, Excel, CSV. " +
-        "'mini': Uses mid-range models (likely better than GPT-5-mini). Supports PDF, Word, Excel, CSV. " +
-        "'pro': Uses capable models (likely better than GPT-5.2). Supports PDF, Word, Excel, CSV, Image. " +
-        "'max': Uses the most powerful models (likely better than Claude Opus 4.6). Supports PDF, Word, Excel, CSV, Image."),
+        .describe(documentAskModelDescription),
     callback: z
         .object({
         url: z
@@ -61,15 +49,11 @@ const askOutputSchema = z
         .number()
         .int()
         .describe("Total number of pages in the document"),
-    model: pdfvectorModelSchema.describe("Model tier used to answer the question. " +
-        "'nano': Supports PDF, Word, Excel, CSV. " +
-        "'mini': Supports PDF, Word, Excel, CSV. " +
-        "'pro': Supports PDF, Word, Excel, CSV, Image. " +
-        "'max': Supports PDF, Word, Excel, CSV, Image."),
+    model: pdfvectorModelSchema.describe(outputAskModelDescription),
     credits: z
         .number()
         .int()
-        .describe("Number of credits consumed by this API call"),
+        .describe("Number of credits consumed by this API call. Cost per page: nano=2, mini=4, pro=8, max=16."),
     requestId: z
         .number()
         .int()
@@ -132,7 +116,7 @@ const requestExamples = {
 export const ask = oc
     .route({
     summary: "Ask a question about a document",
-    description: "Parse a document and answer a question about its content using AI. Supports PDF, Word (.docx), Excel (.xlsx), CSV, and Image (.png, .jpg) files. Files up to 1000 pages and up to 500MB in size. Provide the document via file upload, a public URL, or a base64-encoded string.",
+    description: `Parse a document and answer a question about its content using AI. Supports ${supportedFileTypesLong}. Files up to 1000 pages and up to 500MB in size. Provide the document via file upload, a public URL, or a base64-encoded string.`,
     tags: ["Document"],
     spec: (op) => getDefaultSpec(op, requestExamples),
 })

package/.tsc/lib/router/document/extract.js

@@ -1,6 +1,7 @@
 import { oc } from "@orpc/contract";
 import { z } from "zod";
 import { pdfvectorModelSchema } from "../../pdfvector-model-schema";
+import { documentExtractModelDescription, outputExtractModelDescription, supportedFileFormatsDescription, supportedFileMimes, supportedFileTypesLong, } from "../../supported-mimes";
 import { getDefaultSpec } from "./get-default-spec";
 const extractInputSchema = z.object({
     url: z
@@ -9,17 +10,9 @@ const extractInputSchema = z.object({
         .describe("URL of the document file to fetch and parse"),
     file: z
         .file()
-        .mime([
-        "application/pdf",
-        "application/vnd.openxmlformats-officedocument.wordprocessingml.document",
-        "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet",
-        "text/csv",
-        "application/csv",
-        "image/png",
-        "image/jpeg",
-    ])
+        .mime([...supportedFileMimes])
         .optional()
-        .describe("Document file upload via multipart form-data (PDF, DOCX, XLSX, CSV, PNG, JPG)"),
+        .describe(`Document file upload via multipart form-data (${supportedFileFormatsDescription})`),
     base64: z
         .string()
         .optional()
@@ -38,7 +31,7 @@ const extractInputSchema = z.object({
                 const parsed = JSON.parse(trimmed);
                 if (typeof parsed !== "object" || parsed === null) {
                     ctx.addIssue({
-                        code: z.ZodIssueCode.custom,
+                        code: "custom",
                         message: "Schema must be a JSON object",
                     });
                     return z.NEVER;
@@ -47,7 +40,7 @@ const extractInputSchema = z.object({
             }
             catch {
                 ctx.addIssue({
-                    code: z.ZodIssueCode.custom,
+                    code: "custom",
                     message: "Invalid JSON string for schema",
                 });
                 return z.NEVER;
@@ -59,12 +52,7 @@ const extractInputSchema = z.object({
         .enum(["auto", ...pdfvectorModelSchema.options])
         .optional()
         .default("auto")
-        .describe("Model tier for extracting structured data. " +
-        "'auto' (default): Automatically selects the best tier based on document page count and document complexity. " +
-        "'nano': Uses lightweight models (likely better than GPT-5-nano). Supports PDF, Word, Excel, CSV. " +
-        "'mini': Uses mid-range models (likely better than GPT-5-mini). Supports PDF, Word, Excel, CSV. " +
-        "'pro': Uses capable models (likely better than GPT-5.2). Supports PDF, Word, Excel, CSV, Image. " +
-        "'max': Uses the most powerful models (likely better than Claude Opus 4.6). Supports PDF, Word, Excel, CSV, Image."),
+        .describe(documentExtractModelDescription),
     callback: z
         .object({
         url: z
@@ -92,15 +80,11 @@ const extractOutputSchema = z
         .number()
         .int()
         .describe("Total number of pages in the document"),
-    model: pdfvectorModelSchema.describe("Model tier used to extract the data. " +
-        "'nano': Supports PDF, Word, Excel, CSV. " +
-        "'mini': Supports PDF, Word, Excel, CSV. " +
-        "'pro': Supports PDF, Word, Excel, CSV, Image. " +
-        "'max': Supports PDF, Word, Excel, CSV, Image."),
+    model: pdfvectorModelSchema.describe(outputExtractModelDescription),
     credits: z
         .number()
         .int()
-        .describe("Number of credits consumed by this API call"),
+        .describe("Number of credits consumed by this API call. Cost per page: nano=2, mini=4, pro=8, max=16."),
     requestId: z
         .number()
         .int()
@@ -175,7 +159,7 @@ const requestExamples = {
 export const extract = oc
     .route({
     summary: "Extract structured data from a document",
-    description: "Parse a document and extract structured data matching a provided JSON Schema using AI. Supports PDF, Word (.docx), Excel (.xlsx), CSV, and Image (.png, .jpg) files. Files up to 1000 pages and up to 500MB in size. Provide the document via file upload, a public URL, or a base64-encoded string.",
+    description: `Parse a document and extract structured data matching a provided JSON Schema using AI. Supports ${supportedFileTypesLong}. Files up to 1000 pages and up to 500MB in size. Provide the document via file upload, a public URL, or a base64-encoded string.`,
     tags: ["Document"],
     spec: (op) => getDefaultSpec(op, requestExamples),
 })

package/.tsc/lib/router/document/parse.js

@@ -1,6 +1,7 @@
 import { oc } from "@orpc/contract";
 import { z } from "zod";
 import { pdfvectorModelSchema } from "../../pdfvector-model-schema";
+import { documentParseModelDescription, outputModelDescription, supportedFileFormatsDescription, supportedFileMimes, supportedFileTypesLong, } from "../../supported-mimes";
 import { getDefaultSpec } from "./get-default-spec";
 const parseInputSchema = z.object({
     url: z
@@ -9,17 +10,9 @@ const parseInputSchema = z.object({
         .describe("URL of the document file to fetch and parse"),
     file: z
         .file()
-        .mime([
-        "application/pdf",
-        "application/vnd.openxmlformats-officedocument.wordprocessingml.document",
-        "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet",
-        "text/csv",
-        "application/csv",
-        "image/png",
-        "image/jpeg",
-    ])
+        .mime([...supportedFileMimes])
         .optional()
-        .describe("Document file upload via multipart form-data (PDF, DOCX, XLSX, CSV, PNG, JPG)"),
+        .describe(`Document file upload via multipart form-data (${supportedFileFormatsDescription})`),
     base64: z
         .string()
         .optional()
@@ -28,12 +21,7 @@ const parseInputSchema = z.object({
         .enum(["auto", ...pdfvectorModelSchema.options])
         .optional()
         .default("auto")
-        .describe("Model tier for parsing. " +
-        "'auto' (default): Automatically selects the best parsing strategy with intelligent fallback. File up to 1000 pages, up to 500MB in size. Supports PDF, Word, Excel, CSV, Image. " +
-        "'nano': For simple documents with plain text content. File up to 30 pages, up to 10MB in size. Supports PDF, Word, Excel, CSV. " +
-        "'mini': For documents with tables and structured content. File up to 30 pages, up to 10MB in size. Supports PDF, Word, Excel, CSV. " +
-        "'pro': For documents up to 30 pages with tables, handwritten text, figures, math, and Arabic. File up to 30 pages, up to 40MB in size. Supports PDF, Word, Excel, CSV, Image. " +
-        "'max': For large documents with full Pro capabilities plus enhanced multilingual support. File up to 1000 pages, up to 500MB in size. Supports PDF, Word, Excel, CSV, Image."),
+        .describe(documentParseModelDescription),
     callback: z
         .object({
         url: z
@@ -53,15 +41,11 @@ const parseInputSchema = z.object({
 const parseOutputSchema = z.object({
     markdown: z.string().describe("Extracted text content from the document"),
     pageCount: z.number().int().describe("Total number of pages in the document"),
-    model: pdfvectorModelSchema.describe("Model tier used to parse the document. " +
-        "'nano': Supports PDF, Word, Excel, CSV. " +
-        "'mini': Supports PDF, Word, Excel, CSV. " +
-        "'pro': Supports PDF, Word, Excel, CSV, Image. " +
-        "'max': Supports PDF, Word, Excel, CSV, Image."),
+    model: pdfvectorModelSchema.describe(outputModelDescription),
     credits: z
         .number()
         .int()
-        .describe("Number of credits consumed by this API call"),
+        .describe("Number of credits consumed by this API call. Cost per page: nano=1, mini=2, pro=4, max=8."),
     requestId: z
         .number()
         .int()
@@ -120,7 +104,7 @@ const requestExamples = {
 export const parse = oc
     .route({
     summary: "Parse a document",
-    description: "Extract text and page count from a document. Supports PDF, Word (.docx), Excel (.xlsx), CSV, and Image (.png, .jpg) files. Provide the document via file upload, a public URL, or a base64-encoded string.",
+    description: `Extract text and page count from a document. Supports ${supportedFileTypesLong}. Provide the document via file upload, a public URL, or a base64-encoded string.`,
     tags: ["Document"],
     spec: (op) => getDefaultSpec(op, requestExamples),
 })

package/.tsc/lib/router/free/bank-statement-parse.js

@@ -1,5 +1,6 @@
 import { oc } from "@orpc/contract";
 import { z } from "zod";
+import { supportedFileFormatsDescription, supportedFileMimes, supportedFileTypesLong, } from "../../supported-mimes";
 const inputSchema = z.object({
     url: z
         .url()
@@ -7,17 +8,9 @@ const inputSchema = z.object({
         .describe("URL of the bank statement file to fetch and parse"),
     file: z
         .file()
-        .mime([
-        "application/pdf",
-        "application/vnd.openxmlformats-officedocument.wordprocessingml.document",
-        "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet",
-        "text/csv",
-        "application/csv",
-        "image/png",
-        "image/jpeg",
-    ])
+        .mime([...supportedFileMimes])
         .optional()
-        .describe("Bank statement file upload via multipart form-data (PDF, DOCX, XLSX, CSV, PNG, JPG)"),
+        .describe(`Bank statement file upload via multipart form-data (${supportedFileFormatsDescription})`),
     base64: z
         .string()
         .optional()
@@ -70,7 +63,7 @@ const responseExample = {
 export const bankStatementParse = oc
     .route({
     summary: "Free: Parse a bank statement",
-    description: "Extract text and structured data from a bank statement. Supports PDF, Word, Excel, CSV, and Image files. Free tier: max 5 pages, max 5 MB. Rate limited to 5 requests per IP per day.",
+    description: `Extract text and structured data from a bank statement. Supports ${supportedFileTypesLong}. Free tier: max 5 pages, max 5 MB. Rate limited to 5 requests per IP per day.`,
     tags: ["Free"],
     spec: (op) => {
         op.security = [];

package/.tsc/lib/router/identity/ask.js

@@ -1,6 +1,7 @@
 import { oc } from "@orpc/contract";
 import { z } from "zod";
 import { pdfvectorModelSchema } from "../../pdfvector-model-schema";
+import { outputAskModelDescription, specializedAskModelDescription, supportedFileFormatsDescription, supportedFileMimes, supportedFileTypesLong, } from "../../supported-mimes";
 import { getDefaultSpec } from "./get-default-spec";
 const specializedModelSchema = z
     .enum(["auto", ...pdfvectorModelSchema.options])
@@ -12,17 +13,9 @@ const askInputSchema = z.object({
         .describe("URL of the identity document file to fetch and parse"),
     file: z
         .file()
-        .mime([
-        "application/pdf",
-        "application/vnd.openxmlformats-officedocument.wordprocessingml.document",
-        "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet",
-        "text/csv",
-        "application/csv",
-        "image/png",
-        "image/jpeg",
-    ])
+        .mime([...supportedFileMimes])
         .optional()
-        .describe("Identity document file upload via multipart form-data (PDF, DOCX, XLSX, CSV, PNG, JPG)"),
+        .describe(`Identity document file upload via multipart form-data (${supportedFileFormatsDescription})`),
     base64: z
         .string()
         .optional()
@@ -31,12 +24,7 @@ const askInputSchema = z.object({
         .string()
         .min(4, "question must be at least 4 characters")
         .describe("The question to answer about the identity document"),
-    model: specializedModelSchema.describe("Model tier for answering the question. " +
-        "'auto' (default): Automatically selects the best tier. " +
-        "'nano': Uses lightweight models. " +
-        "'mini': Uses mid-range models. " +
-        "'pro': Uses capable models. " +
-        "'max': Uses the most powerful models."),
+    model: specializedModelSchema.describe(specializedAskModelDescription),
     callback: z
         .object({
         url: z
@@ -56,11 +44,11 @@ const askInputSchema = z.object({
 const askOutputSchema = z.object({
     markdown: z.string().describe("The answer to the question"),
     pageCount: z.number().int().describe("Total number of pages in the document"),
-    model: pdfvectorModelSchema.describe("Model tier used to answer the question"),
+    model: pdfvectorModelSchema.describe(outputAskModelDescription),
     credits: z
         .number()
         .int()
-        .describe("Number of credits consumed by this API call"),
+        .describe("Number of credits consumed by this API call. Cost per page: nano=6, mini=10, pro=14, max=18."),
     requestId: z
         .number()
         .int()
@@ -89,7 +77,7 @@ const requestExamples = {
 export const ask = oc
     .route({
     summary: "Ask a question about an identity document",
-    description: "Parse an identity document and answer a question about its content using AI. Supports PDF, Word (.docx), Excel (.xlsx), CSV, and Image (.png, .jpg) files. Provide the document via file upload, a public URL, or a base64-encoded string.",
+    description: `Parse an identity document and answer a question about its content using AI. Supports ${supportedFileTypesLong}. Provide the document via file upload, a public URL, or a base64-encoded string.`,
     tags: ["Identity"],
     spec: (op) => getDefaultSpec(op, requestExamples),
 })

package/.tsc/lib/router/identity/extract.js

@@ -1,6 +1,7 @@
 import { oc } from "@orpc/contract";
 import { z } from "zod";
 import { pdfvectorModelSchema } from "../../pdfvector-model-schema";
+import { outputExtractModelDescription, specializedExtractModelDescription, supportedFileFormatsDescription, supportedFileMimes, supportedFileTypesLong, } from "../../supported-mimes";
 import { getDefaultSpec } from "./get-default-spec";
 const specializedModelSchema = z
     .enum(["auto", ...pdfvectorModelSchema.options])
@@ -12,17 +13,9 @@ const extractInputSchema = z.object({
         .describe("URL of the identity document file to fetch and parse"),
     file: z
         .file()
-        .mime([
-        "application/pdf",
-        "application/vnd.openxmlformats-officedocument.wordprocessingml.document",
-        "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet",
-        "text/csv",
-        "application/csv",
-        "image/png",
-        "image/jpeg",
-    ])
+        .mime([...supportedFileMimes])
         .optional()
-        .describe("Identity document file upload via multipart form-data (PDF, DOCX, XLSX, CSV, PNG, JPG)"),
+        .describe(`Identity document file upload via multipart form-data (${supportedFileFormatsDescription})`),
     base64: z
         .string()
         .optional()
@@ -40,7 +33,7 @@ const extractInputSchema = z.object({
                 const parsed = JSON.parse(trimmed);
                 if (typeof parsed !== "object" || parsed === null) {
                     ctx.addIssue({
-                        code: z.ZodIssueCode.custom,
+                        code: "custom",
                         message: "Schema must be a JSON object",
                     });
                     return z.NEVER;
@@ -49,7 +42,7 @@ const extractInputSchema = z.object({
             }
             catch {
                 ctx.addIssue({
-                    code: z.ZodIssueCode.custom,
+                    code: "custom",
                     message: "Invalid JSON string for schema",
                 });
                 return z.NEVER;
@@ -57,12 +50,7 @@ const extractInputSchema = z.object({
         }),
     ])
         .describe("JSON Schema describing the structure of the data to extract from the identity document. Can be a JSON object or a JSON string."),
-    model: specializedModelSchema.describe("Model tier for extracting structured data. " +
-        "'auto' (default): Automatically selects the best tier. " +
-        "'nano': Uses lightweight models. " +
-        "'mini': Uses mid-range models. " +
-        "'pro': Uses capable models. " +
-        "'max': Uses the most powerful models."),
+    model: specializedModelSchema.describe(specializedExtractModelDescription),
     callback: z
         .object({
         url: z
@@ -86,11 +74,11 @@ const extractOutputSchema = z.object({
         (typeof val !== "object" || Object.keys(val).length > 0), { message: "Extracted data must not be empty" })
         .describe("Extracted structured data matching the provided JSON Schema"),
     pageCount: z.number().int().describe("Total number of pages in the document"),
-    model: pdfvectorModelSchema.describe("Model tier used to extract the data"),
+    model: pdfvectorModelSchema.describe(outputExtractModelDescription),
     credits: z
         .number()
         .int()
-        .describe("Number of credits consumed by this API call"),
+        .describe("Number of credits consumed by this API call. Cost per page: nano=6, mini=10, pro=14, max=18."),
     requestId: z
         .number()
         .int()
@@ -121,7 +109,7 @@ const requestExamples = {
 export const extract = oc
     .route({
     summary: "Extract structured data from an identity document",
-    description: "Parse an identity document and extract structured data matching a provided JSON Schema using AI. Supports PDF, Word (.docx), Excel (.xlsx), CSV, and Image (.png, .jpg) files. Provide the document via file upload, a public URL, or a base64-encoded string.",
+    description: `Parse an identity document and extract structured data matching a provided JSON Schema using AI. Supports ${supportedFileTypesLong}. Provide the document via file upload, a public URL, or a base64-encoded string.`,
     tags: ["Identity"],
     spec: (op) => getDefaultSpec(op, requestExamples),
 })

package/.tsc/lib/router/identity/parse.js

@@ -1,5 +1,6 @@
 import { oc } from "@orpc/contract";
 import { z } from "zod";
+import { specializedParseModelDescription, supportedFileFormatsDescription, supportedFileMimes, supportedFileTypesLong, } from "../../supported-mimes";
 import { getDefaultSpec } from "./get-default-spec";
 const specializedParseModelSchema = z
     .enum(["pro", "max", "auto"], {
@@ -13,25 +14,14 @@ const parseInputSchema = z.object({
         .describe("URL of the identity document file to fetch and parse"),
     file: z
         .file()
-        .mime([
-        "application/pdf",
-        "application/vnd.openxmlformats-officedocument.wordprocessingml.document",
-        "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet",
-        "text/csv",
-        "application/csv",
-        "image/png",
-        "image/jpeg",
-    ])
+        .mime([...supportedFileMimes])
         .optional()
-        .describe("Identity document file upload via multipart form-data (PDF, DOCX, XLSX, CSV, PNG, JPG)"),
+        .describe(`Identity document file upload via multipart form-data (${supportedFileFormatsDescription})`),
     base64: z
         .string()
         .optional()
         .describe("Base64-encoded identity document file content"),
-    model: specializedParseModelSchema.describe("Model tier for parsing. " +
-        "'auto' (default): Automatically selects the best parsing strategy with intelligent fallback. " +
-        "'pro': Extracts structured identity document fields with standard accuracy. " +
-        "'max': Extracts structured identity document fields with highest accuracy."),
+    model: specializedParseModelSchema.describe(specializedParseModelDescription("identity document")),
     callback: z
         .object({
         url: z
@@ -68,7 +58,7 @@ const parseOutputSchema = z.object({
     credits: z
         .number()
         .int()
-        .describe("Number of credits consumed by this API call"),
+        .describe("Number of credits consumed by this API call. Cost per page: pro=6, max=10."),
     requestId: z
         .number()
         .int()
@@ -101,7 +91,7 @@ const requestExamples = {
 export const parse = oc
     .route({
     summary: "Parse an identity document",
-    description: "Extract text and structured data from an identity document. Supports PDF, Word (.docx), Excel (.xlsx), CSV, and Image (.png, .jpg) files. Provide the document via file upload, a public URL, or a base64-encoded string.",
+    description: `Extract text and structured data from an identity document. Supports ${supportedFileTypesLong}. Provide the document via file upload, a public URL, or a base64-encoded string.`,
     tags: ["Identity"],
     spec: (op) => getDefaultSpec(op, requestExamples),
 })

package/.tsc/lib/router/invoice/ask.js

@@ -1,6 +1,7 @@
 import { oc } from "@orpc/contract";
 import { z } from "zod";
 import { pdfvectorModelSchema } from "../../pdfvector-model-schema";
+import { outputAskModelDescription, specializedAskModelDescription, supportedFileFormatsDescription, supportedFileMimes, supportedFileTypesLong, } from "../../supported-mimes";
 import { getDefaultSpec } from "./get-default-spec";
 const specializedModelSchema = z
     .enum(["auto", ...pdfvectorModelSchema.options])
@@ -12,28 +13,15 @@ const askInputSchema = z.object({
         .describe("URL of the invoice file to fetch and parse"),
     file: z
         .file()
-        .mime([
-        "application/pdf",
-        "application/vnd.openxmlformats-officedocument.wordprocessingml.document",
-        "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet",
-        "text/csv",
-        "application/csv",
-        "image/png",
-        "image/jpeg",
-    ])
+        .mime([...supportedFileMimes])
         .optional()
-        .describe("Invoice file upload via multipart form-data (PDF, DOCX, XLSX, CSV, PNG, JPG)"),
+        .describe(`Invoice file upload via multipart form-data (${supportedFileFormatsDescription})`),
     base64: z.string().optional().describe("Base64-encoded invoice file content"),
     question: z
         .string()
         .min(4, "question must be at least 4 characters")
         .describe("The question to answer about the invoice"),
-    model: specializedModelSchema.describe("Model tier for answering the question. " +
-        "'auto' (default): Automatically selects the best tier. " +
-        "'nano': Uses lightweight models. " +
-        "'mini': Uses mid-range models. " +
-        "'pro': Uses capable models. " +
-        "'max': Uses the most powerful models."),
+    model: specializedModelSchema.describe(specializedAskModelDescription),
     callback: z
         .object({
         url: z
@@ -53,11 +41,11 @@ const askInputSchema = z.object({
 const askOutputSchema = z.object({
     markdown: z.string().describe("The answer to the question"),
     pageCount: z.number().int().describe("Total number of pages in the document"),
-    model: pdfvectorModelSchema.describe("Model tier used to answer the question"),
+    model: pdfvectorModelSchema.describe(outputAskModelDescription),
     credits: z
         .number()
         .int()
-        .describe("Number of credits consumed by this API call"),
+        .describe("Number of credits consumed by this API call. Cost per page: nano=6, mini=10, pro=14, max=18."),
     requestId: z
         .number()
         .int()
@@ -79,7 +67,7 @@ const requestExamples = {
 export const ask = oc
     .route({
     summary: "Ask a question about an invoice",
-    description: "Parse an invoice and answer a question about its content using AI. Supports PDF, Word (.docx), Excel (.xlsx), CSV, and Image (.png, .jpg) files. Provide the document via file upload, a public URL, or a base64-encoded string.",
+    description: `Parse an invoice and answer a question about its content using AI. Supports ${supportedFileTypesLong}. Provide the document via file upload, a public URL, or a base64-encoded string.`,
     tags: ["Invoice"],
     spec: (op) => getDefaultSpec(op, requestExamples),
 })

package/.tsc/lib/router/invoice/extract.js

@@ -1,6 +1,7 @@
 import { oc } from "@orpc/contract";
 import { z } from "zod";
 import { pdfvectorModelSchema } from "../../pdfvector-model-schema";
+import { outputExtractModelDescription, specializedExtractModelDescription, supportedFileFormatsDescription, supportedFileMimes, supportedFileTypesLong, } from "../../supported-mimes";
 import { getDefaultSpec } from "./get-default-spec";
 const specializedModelSchema = z
     .enum(["auto", ...pdfvectorModelSchema.options])
@@ -12,17 +13,9 @@ const extractInputSchema = z.object({
         .describe("URL of the invoice file to fetch and parse"),
     file: z
         .file()
-        .mime([
-        "application/pdf",
-        "application/vnd.openxmlformats-officedocument.wordprocessingml.document",
-        "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet",
-        "text/csv",
-        "application/csv",
-        "image/png",
-        "image/jpeg",
-    ])
+        .mime([...supportedFileMimes])
         .optional()
-        .describe("Invoice file upload via multipart form-data (PDF, DOCX, XLSX, CSV, PNG, JPG)"),
+        .describe(`Invoice file upload via multipart form-data (${supportedFileFormatsDescription})`),
     base64: z.string().optional().describe("Base64-encoded invoice file content"),
     prompt: z
         .string()
@@ -37,7 +30,7 @@ const extractInputSchema = z.object({
                 const parsed = JSON.parse(trimmed);
                 if (typeof parsed !== "object" || parsed === null) {
                     ctx.addIssue({
-                        code: z.ZodIssueCode.custom,
+                        code: "custom",
                         message: "Schema must be a JSON object",
                     });
                     return z.NEVER;
@@ -46,7 +39,7 @@ const extractInputSchema = z.object({
             }
             catch {
                 ctx.addIssue({
-                    code: z.ZodIssueCode.custom,
+                    code: "custom",
                     message: "Invalid JSON string for schema",
                 });
                 return z.NEVER;
@@ -54,12 +47,7 @@ const extractInputSchema = z.object({
         }),
     ])
         .describe("JSON Schema describing the structure of the data to extract from the invoice. Can be a JSON object or a JSON string."),
-    model: specializedModelSchema.describe("Model tier for extracting structured data. " +
-        "'auto' (default): Automatically selects the best tier. " +
-        "'nano': Uses lightweight models. " +
-        "'mini': Uses mid-range models. " +
-        "'pro': Uses capable models. " +
-        "'max': Uses the most powerful models."),
+    model: specializedModelSchema.describe(specializedExtractModelDescription),
     callback: z
         .object({
         url: z
@@ -83,11 +71,11 @@ const extractOutputSchema = z.object({
         (typeof val !== "object" || Object.keys(val).length > 0), { message: "Extracted data must not be empty" })
         .describe("Extracted structured data matching the provided JSON Schema"),
     pageCount: z.number().int().describe("Total number of pages in the document"),
-    model: pdfvectorModelSchema.describe("Model tier used to extract the data"),
+    model: pdfvectorModelSchema.describe(outputExtractModelDescription),
     credits: z
         .number()
         .int()
-        .describe("Number of credits consumed by this API call"),
+        .describe("Number of credits consumed by this API call. Cost per page: nano=6, mini=10, pro=14, max=18."),
     requestId: z
         .number()
         .int()
@@ -127,7 +115,7 @@ const requestExamples = {
 export const extract = oc
     .route({
     summary: "Extract structured data from an invoice",
-    description: "Parse an invoice and extract structured data matching a provided JSON Schema using AI. Supports PDF, Word (.docx), Excel (.xlsx), CSV, and Image (.png, .jpg) files. Provide the document via file upload, a public URL, or a base64-encoded string.",
+    description: `Parse an invoice and extract structured data matching a provided JSON Schema using AI. Supports ${supportedFileTypesLong}. Provide the document via file upload, a public URL, or a base64-encoded string.`,
     tags: ["Invoice"],
     spec: (op) => getDefaultSpec(op, requestExamples),
 })

package/.tsc/lib/router/invoice/parse.js

@@ -1,5 +1,6 @@
 import { oc } from "@orpc/contract";
 import { z } from "zod";
+import { specializedParseModelDescription, supportedFileFormatsDescription, supportedFileMimes, supportedFileTypesLong, } from "../../supported-mimes";
 import { getDefaultSpec } from "./get-default-spec";
 const specializedParseModelSchema = z
     .enum(["pro", "max", "auto"], {
@@ -13,22 +14,11 @@ const parseInputSchema = z.object({
         .describe("URL of the invoice file to fetch and parse"),
     file: z
         .file()
-        .mime([
-        "application/pdf",
-        "application/vnd.openxmlformats-officedocument.wordprocessingml.document",
-        "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet",
-        "text/csv",
-        "application/csv",
-        "image/png",
-        "image/jpeg",
-    ])
+        .mime([...supportedFileMimes])
         .optional()
-        .describe("Invoice file upload via multipart form-data (PDF, DOCX, XLSX, CSV, PNG, JPG)"),
+        .describe(`Invoice file upload via multipart form-data (${supportedFileFormatsDescription})`),
     base64: z.string().optional().describe("Base64-encoded invoice file content"),
-    model: specializedParseModelSchema.describe("Model tier for parsing. " +
-        "'auto' (default): Automatically selects the best parsing strategy with intelligent fallback. " +
-        "'pro': Extracts structured invoice fields with standard accuracy. " +
-        "'max': Extracts structured invoice fields with highest accuracy and fallback."),
+    model: specializedParseModelSchema.describe(specializedParseModelDescription("invoice")),
     callback: z
         .object({
         url: z
@@ -54,7 +44,7 @@ const parseOutputSchema = z.object({
     credits: z
         .number()
         .int()
-        .describe("Number of credits consumed by this API call"),
+        .describe("Number of credits consumed by this API call. Cost per page: pro=6, max=10."),
     requestId: z
         .number()
         .int()
@@ -92,7 +82,7 @@ const requestExamples = {
 export const parse = oc
     .route({
     summary: "Parse an invoice",
-    description: "Extract text and structured data from an invoice. Supports PDF, Word (.docx), Excel (.xlsx), CSV, and Image (.png, .jpg) files. Provide the document via file upload, a public URL, or a base64-encoded string.",
+    description: `Extract text and structured data from an invoice. Supports ${supportedFileTypesLong}. Provide the document via file upload, a public URL, or a base64-encoded string.`,
     tags: ["Invoice"],
     spec: (op) => getDefaultSpec(op, requestExamples),
 })

package/.tsc/lib/supported-mimes.d.ts

@@ -0,0 +1,29 @@
+/**
+ * All MIME types accepted for file uploads across all API endpoints.
+ * Single source of truth — imported by all contract schemas.
+ */
+export declare const supportedFileMimes: readonly ["application/pdf", "application/vnd.openxmlformats-officedocument.wordprocessingml.document", "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet", "application/vnd.openxmlformats-officedocument.presentationml.presentation", "text/csv", "application/csv", "image/png", "image/jpeg", "image/tiff", "image/bmp", "image/heif", "image/heic", "text/plain", "text/markdown", "text/tab-separated-values", "text/xml", "application/xml", "application/rtf", "text/rtf", "text/html", "application/epub+zip", "application/vnd.oasis.opendocument.text", "application/vnd.oasis.opendocument.spreadsheet", "application/vnd.oasis.opendocument.presentation", "application/x-bibtex"];
+export declare const supportedFileFormatsDescription = "PDF, DOCX, XLSX, PPTX, CSV, PNG, JPG, TIFF, BMP, HEIF, TXT, MD, TSV, XML, RTF, HTML, ODT, ODS, ODP, EPUB, BIB, RIS, NBIB, ENW";
+/**
+ * Human-readable description of supported file types with extensions.
+ * Used in route-level API descriptions.
+ */
+export declare const supportedFileTypesLong: string;
+/** Model tier descriptions for document parse endpoints. */
+export declare const documentParseModelDescription: string;
+/** Model tier descriptions for document extract endpoints. */
+export declare const documentExtractModelDescription: string;
+/** Model tier descriptions for document ask endpoints. */
+export declare const documentAskModelDescription: string;
+/** Model tier descriptions for invoice/identity/bankStatement parse endpoints (pro/max/auto only). */
+export declare const specializedParseModelDescription: (type: string) => string;
+/** Model tier descriptions for invoice/identity/bankStatement extract endpoints. */
+export declare const specializedExtractModelDescription: string;
+/** Model tier descriptions for invoice/identity/bankStatement ask endpoints. */
+export declare const specializedAskModelDescription: string;
+/** Output model description for parse results. */
+export declare const outputModelDescription: string;
+/** Output model description for extract results. */
+export declare const outputExtractModelDescription: string;
+/** Output model description for ask results. */
+export declare const outputAskModelDescription: string;

package/.tsc/lib/supported-mimes.js

@@ -0,0 +1,122 @@
+/**
+ * All MIME types accepted for file uploads across all API endpoints.
+ * Single source of truth — imported by all contract schemas.
+ */
+export const supportedFileMimes = [
+    // PDF
+    "application/pdf",
+    // Office documents
+    "application/vnd.openxmlformats-officedocument.wordprocessingml.document",
+    "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet",
+    "application/vnd.openxmlformats-officedocument.presentationml.presentation",
+    // CSV
+    "text/csv",
+    "application/csv",
+    // Images
+    "image/png",
+    "image/jpeg",
+    "image/tiff",
+    "image/bmp",
+    "image/heif",
+    "image/heic",
+    // Plain text & structured text
+    "text/plain",
+    "text/markdown",
+    "text/tab-separated-values",
+    "text/xml",
+    "application/xml",
+    // RTF
+    "application/rtf",
+    "text/rtf",
+    // HTML
+    "text/html",
+    // OpenDocument & EPUB
+    "application/epub+zip",
+    "application/vnd.oasis.opendocument.text",
+    "application/vnd.oasis.opendocument.spreadsheet",
+    "application/vnd.oasis.opendocument.presentation",
+    // Bibliography / Academic
+    "application/x-bibtex",
+];
+export const supportedFileFormatsDescription = "PDF, DOCX, XLSX, PPTX, CSV, PNG, JPG, TIFF, BMP, HEIF, TXT, MD, TSV, XML, RTF, HTML, ODT, ODS, ODP, EPUB, BIB, RIS, NBIB, ENW";
+/**
+ * Human-readable description of supported file types with extensions.
+ * Used in route-level API descriptions.
+ */
+export const supportedFileTypesLong = "PDF, Word (.docx), Excel (.xlsx), PowerPoint (.pptx), CSV, " +
+    "Image (.png, .jpg, .tiff, .bmp, .heif), " +
+    "Plain Text (.txt, .md, .tsv, .xml), RTF, HTML, " +
+    "OpenDocument (.odt, .ods, .odp), EPUB, " +
+    "and Bibliography (.bib, .ris, .nbib, .enw) files";
+/**
+ * Per-tier file type support descriptions for model input fields.
+ * Format lists are stated once at the bottom to avoid wall-of-text in Scalar.
+ */
+const formatNote = "\n\n" +
+    "Supported formats by tier:\n" +
+    "- All tiers: PDF, Word, Excel, PowerPoint, CSV, Text, HTML, RTF, OpenDocument, EPUB, Bibliography.\n" +
+    "- Pro adds: Image (PNG, JPG).\n" +
+    "- Max/Auto adds: Image (PNG, JPG, TIFF, BMP, HEIF).";
+/** Model tier descriptions for document parse endpoints. */
+export const documentParseModelDescription = "Model tier for parsing.\n\n" +
+    "- auto (default): Intelligent fallback. Up to 1000 pages, 500MB.\n" +
+    "- nano: 1 credit/page. Simple plain text documents. Up to 30 pages, 10MB.\n" +
+    "- mini: 2 credits/page. Documents with tables and structured content. Up to 30 pages, 10MB.\n" +
+    "- pro: 4 credits/page. Tables, handwritten text, figures, math, Arabic. Up to 30 pages, 40MB.\n" +
+    "- max: 8 credits/page. Full Pro capabilities + enhanced multilingual. Up to 1000 pages, 500MB." +
+    formatNote;
+/** Model tier descriptions for document extract endpoints. */
+export const documentExtractModelDescription = "Model tier for extracting structured data.\n\n" +
+    "- auto (default): Automatically selects the best tier based on document complexity.\n" +
+    "- nano: 2 credits/page. Fastest. Best for simple documents with straightforward schemas.\n" +
+    "- mini: 4 credits/page. Balanced speed and accuracy. Moderately complex schemas.\n" +
+    "- pro: 8 credits/page. High accuracy for complex documents with large or nested schemas.\n" +
+    "- max: 16 credits/page. Maximum accuracy. Best for difficult extractions requiring deep reasoning." +
+    formatNote;
+/** Model tier descriptions for document ask endpoints. */
+export const documentAskModelDescription = "Model tier for answering the question.\n\n" +
+    "- auto (default): Automatically selects the best tier based on document complexity.\n" +
+    "- nano: 2 credits/page. Fastest. Best for simple questions about straightforward documents.\n" +
+    "- mini: 4 credits/page. Balanced speed and accuracy. Moderately complex questions.\n" +
+    "- pro: 8 credits/page. High accuracy for nuanced questions about complex documents.\n" +
+    "- max: 16 credits/page. Maximum accuracy. Best for difficult questions requiring deep reasoning." +
+    formatNote;
+/** Model tier descriptions for invoice/identity/bankStatement parse endpoints (pro/max/auto only). */
+export const specializedParseModelDescription = (type) => "Model tier for parsing.\n\n" +
+    "- auto (default): Intelligent fallback.\n" +
+    `- pro: 6 credits/page. Extracts structured ${type} fields with standard accuracy.\n` +
+    `- max: 10 credits/page. Extracts structured ${type} fields with highest accuracy and fallback.`;
+/** Model tier descriptions for invoice/identity/bankStatement extract endpoints. */
+export const specializedExtractModelDescription = "Model tier for extracting structured data.\n\n" +
+    "- auto (default): Automatically selects the best tier based on document complexity.\n" +
+    "- nano: 6 credits/page. Fastest. Best for simple documents with straightforward schemas.\n" +
+    "- mini: 10 credits/page. Balanced speed and accuracy. Moderately complex schemas.\n" +
+    "- pro: 14 credits/page. High accuracy for complex documents with large or nested schemas.\n" +
+    "- max: 18 credits/page. Maximum accuracy. Best for difficult extractions requiring deep reasoning." +
+    formatNote;
+/** Model tier descriptions for invoice/identity/bankStatement ask endpoints. */
+export const specializedAskModelDescription = "Model tier for answering the question.\n\n" +
+    "- auto (default): Automatically selects the best tier based on document complexity.\n" +
+    "- nano: 6 credits/page. Fastest. Best for simple questions about straightforward documents.\n" +
+    "- mini: 10 credits/page. Balanced speed and accuracy. Moderately complex questions.\n" +
+    "- pro: 14 credits/page. High accuracy for nuanced questions about complex documents.\n" +
+    "- max: 18 credits/page. Maximum accuracy. Best for difficult questions requiring deep reasoning." +
+    formatNote;
+/** Output model description for parse results. */
+export const outputModelDescription = "Model tier used to parse the document.\n\n" +
+    "- nano: Fastest, best for simple documents.\n" +
+    "- mini: Balanced speed and accuracy.\n" +
+    "- pro: High accuracy for complex documents.\n" +
+    "- max: Maximum accuracy with deep reasoning.";
+/** Output model description for extract results. */
+export const outputExtractModelDescription = "Model tier used to extract the data.\n\n" +
+    "- nano: Fastest, best for simple documents.\n" +
+    "- mini: Balanced speed and accuracy.\n" +
+    "- pro: High accuracy for complex documents.\n" +
+    "- max: Maximum accuracy with deep reasoning.";
+/** Output model description for ask results. */
+export const outputAskModelDescription = "Model tier used to answer the question.\n\n" +
+    "- nano: Fastest, best for simple questions.\n" +
+    "- mini: Balanced speed and accuracy.\n" +
+    "- pro: High accuracy for complex questions.\n" +
+    "- max: Maximum accuracy with deep reasoning.";

package/CHANGELOG.md

@@ -1,5 +1,19 @@
 # @pdfvector/instance-contract
 
+## 0.0.28
+### Patch Changes
+
+
+
+- [#148](https://github.com/phuctm97/pdfvector/pull/148) [`9a8d292`](https://github.com/phuctm97/pdfvector/commit/9a8d2920d022837dd09eb297949c2a40acd04b68) Thanks [@khanhduyvt0101](https://github.com/khanhduyvt0101)! - Add support for academic and additional file types
+
+## 0.0.27
+### Patch Changes
+
+
+
+- [#146](https://github.com/phuctm97/pdfvector/pull/146) [`3f46b91`](https://github.com/phuctm97/pdfvector/commit/3f46b91bff72ba75616a5b529aa3e511ea4fb8a2) Thanks [@khanhduyvt0101](https://github.com/khanhduyvt0101)! - Fix extract empty responses, track actual model, and reorder tier models
+
 ## 0.0.26
 ### Patch Changes
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pdfvector/instance-contract",
-  "version": "0.0.26",
+  "version": "0.0.28",
   "type": "module",
   "description": "API contract definitions for PDFVector instance server",
   "license": "MIT",