@veruna/api-contracts 20.0.0 → 20.2.0

package/build/v1/chat-project/schemas/project-response.schema.js.map

@@ -1 +1 @@
-{"version":3,"file":"project-response.schema.js","sourceRoot":"","sources":["../../../../v1/chat-project/schemas/project-response.schema.ts"],"names":[],"mappings":";;;AAAA,6BAAwB;AACxB,4CAA6D;AAC7D,yEAA+D;AAKlD,QAAA,qBAAqB,GAAG,OAAC,CAAC,MAAM,CAAC;IAC1C,IAAI,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,mBAAU,CAAC;IAClC,KAAK,EAAE,OAAC,CAAC,MAAM,EAAE;IACjB,KAAK,EAAE,OAAC,CAAC,MAAM,EAAE;IACjB,MAAM,EAAE,OAAC,CAAC,IAAI,CAAC,4CAAiB,CAAC;IACjC,SAAS,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,uBAAc,CAAC;IAC3C,SAAS,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,uBAAc,CAAC;CAC9C,CAAC,CAAC"}
+{"version":3,"file":"project-response.schema.js","sourceRoot":"","sources":["../../../../v1/chat-project/schemas/project-response.schema.ts"],"names":[],"mappings":";;;AAAA,6BAAwB;AACxB,4CAA6D;AAC7D,yEAA+D;AAE/D;;GAEG;AACU,QAAA,qBAAqB,GAAG,OAAC,CAAC,MAAM,CAAC;IAC1C,IAAI,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,mBAAU,CAAC;IAClC,KAAK,EAAE,OAAC,CAAC,MAAM,EAAE;IACjB,KAAK,EAAE,OAAC,CAAC,MAAM,EAAE;IACjB,MAAM,EAAE,OAAC,CAAC,IAAI,CAAC,4CAAiB,CAAC;IACjC,SAAS,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,uBAAc,CAAC;IAC3C,SAAS,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,uBAAc,CAAC;CAC9C,CAAC,CAAC"}

package/build/v1/chat-project/schemas/route-params.schema.d.ts

@@ -1,4 +1,8 @@
 import { z } from 'zod';
+/**
+ * Project UUID param schema for route validation
+ * Error messages: ProjectUuidParam.{field}.{rule}
+ */
 export declare const ProjectUuidParamSchema: z.ZodObject<{
     uuid: z.ZodString;
 }, z.core.$strip>;

package/build/v1/chat-project/schemas/route-params.schema.js

@@ -3,6 +3,10 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.ProjectUuidParamSchema = void 0;
 const zod_1 = require("zod");
 const shared_1 = require("../../../shared");
+/**
+ * Project UUID param schema for route validation
+ * Error messages: ProjectUuidParam.{field}.{rule}
+ */
 exports.ProjectUuidParamSchema = zod_1.z.object({
     uuid: zod_1.z
         .string({ error: 'ProjectUuidParam.uuid.required' })

package/build/v1/chat-project/schemas/route-params.schema.js.map

@@ -1 +1 @@
-{"version":3,"file":"route-params.schema.js","sourceRoot":"","sources":["../../../../v1/chat-project/schemas/route-params.schema.ts"],"names":[],"mappings":";;;AAAA,6BAAwB;AACxB,4CAA6C;AAMhC,QAAA,sBAAsB,GAAG,OAAC,CAAC,MAAM,CAAC;IAC3C,IAAI,EAAE,OAAC;SACF,MAAM,CAAC,EAAE,KAAK,EAAE,gCAAgC,EAAE,CAAC;SACnD,KAAK,CAAC,mBAAU,EAAE,EAAE,OAAO,EAAE,+BAA+B,EAAE,CAAC;CACvE,CAAC,CAAC"}
+{"version":3,"file":"route-params.schema.js","sourceRoot":"","sources":["../../../../v1/chat-project/schemas/route-params.schema.ts"],"names":[],"mappings":";;;AAAA,6BAAwB;AACxB,4CAA6C;AAE7C;;;GAGG;AACU,QAAA,sBAAsB,GAAG,OAAC,CAAC,MAAM,CAAC;IAC3C,IAAI,EAAE,OAAC;SACF,MAAM,CAAC,EAAE,KAAK,EAAE,gCAAgC,EAAE,CAAC;SACnD,KAAK,CAAC,mBAAU,EAAE,EAAE,OAAO,EAAE,+BAA+B,EAAE,CAAC;CACvE,CAAC,CAAC"}

package/build/v1/chat-project/schemas/update-project-request.schema.d.ts

@@ -1,4 +1,8 @@
 import { z } from 'zod';
+/**
+ * Update Chat Project Request Schema
+ * Error messages: UpdateProjectRequest.{field}.{rule}
+ */
 export declare const UpdateProjectRequestSchema: z.ZodObject<{
     title: z.ZodOptional<z.ZodString>;
     color: z.ZodOptional<z.ZodString>;

package/build/v1/chat-project/schemas/update-project-request.schema.js

@@ -3,6 +3,10 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.UpdateProjectRequestSchema = void 0;
 const zod_1 = require("zod");
 const shared_1 = require("../../../shared");
+/**
+ * Update Chat Project Request Schema
+ * Error messages: UpdateProjectRequest.{field}.{rule}
+ */
 exports.UpdateProjectRequestSchema = zod_1.z.object({
     title: zod_1.z
         .string()

package/build/v1/chat-project/schemas/update-project-request.schema.js.map

@@ -1 +1 @@
-{"version":3,"file":"update-project-request.schema.js","sourceRoot":"","sources":["../../../../v1/chat-project/schemas/update-project-request.schema.ts"],"names":[],"mappings":";;;AAAA,6BAAwB;AACxB,4CAAkD;AAMrC,QAAA,0BAA0B,GAAG,OAAC,CAAC,MAAM,CAAC;IAC/C,KAAK,EAAE,OAAC;SACH,MAAM,EAAE;SACR,GAAG,CAAC,CAAC,EAAE,EAAE,OAAO,EAAE,gCAAgC,EAAE,CAAC;SACrD,GAAG,CAAC,GAAG,EAAE,EAAE,OAAO,EAAE,gCAAgC,EAAE,CAAC;SACvD,QAAQ,EAAE;IACf,KAAK,EAAE,OAAC;SACH,MAAM,EAAE;SACR,KAAK,CAAC,wBAAe,EAAE,EAAE,OAAO,EAAE,oCAAoC,EAAE,CAAC;SACzE,QAAQ,EAAE;CAClB,CAAC,CAAC"}
+{"version":3,"file":"update-project-request.schema.js","sourceRoot":"","sources":["../../../../v1/chat-project/schemas/update-project-request.schema.ts"],"names":[],"mappings":";;;AAAA,6BAAwB;AACxB,4CAAkD;AAElD;;;GAGG;AACU,QAAA,0BAA0B,GAAG,OAAC,CAAC,MAAM,CAAC;IAC/C,KAAK,EAAE,OAAC;SACH,MAAM,EAAE;SACR,GAAG,CAAC,CAAC,EAAE,EAAE,OAAO,EAAE,gCAAgC,EAAE,CAAC;SACrD,GAAG,CAAC,GAAG,EAAE,EAAE,OAAO,EAAE,gCAAgC,EAAE,CAAC;SACvD,QAAQ,EAAE;IACf,KAAK,EAAE,OAAC;SACH,MAAM,EAAE;SACR,KAAK,CAAC,wBAAe,EAAE,EAAE,OAAO,EAAE,oCAAoC,EAAE,CAAC;SACzE,QAAQ,EAAE;CAClB,CAAC,CAAC"}

package/build/v1/client-file/attachment-coverage.d.ts

@@ -1,3 +1,36 @@
 import { AttachmentCoverageInput } from './attachment-coverage.types';
+/**
+ * A document long or heavy enough that only its first pages are sent.
+ *
+ * Either threshold is enough on its own: a four-page PDF of scanned photos
+ * blows the token budget exactly as a two-hundred-page text one does.
+ */
 export declare function isLargeVisualDoc(file: AttachmentCoverageInput): boolean;
+/**
+ * Will the WHOLE of this attachment be in front of the model, with no tool call
+ * needed to see the rest?
+ *
+ * The answer mirrors, case for case, what the content builder actually puts in
+ * the message:
+ *
+ *   image            → inlined as image_url, always whole
+ *   small text file  → raw text inlined
+ *   long text file   → preview only (the worker stamps `textPreview`)
+ *   huge text file   → nothing but a metadata stub, whatever the worker stamped
+ *   small PDF / doc  → sent as a FILE item, OCR'd in full by the provider
+ *   large PDF / doc  → first pages only, the rest reachable from the sandbox
+ *   other binaries   → sandbox-only, the model gets a filename and nothing else
+ *
+ * Coverage information, not upload permission: guests may receive a partial
+ * document, with explicit reading boundaries and a FILE_TRUNCATED card.
+ * Callers must supply the main document size as originalSize, not the S3
+ * accounting total for additional objects stored under the same row.
+ *
+ * Reads a row that is already final: page count, category and preview are all
+ * written by `finalizeUpload`, the same call that flips the row to PENDING, so
+ * there is no window where this sees half-processed metadata. A paginated
+ * document that still has no page count is a FAILED conversion, and it is
+ * refused after attach for everyone alike (DOCUMENT_PAGE_COUNT_UNAVAILABLE) —
+ * not this predicate's question, which is about coverage, not validity.
+ */
 export declare function reachesModelInFull(file: AttachmentCoverageInput): boolean;

package/build/v1/client-file/attachment-coverage.js

@@ -7,6 +7,12 @@ const processing_category_enum_1 = require("./schemas/processing-category.enum")
 const file_processing_constants_1 = require("./file-processing.constants");
 const PDF_CONTENT_TYPE = 'application/pdf';
 const PDF_EXTENSION = '.pdf';
+/**
+ * A document long or heavy enough that only its first pages are sent.
+ *
+ * Either threshold is enough on its own: a four-page PDF of scanned photos
+ * blows the token budget exactly as a two-hundred-page text one does.
+ */
 function isLargeVisualDoc(file) {
     const pageLarge = file.pageCount != null && file.pageCount > file_processing_constants_1.PDF_LARGE_PAGE_THRESHOLD;
     const sizeLarge = file.originalSize != null && file.originalSize > file_processing_constants_1.PDF_LARGE_SIZE_THRESHOLD_BYTES;
@@ -16,10 +22,44 @@ function isPdf(file) {
     return (file.contentType === PDF_CONTENT_TYPE ||
         file.originalFilename.toLowerCase().endsWith(PDF_EXTENSION));
 }
+/**
+ * Will the WHOLE of this attachment be in front of the model, with no tool call
+ * needed to see the rest?
+ *
+ * The answer mirrors, case for case, what the content builder actually puts in
+ * the message:
+ *
+ *   image            → inlined as image_url, always whole
+ *   small text file  → raw text inlined
+ *   long text file   → preview only (the worker stamps `textPreview`)
+ *   huge text file   → nothing but a metadata stub, whatever the worker stamped
+ *   small PDF / doc  → sent as a FILE item, OCR'd in full by the provider
+ *   large PDF / doc  → first pages only, the rest reachable from the sandbox
+ *   other binaries   → sandbox-only, the model gets a filename and nothing else
+ *
+ * Coverage information, not upload permission: guests may receive a partial
+ * document, with explicit reading boundaries and a FILE_TRUNCATED card.
+ * Callers must supply the main document size as originalSize, not the S3
+ * accounting total for additional objects stored under the same row.
+ *
+ * Reads a row that is already final: page count, category and preview are all
+ * written by `finalizeUpload`, the same call that flips the row to PENDING, so
+ * there is no window where this sees half-processed metadata. A paginated
+ * document that still has no page count is a FAILED conversion, and it is
+ * refused after attach for everyone alike (DOCUMENT_PAGE_COUNT_UNAVAILABLE) —
+ * not this predicate's question, which is about coverage, not validity.
+ */
 function reachesModelInFull(file) {
     if (file.type === client_file_type_enum_1.ClientFileType.IMAGE) {
         return true;
     }
+    // Fail CLOSED when the upload pipeline's own verdict is missing. A document
+    // with no category is either a legacy row or a response from a file service
+    // that does not send the field yet — and the two apps deploy on independent
+    // pipelines, so that second case is a real window on every release. Reading
+    // silence as "small" there would pass a two-hundred-page PDF whose page
+    // count simply never arrived. Refusing costs nothing: without the field
+    // these were refused outright before this predicate existed.
     if (file.processingCategory == null) {
         return false;
     }
@@ -34,6 +74,9 @@ function reachesModelInFull(file) {
         file.processingCategory === processing_category_enum_1.FileProcessingCategory.VISUAL_DOC) {
         return !isLargeVisualDoc(file);
     }
+    // A binary the pipeline could not convert — pptx or xlsx that never became
+    // a PDF. It is skipped as a content item entirely; only a pointer to the
+    // sandbox path is left, which is worth nothing without a sandbox.
     return false;
 }
 //# sourceMappingURL=attachment-coverage.js.map

package/build/v1/client-file/attachment-coverage.js.map

@@ -1 +1 @@
-{"version":3,"file":"attachment-coverage.js","sourceRoot":"","sources":["../../../v1/client-file/attachment-coverage.ts"],"names":[],"mappings":";;AAkBA,4CAKC;AAoCD,gDAmCC;AA9FD,2EAAiE;AACjE,iFAA4E;AAC5E,2EAIqC;AAGrC,MAAM,gBAAgB,GAAG,iBAAiB,CAAC;AAC3C,MAAM,aAAa,GAAG,MAAM,CAAC;AAQ7B,SAAgB,gBAAgB,CAAC,IAA6B;IAC1D,MAAM,SAAS,GAAG,IAAI,CAAC,SAAS,IAAI,IAAI,IAAI,IAAI,CAAC,SAAS,GAAG,oDAAwB,CAAC;IACtF,MAAM,SAAS,GACX,IAAI,CAAC,YAAY,IAAI,IAAI,IAAI,IAAI,CAAC,YAAY,GAAG,0DAA8B,CAAC;IACpF,OAAO,SAAS,IAAI,SAAS,CAAC;AAClC,CAAC;AAED,SAAS,KAAK,CAAC,IAA6B;IACxC,OAAO,CACH,IAAI,CAAC,WAAW,KAAK,gBAAgB;QACrC,IAAI,CAAC,gBAAgB,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,aAAa,CAAC,CAC9D,CAAC;AACN,CAAC;AA6BD,SAAgB,kBAAkB,CAAC,IAA6B;IAC5D,IAAI,IAAI,CAAC,IAAI,KAAK,sCAAc,CAAC,KAAK,EAAE,CAAC;QACrC,OAAO,IAAI,CAAC;IAChB,CAAC;IASD,IAAI,IAAI,CAAC,kBAAkB,IAAI,IAAI,EAAE,CAAC;QAClC,OAAO,KAAK,CAAC;IACjB,CAAC;IAED,IAAI,IAAI,CAAC,kBAAkB,KAAK,iDAAsB,CAAC,WAAW,EAAE,CAAC;QACjE,IAAI,IAAI,CAAC,WAAW,EAAE,CAAC;YACnB,OAAO,KAAK,CAAC;QACjB,CAAC;QACD,OAAO,IAAI,CAAC,YAAY,IAAI,IAAI,IAAI,IAAI,CAAC,YAAY,IAAI,wDAA4B,CAAC;IAC1F,CAAC;IAED,IACI,KAAK,CAAC,IAAI,CAAC;QACX,IAAI,CAAC,kBAAkB,KAAK,iDAAsB,CAAC,GAAG;QACtD,IAAI,CAAC,kBAAkB,KAAK,iDAAsB,CAAC,UAAU,EAC/D,CAAC;QACC,OAAO,CAAC,gBAAgB,CAAC,IAAI,CAAC,CAAC;IACnC,CAAC;IAKD,OAAO,KAAK,CAAC;AACjB,CAAC"}
+{"version":3,"file":"attachment-coverage.js","sourceRoot":"","sources":["../../../v1/client-file/attachment-coverage.ts"],"names":[],"mappings":";;AAkBA,4CAKC;AAoCD,gDAmCC;AA9FD,2EAAiE;AACjE,iFAA4E;AAC5E,2EAIqC;AAGrC,MAAM,gBAAgB,GAAG,iBAAiB,CAAC;AAC3C,MAAM,aAAa,GAAG,MAAM,CAAC;AAE7B;;;;;GAKG;AACH,SAAgB,gBAAgB,CAAC,IAA6B;IAC1D,MAAM,SAAS,GAAG,IAAI,CAAC,SAAS,IAAI,IAAI,IAAI,IAAI,CAAC,SAAS,GAAG,oDAAwB,CAAC;IACtF,MAAM,SAAS,GACX,IAAI,CAAC,YAAY,IAAI,IAAI,IAAI,IAAI,CAAC,YAAY,GAAG,0DAA8B,CAAC;IACpF,OAAO,SAAS,IAAI,SAAS,CAAC;AAClC,CAAC;AAED,SAAS,KAAK,CAAC,IAA6B;IACxC,OAAO,CACH,IAAI,CAAC,WAAW,KAAK,gBAAgB;QACrC,IAAI,CAAC,gBAAgB,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,aAAa,CAAC,CAC9D,CAAC;AACN,CAAC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,SAAgB,kBAAkB,CAAC,IAA6B;IAC5D,IAAI,IAAI,CAAC,IAAI,KAAK,sCAAc,CAAC,KAAK,EAAE,CAAC;QACrC,OAAO,IAAI,CAAC;IAChB,CAAC;IAED,4EAA4E;IAC5E,4EAA4E;IAC5E,4EAA4E;IAC5E,4EAA4E;IAC5E,wEAAwE;IACxE,wEAAwE;IACxE,6DAA6D;IAC7D,IAAI,IAAI,CAAC,kBAAkB,IAAI,IAAI,EAAE,CAAC;QAClC,OAAO,KAAK,CAAC;IACjB,CAAC;IAED,IAAI,IAAI,CAAC,kBAAkB,KAAK,iDAAsB,CAAC,WAAW,EAAE,CAAC;QACjE,IAAI,IAAI,CAAC,WAAW,EAAE,CAAC;YACnB,OAAO,KAAK,CAAC;QACjB,CAAC;QACD,OAAO,IAAI,CAAC,YAAY,IAAI,IAAI,IAAI,IAAI,CAAC,YAAY,IAAI,wDAA4B,CAAC;IAC1F,CAAC;IAED,IACI,KAAK,CAAC,IAAI,CAAC;QACX,IAAI,CAAC,kBAAkB,KAAK,iDAAsB,CAAC,GAAG;QACtD,IAAI,CAAC,kBAAkB,KAAK,iDAAsB,CAAC,UAAU,EAC/D,CAAC;QACC,OAAO,CAAC,gBAAgB,CAAC,IAAI,CAAC,CAAC;IACnC,CAAC;IAED,2EAA2E;IAC3E,yEAAyE;IACzE,kEAAkE;IAClE,OAAO,KAAK,CAAC;AACjB,CAAC"}

package/build/v1/client-file/attachment-coverage.types.d.ts

@@ -1,9 +1,19 @@
 import { ClientFileType } from './schemas/client-file-type.enum';
+/**
+ * The part of an uploaded file that decides how much of it reaches a model.
+ *
+ * Structural on purpose: the same question is asked at three points, about
+ * three different shapes — the row the uploader has just finalised, the S2S list
+ * row before attaching, and the richer attachment item after. All three carry
+ * these fields, and the answer must not depend on which one is at hand.
+ */
 export interface AttachmentCoverageInput {
     readonly type: ClientFileType;
+    /** Size of the main document; normalize S2S `size` into this legacy field. */
     readonly originalSize?: number | null;
     readonly processingCategory?: string | null;
     readonly pageCount?: number | null;
+    /** Stamped by the upload worker ONLY when the text was too long to inline whole. */
     readonly textPreview?: string | null;
     readonly contentType?: string | null;
     readonly originalFilename: string;

package/build/v1/client-file/client-file-content-kind.d.ts

@@ -0,0 +1,11 @@
+import { ClientFileContentKind } from './schemas/client-file-pages.schema';
+/** Spreadsheets read as sheets and rows (no PDF, no OCR). */
+export declare const CLIENT_FILE_SHEET_MIME_TYPES: ReadonlySet<string>;
+/** Legacy .xls / .ods: no safe maintained parser; read as document pages of the converted PDF. */
+export declare const CLIENT_FILE_LEGACY_SHEET_MIME_TYPES: ReadonlySet<string>;
+export declare const CLIENT_FILE_PRESENTATION_MIME_TYPES: ReadonlySet<string>;
+/**
+ * The one rule both file-service and the API use to decide how a client file is read. The declared MIME wins; a
+ * generic text MIME with a .csv / .tsv / .xlsx name is still a sheet (browsers often send text/plain for CSV).
+ */
+export declare function resolveClientFileContentKind(mimeType: string, filename?: string | null): ClientFileContentKind;

package/build/v1/client-file/client-file-content-kind.js

@@ -0,0 +1,49 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CLIENT_FILE_PRESENTATION_MIME_TYPES = exports.CLIENT_FILE_LEGACY_SHEET_MIME_TYPES = exports.CLIENT_FILE_SHEET_MIME_TYPES = void 0;
+exports.resolveClientFileContentKind = resolveClientFileContentKind;
+const client_file_pages_schema_1 = require("./schemas/client-file-pages.schema");
+/** Spreadsheets read as sheets and rows (no PDF, no OCR). */
+exports.CLIENT_FILE_SHEET_MIME_TYPES = new Set([
+    'text/csv',
+    'text/tab-separated-values',
+    'application/vnd.openxmlformats-officedocument.spreadsheetml.sheet',
+]);
+/** Legacy .xls / .ods: no safe maintained parser; read as document pages of the converted PDF. */
+exports.CLIENT_FILE_LEGACY_SHEET_MIME_TYPES = new Set([
+    'application/vnd.ms-excel',
+    'application/vnd.oasis.opendocument.spreadsheet',
+]);
+exports.CLIENT_FILE_PRESENTATION_MIME_TYPES = new Set([
+    'application/vnd.ms-powerpoint',
+    'application/vnd.openxmlformats-officedocument.presentationml.presentation',
+    'application/vnd.oasis.opendocument.presentation',
+]);
+const SHEET_EXTENSIONS = new Set(['csv', 'tsv', 'xlsx']);
+/**
+ * The one rule both file-service and the API use to decide how a client file is read. The declared MIME wins; a
+ * generic text MIME with a .csv / .tsv / .xlsx name is still a sheet (browsers often send text/plain for CSV).
+ */
+function resolveClientFileContentKind(mimeType, filename) {
+    const mime = mimeType.toLowerCase().split(';')[0].trim();
+    const extension = (filename ?? '').toLowerCase().split('.').pop() ?? '';
+    if (mime.startsWith('image/'))
+        return client_file_pages_schema_1.ClientFileContentKind.IMAGE;
+    if (mime === 'application/pdf')
+        return client_file_pages_schema_1.ClientFileContentKind.PDF;
+    if (exports.CLIENT_FILE_SHEET_MIME_TYPES.has(mime))
+        return client_file_pages_schema_1.ClientFileContentKind.SHEET;
+    if (exports.CLIENT_FILE_LEGACY_SHEET_MIME_TYPES.has(mime))
+        return client_file_pages_schema_1.ClientFileContentKind.DOCUMENT;
+    if (exports.CLIENT_FILE_PRESENTATION_MIME_TYPES.has(mime))
+        return client_file_pages_schema_1.ClientFileContentKind.PRESENTATION;
+    if (mime.includes('word') || mime.includes('opendocument.text') || mime.includes('rtf')) {
+        return client_file_pages_schema_1.ClientFileContentKind.DOCUMENT;
+    }
+    if (SHEET_EXTENSIONS.has(extension) &&
+        (mime.startsWith('text/') || mime === 'application/octet-stream')) {
+        return client_file_pages_schema_1.ClientFileContentKind.SHEET;
+    }
+    return client_file_pages_schema_1.ClientFileContentKind.TEXT;
+}
+//# sourceMappingURL=client-file-content-kind.js.map

package/build/v1/client-file/client-file-content-kind.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client-file-content-kind.js","sourceRoot":"","sources":["../../../v1/client-file/client-file-content-kind.ts"],"names":[],"mappings":";;;AAwBA,oEAqBC;AA7CD,iFAA2E;AAE3E,6DAA6D;AAChD,QAAA,4BAA4B,GAAwB,IAAI,GAAG,CAAC;IACrE,UAAU;IACV,2BAA2B;IAC3B,mEAAmE;CACtE,CAAC,CAAC;AACH,kGAAkG;AACrF,QAAA,mCAAmC,GAAwB,IAAI,GAAG,CAAC;IAC5E,0BAA0B;IAC1B,gDAAgD;CACnD,CAAC,CAAC;AACU,QAAA,mCAAmC,GAAwB,IAAI,GAAG,CAAC;IAC5E,+BAA+B;IAC/B,2EAA2E;IAC3E,iDAAiD;CACpD,CAAC,CAAC;AACH,MAAM,gBAAgB,GAAwB,IAAI,GAAG,CAAC,CAAC,KAAK,EAAE,KAAK,EAAE,MAAM,CAAC,CAAC,CAAC;AAE9E;;;GAGG;AACH,SAAgB,4BAA4B,CACxC,QAAgB,EAChB,QAAwB;IAExB,MAAM,IAAI,GAAG,QAAQ,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;IACzD,MAAM,SAAS,GAAG,CAAC,QAAQ,IAAI,EAAE,CAAC,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,IAAI,EAAE,CAAC;IACxE,IAAI,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC;QAAE,OAAO,gDAAqB,CAAC,KAAK,CAAC;IAClE,IAAI,IAAI,KAAK,iBAAiB;QAAE,OAAO,gDAAqB,CAAC,GAAG,CAAC;IACjE,IAAI,oCAA4B,CAAC,GAAG,CAAC,IAAI,CAAC;QAAE,OAAO,gDAAqB,CAAC,KAAK,CAAC;IAC/E,IAAI,2CAAmC,CAAC,GAAG,CAAC,IAAI,CAAC;QAAE,OAAO,gDAAqB,CAAC,QAAQ,CAAC;IACzF,IAAI,2CAAmC,CAAC,GAAG,CAAC,IAAI,CAAC;QAAE,OAAO,gDAAqB,CAAC,YAAY,CAAC;IAC7F,IAAI,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,mBAAmB,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;QACtF,OAAO,gDAAqB,CAAC,QAAQ,CAAC;IAC1C,CAAC;IACD,IACI,gBAAgB,CAAC,GAAG,CAAC,SAAS,CAAC;QAC/B,CAAC,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,IAAI,IAAI,KAAK,0BAA0B,CAAC,EACnE,CAAC;QACC,OAAO,gDAAqB,CAAC,KAAK,CAAC;IACvC,CAAC;IACD,OAAO,gDAAqB,CAAC,IAAI,CAAC;AACtC,CAAC"}

package/build/v1/client-file/commands/user-file-delete.command.d.ts

@@ -1,5 +1,11 @@
 import { z } from 'zod';
 import { HttpMethod } from '../../../shared/http-method.enum';
+/**
+ * `DELETE /file-api/v1/client/files/:fileId`
+ *
+ * Soft-delete the user's file regardless of which chat it belongs to.
+ * Verifies ownership server-side; foreign rows return FORBIDDEN.
+ */
 export declare namespace UserFileDeleteCommand {
     const Params: z.ZodObject<{
         fileId: z.ZodString;

package/build/v1/client-file/commands/user-file-delete.command.js

@@ -4,6 +4,12 @@ exports.UserFileDeleteCommand = void 0;
 const schemas_1 = require("../schemas");
 const rest_api_1 = require("../../../rest-api");
 const http_method_enum_1 = require("../../../shared/http-method.enum");
+/**
+ * `DELETE /file-api/v1/client/files/:fileId`
+ *
+ * Soft-delete the user's file regardless of which chat it belongs to.
+ * Verifies ownership server-side; foreign rows return FORBIDDEN.
+ */
 var UserFileDeleteCommand;
 (function (UserFileDeleteCommand) {
     UserFileDeleteCommand.Params = schemas_1.ClientFileIdParamSchema;

package/build/v1/client-file/commands/user-file-delete.command.js.map

@@ -1 +1 @@
-{"version":3,"file":"user-file-delete.command.js","sourceRoot":"","sources":["../../../../v1/client-file/commands/user-file-delete.command.ts"],"names":[],"mappings":";;;AACA,wCAAqF;AACrF,gDAA6C;AAC7C,uEAA8D;AAQ9D,IAAiB,qBAAqB,CAQrC;AARD,WAAiB,qBAAqB;IACrB,4BAAM,GAAG,iCAAuB,CAAC;IACjC,8BAAQ,GAAG,wCAA8B,CAAC;IAC1C,yBAAG,GAAG,CAAC,MAAc,EAAE,EAAE,CAAC,mBAAQ,CAAC,EAAE,CAAC,UAAU,CAAC,GAAG,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;IACpE,4BAAM,GAAG,6BAAU,CAAC,MAAM,CAAC;AAI5C,CAAC,EARgB,qBAAqB,qCAArB,qBAAqB,QAQrC"}
+{"version":3,"file":"user-file-delete.command.js","sourceRoot":"","sources":["../../../../v1/client-file/commands/user-file-delete.command.ts"],"names":[],"mappings":";;;AACA,wCAAqF;AACrF,gDAA6C;AAC7C,uEAA8D;AAE9D;;;;;GAKG;AACH,IAAiB,qBAAqB,CAQrC;AARD,WAAiB,qBAAqB;IACrB,4BAAM,GAAG,iCAAuB,CAAC;IACjC,8BAAQ,GAAG,wCAA8B,CAAC;IAC1C,yBAAG,GAAG,CAAC,MAAc,EAAE,EAAE,CAAC,mBAAQ,CAAC,EAAE,CAAC,UAAU,CAAC,GAAG,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;IACpE,4BAAM,GAAG,6BAAU,CAAC,MAAM,CAAC;AAI5C,CAAC,EARgB,qBAAqB,qCAArB,qBAAqB,QAQrC"}

package/build/v1/client-file/file-processing.constants.d.ts

@@ -1,12 +1,49 @@
+/**
+ * Cross-app constants for client-file processing. Single source of truth
+ * shared by:
+ *   - `apps/file`  — upload-time classification, preview generation, text
+ *                    extraction (`client-file.constants.ts` re-exports these).
+ *   - `apps/api`   — prompt-assembly decisions at message-build time
+ *                    (`attachments.constants.ts` re-exports these).
+ *
+ * Duplicating these values across the two apps was the drift risk flagged in
+ * the arch-03 review. Hosting them here in `@veruna/api-contracts` means a
+ * change is a single edit + contracts rebuild.
+ */
+/** Page count above which a PDF is considered "large" → preview-only path. */
 export declare const PDF_LARGE_PAGE_THRESHOLD = 5;
+/**
+ * Byte size above which a PDF is considered "large" even if page count is
+ * low (e.g. a 4-page PDF with huge embedded images still blows the token
+ * budget). Either threshold triggers the preview-only path.
+ */
 export declare const PDF_LARGE_SIZE_THRESHOLD_BYTES: number;
+/** Number of pages to include in the short preview PDF for large docs. */
 export declare const PDF_PREVIEW_PAGES = 3;
+/** Approximate bytes per LLM token — conservative estimate for budgeting. */
 export declare const BYTES_PER_TOKEN_ESTIMATE = 3.2;
+/** Max bytes of a text-native file that may be fetched from S3 for inline. */
 export declare const TEXT_NATIVE_MAX_INLINE_BYTES = 1024000;
+/** Max tokens for the FULL inline of a small text-native file. */
 export declare const TEXT_NATIVE_INLINE_TOKEN_LIMIT = 5000;
+/** Max tokens for the `textPreview` of a large text-native file. */
 export declare const TEXT_NATIVE_PREVIEW_TOKEN_LIMIT = 2000;
+/** Max rows included in a CSV preview (header + data rows). */
 export declare const CSV_PREVIEW_MAX_ROWS = 100;
+/** Max items shown in a JSON array preview. */
 export declare const JSON_PREVIEW_MAX_ITEMS = 3;
+/**
+ * Hard timeout on the api-side S3 fetch when inlining a small text-native
+ * file's contents into the LLM context. Prevents a slow or malicious origin
+ * from stalling request-scoped prompt assembly.
+ */
 export declare const TEXT_NATIVE_INLINE_FETCH_TIMEOUT_MS = 10000;
+/** All incoming guest uploads, including images. Generated artifacts keep their technical caps. */
 export declare const GUEST_DOCUMENT_MAX_SIZE_BYTES: number;
+/**
+ * Minimum across all plans (the free plan), in the same MiB units as CLIENT_FILE_*_MAX_SIZE_MB.
+ * At or below this threshold the answer cannot depend on the plan, so file-api
+ * does not need an entitlement request. Keep all plan limits at least this high.
+ * The service's absolute technical ceiling still applies independently.
+ */
 export declare const BASE_FILE_MAX_SIZE_BYTES: number;

package/build/v1/client-file/file-processing.constants.js

@@ -1,16 +1,59 @@
 "use strict";
+/**
+ * Cross-app constants for client-file processing. Single source of truth
+ * shared by:
+ *   - `apps/file`  — upload-time classification, preview generation, text
+ *                    extraction (`client-file.constants.ts` re-exports these).
+ *   - `apps/api`   — prompt-assembly decisions at message-build time
+ *                    (`attachments.constants.ts` re-exports these).
+ *
+ * Duplicating these values across the two apps was the drift risk flagged in
+ * the arch-03 review. Hosting them here in `@veruna/api-contracts` means a
+ * change is a single edit + contracts rebuild.
+ */
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.BASE_FILE_MAX_SIZE_BYTES = exports.GUEST_DOCUMENT_MAX_SIZE_BYTES = exports.TEXT_NATIVE_INLINE_FETCH_TIMEOUT_MS = exports.JSON_PREVIEW_MAX_ITEMS = exports.CSV_PREVIEW_MAX_ROWS = exports.TEXT_NATIVE_PREVIEW_TOKEN_LIMIT = exports.TEXT_NATIVE_INLINE_TOKEN_LIMIT = exports.TEXT_NATIVE_MAX_INLINE_BYTES = exports.BYTES_PER_TOKEN_ESTIMATE = exports.PDF_PREVIEW_PAGES = exports.PDF_LARGE_SIZE_THRESHOLD_BYTES = exports.PDF_LARGE_PAGE_THRESHOLD = void 0;
+// -----------------------------------------------------------------------------
+// PDF / visual-doc preview thresholds
+// -----------------------------------------------------------------------------
+/** Page count above which a PDF is considered "large" → preview-only path. */
 exports.PDF_LARGE_PAGE_THRESHOLD = 5;
-exports.PDF_LARGE_SIZE_THRESHOLD_BYTES = 500 * 1024;
+/**
+ * Byte size above which a PDF is considered "large" even if page count is
+ * low (e.g. a 4-page PDF with huge embedded images still blows the token
+ * budget). Either threshold triggers the preview-only path.
+ */
+exports.PDF_LARGE_SIZE_THRESHOLD_BYTES = 500 * 1024; // 500 KB
+/** Number of pages to include in the short preview PDF for large docs. */
 exports.PDF_PREVIEW_PAGES = 3;
+// -----------------------------------------------------------------------------
+// Text-native inline / preview budgets
+// -----------------------------------------------------------------------------
+/** Approximate bytes per LLM token — conservative estimate for budgeting. */
 exports.BYTES_PER_TOKEN_ESTIMATE = 3.2;
-exports.TEXT_NATIVE_MAX_INLINE_BYTES = 1_024_000;
+/** Max bytes of a text-native file that may be fetched from S3 for inline. */
+exports.TEXT_NATIVE_MAX_INLINE_BYTES = 1_024_000; // ~1 MB
+/** Max tokens for the FULL inline of a small text-native file. */
 exports.TEXT_NATIVE_INLINE_TOKEN_LIMIT = 5_000;
+/** Max tokens for the `textPreview` of a large text-native file. */
 exports.TEXT_NATIVE_PREVIEW_TOKEN_LIMIT = 2_000;
+/** Max rows included in a CSV preview (header + data rows). */
 exports.CSV_PREVIEW_MAX_ROWS = 100;
+/** Max items shown in a JSON array preview. */
 exports.JSON_PREVIEW_MAX_ITEMS = 3;
+/**
+ * Hard timeout on the api-side S3 fetch when inlining a small text-native
+ * file's contents into the LLM context. Prevents a slow or malicious origin
+ * from stalling request-scoped prompt assembly.
+ */
 exports.TEXT_NATIVE_INLINE_FETCH_TIMEOUT_MS = 10_000;
+/** All incoming guest uploads, including images. Generated artifacts keep their technical caps. */
 exports.GUEST_DOCUMENT_MAX_SIZE_BYTES = 10 * 1024 * 1024;
+/**
+ * Minimum across all plans (the free plan), in the same MiB units as CLIENT_FILE_*_MAX_SIZE_MB.
+ * At or below this threshold the answer cannot depend on the plan, so file-api
+ * does not need an entitlement request. Keep all plan limits at least this high.
+ * The service's absolute technical ceiling still applies independently.
+ */
 exports.BASE_FILE_MAX_SIZE_BYTES = 100 * 1024 * 1024;
 //# sourceMappingURL=file-processing.constants.js.map

package/build/v1/client-file/file-processing.constants.js.map

@@ -1 +1 @@
-{"version":3,"file":"file-processing.constants.js","sourceRoot":"","sources":["../../../v1/client-file/file-processing.constants.ts"],"names":[],"mappings":";;;AAkBa,QAAA,wBAAwB,GAAG,CAAC,CAAC;AAO7B,QAAA,8BAA8B,GAAG,GAAG,GAAG,IAAI,CAAC;AAG5C,QAAA,iBAAiB,GAAG,CAAC,CAAC;AAOtB,QAAA,wBAAwB,GAAG,GAAG,CAAC;AAG/B,QAAA,4BAA4B,GAAG,SAAS,CAAC;AAGzC,QAAA,8BAA8B,GAAG,KAAK,CAAC;AAGvC,QAAA,+BAA+B,GAAG,KAAK,CAAC;AAGxC,QAAA,oBAAoB,GAAG,GAAG,CAAC;AAG3B,QAAA,sBAAsB,GAAG,CAAC,CAAC;AAO3B,QAAA,mCAAmC,GAAG,MAAM,CAAC;AAG7C,QAAA,6BAA6B,GAAG,EAAE,GAAG,IAAI,GAAG,IAAI,CAAC;AAQjD,QAAA,wBAAwB,GAAG,GAAG,GAAG,IAAI,GAAG,IAAI,CAAC"}
+{"version":3,"file":"file-processing.constants.js","sourceRoot":"","sources":["../../../v1/client-file/file-processing.constants.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;GAWG;;;AAEH,gFAAgF;AAChF,sCAAsC;AACtC,gFAAgF;AAEhF,8EAA8E;AACjE,QAAA,wBAAwB,GAAG,CAAC,CAAC;AAE1C;;;;GAIG;AACU,QAAA,8BAA8B,GAAG,GAAG,GAAG,IAAI,CAAC,CAAC,SAAS;AAEnE,0EAA0E;AAC7D,QAAA,iBAAiB,GAAG,CAAC,CAAC;AAEnC,gFAAgF;AAChF,uCAAuC;AACvC,gFAAgF;AAEhF,6EAA6E;AAChE,QAAA,wBAAwB,GAAG,GAAG,CAAC;AAE5C,8EAA8E;AACjE,QAAA,4BAA4B,GAAG,SAAS,CAAC,CAAC,QAAQ;AAE/D,kEAAkE;AACrD,QAAA,8BAA8B,GAAG,KAAK,CAAC;AAEpD,oEAAoE;AACvD,QAAA,+BAA+B,GAAG,KAAK,CAAC;AAErD,+DAA+D;AAClD,QAAA,oBAAoB,GAAG,GAAG,CAAC;AAExC,+CAA+C;AAClC,QAAA,sBAAsB,GAAG,CAAC,CAAC;AAExC;;;;GAIG;AACU,QAAA,mCAAmC,GAAG,MAAM,CAAC;AAE1D,mGAAmG;AACtF,QAAA,6BAA6B,GAAG,EAAE,GAAG,IAAI,GAAG,IAAI,CAAC;AAE9D;;;;;GAKG;AACU,QAAA,wBAAwB,GAAG,GAAG,GAAG,IAAI,GAAG,IAAI,CAAC"}

package/build/v1/client-file/index.d.ts

@@ -5,3 +5,4 @@ export * from './file-processing.constants';
 export * from './upload-magic-bytes';
 export * from './attachment-coverage';
 export * from './attachment-coverage.types';
+export * from './client-file-content-kind';

package/build/v1/client-file/index.js

@@ -21,4 +21,5 @@ __exportStar(require("./file-processing.constants"), exports);
 __exportStar(require("./upload-magic-bytes"), exports);
 __exportStar(require("./attachment-coverage"), exports);
 __exportStar(require("./attachment-coverage.types"), exports);
+__exportStar(require("./client-file-content-kind"), exports);
 //# sourceMappingURL=index.js.map

package/build/v1/client-file/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../v1/client-file/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,4CAA0B;AAC1B,6CAA2B;AAC3B,4CAA0B;AAC1B,8DAA4C;AAC5C,uDAAqC;AACrC,wDAAsC;AACtC,8DAA4C"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../v1/client-file/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,4CAA0B;AAC1B,6CAA2B;AAC3B,4CAA0B;AAC1B,8DAA4C;AAC5C,uDAAqC;AACrC,wDAAsC;AACtC,8DAA4C;AAC5C,6DAA2C"}

package/build/v1/client-file/queries/client-file-reading.s2s.d.ts

@@ -0,0 +1,183 @@
+import { z } from 'zod';
+import { HttpMethod } from '../../../shared/http-method.enum';
+/** S2S (api → file-service): the reading outline of one client file — kind, pages with status/hint, sheets. */
+export declare namespace ClientFileOutlineS2SQuery {
+    const Params: z.ZodObject<{
+        fileId: z.ZodUUID;
+    }, z.core.$strip>;
+    const Response: z.ZodObject<{
+        fileId: z.ZodUUID;
+        kind: z.ZodEnum<typeof import("../schemas/client-file-pages.schema").ClientFileContentKind>;
+        pageCount: z.ZodNullable<z.ZodNumber>;
+        lineCount: z.ZodNullable<z.ZodNumber>;
+        pages: z.ZodArray<z.ZodObject<{
+            page: z.ZodNumber;
+            status: z.ZodEnum<typeof import("../schemas/client-file-pages.schema").ClientFilePageStatus>;
+            source: z.ZodNullable<z.ZodEnum<typeof import("../schemas/client-file-pages.schema").ClientFilePageSource>>;
+            chars: z.ZodNumber;
+            hint: z.ZodString;
+            hasFigures: z.ZodBoolean;
+        }, z.core.$strip>>;
+        sheets: z.ZodArray<z.ZodObject<{
+            index: z.ZodNumber;
+            name: z.ZodString;
+            rows: z.ZodNumber;
+            columns: z.ZodNumber;
+            header: z.ZodArray<z.ZodString>;
+        }, z.core.$strip>>;
+        extractedAt: z.ZodNullable<z.ZodISODateTime>;
+        extraction: z.ZodEnum<typeof import("../schemas/client-file-pages.schema").ClientFileExtractionState>;
+    }, z.core.$strip>;
+    const URL: (fileId: string) => string;
+    const METHOD = HttpMethod.GET;
+    type ParamsType = z.infer<typeof Params>;
+    type ResponseType = z.infer<typeof Response>;
+}
+/** S2S: stored text of up to CLIENT_FILE_MAX_PAGES_PER_READ pages (`?from=&to=`); NEEDS_OCR pages have text null. */
+export declare namespace ClientFilePagesS2SQuery {
+    const Params: z.ZodObject<{
+        fileId: z.ZodUUID;
+    }, z.core.$strip>;
+    const Query: z.ZodObject<{
+        from: z.ZodCoercedNumber<unknown>;
+        to: z.ZodCoercedNumber<unknown>;
+    }, z.core.$strip>;
+    const Response: z.ZodObject<{
+        extractedAt: z.ZodOptional<z.ZodNullable<z.ZodISODateTime>>;
+        fileId: z.ZodUUID;
+        pages: z.ZodArray<z.ZodObject<{
+            page: z.ZodNumber;
+            status: z.ZodEnum<typeof import("../schemas/client-file-pages.schema").ClientFilePageStatus>;
+            source: z.ZodNullable<z.ZodEnum<typeof import("../schemas/client-file-pages.schema").ClientFilePageSource>>;
+            chars: z.ZodNumber;
+            hint: z.ZodString;
+            hasFigures: z.ZodBoolean;
+            text: z.ZodNullable<z.ZodString>;
+        }, z.core.$strip>>;
+    }, z.core.$strip>;
+    const URL: (fileId: string) => string;
+    const METHOD = HttpMethod.GET;
+    type ParamsType = z.infer<typeof Params>;
+    type QueryType = z.infer<typeof Query>;
+    type ResponseType = z.infer<typeof Response>;
+}
+/** S2S: store OCR text the API recognised; a page that already has text keeps it (first write wins). */
+export declare namespace ClientFileOcrPagesS2SCommand {
+    const Params: z.ZodObject<{
+        fileId: z.ZodUUID;
+    }, z.core.$strip>;
+    const Request: z.ZodObject<{
+        pages: z.ZodArray<z.ZodObject<{
+            page: z.ZodNumber;
+            text: z.ZodPipe<z.ZodString, z.ZodTransform<string, string>>;
+            failed: z.ZodOptional<z.ZodBoolean>;
+        }, z.core.$strip>>;
+    }, z.core.$strip>;
+    const Response: z.ZodObject<{
+        stored: z.ZodNumber;
+    }, z.core.$strip>;
+    const URL: (fileId: string) => string;
+    const METHOD = HttpMethod.PUT;
+    type ParamsType = z.infer<typeof Params>;
+    type RequestType = z.infer<typeof Request>;
+    type ResponseType = z.infer<typeof Response>;
+}
+/** S2S: a one-page PDF of the page (for OCR), cut once and kept in storage. */
+export declare namespace ClientFilePagePdfS2SQuery {
+    const Params: z.ZodObject<{
+        fileId: z.ZodUUID;
+        page: z.ZodCoercedNumber<unknown>;
+    }, z.core.$strip>;
+    const Response: z.ZodObject<{
+        page: z.ZodNumber;
+        url: z.ZodURL;
+        contentType: z.ZodEnum<{
+            "image/jpeg": "image/jpeg";
+            "application/pdf": "application/pdf";
+        }>;
+    }, z.core.$strip>;
+    const URL: (fileId: string, page: number) => string;
+    const METHOD = HttpMethod.GET;
+    type ParamsType = z.infer<typeof Params>;
+    type ResponseType = z.infer<typeof Response>;
+}
+/** S2S: the page rendered as a JPEG (for "look at the page"), rendered once and kept in storage. */
+export declare namespace ClientFilePageImageS2SQuery {
+    const Params: z.ZodObject<{
+        fileId: z.ZodUUID;
+        page: z.ZodCoercedNumber<unknown>;
+    }, z.core.$strip>;
+    const Response: z.ZodObject<{
+        page: z.ZodNumber;
+        url: z.ZodURL;
+        contentType: z.ZodEnum<{
+            "image/jpeg": "image/jpeg";
+            "application/pdf": "application/pdf";
+        }>;
+    }, z.core.$strip>;
+    const URL: (fileId: string, page: number) => string;
+    const METHOD = HttpMethod.GET;
+    type ParamsType = z.infer<typeof Params>;
+    type ResponseType = z.infer<typeof Response>;
+}
+/** S2S: up to CLIENT_FILE_MAX_ROWS_PER_READ data rows of one sheet (`?from=&to=`, 1-based data rows). */
+export declare namespace ClientFileSheetRowsS2SQuery {
+    const Params: z.ZodObject<{
+        fileId: z.ZodUUID;
+        sheet: z.ZodCoercedNumber<unknown>;
+    }, z.core.$strip>;
+    const Query: z.ZodObject<{
+        from: z.ZodCoercedNumber<unknown>;
+        to: z.ZodCoercedNumber<unknown>;
+    }, z.core.$strip>;
+    const Response: z.ZodObject<{
+        extractedAt: z.ZodOptional<z.ZodNullable<z.ZodISODateTime>>;
+        fileId: z.ZodUUID;
+        sheet: z.ZodNumber;
+        name: z.ZodString;
+        header: z.ZodArray<z.ZodString>;
+        rows: z.ZodArray<z.ZodArray<z.ZodString>>;
+        totalRows: z.ZodNumber;
+    }, z.core.$strip>;
+    const URL: (fileId: string, sheet: number) => string;
+    const METHOD = HttpMethod.GET;
+    type ParamsType = z.infer<typeof Params>;
+    type QueryType = z.infer<typeof Query>;
+    type ResponseType = z.infer<typeof Response>;
+}
+/** S2S: up to CLIENT_FILE_MAX_LINES_PER_READ lines of a text file (`?from=&to=`, 1-based). */
+export declare namespace ClientFileTextLinesS2SQuery {
+    const Params: z.ZodObject<{
+        fileId: z.ZodUUID;
+    }, z.core.$strip>;
+    const Query: z.ZodObject<{
+        from: z.ZodCoercedNumber<unknown>;
+        to: z.ZodCoercedNumber<unknown>;
+    }, z.core.$strip>;
+    const Response: z.ZodObject<{
+        extractedAt: z.ZodOptional<z.ZodNullable<z.ZodISODateTime>>;
+        fileId: z.ZodUUID;
+        from: z.ZodNumber;
+        lines: z.ZodArray<z.ZodString>;
+        totalLines: z.ZodNumber;
+    }, z.core.$strip>;
+    const URL: (fileId: string) => string;
+    const METHOD = HttpMethod.GET;
+    type ParamsType = z.infer<typeof Params>;
+    type QueryType = z.infer<typeof Query>;
+    type ResponseType = z.infer<typeof Response>;
+}
+/** S2S: resolve a legacy attachment's storage key within its authorized chat. */
+export declare namespace ClientFileResolveKeyS2SQuery {
+    const Query: z.ZodObject<{
+        chatId: z.ZodUUID;
+        key: z.ZodString;
+    }, z.core.$strip>;
+    const Response: z.ZodObject<{
+        fileId: z.ZodNullable<z.ZodUUID>;
+    }, z.core.$strip>;
+    const URL: "/file-api/s2s/files/client-file/resolve-key";
+    const METHOD = HttpMethod.GET;
+    type QueryType = z.infer<typeof Query>;
+    type ResponseType = z.infer<typeof Response>;
+}