cencori 1.3.1 → 1.4.1

package/README.md

@@ -170,6 +170,31 @@ import { VisionUploader } from 'cencori/react';
 
 Full API in [docs](https://cencori.com/docs/ai/endpoints/vision).
 
+### Documents (PDF & Image Extraction)
+
+Extract text from PDFs and images, summarize documents, and answer questions about them. Text-based PDFs use native parsing — no LLM tokens, free.
+
+```typescript
+// Extract text — native PDF parsing, free
+const { text, method } = await cencori.documents.extract({
+  document: { url: 'https://example.com/contract.pdf' },
+});
+console.log(method); // 'pdf_text' means free
+
+// Summarize
+const { summary } = await cencori.documents.summarize({
+  document: { url: 'https://example.com/report.pdf' },
+});
+
+// Q&A — strict "Not found" if the answer isn't in the doc
+const { answer } = await cencori.documents.query({
+  document: { url: 'https://example.com/contract.pdf' },
+  question: 'What is the termination clause?',
+});
+```
+
+Full API in [docs](https://cencori.com/docs/ai/endpoints/documents). See the [Contract Analyzer tutorial](https://cencori.com/docs/guides/build-a-contract-analyzer) for an end-to-end example.
+
 ### Image Generation
 
 Generate images from text prompts using multiple providers:

package/dist/documents/index.d.mts

@@ -0,0 +1,94 @@
+import { C as CencoriConfig } from '../types-kh1whvNH.mjs';
+
+/**
+ * Documents API — extract text from PDFs and images, summarize, and query.
+ *
+ * @example
+ *   const { text, pageCount } = await cencori.documents.extract({
+ *       document: { url: 'https://example.com/contract.pdf' },
+ *   });
+ *
+ * @example
+ *   const { summary } = await cencori.documents.summarize({
+ *       document: { base64, mimeType: 'application/pdf' },
+ *   });
+ *
+ * @example
+ *   const { answer } = await cencori.documents.query({
+ *       document: { url: 'https://example.com/report.pdf' },
+ *       question: 'What is the total revenue for Q3?',
+ *   });
+ */
+
+type DocumentExtractMethod = 'pdf_text' | 'vision_ocr';
+type DocumentKind = 'pdf' | 'image';
+interface DocumentInput {
+    url?: string;
+    base64?: string;
+    mimeType?: string;
+    filename?: string;
+}
+interface DocumentRequest {
+    document: DocumentInput;
+    prompt?: string;
+    model?: string;
+    maxTokens?: number;
+    temperature?: number;
+}
+interface DocumentQueryRequest extends DocumentRequest {
+    question: string;
+}
+interface DocumentUsage {
+    promptTokens: number;
+    completionTokens: number;
+    totalTokens: number;
+}
+interface DocumentCost {
+    providerCostUsd: number;
+    cencoriChargeUsd: number;
+    markupPercentage: number;
+}
+interface DocumentExtractResult {
+    text: string;
+    pageCount: number;
+    kind: DocumentKind;
+    method: DocumentExtractMethod;
+    model?: string;
+    provider?: string;
+    metadata?: Record<string, unknown>;
+    usage?: DocumentUsage;
+    cost?: DocumentCost;
+}
+interface DocumentSummarizeResult {
+    summary: string;
+    text: string;
+    pageCount: number;
+    model: string;
+    provider: string;
+    extractMethod: DocumentExtractMethod;
+    usage: DocumentUsage;
+    cost: DocumentCost;
+}
+interface DocumentQueryResult {
+    answer: string;
+    question: string;
+    pageCount: number;
+    model: string;
+    provider: string;
+    extractMethod: DocumentExtractMethod;
+    usage: DocumentUsage;
+    cost: DocumentCost;
+}
+declare class DocumentsNamespace {
+    private config;
+    constructor(config: Required<CencoriConfig>);
+    /** Extract text from a PDF (native, no LLM) or image (via Vision OCR). */
+    extract(request: DocumentRequest): Promise<DocumentExtractResult>;
+    /** Extract then summarize the document with a chat model. */
+    summarize(request: DocumentRequest): Promise<DocumentSummarizeResult>;
+    /** Extract then answer a question about the document. */
+    query(request: DocumentQueryRequest): Promise<DocumentQueryResult>;
+    private post;
+}
+
+export { type DocumentCost, type DocumentExtractMethod, type DocumentExtractResult, type DocumentInput, type DocumentKind, type DocumentQueryRequest, type DocumentQueryResult, type DocumentRequest, type DocumentSummarizeResult, type DocumentUsage, DocumentsNamespace };

package/dist/documents/index.d.ts

@@ -0,0 +1,94 @@
+import { C as CencoriConfig } from '../types-kh1whvNH.js';
+
+/**
+ * Documents API — extract text from PDFs and images, summarize, and query.
+ *
+ * @example
+ *   const { text, pageCount } = await cencori.documents.extract({
+ *       document: { url: 'https://example.com/contract.pdf' },
+ *   });
+ *
+ * @example
+ *   const { summary } = await cencori.documents.summarize({
+ *       document: { base64, mimeType: 'application/pdf' },
+ *   });
+ *
+ * @example
+ *   const { answer } = await cencori.documents.query({
+ *       document: { url: 'https://example.com/report.pdf' },
+ *       question: 'What is the total revenue for Q3?',
+ *   });
+ */
+
+type DocumentExtractMethod = 'pdf_text' | 'vision_ocr';
+type DocumentKind = 'pdf' | 'image';
+interface DocumentInput {
+    url?: string;
+    base64?: string;
+    mimeType?: string;
+    filename?: string;
+}
+interface DocumentRequest {
+    document: DocumentInput;
+    prompt?: string;
+    model?: string;
+    maxTokens?: number;
+    temperature?: number;
+}
+interface DocumentQueryRequest extends DocumentRequest {
+    question: string;
+}
+interface DocumentUsage {
+    promptTokens: number;
+    completionTokens: number;
+    totalTokens: number;
+}
+interface DocumentCost {
+    providerCostUsd: number;
+    cencoriChargeUsd: number;
+    markupPercentage: number;
+}
+interface DocumentExtractResult {
+    text: string;
+    pageCount: number;
+    kind: DocumentKind;
+    method: DocumentExtractMethod;
+    model?: string;
+    provider?: string;
+    metadata?: Record<string, unknown>;
+    usage?: DocumentUsage;
+    cost?: DocumentCost;
+}
+interface DocumentSummarizeResult {
+    summary: string;
+    text: string;
+    pageCount: number;
+    model: string;
+    provider: string;
+    extractMethod: DocumentExtractMethod;
+    usage: DocumentUsage;
+    cost: DocumentCost;
+}
+interface DocumentQueryResult {
+    answer: string;
+    question: string;
+    pageCount: number;
+    model: string;
+    provider: string;
+    extractMethod: DocumentExtractMethod;
+    usage: DocumentUsage;
+    cost: DocumentCost;
+}
+declare class DocumentsNamespace {
+    private config;
+    constructor(config: Required<CencoriConfig>);
+    /** Extract text from a PDF (native, no LLM) or image (via Vision OCR). */
+    extract(request: DocumentRequest): Promise<DocumentExtractResult>;
+    /** Extract then summarize the document with a chat model. */
+    summarize(request: DocumentRequest): Promise<DocumentSummarizeResult>;
+    /** Extract then answer a question about the document. */
+    query(request: DocumentQueryRequest): Promise<DocumentQueryResult>;
+    private post;
+}
+
+export { type DocumentCost, type DocumentExtractMethod, type DocumentExtractResult, type DocumentInput, type DocumentKind, type DocumentQueryRequest, type DocumentQueryResult, type DocumentRequest, type DocumentSummarizeResult, type DocumentUsage, DocumentsNamespace };

package/dist/documents/index.js

@@ -0,0 +1,88 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/documents/index.ts
+var documents_exports = {};
+__export(documents_exports, {
+  DocumentsNamespace: () => DocumentsNamespace
+});
+module.exports = __toCommonJS(documents_exports);
+function toBody(request, extra = {}) {
+  const body = {
+    prompt: request.prompt,
+    model: request.model,
+    max_tokens: request.maxTokens,
+    temperature: request.temperature,
+    ...extra
+  };
+  if (request.document.url) {
+    body.document_url = request.document.url;
+  } else if (request.document.base64) {
+    body.document_base64 = request.document.base64;
+    body.mime_type = request.document.mimeType;
+    body.filename = request.document.filename;
+  } else {
+    throw new Error("documents request requires document.url or document.base64");
+  }
+  return body;
+}
+var DocumentsNamespace = class {
+  constructor(config) {
+    this.config = config;
+  }
+  /** Extract text from a PDF (native, no LLM) or image (via Vision OCR). */
+  async extract(request) {
+    return this.post("/api/ai/documents/extract", toBody(request));
+  }
+  /** Extract then summarize the document with a chat model. */
+  async summarize(request) {
+    return this.post("/api/ai/documents/summarize", toBody(request));
+  }
+  /** Extract then answer a question about the document. */
+  async query(request) {
+    if (!request.question) throw new Error("documents.query requires a `question`");
+    return this.post("/api/ai/documents/query", toBody(request, { question: request.question }));
+  }
+  async post(path, body) {
+    const response = await fetch(`${this.config.baseUrl}${path}`, {
+      method: "POST",
+      headers: {
+        "CENCORI_API_KEY": this.config.apiKey,
+        "Content-Type": "application/json",
+        ...this.config.headers
+      },
+      body: JSON.stringify(body)
+    });
+    const data = await response.json();
+    if (!response.ok) {
+      const message = data && typeof data === "object" && "message" in data && typeof data.message === "string" ? data.message : `Documents request failed with status ${response.status}`;
+      const code = data && typeof data === "object" && "error" in data && typeof data.error === "string" ? data.error : "request_failed";
+      const err = new Error(message);
+      err.code = code;
+      err.details = data;
+      throw err;
+    }
+    return data;
+  }
+};
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  DocumentsNamespace
+});
+//# sourceMappingURL=index.js.map

package/dist/documents/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/documents/index.ts"],"sourcesContent":["/**\n * Documents API — extract text from PDFs and images, summarize, and query.\n *\n * @example\n *   const { text, pageCount } = await cencori.documents.extract({\n *       document: { url: 'https://example.com/contract.pdf' },\n *   });\n *\n * @example\n *   const { summary } = await cencori.documents.summarize({\n *       document: { base64, mimeType: 'application/pdf' },\n *   });\n *\n * @example\n *   const { answer } = await cencori.documents.query({\n *       document: { url: 'https://example.com/report.pdf' },\n *       question: 'What is the total revenue for Q3?',\n *   });\n */\n\nimport type { CencoriConfig } from '../types';\n\nexport type DocumentExtractMethod = 'pdf_text' | 'vision_ocr';\nexport type DocumentKind = 'pdf' | 'image';\n\nexport interface DocumentInput {\n    url?: string;\n    base64?: string;\n    mimeType?: string;\n    filename?: string;\n}\n\nexport interface DocumentRequest {\n    document: DocumentInput;\n    prompt?: string;\n    model?: string;\n    maxTokens?: number;\n    temperature?: number;\n}\n\nexport interface DocumentQueryRequest extends DocumentRequest {\n    question: string;\n}\n\nexport interface DocumentUsage {\n    promptTokens: number;\n    completionTokens: number;\n    totalTokens: number;\n}\n\nexport interface DocumentCost {\n    providerCostUsd: number;\n    cencoriChargeUsd: number;\n    markupPercentage: number;\n}\n\nexport interface DocumentExtractResult {\n    text: string;\n    pageCount: number;\n    kind: DocumentKind;\n    method: DocumentExtractMethod;\n    model?: string;\n    provider?: string;\n    metadata?: Record<string, unknown>;\n    usage?: DocumentUsage;\n    cost?: DocumentCost;\n}\n\nexport interface DocumentSummarizeResult {\n    summary: string;\n    text: string;\n    pageCount: number;\n    model: string;\n    provider: string;\n    extractMethod: DocumentExtractMethod;\n    usage: DocumentUsage;\n    cost: DocumentCost;\n}\n\nexport interface DocumentQueryResult {\n    answer: string;\n    question: string;\n    pageCount: number;\n    model: string;\n    provider: string;\n    extractMethod: DocumentExtractMethod;\n    usage: DocumentUsage;\n    cost: DocumentCost;\n}\n\ninterface JsonBody {\n    document_url?: string;\n    document_base64?: string;\n    mime_type?: string;\n    filename?: string;\n    prompt?: string;\n    model?: string;\n    max_tokens?: number;\n    temperature?: number;\n    question?: string;\n}\n\nfunction toBody(request: DocumentRequest, extra: Partial<JsonBody> = {}): JsonBody {\n    const body: JsonBody = {\n        prompt: request.prompt,\n        model: request.model,\n        max_tokens: request.maxTokens,\n        temperature: request.temperature,\n        ...extra,\n    };\n    if (request.document.url) {\n        body.document_url = request.document.url;\n    } else if (request.document.base64) {\n        body.document_base64 = request.document.base64;\n        body.mime_type = request.document.mimeType;\n        body.filename = request.document.filename;\n    } else {\n        throw new Error('documents request requires document.url or document.base64');\n    }\n    return body;\n}\n\nexport class DocumentsNamespace {\n    private config: Required<CencoriConfig>;\n\n    constructor(config: Required<CencoriConfig>) {\n        this.config = config;\n    }\n\n    /** Extract text from a PDF (native, no LLM) or image (via Vision OCR). */\n    async extract(request: DocumentRequest): Promise<DocumentExtractResult> {\n        return this.post<DocumentExtractResult>('/api/ai/documents/extract', toBody(request));\n    }\n\n    /** Extract then summarize the document with a chat model. */\n    async summarize(request: DocumentRequest): Promise<DocumentSummarizeResult> {\n        return this.post<DocumentSummarizeResult>('/api/ai/documents/summarize', toBody(request));\n    }\n\n    /** Extract then answer a question about the document. */\n    async query(request: DocumentQueryRequest): Promise<DocumentQueryResult> {\n        if (!request.question) throw new Error('documents.query requires a `question`');\n        return this.post<DocumentQueryResult>('/api/ai/documents/query', toBody(request, { question: request.question }));\n    }\n\n    private async post<T>(path: string, body: JsonBody): Promise<T> {\n        const response = await fetch(`${this.config.baseUrl}${path}`, {\n            method: 'POST',\n            headers: {\n                'CENCORI_API_KEY': this.config.apiKey,\n                'Content-Type': 'application/json',\n                ...this.config.headers,\n            },\n            body: JSON.stringify(body),\n        });\n        const data = await response.json();\n        if (!response.ok) {\n            const message =\n                (data && typeof data === 'object' && 'message' in data && typeof data.message === 'string')\n                    ? data.message\n                    : `Documents request failed with status ${response.status}`;\n            const code =\n                (data && typeof data === 'object' && 'error' in data && typeof data.error === 'string')\n                    ? data.error\n                    : 'request_failed';\n            const err = new Error(message) as Error & { code?: string; details?: unknown };\n            err.code = code;\n            err.details = data;\n            throw err;\n        }\n        return data as T;\n    }\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAsGA,SAAS,OAAO,SAA0B,QAA2B,CAAC,GAAa;AAC/E,QAAM,OAAiB;AAAA,IACnB,QAAQ,QAAQ;AAAA,IAChB,OAAO,QAAQ;AAAA,IACf,YAAY,QAAQ;AAAA,IACpB,aAAa,QAAQ;AAAA,IACrB,GAAG;AAAA,EACP;AACA,MAAI,QAAQ,SAAS,KAAK;AACtB,SAAK,eAAe,QAAQ,SAAS;AAAA,EACzC,WAAW,QAAQ,SAAS,QAAQ;AAChC,SAAK,kBAAkB,QAAQ,SAAS;AACxC,SAAK,YAAY,QAAQ,SAAS;AAClC,SAAK,WAAW,QAAQ,SAAS;AAAA,EACrC,OAAO;AACH,UAAM,IAAI,MAAM,4DAA4D;AAAA,EAChF;AACA,SAAO;AACX;AAEO,IAAM,qBAAN,MAAyB;AAAA,EAG5B,YAAY,QAAiC;AACzC,SAAK,SAAS;AAAA,EAClB;AAAA;AAAA,EAGA,MAAM,QAAQ,SAA0D;AACpE,WAAO,KAAK,KAA4B,6BAA6B,OAAO,OAAO,CAAC;AAAA,EACxF;AAAA;AAAA,EAGA,MAAM,UAAU,SAA4D;AACxE,WAAO,KAAK,KAA8B,+BAA+B,OAAO,OAAO,CAAC;AAAA,EAC5F;AAAA;AAAA,EAGA,MAAM,MAAM,SAA6D;AACrE,QAAI,CAAC,QAAQ,SAAU,OAAM,IAAI,MAAM,uCAAuC;AAC9E,WAAO,KAAK,KAA0B,2BAA2B,OAAO,SAAS,EAAE,UAAU,QAAQ,SAAS,CAAC,CAAC;AAAA,EACpH;AAAA,EAEA,MAAc,KAAQ,MAAc,MAA4B;AAC5D,UAAM,WAAW,MAAM,MAAM,GAAG,KAAK,OAAO,OAAO,GAAG,IAAI,IAAI;AAAA,MAC1D,QAAQ;AAAA,MACR,SAAS;AAAA,QACL,mBAAmB,KAAK,OAAO;AAAA,QAC/B,gBAAgB;AAAA,QAChB,GAAG,KAAK,OAAO;AAAA,MACnB;AAAA,MACA,MAAM,KAAK,UAAU,IAAI;AAAA,IAC7B,CAAC;AACD,UAAM,OAAO,MAAM,SAAS,KAAK;AACjC,QAAI,CAAC,SAAS,IAAI;AACd,YAAM,UACD,QAAQ,OAAO,SAAS,YAAY,aAAa,QAAQ,OAAO,KAAK,YAAY,WAC5E,KAAK,UACL,wCAAwC,SAAS,MAAM;AACjE,YAAM,OACD,QAAQ,OAAO,SAAS,YAAY,WAAW,QAAQ,OAAO,KAAK,UAAU,WACxE,KAAK,QACL;AACV,YAAM,MAAM,IAAI,MAAM,OAAO;AAC7B,UAAI,OAAO;AACX,UAAI,UAAU;AACd,YAAM;AAAA,IACV;AACA,WAAO;AAAA,EACX;AACJ;","names":[]}

package/dist/documents/index.mjs

@@ -0,0 +1,63 @@
+// src/documents/index.ts
+function toBody(request, extra = {}) {
+  const body = {
+    prompt: request.prompt,
+    model: request.model,
+    max_tokens: request.maxTokens,
+    temperature: request.temperature,
+    ...extra
+  };
+  if (request.document.url) {
+    body.document_url = request.document.url;
+  } else if (request.document.base64) {
+    body.document_base64 = request.document.base64;
+    body.mime_type = request.document.mimeType;
+    body.filename = request.document.filename;
+  } else {
+    throw new Error("documents request requires document.url or document.base64");
+  }
+  return body;
+}
+var DocumentsNamespace = class {
+  constructor(config) {
+    this.config = config;
+  }
+  /** Extract text from a PDF (native, no LLM) or image (via Vision OCR). */
+  async extract(request) {
+    return this.post("/api/ai/documents/extract", toBody(request));
+  }
+  /** Extract then summarize the document with a chat model. */
+  async summarize(request) {
+    return this.post("/api/ai/documents/summarize", toBody(request));
+  }
+  /** Extract then answer a question about the document. */
+  async query(request) {
+    if (!request.question) throw new Error("documents.query requires a `question`");
+    return this.post("/api/ai/documents/query", toBody(request, { question: request.question }));
+  }
+  async post(path, body) {
+    const response = await fetch(`${this.config.baseUrl}${path}`, {
+      method: "POST",
+      headers: {
+        "CENCORI_API_KEY": this.config.apiKey,
+        "Content-Type": "application/json",
+        ...this.config.headers
+      },
+      body: JSON.stringify(body)
+    });
+    const data = await response.json();
+    if (!response.ok) {
+      const message = data && typeof data === "object" && "message" in data && typeof data.message === "string" ? data.message : `Documents request failed with status ${response.status}`;
+      const code = data && typeof data === "object" && "error" in data && typeof data.error === "string" ? data.error : "request_failed";
+      const err = new Error(message);
+      err.code = code;
+      err.details = data;
+      throw err;
+    }
+    return data;
+  }
+};
+export {
+  DocumentsNamespace
+};
+//# sourceMappingURL=index.mjs.map

package/dist/documents/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/documents/index.ts"],"sourcesContent":["/**\n * Documents API — extract text from PDFs and images, summarize, and query.\n *\n * @example\n *   const { text, pageCount } = await cencori.documents.extract({\n *       document: { url: 'https://example.com/contract.pdf' },\n *   });\n *\n * @example\n *   const { summary } = await cencori.documents.summarize({\n *       document: { base64, mimeType: 'application/pdf' },\n *   });\n *\n * @example\n *   const { answer } = await cencori.documents.query({\n *       document: { url: 'https://example.com/report.pdf' },\n *       question: 'What is the total revenue for Q3?',\n *   });\n */\n\nimport type { CencoriConfig } from '../types';\n\nexport type DocumentExtractMethod = 'pdf_text' | 'vision_ocr';\nexport type DocumentKind = 'pdf' | 'image';\n\nexport interface DocumentInput {\n    url?: string;\n    base64?: string;\n    mimeType?: string;\n    filename?: string;\n}\n\nexport interface DocumentRequest {\n    document: DocumentInput;\n    prompt?: string;\n    model?: string;\n    maxTokens?: number;\n    temperature?: number;\n}\n\nexport interface DocumentQueryRequest extends DocumentRequest {\n    question: string;\n}\n\nexport interface DocumentUsage {\n    promptTokens: number;\n    completionTokens: number;\n    totalTokens: number;\n}\n\nexport interface DocumentCost {\n    providerCostUsd: number;\n    cencoriChargeUsd: number;\n    markupPercentage: number;\n}\n\nexport interface DocumentExtractResult {\n    text: string;\n    pageCount: number;\n    kind: DocumentKind;\n    method: DocumentExtractMethod;\n    model?: string;\n    provider?: string;\n    metadata?: Record<string, unknown>;\n    usage?: DocumentUsage;\n    cost?: DocumentCost;\n}\n\nexport interface DocumentSummarizeResult {\n    summary: string;\n    text: string;\n    pageCount: number;\n    model: string;\n    provider: string;\n    extractMethod: DocumentExtractMethod;\n    usage: DocumentUsage;\n    cost: DocumentCost;\n}\n\nexport interface DocumentQueryResult {\n    answer: string;\n    question: string;\n    pageCount: number;\n    model: string;\n    provider: string;\n    extractMethod: DocumentExtractMethod;\n    usage: DocumentUsage;\n    cost: DocumentCost;\n}\n\ninterface JsonBody {\n    document_url?: string;\n    document_base64?: string;\n    mime_type?: string;\n    filename?: string;\n    prompt?: string;\n    model?: string;\n    max_tokens?: number;\n    temperature?: number;\n    question?: string;\n}\n\nfunction toBody(request: DocumentRequest, extra: Partial<JsonBody> = {}): JsonBody {\n    const body: JsonBody = {\n        prompt: request.prompt,\n        model: request.model,\n        max_tokens: request.maxTokens,\n        temperature: request.temperature,\n        ...extra,\n    };\n    if (request.document.url) {\n        body.document_url = request.document.url;\n    } else if (request.document.base64) {\n        body.document_base64 = request.document.base64;\n        body.mime_type = request.document.mimeType;\n        body.filename = request.document.filename;\n    } else {\n        throw new Error('documents request requires document.url or document.base64');\n    }\n    return body;\n}\n\nexport class DocumentsNamespace {\n    private config: Required<CencoriConfig>;\n\n    constructor(config: Required<CencoriConfig>) {\n        this.config = config;\n    }\n\n    /** Extract text from a PDF (native, no LLM) or image (via Vision OCR). */\n    async extract(request: DocumentRequest): Promise<DocumentExtractResult> {\n        return this.post<DocumentExtractResult>('/api/ai/documents/extract', toBody(request));\n    }\n\n    /** Extract then summarize the document with a chat model. */\n    async summarize(request: DocumentRequest): Promise<DocumentSummarizeResult> {\n        return this.post<DocumentSummarizeResult>('/api/ai/documents/summarize', toBody(request));\n    }\n\n    /** Extract then answer a question about the document. */\n    async query(request: DocumentQueryRequest): Promise<DocumentQueryResult> {\n        if (!request.question) throw new Error('documents.query requires a `question`');\n        return this.post<DocumentQueryResult>('/api/ai/documents/query', toBody(request, { question: request.question }));\n    }\n\n    private async post<T>(path: string, body: JsonBody): Promise<T> {\n        const response = await fetch(`${this.config.baseUrl}${path}`, {\n            method: 'POST',\n            headers: {\n                'CENCORI_API_KEY': this.config.apiKey,\n                'Content-Type': 'application/json',\n                ...this.config.headers,\n            },\n            body: JSON.stringify(body),\n        });\n        const data = await response.json();\n        if (!response.ok) {\n            const message =\n                (data && typeof data === 'object' && 'message' in data && typeof data.message === 'string')\n                    ? data.message\n                    : `Documents request failed with status ${response.status}`;\n            const code =\n                (data && typeof data === 'object' && 'error' in data && typeof data.error === 'string')\n                    ? data.error\n                    : 'request_failed';\n            const err = new Error(message) as Error & { code?: string; details?: unknown };\n            err.code = code;\n            err.details = data;\n            throw err;\n        }\n        return data as T;\n    }\n}\n"],"mappings":";AAsGA,SAAS,OAAO,SAA0B,QAA2B,CAAC,GAAa;AAC/E,QAAM,OAAiB;AAAA,IACnB,QAAQ,QAAQ;AAAA,IAChB,OAAO,QAAQ;AAAA,IACf,YAAY,QAAQ;AAAA,IACpB,aAAa,QAAQ;AAAA,IACrB,GAAG;AAAA,EACP;AACA,MAAI,QAAQ,SAAS,KAAK;AACtB,SAAK,eAAe,QAAQ,SAAS;AAAA,EACzC,WAAW,QAAQ,SAAS,QAAQ;AAChC,SAAK,kBAAkB,QAAQ,SAAS;AACxC,SAAK,YAAY,QAAQ,SAAS;AAClC,SAAK,WAAW,QAAQ,SAAS;AAAA,EACrC,OAAO;AACH,UAAM,IAAI,MAAM,4DAA4D;AAAA,EAChF;AACA,SAAO;AACX;AAEO,IAAM,qBAAN,MAAyB;AAAA,EAG5B,YAAY,QAAiC;AACzC,SAAK,SAAS;AAAA,EAClB;AAAA;AAAA,EAGA,MAAM,QAAQ,SAA0D;AACpE,WAAO,KAAK,KAA4B,6BAA6B,OAAO,OAAO,CAAC;AAAA,EACxF;AAAA;AAAA,EAGA,MAAM,UAAU,SAA4D;AACxE,WAAO,KAAK,KAA8B,+BAA+B,OAAO,OAAO,CAAC;AAAA,EAC5F;AAAA;AAAA,EAGA,MAAM,MAAM,SAA6D;AACrE,QAAI,CAAC,QAAQ,SAAU,OAAM,IAAI,MAAM,uCAAuC;AAC9E,WAAO,KAAK,KAA0B,2BAA2B,OAAO,SAAS,EAAE,UAAU,QAAQ,SAAS,CAAC,CAAC;AAAA,EACpH;AAAA,EAEA,MAAc,KAAQ,MAAc,MAA4B;AAC5D,UAAM,WAAW,MAAM,MAAM,GAAG,KAAK,OAAO,OAAO,GAAG,IAAI,IAAI;AAAA,MAC1D,QAAQ;AAAA,MACR,SAAS;AAAA,QACL,mBAAmB,KAAK,OAAO;AAAA,QAC/B,gBAAgB;AAAA,QAChB,GAAG,KAAK,OAAO;AAAA,MACnB;AAAA,MACA,MAAM,KAAK,UAAU,IAAI;AAAA,IAC7B,CAAC;AACD,UAAM,OAAO,MAAM,SAAS,KAAK;AACjC,QAAI,CAAC,SAAS,IAAI;AACd,YAAM,UACD,QAAQ,OAAO,SAAS,YAAY,aAAa,QAAQ,OAAO,KAAK,YAAY,WAC5E,KAAK,UACL,wCAAwC,SAAS,MAAM;AACjE,YAAM,OACD,QAAQ,OAAO,SAAS,YAAY,WAAW,QAAQ,OAAO,KAAK,UAAU,WACxE,KAAK,QACL;AACV,YAAM,MAAM,IAAI,MAAM,OAAO;AAC7B,UAAI,OAAO;AACX,UAAI,UAAU;AACd,YAAM;AAAA,IACV;AACA,WAAO;AAAA,EACX;AACJ;","names":[]}

package/dist/index.d.mts

@@ -4,6 +4,10 @@ import { AINamespace } from './ai/index.mjs';
 export { StreamChunk } from './ai/index.mjs';
 import { VisionNamespace } from './vision/index.mjs';
 export { VisionClassification, VisionClassifyResult, VisionCost, VisionDescribeResult, VisionImage, VisionOcrResult, VisionProvider, VisionRequest, VisionResult, VisionStreamChunk, VisionTask, VisionUsage } from './vision/index.mjs';
+import { VoiceNamespace } from './voice/index.mjs';
+export { AudioFormat, AudioInput, STTProvider, SpeakRequest, SpeakResult, TTSProvider, TranscribeRequest, TranscribeResult, TranscriptFormat, TranscriptSegment, TranscriptWord, VoiceModelInfo } from './voice/index.mjs';
+import { DocumentsNamespace } from './documents/index.mjs';
+export { DocumentCost, DocumentExtractMethod, DocumentExtractResult, DocumentInput, DocumentKind, DocumentQueryRequest, DocumentQueryResult, DocumentRequest, DocumentSummarizeResult, DocumentUsage } from './documents/index.mjs';
 import { ComputeNamespace } from './compute/index.mjs';
 import { WorkflowNamespace } from './workflow/index.mjs';
 import { StorageNamespace } from './storage/index.mjs';
@@ -178,6 +182,118 @@ declare class SessionsNamespace {
     }>;
 }
 
+/**
+ * Cencori Chat namespace — OpenAI-compatible chat completions with
+ * gateway-level memory.
+ *
+ * The magic path: one line makes chat stateful.
+ *
+ * @example
+ * ```typescript
+ * const response = await cencori.chat.completions.create({
+ *     model: 'gpt-4o',
+ *     messages: [{ role: 'user', content: 'What did we agree about pricing?' }],
+ *     memory: { userId: session.user.id },
+ * });
+ * console.log(response.choices[0].message.content);
+ * console.log(response.memory?.retrieved); // facts injected into this reply
+ * ```
+ */
+
+interface ChatMemoryOptions {
+    userId?: string;
+    sessionId?: string;
+    scope?: 'session' | 'user';
+    retrieve?: boolean;
+    write?: boolean;
+    topK?: number;
+    threshold?: number;
+    namespace?: string;
+    extract?: {
+        model?: string;
+        prompt?: string;
+        minImportance?: number;
+    };
+}
+interface ChatCompletionMessage {
+    role: 'system' | 'user' | 'assistant' | 'tool';
+    content: string;
+}
+interface ChatCompletionCreateParams {
+    model: string;
+    messages: ChatCompletionMessage[];
+    temperature?: number;
+    max_tokens?: number;
+    user?: string;
+    memory?: ChatMemoryOptions;
+    tools?: unknown[];
+    tool_choice?: unknown;
+    prompt?: {
+        name: string;
+        variables?: Record<string, string>;
+    };
+}
+interface ChatCompletionResponse {
+    id: string;
+    object: string;
+    created: number;
+    model: string;
+    choices: Array<{
+        index: number;
+        message: {
+            role: string;
+            content: string;
+            tool_calls?: unknown[];
+        };
+        finish_reason: string;
+    }>;
+    usage?: {
+        prompt_tokens: number;
+        completion_tokens: number;
+        total_tokens: number;
+    };
+    memory?: {
+        retrieved: Array<{
+            id: string;
+            score: number;
+            content: string;
+        }>;
+        written: Array<{
+            id: string;
+            content: string;
+        }>;
+        write_status: 'pending' | 'disabled';
+    };
+}
+interface ChatCompletionChunk {
+    delta: string;
+    raw: Record<string, unknown>;
+}
+interface ChatCompletionStream extends AsyncIterable<ChatCompletionChunk> {
+    /** Number of memories injected into this request (from X-Cencori-Memory-Retrieved). */
+    memoriesRetrieved: number;
+}
+declare class Completions {
+    private config;
+    constructor(config: Required<CencoriConfig>);
+    private endpoint;
+    private headers;
+    /**
+     * Create a chat completion. Include `memory: { userId }` to retrieve
+     * relevant facts before the model call and persist new ones after it.
+     */
+    create(params: ChatCompletionCreateParams): Promise<ChatCompletionResponse>;
+    /**
+     * Stream a chat completion (SSE). Memory writeback still runs after the
+     * stream completes; `memoriesRetrieved` reports the injected count.
+     */
+    stream(params: ChatCompletionCreateParams): Promise<ChatCompletionStream>;
+}
+declare class ChatNamespace {
+    readonly completions: Completions;
+    constructor(config: Required<CencoriConfig>);
+}
+
 /**
  * Cencori - Unified AI Infrastructure SDK
  *
@@ -214,6 +330,18 @@ declare class Cencori {
      * await cencori.ai.chat({ model: 'gpt-4o', messages: [...] });
      */
     readonly ai: AINamespace;
+    /**
+     * Chat - OpenAI-compatible chat completions with gateway memory.
+     * One line makes chat stateful.
+     *
+     * @example
+     * const response = await cencori.chat.completions.create({
+     *   model: 'gpt-4o',
+     *   messages: [{ role: 'user', content: 'What did we agree about pricing?' }],
+     *   memory: { userId: session.user.id },
+     * });
+     */
+    readonly chat: ChatNamespace;
     /**
      * Vision - Analyze, describe, OCR, and classify images
      *
@@ -229,6 +357,48 @@ declare class Cencori {
      * });
      */
     readonly vision: VisionNamespace;
+    /**
+     * Voice - Text-to-speech and speech-to-text across providers
+     *
+     * @example
+     * const { audio } = await cencori.voice.speak({
+     *   input: 'Hello from Cencori.',
+     *   model: 'aura-asteria-en', // Deepgram; provider inferred from model
+     * });
+     *
+     * @example
+     * const { text } = await cencori.voice.transcribe({
+     *   audio: fileBytes,
+     *   model: 'nova-3',
+     * });
+     *
+     * @example
+     * const { segments } = await cencori.voice.diarize({
+     *   audio: fileBytes,
+     *   model: 'assemblyai-universal',
+     * });
+     */
+    readonly voice: VoiceNamespace;
+    /**
+     * Documents - Extract text from PDFs and images, summarize, and query
+     *
+     * @example
+     * const { text } = await cencori.documents.extract({
+     *   document: { url: 'https://example.com/contract.pdf' }
+     * });
+     *
+     * @example
+     * const { summary } = await cencori.documents.summarize({
+     *   document: { url: 'https://example.com/report.pdf' }
+     * });
+     *
+     * @example
+     * const { answer } = await cencori.documents.query({
+     *   document: { url },
+     *   question: 'What is the total revenue for Q3?',
+     * });
+     */
+    readonly documents: DocumentsNamespace;
     /**
      * Agents - Create and manage AI agents programmatically.
      *
@@ -369,4 +539,4 @@ declare class SafetyError extends CencoriError {
  */
 declare function fetchWithRetry(url: string, options: RequestInit, maxRetries?: number): Promise<Response>;
 
-export { AINamespace, type Agent, type AgentConfig, type AgentKey, type AgentListItem, AgentsNamespace, AuthenticationError, Cencori, CencoriConfig, CencoriError, ComputeNamespace, type CreateAgentKeyParams, type CreateAgentParams, type CreateSessionParams, MemoryClient, type PaginatedResponse, RateLimitError, RequestOptions, SafetyError, type Session, type SessionEvent, type SessionListParams, SessionsNamespace, StorageNamespace, TelemetryClient, type TurnParams, type UpdateAgentParams, VisionNamespace, WorkflowNamespace, Cencori as default, fetchWithRetry };
+export { AINamespace, type Agent, type AgentConfig, type AgentKey, type AgentListItem, AgentsNamespace, AuthenticationError, Cencori, CencoriConfig, CencoriError, type ChatCompletionChunk, type ChatCompletionCreateParams, type ChatCompletionResponse, type ChatCompletionStream, type ChatMemoryOptions, ChatNamespace, ComputeNamespace, type CreateAgentKeyParams, type CreateAgentParams, type CreateSessionParams, DocumentsNamespace, MemoryClient, type PaginatedResponse, RateLimitError, RequestOptions, SafetyError, type Session, type SessionEvent, type SessionListParams, SessionsNamespace, StorageNamespace, TelemetryClient, type TurnParams, type UpdateAgentParams, VisionNamespace, VoiceNamespace, WorkflowNamespace, Cencori as default, fetchWithRetry };