@lotics/cli 0.281.0 → 0.282.0

package/dist/src/cli.js

@@ -21977,6 +21977,186 @@ function fixtureWriteOrder(entities) {
   return { cycle: entities.filter((entity) => !placed.has(entity.alias)).map((entity) => entity.alias) };
 }
 
+// ../shared/src/schemas/files.ts
+var processedFileSchema = zod_default.object({
+  id: zod_default.string().describe("Unique identifier for the processed file"),
+  filename: zod_default.string().describe("Original filename of the uploaded file"),
+  mime_type: zod_default.string().describe("MIME type of the file (e.g., 'image/png', 'application/pdf')"),
+  // Stable proxy URL (`/v1/files/<file_storage_key>`), resolved at serving time
+  // — never stored in the DB.
+  url: zod_default.string().optional().describe("Stable file serving URL, resolved at serving time"),
+  thumbnail_url: zod_default.string().optional().describe("Thumbnail URL for image files, resolved at serving time"),
+  preview_url: zod_default.string().optional().describe("Preview URL for legacy Excel files, resolved at serving time"),
+  provider: zod_default.string().describe("Storage provider name (e.g., 'aws', 'gcs')"),
+  file_storage_key: zod_default.string().describe("Storage key/path where the file is stored"),
+  workspace_id: zod_default.string().describe("ID of the workspace this file belongs to"),
+  size: zod_default.number().nullish().describe("Byte size of the stored object (null until backfilled)"),
+  created_at: zod_default.string().describe("Timestamp when file was uploaded"),
+  metadata: zod_default.unknown().describe("Additional metadata about the file"),
+  data: zod_default.unknown().describe("File-type-specific data (e.g., {width, height, orientation} for images)")
+});
+var fileUploadErrorSchema = zod_default.object({
+  filename: zod_default.string().describe("Original filename that failed to upload"),
+  error: zod_default.string().describe("Error message describing the failure reason")
+});
+var fileUploadResponseSchema = zod_default.object({
+  files: zod_default.array(processedFileSchema).describe("Successfully uploaded files"),
+  errors: zod_default.array(fileUploadErrorSchema).describe("Files that failed to upload with error details")
+});
+var fileFieldValueSchema = zod_default.object({
+  id: zod_default.string().describe("Unique identifier for the file"),
+  /**
+   * Present on a STORED cell and on its way off responses.
+   *
+   * Optional here because this schema types both, and a response is the half
+   * that loses it — no client reads it, and one that required it would reject
+   * the first response without it. Nothing weakens at write time: a file cell
+   * is written from file IDS and `resolveFileFieldIds` mints this from the
+   * `files` row, so a caller never supplies it and a stored cell always has it.
+   * Code that derives a serving URL guards for it (`file_url_resolver.ts`).
+   */
+  file_storage_key: zod_default.string().optional().describe("Storage key for the file"),
+  filename: zod_default.string().describe("Original filename"),
+  mime_type: zod_default.string().describe("MIME type of the file"),
+  url: zod_default.string().optional().describe("Public URL for the file, resolved at serving time"),
+  thumbnail_url: zod_default.string().optional().describe("Thumbnail URL for image files, resolved at serving time"),
+  preview_url: zod_default.string().optional().describe("Preview URL for legacy Excel files, resolved at serving time"),
+  // Immutable file-object metadata, resolved at serving time from the `files`
+  // row (never stored on the denormalized cell) — like `url`. `size` may be
+  // absent for older files not yet backfilled.
+  size: zod_default.number().nullish().describe("Byte size, resolved at serving time from the file object (null/absent until backfilled)"),
+  created_at: zod_default.string().optional().describe("Upload timestamp, resolved at serving time from the file object"),
+  document_template_id: zod_default.string().optional().describe("The document template the file was generated from, resolved at serving time from the file object; absent on a file a person brought")
+});
+var servedFileSchema = zod_default.object({
+  id: zod_default.string(),
+  filename: zod_default.string(),
+  mime_type: zod_default.string(),
+  url: zod_default.string().optional().describe("Serving URL, signed for 24 hours."),
+  thumbnail_url: zod_default.string().optional().describe("Signed thumbnail, for an image."),
+  preview_url: zod_default.string().optional(),
+  size: zod_default.number().nullish().describe("Bytes, where the object records it."),
+  created_at: zod_default.string().optional().describe("When the file was uploaded."),
+  document_template_id: zod_default.string().optional().describe("The document template the file was generated from.")
+});
+var SERVED_FILE_KEYS = servedFileSchema.keyof().options;
+var MAX_UPLOAD_FILE_SIZE = 2 * 1024 * 1024 * 1024;
+var PROFILE_IMAGE_MAX_SIZE = 10 * 1024 * 1024;
+var UPLOAD_TICKET_TTL_SECONDS = 5 * 60;
+var MAX_TICKET_UPLOAD_BYTES = 20 * 1024 * 1024;
+var uploadTicketRequestSchema = zod_default.object({
+  filename: zod_default.string().min(1),
+  mime_type: zod_default.string().optional(),
+  /** Declared up front so an oversize file is refused before its bytes move,
+   *  rather than after the transfer is already spent. Optional because a caller
+   *  streaming from a pipe may genuinely not know; the PUT enforces the cap
+   *  either way. */
+  size_bytes: zod_default.number().int().positive().optional()
+});
+var uploadTicketResponseSchema = zod_default.object({
+  upload_url: zod_default.string(),
+  ticket_id: zod_default.string(),
+  method: zod_default.literal("PUT"),
+  expires_at: zod_default.string(),
+  max_bytes: zod_default.number(),
+  required_headers: zod_default.record(zod_default.string(), zod_default.string())
+});
+var uploadTicketResultSchema = zod_default.object({
+  file_id: zod_default.string(),
+  file_name: zod_default.string(),
+  mime_type: zod_default.string(),
+  size_bytes: zod_default.number(),
+  sha256: zod_default.string(),
+  /** True when these bytes were already in the workspace and no second copy was
+   *  stored. Stated rather than left to inference, because the caller then gets
+   *  back a `file_name` it did not send — the stored file's, not the one it
+   *  uploaded under — and a silent difference reads as a bug. */
+  deduplicated: zod_default.boolean()
+});
+var fileSizeSchema = zod_default.number().int().positive().max(MAX_UPLOAD_FILE_SIZE);
+var directUploadInitRequestSchema = zod_default.object({
+  file_id: zod_default.string().optional(),
+  filename: zod_default.string(),
+  mime_type: zod_default.string(),
+  file_size: fileSizeSchema
+});
+var directUploadInitResponseSchema = zod_default.object({
+  file_id: zod_default.string(),
+  file_storage_key: zod_default.string(),
+  upload_url: zod_default.string()
+});
+var directUploadCompleteRequestSchema = zod_default.object({
+  file_id: zod_default.string(),
+  file_storage_key: zod_default.string(),
+  filename: zod_default.string(),
+  mime_type: zod_default.string(),
+  original_file_id: zod_default.string().optional().describe(
+    "When set, this upload becomes a new version of the original file. The server resolves the current latest, links the new row via source_file_id, and bumps the original's latest_version_id pointer."
+  )
+});
+var multipartInitRequestSchema = zod_default.object({
+  file_id: zod_default.string().optional(),
+  filename: zod_default.string(),
+  mime_type: zod_default.string(),
+  file_size: fileSizeSchema,
+  network_effective_type: zod_default.enum(["slow-2g", "2g", "3g", "4g"]).optional(),
+  network_rtt_ms: zod_default.number().nonnegative().optional()
+});
+var multipartInitResponseSchema = zod_default.object({
+  file_id: zod_default.string(),
+  upload_id: zod_default.string(),
+  file_storage_key: zod_default.string(),
+  part_size: zod_default.number(),
+  parts: zod_default.array(
+    zod_default.object({
+      part_number: zod_default.number(),
+      url: zod_default.string()
+    })
+  )
+});
+var multipartCompleteRequestSchema = zod_default.object({
+  file_id: zod_default.string(),
+  upload_id: zod_default.string(),
+  file_storage_key: zod_default.string(),
+  filename: zod_default.string(),
+  mime_type: zod_default.string(),
+  parts: zod_default.array(
+    zod_default.object({
+      part_number: zod_default.number(),
+      etag: zod_default.string()
+    })
+  ),
+  original_file_id: zod_default.string().optional().describe(
+    "When set, this upload becomes a new version of the original file. The server resolves the current latest, links the new row via source_file_id, and bumps the original's latest_version_id pointer."
+  )
+});
+var multipartAbortRequestSchema = zod_default.object({
+  upload_id: zod_default.string(),
+  file_storage_key: zod_default.string()
+});
+var fileVersionEntrySchema = zod_default.object({
+  id: zod_default.string(),
+  filename: zod_default.string(),
+  /**
+   * Resolved by the server, because deriving it needs the storage key and a
+   * caller that derives is a caller that must be handed one. Every other file
+   * shape already resolves its URL at serving time; this one did not, which is
+   * the whole reason the key still travels here.
+   */
+  url: zod_default.string(),
+  /** @deprecated Unread by any client — resolve bytes through `url` or `id`. */
+  file_storage_key: zod_default.string(),
+  mime_type: zod_default.string(),
+  created_at: zod_default.string(),
+  is_current: zod_default.boolean(),
+  source_file_id: zod_default.string().nullable()
+});
+var fileVersionListResponseSchema = zod_default.object({
+  original_file_id: zod_default.string(),
+  current_version_id: zod_default.string(),
+  versions: zod_default.array(fileVersionEntrySchema).describe("Ordered newest \u2192 oldest. Index 0 is the current version.")
+});
+
 // ../../node_modules/date-fns/constants.js
 var daysInYear = 365.2425;
 var maxTime = Math.pow(10, 8) * 24 * 60 * 60 * 1e3;
@@ -40264,8 +40444,8 @@ function resultSideEffects(result) {
 }
 
 // src/version.ts
-var VERSION = "0.281.0";
-var APP_SDK_VERSION = "0.108.0";
+var VERSION = "0.282.0";
+var APP_SDK_VERSION = "0.109.0";
 
 // src/timezone.ts
 function machineTimezone() {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lotics/cli",
-  "version": "0.281.0",
+  "version": "0.282.0",
   "description": "Lotics SDK and CLI for AI agents",
   "type": "module",
   "bin": {