@pdfvector/instance-contract 0.0.31 → 0.0.33

package/.tsc/lib/pdfvector-model-schema.d.ts

@@ -1,7 +1,7 @@
 import { z } from "zod";
 export declare const pdfvectorModelSchema: z.ZodEnum<{
+    pro: "pro";
     nano: "nano";
     mini: "mini";
-    pro: "pro";
     max: "max";
 }>;

package/.tsc/lib/router/academic/fetch.d.ts

@@ -2,13 +2,13 @@ import { z } from "zod";
 export declare const fetch: import("@orpc/contract").ContractProcedureBuilderWithInputOutput<z.ZodObject<{
     ids: z.ZodArray<z.ZodString>;
     fields: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodEnum<{
+        year: "year";
         url: "url";
         doi: "doi";
         title: "title";
         providerURL: "providerURL";
         date: "date";
         authors: "authors";
-        year: "year";
         totalCitations: "totalCitations";
         totalReferences: "totalReferences";
         abstract: "abstract";

package/.tsc/lib/router/academic/fetch.js

@@ -1,4 +1,5 @@
 import { oc } from "@orpc/contract";
+import { academicCreditCosts } from "@pdfvector/util";
 import { z } from "zod";
 const authorSchema = z.object({
     name: z.string(),
@@ -101,7 +102,7 @@ export const fetch = oc
 }))
     .route({
     summary: "Fetch academic papers by ID",
-    description: "Fetch specific academic publications by their unique identifiers with automatic provider detection and batch processing.",
+    description: `Fetch specific academic publications by their unique identifiers with automatic provider detection and batch processing. Costs ${academicCreditCosts.academicFetch} credits per request.`,
     tags: ["Academic"],
     spec: (op) => {
         op.security = [{ bearerAuth: [] }];

package/.tsc/lib/router/academic/find-citations.d.ts

@@ -12,13 +12,13 @@ export declare const findCitations: import("@orpc/contract").ContractProcedureBu
         crossref: "crossref";
     }>>>;
     fields: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodEnum<{
+        year: "year";
         url: "url";
         doi: "doi";
         title: "title";
         providerURL: "providerURL";
         date: "date";
         authors: "authors";
-        year: "year";
         totalCitations: "totalCitations";
         totalReferences: "totalReferences";
         abstract: "abstract";

package/.tsc/lib/router/academic/find-citations.js

@@ -1,4 +1,5 @@
 import { oc } from "@orpc/contract";
+import { academicCreditCosts } from "@pdfvector/util";
 import { z } from "zod";
 const providerSchema = z.enum([
     "semantic-scholar",
@@ -109,7 +110,7 @@ export const findCitations = oc
 }))
     .route({
     summary: "Find citations for a paragraph",
-    description: "Find relevant academic citations for a paragraph by splitting it into sentences and scoring papers using semantic embedding similarity.",
+    description: `Find relevant academic citations for a paragraph by splitting it into sentences and scoring papers using semantic embedding similarity. Costs ${academicCreditCosts.academicFindCitationsPerSentence} credits per sentence.`,
     tags: ["Academic"],
     spec: (op) => {
         op.security = [{ bearerAuth: [] }];

package/.tsc/lib/router/academic/paper-graph.d.ts

@@ -6,13 +6,13 @@ export declare const paperGraph: import("@orpc/contract").ContractProcedureBuild
     citationsOffset: z.ZodDefault<z.ZodNumber>;
     referencesOffset: z.ZodDefault<z.ZodNumber>;
     fields: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodEnum<{
+        year: "year";
         url: "url";
         doi: "doi";
         title: "title";
         providerURL: "providerURL";
         date: "date";
         authors: "authors";
-        year: "year";
         totalCitations: "totalCitations";
         totalReferences: "totalReferences";
         abstract: "abstract";

package/.tsc/lib/router/academic/paper-graph.js

@@ -1,4 +1,5 @@
 import { oc } from "@orpc/contract";
+import { academicCreditCosts } from "@pdfvector/util";
 import { z } from "zod";
 const authorSchema = z.object({
     name: z.string(),
@@ -125,7 +126,7 @@ export const paperGraph = oc
 }))
     .route({
     summary: "Get paper citations and references",
-    description: "Fetch a paper's citing papers and referenced papers as full publication objects with automatic provider detection and pagination support.",
+    description: `Fetch a paper's citing papers and referenced papers as full publication objects with automatic provider detection and pagination support. Costs ${academicCreditCosts.academicPaperGraphMin}+ credits per request (scales with result count).`,
     tags: ["Academic"],
     spec: (op) => {
         op.security = [{ bearerAuth: [] }];

package/.tsc/lib/router/academic/search-grants.js

@@ -1,4 +1,5 @@
 import { oc } from "@orpc/contract";
+import { academicCreditCosts } from "@pdfvector/util";
 import { z } from "zod";
 const grantProviderSchema = z.enum(["grants-gov", "nih-reporter", "cordis", "ukri"], {
     message: "Invalid provider. Must be one of: grants-gov, nih-reporter, cordis, ukri",
@@ -155,7 +156,7 @@ export const searchGrants = oc
 }))
     .route({
     summary: "Search grants",
-    description: "Search for research grants and funding opportunities across multiple databases (Grants.gov, NIH RePORTER, CORDIS, UKRI) with unified results, relevance ranking, and filtering by deadline and funding amount.",
+    description: `Search for research grants and funding opportunities across multiple databases (Grants.gov, NIH RePORTER, CORDIS, UKRI) with unified results, relevance ranking, and filtering by deadline and funding amount. Costs ${academicCreditCosts.grantSearch} credits per request.`,
     tags: ["Academic"],
     spec: (op) => {
         op.security = [{ bearerAuth: [] }];

package/.tsc/lib/router/academic/search.d.ts

@@ -16,13 +16,13 @@ export declare const search: import("@orpc/contract").ContractProcedureBuilderWi
     yearFrom: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
     yearTo: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
     fields: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodEnum<{
+        year: "year";
         url: "url";
         doi: "doi";
         title: "title";
         providerURL: "providerURL";
         date: "date";
         authors: "authors";
-        year: "year";
         totalCitations: "totalCitations";
         totalReferences: "totalReferences";
         abstract: "abstract";

package/.tsc/lib/router/academic/search.js

@@ -1,4 +1,5 @@
 import { oc } from "@orpc/contract";
+import { academicCreditCosts } from "@pdfvector/util";
 import { z } from "zod";
 const providerSchema = z.enum([
     "semantic-scholar",
@@ -147,7 +148,7 @@ export const search = oc
 }))
     .route({
     summary: "Search academic papers",
-    description: "Search for academic publications across multiple databases with relevance ranking.",
+    description: `Search for academic publications across multiple databases with relevance ranking. Costs ${academicCreditCosts.academicSearch} credits per request.`,
     tags: ["Academic"],
     spec: (op) => {
         op.security = [{ bearerAuth: [] }];

package/.tsc/lib/router/academic/similar-papers.d.ts

@@ -4,13 +4,13 @@ export declare const similarPapers: import("@orpc/contract").ContractProcedureBu
     limit: z.ZodDefault<z.ZodNumber>;
     includeEdges: z.ZodDefault<z.ZodBoolean>;
     fields: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodEnum<{
+        year: "year";
         url: "url";
         doi: "doi";
         title: "title";
         providerURL: "providerURL";
         date: "date";
         authors: "authors";
-        year: "year";
         totalCitations: "totalCitations";
         totalReferences: "totalReferences";
         abstract: "abstract";

package/.tsc/lib/router/academic/similar-papers.js

@@ -1,4 +1,5 @@
 import { oc } from "@orpc/contract";
+import { academicCreditCosts } from "@pdfvector/util";
 import { z } from "zod";
 const authorSchema = z.object({
     name: z.string(),
@@ -124,7 +125,7 @@ export const similarPapers = oc
 }))
     .route({
     summary: "Find similar papers",
-    description: "Find papers similar to a seed paper using citation network analysis. Returns papers ranked by similarity with optional graph edge data for visualization.",
+    description: `Find papers similar to a seed paper using citation network analysis. Returns papers ranked by similarity with optional graph edge data for visualization. Costs ${academicCreditCosts.academicSimilarPapers} credits per request.`,
     tags: ["Academic"],
     spec: (op) => {
         op.security = [{ bearerAuth: [] }];

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

@@ -0,0 +1,21 @@
+import { z } from "zod";
+export declare const getFreeUsageRecords: import("@orpc/contract").ContractProcedureBuilderWithInputOutput<z.ZodObject<{
+    cursor: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+    limit: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+}, z.core.$strip>, z.ZodObject<{
+    records: z.ZodArray<z.ZodObject<{
+        id: z.ZodNumber;
+        operation: z.ZodString;
+        ip: z.ZodString;
+        model: z.ZodNullable<z.ZodString>;
+        inputSource: z.ZodNullable<z.ZodString>;
+        inputRef: z.ZodNullable<z.ZodString>;
+        fileSize: z.ZodNullable<z.ZodNumber>;
+        documentType: z.ZodNullable<z.ZodString>;
+        pageCount: z.ZodNullable<z.ZodNumber>;
+        error: z.ZodNullable<z.ZodString>;
+        duration: z.ZodNumber;
+        createdAt: z.ZodNumber;
+    }, z.core.$strip>>;
+    hasMore: z.ZodBoolean;
+}, z.core.$strip>, Record<never, never>, Record<never, never>>;

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

@@ -0,0 +1,34 @@
+import { oc } from "@orpc/contract";
+import { z } from "zod";
+const freeUsageRecordSchema = z.object({
+    id: z.number(),
+    operation: z.string(),
+    ip: z.string(),
+    model: z.string().nullable(),
+    inputSource: z.string().nullable(),
+    inputRef: z.string().nullable(),
+    fileSize: z.number().nullable(),
+    documentType: z.string().nullable(),
+    pageCount: z.number().nullable(),
+    error: z.string().nullable(),
+    duration: z.number(),
+    createdAt: z.number(),
+});
+export const getFreeUsageRecords = oc
+    .route({
+    summary: "Get free usage records",
+    description: "Returns free usage records with id > cursor, ordered by id ascending",
+    tags: ["Admin"],
+    spec: (op) => {
+        op.security = [{ bearerAuth: [] }];
+        return op;
+    },
+})
+    .input(z.object({
+    cursor: z.number().optional().default(0),
+    limit: z.number().optional().default(1000),
+}))
+    .output(z.object({
+    records: z.array(freeUsageRecordSchema),
+    hasMore: z.boolean(),
+}));

package/.tsc/lib/router/admin/index.d.ts

@@ -1,3 +1,4 @@
+export * from "./get-free-usage-records";
 export * from "./get-usage-records";
 export * from "./health-check";
 export * from "./set-domain";

package/.tsc/lib/router/admin/index.js

@@ -1,3 +1,4 @@
+export * from "./get-free-usage-records";
 export * from "./get-usage-records";
 export * from "./health-check";
 export * from "./set-domain";

package/.tsc/lib/router/bankStatement/ask.d.ts

@@ -5,9 +5,9 @@ export declare const ask: import("@orpc/contract").ContractProcedureBuilderWithI
     base64: z.ZodOptional<z.ZodString>;
     question: z.ZodString;
     model: z.ZodDefault<z.ZodEnum<{
+        pro: "pro";
         nano: "nano";
         mini: "mini";
-        pro: "pro";
         max: "max";
         auto: "auto";
     }>>;
@@ -19,9 +19,9 @@ export declare const ask: import("@orpc/contract").ContractProcedureBuilderWithI
     markdown: z.ZodString;
     pageCount: z.ZodNumber;
     model: z.ZodEnum<{
+        pro: "pro";
         nano: "nano";
         mini: "mini";
-        pro: "pro";
         max: "max";
     }>;
     credits: z.ZodNumber;

package/.tsc/lib/router/bankStatement/extract.d.ts

@@ -6,9 +6,9 @@ export declare const extract: import("@orpc/contract").ContractProcedureBuilderW
     prompt: z.ZodString;
     schema: z.ZodUnion<readonly [z.ZodRecord<z.ZodString, z.ZodUnknown>, z.ZodPipe<z.ZodString, z.ZodTransform<Record<string, unknown>, string>>]>;
     model: z.ZodDefault<z.ZodEnum<{
+        pro: "pro";
         nano: "nano";
         mini: "mini";
-        pro: "pro";
         max: "max";
         auto: "auto";
     }>>;
@@ -20,9 +20,9 @@ export declare const extract: import("@orpc/contract").ContractProcedureBuilderW
     data: z.ZodUnknown;
     pageCount: z.ZodNumber;
     model: z.ZodEnum<{
+        pro: "pro";
         nano: "nano";
         mini: "mini";
-        pro: "pro";
         max: "max";
     }>;
     credits: z.ZodNumber;

package/.tsc/lib/router/document/ask.d.ts

@@ -5,9 +5,9 @@ export declare const ask: import("@orpc/contract").ContractProcedureBuilderWithI
     base64: z.ZodOptional<z.ZodString>;
     question: z.ZodString;
     model: z.ZodDefault<z.ZodOptional<z.ZodEnum<{
+        pro: "pro";
         nano: "nano";
         mini: "mini";
-        pro: "pro";
         max: "max";
         auto: "auto";
     }>>>;
@@ -19,9 +19,9 @@ export declare const ask: import("@orpc/contract").ContractProcedureBuilderWithI
     markdown: z.ZodString;
     pageCount: z.ZodNumber;
     model: z.ZodEnum<{
+        pro: "pro";
         nano: "nano";
         mini: "mini";
-        pro: "pro";
         max: "max";
     }>;
     credits: z.ZodNumber;

package/.tsc/lib/router/document/extract.d.ts

@@ -6,9 +6,9 @@ export declare const extract: import("@orpc/contract").ContractProcedureBuilderW
     prompt: z.ZodString;
     schema: z.ZodUnion<readonly [z.ZodRecord<z.ZodString, z.ZodUnknown>, z.ZodPipe<z.ZodString, z.ZodTransform<Record<string, unknown>, string>>]>;
     model: z.ZodDefault<z.ZodOptional<z.ZodEnum<{
+        pro: "pro";
         nano: "nano";
         mini: "mini";
-        pro: "pro";
         max: "max";
         auto: "auto";
     }>>>;
@@ -20,9 +20,9 @@ export declare const extract: import("@orpc/contract").ContractProcedureBuilderW
     data: z.ZodUnknown;
     pageCount: z.ZodNumber;
     model: z.ZodEnum<{
+        pro: "pro";
         nano: "nano";
         mini: "mini";
-        pro: "pro";
         max: "max";
     }>;
     credits: z.ZodNumber;

package/.tsc/lib/router/document/parse.d.ts

@@ -4,9 +4,9 @@ export declare const parse: import("@orpc/contract").ContractProcedureBuilderWit
     file: z.ZodOptional<z.ZodFile>;
     base64: z.ZodOptional<z.ZodString>;
     model: z.ZodDefault<z.ZodOptional<z.ZodEnum<{
+        pro: "pro";
         nano: "nano";
         mini: "mini";
-        pro: "pro";
         max: "max";
         auto: "auto";
     }>>>;
@@ -18,9 +18,9 @@ export declare const parse: import("@orpc/contract").ContractProcedureBuilderWit
     markdown: z.ZodString;
     pageCount: z.ZodNumber;
     model: z.ZodEnum<{
+        pro: "pro";
         nano: "nano";
         mini: "mini";
-        pro: "pro";
         max: "max";
     }>;
     credits: z.ZodNumber;

package/.tsc/lib/router/identity/ask.d.ts

@@ -5,9 +5,9 @@ export declare const ask: import("@orpc/contract").ContractProcedureBuilderWithI
     base64: z.ZodOptional<z.ZodString>;
     question: z.ZodString;
     model: z.ZodDefault<z.ZodEnum<{
+        pro: "pro";
         nano: "nano";
         mini: "mini";
-        pro: "pro";
         max: "max";
         auto: "auto";
     }>>;
@@ -19,9 +19,9 @@ export declare const ask: import("@orpc/contract").ContractProcedureBuilderWithI
     markdown: z.ZodString;
     pageCount: z.ZodNumber;
     model: z.ZodEnum<{
+        pro: "pro";
         nano: "nano";
         mini: "mini";
-        pro: "pro";
         max: "max";
     }>;
     credits: z.ZodNumber;

package/.tsc/lib/router/identity/extract.d.ts

@@ -6,9 +6,9 @@ export declare const extract: import("@orpc/contract").ContractProcedureBuilderW
     prompt: z.ZodString;
     schema: z.ZodUnion<readonly [z.ZodRecord<z.ZodString, z.ZodUnknown>, z.ZodPipe<z.ZodString, z.ZodTransform<Record<string, unknown>, string>>]>;
     model: z.ZodDefault<z.ZodEnum<{
+        pro: "pro";
         nano: "nano";
         mini: "mini";
-        pro: "pro";
         max: "max";
         auto: "auto";
     }>>;
@@ -20,9 +20,9 @@ export declare const extract: import("@orpc/contract").ContractProcedureBuilderW
     data: z.ZodUnknown;
     pageCount: z.ZodNumber;
     model: z.ZodEnum<{
+        pro: "pro";
         nano: "nano";
         mini: "mini";
-        pro: "pro";
         max: "max";
     }>;
     credits: z.ZodNumber;

package/.tsc/lib/router/invoice/ask.d.ts

@@ -5,9 +5,9 @@ export declare const ask: import("@orpc/contract").ContractProcedureBuilderWithI
     base64: z.ZodOptional<z.ZodString>;
     question: z.ZodString;
     model: z.ZodDefault<z.ZodEnum<{
+        pro: "pro";
         nano: "nano";
         mini: "mini";
-        pro: "pro";
         max: "max";
         auto: "auto";
     }>>;
@@ -19,9 +19,9 @@ export declare const ask: import("@orpc/contract").ContractProcedureBuilderWithI
     markdown: z.ZodString;
     pageCount: z.ZodNumber;
     model: z.ZodEnum<{
+        pro: "pro";
         nano: "nano";
         mini: "mini";
-        pro: "pro";
         max: "max";
     }>;
     credits: z.ZodNumber;

package/.tsc/lib/router/invoice/extract.d.ts

@@ -6,9 +6,9 @@ export declare const extract: import("@orpc/contract").ContractProcedureBuilderW
     prompt: z.ZodString;
     schema: z.ZodUnion<readonly [z.ZodRecord<z.ZodString, z.ZodUnknown>, z.ZodPipe<z.ZodString, z.ZodTransform<Record<string, unknown>, string>>]>;
     model: z.ZodDefault<z.ZodEnum<{
+        pro: "pro";
         nano: "nano";
         mini: "mini";
-        pro: "pro";
         max: "max";
         auto: "auto";
     }>>;
@@ -20,9 +20,9 @@ export declare const extract: import("@orpc/contract").ContractProcedureBuilderW
     data: z.ZodUnknown;
     pageCount: z.ZodNumber;
     model: z.ZodEnum<{
+        pro: "pro";
         nano: "nano";
         mini: "mini";
-        pro: "pro";
         max: "max";
     }>;
     credits: z.ZodNumber;

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

@@ -1,3 +1,4 @@
+import { allSupportedFormatsLong, allSupportedFormatsShort, documentAskExtractCosts, documentParseCosts, formatsByTierDescription, specializedAskExtractCosts, specializedParseCosts, tierLimits, } from "@pdfvector/util";
 /**
  * All MIME types accepted for file uploads across all API endpoints.
  * Single source of truth — imported by all contract schemas.
@@ -38,69 +39,70 @@ export const supportedFileMimes = [
     // 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";
+export const supportedFileFormatsDescription = allSupportedFormatsShort;
 /**
  * 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).";
+export const supportedFileTypesLong = allSupportedFormatsLong;
+const formatNote = `\n\n${formatsByTierDescription}`;
+function fmtSize(bytes) {
+    return `${bytes / (1024 * 1024)}MB`;
+}
+function tierDesc(tier, credits, unit, extra) {
+    const limit = tierLimits[tier];
+    const limitStr = limit
+        ? `Up to ${limit.maxPages} pages, ${fmtSize(limit.maxFileSize)}.`
+        : "";
+    return `- ${tier}: ${credits} ${unit}. ${extra}${limitStr ? ` ${limitStr}` : ""}`;
+}
+// biome-ignore lint/style/noNonNullAssertion: auto tier always exists
+const autoLimit = tierLimits.auto;
+const autoLimitStr = `Up to ${autoLimit.maxPages} pages, ${fmtSize(autoLimit.maxFileSize)}.`;
 /** 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." +
+    `- auto (default): Intelligent fallback — credits based on the tier selected automatically. ${autoLimitStr}\n` +
+    `${tierDesc("nano", documentParseCosts.nano, "credit/page", "Simple plain text documents.")}\n` +
+    `${tierDesc("mini", documentParseCosts.mini, "credits/page", "Documents with tables and structured content.")}\n` +
+    `${tierDesc("pro", documentParseCosts.pro, "credits/page", "Tables, handwritten text, figures, math, Arabic.")}\n` +
+    `${tierDesc("max", documentParseCosts.max, "credits/page", "Full Pro capabilities + enhanced multilingual.")}` +
     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." +
+    "- auto (default): Automatically selects the best tier — credits based on the tier selected.\n" +
+    `- nano: ${documentAskExtractCosts.nano} credits/page. Fastest. Best for simple documents with straightforward schemas.\n` +
+    `- mini: ${documentAskExtractCosts.mini} credits/page. Balanced speed and accuracy. Moderately complex schemas.\n` +
+    `- pro: ${documentAskExtractCosts.pro} credits/page. High accuracy for complex documents with large or nested schemas.\n` +
+    `- max: ${documentAskExtractCosts.max} 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." +
+    "- auto (default): Automatically selects the best tier — credits based on the tier selected.\n" +
+    `- nano: ${documentAskExtractCosts.nano} credits/page. Fastest. Best for simple questions about straightforward documents.\n` +
+    `- mini: ${documentAskExtractCosts.mini} credits/page. Balanced speed and accuracy. Moderately complex questions.\n` +
+    `- pro: ${documentAskExtractCosts.pro} credits/page. High accuracy for nuanced questions about complex documents.\n` +
+    `- max: ${documentAskExtractCosts.max} 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.`;
+    "- auto (default): Intelligent fallback — credits based on the tier selected.\n" +
+    `- pro: ${specializedParseCosts.pro} credits/page. Extracts structured ${type} fields with standard accuracy.\n` +
+    `- max: ${specializedParseCosts.max} 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." +
+    "- auto (default): Automatically selects the best tier — credits based on the tier selected.\n" +
+    `- nano: ${specializedAskExtractCosts.nano} credits/page. Fastest. Best for simple documents with straightforward schemas.\n` +
+    `- mini: ${specializedAskExtractCosts.mini} credits/page. Balanced speed and accuracy. Moderately complex schemas.\n` +
+    `- pro: ${specializedAskExtractCosts.pro} credits/page. High accuracy for complex documents with large or nested schemas.\n` +
+    `- max: ${specializedAskExtractCosts.max} 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." +
+    "- auto (default): Automatically selects the best tier — credits based on the tier selected.\n" +
+    `- nano: ${specializedAskExtractCosts.nano} credits/page. Fastest. Best for simple questions about straightforward documents.\n` +
+    `- mini: ${specializedAskExtractCosts.mini} credits/page. Balanced speed and accuracy. Moderately complex questions.\n` +
+    `- pro: ${specializedAskExtractCosts.pro} credits/page. High accuracy for nuanced questions about complex documents.\n` +
+    `- max: ${specializedAskExtractCosts.max} 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" +

package/CHANGELOG.md

@@ -1,5 +1,22 @@
 # @pdfvector/instance-contract
 
+## 0.0.33
+### Patch Changes
+
+
+
+- [#176](https://github.com/phuctm97/pdfvector/pull/176) [`cfbc548`](https://github.com/phuctm97/pdfvector/commit/cfbc54864ef055bb68ea081b3ead7ba69ca2c819) Thanks [@khanhduyvt0101](https://github.com/khanhduyvt0101)! - Add free usage sync, centralize tier limits/credits, deduplicate parse handlers
+
+- Updated dependencies [[`cfbc548`](https://github.com/phuctm97/pdfvector/commit/cfbc54864ef055bb68ea081b3ead7ba69ca2c819)]:
+  - @pdfvector/util@0.0.17
+
+## 0.0.32
+### Patch Changes
+
+
+
+- [#159](https://github.com/phuctm97/pdfvector/pull/159) [`931317b`](https://github.com/phuctm97/pdfvector/commit/931317bd4732e56147d11f48cf6a203aa9983db2) Thanks [@khanhduyvt0101](https://github.com/khanhduyvt0101)! - Add admin user detail sheet and plan/credits columns
+
 ## 0.0.31
 ### Patch Changes
 

package/package.json

@@ -1,8 +1,8 @@
 {
   "name": "@pdfvector/instance-contract",
-  "version": "0.0.31",
+  "version": "0.0.33",
   "type": "module",
-  "description": "API contract definitions for PDFVector instance server",
+  "description": "API contract definitions for PDF Vector instance server",
   "license": "MIT",
   "repository": {
     "type": "git",
@@ -20,7 +20,8 @@
   },
   "main": ".tsc/lib/index.js",
   "dependencies": {
-    "@orpc/contract": "^1.13.13"
+    "@orpc/contract": "^1.13.13",
+    "@pdfvector/util": "0.0.16"
   },
   "peerDependencies": {
     "zod": "^4.3.6"