sim 2.1.21 → 2.1.22-preview.142.1

package/dist/index.js

@@ -10645,6 +10645,17 @@ var V2_OPERATIONS = {
       }
     }
   },
+  deleteFileVersion: {
+    method: "DELETE",
+    path: "/api/v2/files/[fileId]/versions/[version]",
+    pathParams: ["fileId", "version"],
+    pathParamDocs: { fileId: "File identifier.", version: "Version number." },
+    responseMode: "json",
+    summary: "Delete File Version",
+    query: {
+      workspaceId: { kind: "string", required: true, describe: "Workspace that owns the file." }
+    }
+  },
   deleteKnowledgeBase: {
     method: "DELETE",
     path: "/api/v2/knowledge/[knowledgeBaseId]",
@@ -11068,6 +11079,17 @@ var V2_OPERATIONS = {
       workspaceId: { kind: "string", required: true, describe: "Workspace that owns the file." }
     }
   },
+  downloadFileVersion: {
+    method: "GET",
+    path: "/api/v2/files/[fileId]/versions/[version]/content",
+    pathParams: ["fileId", "version"],
+    pathParamDocs: { fileId: "File identifier.", version: "Version number." },
+    responseMode: "binary",
+    summary: "Download File Version",
+    query: {
+      workspaceId: { kind: "string", required: true, describe: "Workspace that owns the file." }
+    }
+  },
   downloadRunFile: {
     method: "GET",
     path: "/api/v2/workflows/[workflowId]/runs/[runId]/files/[fileId]",
@@ -11378,6 +11400,17 @@ var V2_OPERATIONS = {
       }
     }
   },
+  getFileVersion: {
+    method: "GET",
+    path: "/api/v2/files/[fileId]/versions/[version]",
+    pathParams: ["fileId", "version"],
+    pathParamDocs: { fileId: "File identifier.", version: "Version number." },
+    responseMode: "json",
+    summary: "Get File Version",
+    query: {
+      workspaceId: { kind: "string", required: true, describe: "Workspace that owns the file." }
+    }
+  },
   getKnowledgeBase: {
     method: "GET",
     path: "/api/v2/knowledge/[knowledgeBaseId]",
@@ -12489,6 +12522,38 @@ var V2_OPERATIONS = {
       }
     }
   },
+  listFileVersions: {
+    method: "GET",
+    path: "/api/v2/files/[fileId]/versions",
+    pathParams: ["fileId"],
+    pathParamDocs: { fileId: "File identifier." },
+    responseMode: "json",
+    summary: "List File Versions",
+    query: {
+      workspaceId: { kind: "string", required: true, describe: "Workspace that owns the file." },
+      sortBy: {
+        kind: "enum",
+        values: ["version"],
+        default: "version",
+        describe: "Field used to sort the result."
+      },
+      sortOrder: {
+        kind: "enum",
+        values: ["asc", "desc"],
+        default: "desc",
+        describe: "Sort direction."
+      },
+      limit: {
+        kind: "integer",
+        default: 50,
+        describe: "Maximum versions to return per page. Must be a whole number from 1 to 100. Defaults to 50."
+      },
+      cursor: {
+        kind: "string",
+        describe: "Opaque cursor from the previous page. Send it back with the same sort and filters; only `limit` may change. Change anything else and pagination must restart without a cursor."
+      }
+    }
+  },
   listKnowledgeBases: {
     method: "GET",
     path: "/api/v2/knowledge",
@@ -14108,6 +14173,29 @@ var V2_OPERATIONS = {
       }
     }
   },
+  readFileVersionText: {
+    method: "GET",
+    path: "/api/v2/files/[fileId]/versions/[version]/text",
+    pathParams: ["fileId", "version"],
+    pathParamDocs: { fileId: "File identifier.", version: "Version number." },
+    responseMode: "json",
+    summary: "Read File Version Text",
+    query: {
+      workspaceId: { kind: "string", required: true, describe: "Workspace that owns the file." },
+      maxBytes: {
+        kind: "integer",
+        describe: "Optional ceiling on the source bytes fed to the parser, lowering but never raising the server limit."
+      },
+      offset: {
+        kind: "integer",
+        describe: "First line to return, 1-based. Absent starts at the first line."
+      },
+      limit: {
+        kind: "integer",
+        describe: "How many lines to return from `offset`. Absent reads to the end."
+      }
+    }
+  },
   relocateFileFolder: {
     method: "PATCH",
     path: "/api/v2/files/folders",
@@ -14374,6 +14462,21 @@ var V2_OPERATIONS = {
       input: { kind: "unknown", describe: "Input supplied to the paused workflow block." }
     }
   },
+  revertFileVersion: {
+    method: "POST",
+    path: "/api/v2/files/[fileId]/versions/[version]/revert",
+    pathParams: ["fileId", "version"],
+    pathParamDocs: { fileId: "File identifier.", version: "Version number." },
+    responseMode: "json",
+    summary: "Revert File Version",
+    body: {
+      workspaceId: { kind: "string", required: true, describe: "Workspace that owns the file." },
+      expectedCurrentVersion: {
+        kind: "integer",
+        describe: "Revert only while this is still the current version; otherwise the request fails with `409`. Omit to revert whatever is current. Collaborative edits and repeated workflow writes that fold into the current version keep its number."
+      }
+    }
+  },
   revertWorkflowVersion: {
     method: "POST",
     path: "/api/v2/workflows/[workflowId]/versions/[version]/revert",
@@ -16889,6 +16992,7 @@ var CLI_CONTRACT = {
       { header: "uploaded by", path: "uploadedByEmail" },
       { header: "uploaded", path: "uploadedAt", format: "timestamp" },
       { header: "updated", path: "updatedAt", format: "timestamp" },
+      { header: "version", path: "currentVersion" },
       { header: "shared", path: "share.isActive", format: "bool" },
       { header: "share URL", path: "share.url" },
       { header: "share auth", path: "share.authType" },
@@ -16913,6 +17017,49 @@ var CLI_CONTRACT = {
     renamedFrom: ["files restore create"],
     describe: "Restore an archived file"
   },
+  listFileVersions: {
+    command: "files versions list",
+    describe: "List the recorded versions of a file",
+    columns: [
+      { header: "version" },
+      { header: "current", path: "isCurrent", format: "bool" },
+      { header: "source" },
+      { header: "size", format: "bytes" },
+      { header: "authors", format: "count" },
+      { header: "created", path: "createdAt", format: "timestamp" },
+      { header: "superseded", path: "supersededAt", format: "timestamp" }
+    ]
+  },
+  getFileVersion: {
+    command: "files versions describe",
+    describe: "Show the metadata of one version of a file",
+    fields: [
+      { header: "file", path: "fileId" },
+      { header: "version" },
+      { header: "current", path: "isCurrent", format: "bool" },
+      { header: "source" },
+      { header: "restored from", path: "restoredFromVersion" },
+      { header: "size", format: "bytes" },
+      { header: "type", path: "contentType" },
+      { header: "authors", format: "count" },
+      { header: "created", path: "createdAt", format: "timestamp" },
+      { header: "updated", path: "updatedAt", format: "timestamp" },
+      { header: "superseded", path: "supersededAt", format: "timestamp" }
+    ]
+  },
+  readFileVersionText: {
+    command: "files versions read",
+    describe: "Read the text content of one version of a file"
+  },
+  revertFileVersion: {
+    command: "files versions revert",
+    describe: "Make a previous version of a file current again"
+  },
+  deleteFileVersion: {
+    command: "files versions delete",
+    describe: "Permanently delete a previous version of a file",
+    confirm: "This permanently deletes the version and its stored content."
+  },
   restoreFileFolder: {
     command: "files folders restore",
     positionals: ["path"],
@@ -19403,40 +19550,43 @@ function isTerminalSafeContentType(contentType) {
     "image/svg+xml"
   ].includes(mediaType);
 }
-function attachFileGet(files) {
-  files.command("get").argument("<fileId>", "File whose content to read").allowExcessArguments(false).description("Get a file’s content").option("-o, --output-file <path>", "Write content to a file instead of stdout").option("--force", "Overwrite --output-file if it already exists").action(async (fileId, options, command) => {
-    const writesToStdout = options.outputFile === undefined || options.outputFile === "-";
-    if (writesToStdout && options.force) {
-      throw new SimApiError("--force requires --output-file <path>", 0);
-    }
-    const { client, profile } = clientFrom(command);
-    const workspaceId = client.requireWorkspace();
-    const operation = V2_OPERATIONS.downloadFile;
-    const response = await client.requestRaw(resolvePath(operation.path, { fileId }), {
-      method: operation.method,
-      query: { workspaceId }
-    });
-    if (!response.body) {
-      throw new SimApiError("File content response was empty.", response.status);
-    }
-    if (options.outputFile === undefined || options.outputFile === "-") {
-      const contentType = response.headers.get("content-type");
-      if (process.stdout.isTTY && !isTerminalSafeContentType(contentType)) {
-        await response.body.cancel();
-        throw new SimApiError(`Refusing to write ${contentType ?? "unknown content"} to an interactive terminal. Use --output-file <path> or pipe stdout.`, 0);
-      }
-      await streamToStdout(response.body);
-      return;
+async function downloadToOutput(command, operation, pathParams, options) {
+  const target = options.outputFile;
+  const writesToStdout = target === undefined || target === "-";
+  if (writesToStdout && options.force) {
+    throw new SimApiError("--force requires --output-file <path>", 0);
+  }
+  const { client, profile } = clientFrom(command);
+  const workspaceId = client.requireWorkspace();
+  const response = await client.requestRaw(resolvePath(operation.path, pathParams), {
+    method: operation.method,
+    query: { workspaceId }
+  });
+  if (!response.body) {
+    throw new SimApiError("File content response was empty.", response.status);
+  }
+  if (writesToStdout) {
+    const contentType = response.headers.get("content-type");
+    if (process.stdout.isTTY && !isTerminalSafeContentType(contentType)) {
+      await response.body.cancel();
+      throw new SimApiError(`Refusing to write ${contentType ?? "unknown content"} to an interactive terminal. Use --output-file <path> or pipe stdout.`, 0);
     }
-    const target = options.outputFile;
-    await saveToFile(response.body, target, Boolean(options.force));
-    printProtocolResult(profile.output, {
-      id: fileId,
-      path: target,
-      status: "saved"
-    });
+    await streamToStdout(response.body);
+    return;
+  }
+  await saveToFile(response.body, target, Boolean(options.force));
+  printProtocolResult(profile.output, {
+    id: pathParams.fileId,
+    path: target,
+    status: "saved"
   });
 }
+function attachFileGet(files) {
+  files.command("get").argument("<fileId>", "File whose content to read").allowExcessArguments(false).description("Get a file’s content").option("-o, --output-file <path>", "Write content to a file instead of stdout").option("--force", "Overwrite --output-file if it already exists").action((fileId, options, command) => downloadToOutput(command, V2_OPERATIONS.downloadFile, { fileId }, options));
+}
+function attachFileVersionDownload(versions) {
+  versions.command("download").argument("<fileId>", "File identifier.").argument("<version>", "Version number.").allowExcessArguments(false).description("Download the content of one version of a file").option("-o, --output-file <path>", "Write content to a file instead of stdout").option("--force", "Overwrite --output-file if it already exists").action((fileId, version, options, command) => downloadToOutput(command, V2_OPERATIONS.downloadFileVersion, { fileId, version }, options));
+}
 
 // src/transfer/local-file.ts
 import { constants as constants2 } from "node:fs";
@@ -20645,6 +20795,7 @@ function attachProtocolCommands(program) {
   const files = group(program, "files");
   attachFileUpload(files);
   attachFileGet(files);
+  attachFileVersionDownload(group(files, "versions"));
   attachResourceDirectoryCommands(files, {
     kind: "file",
     resources: "listFiles",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "sim",
-  "version": "2.1.21",
+  "version": "2.1.22-preview.142.1",
   "description": "Sim CLI - talk to the Sim API from your terminal",
   "type": "module",
   "imports": {