@zapier/zapier-sdk-cli 0.80.2 → 0.81.0

package/CHANGELOG.md

@@ -1,5 +1,18 @@
 # @zapier/zapier-sdk-cli
 
+## 0.81.0
+
+### Minor Changes
+
+- cd1cafb: Added nine experimental VFS commands: `read-vfs-file`, `write-vfs-file`, `append-vfs-file`, `copy-vfs-file`, `list-vfs-directory`, `create-vfs-directory`, `stat-vfs-path`, `delete-vfs-path`, and `move-vfs-path`.
+
+### Patch Changes
+
+- Updated dependencies [cd1cafb]
+- Updated dependencies [cd1cafb]
+  - @zapier/zapier-sdk@0.108.0
+  - @zapier/zapier-sdk-mcp@0.23.0
+
 ## 0.80.2
 
 ### Patch Changes

package/README.md

@@ -114,6 +114,16 @@
   - [`init`](#init)
   - [`mcp`](#mcp)
   - [`setup`](#setup)
+- [Virtual File System (Experimental)](#virtual-file-system-experimental)
+  - [`append-vfs-file`](#append-vfs-file--experimental)
+  - [`copy-vfs-file`](#copy-vfs-file--experimental)
+  - [`create-vfs-directory`](#create-vfs-directory--experimental)
+  - [`delete-vfs-path`](#delete-vfs-path--experimental)
+  - [`list-vfs-directory`](#list-vfs-directory--experimental)
+  - [`move-vfs-path`](#move-vfs-path--experimental)
+  - [`read-vfs-file`](#read-vfs-file--experimental)
+  - [`stat-vfs-path`](#stat-vfs-path--experimental)
+  - [`write-vfs-file`](#write-vfs-file--experimental)
 
 ## Quick Start
 
@@ -2063,3 +2073,162 @@ Set up the Zapier SDK in an existing or new project
 ```bash
 npx zapier-sdk setup
 ```
+
+### Virtual File System (Experimental)
+
+> ℹ️ **Experimental.** Run commands via the `zapier-sdk-experimental` binary, pass `--experimental` to `zapier-sdk`, or set `ZAPIER_EXPERIMENTAL=true` in the environment. Flags and behavior may change between versions.
+
+#### `append-vfs-file` 🧪 _experimental_
+
+Append content to a file in the Zapier Virtual File System (VFS). Creates the file if it doesn't exist; missing parent directories are created automatically. Safer than reading the file and rewriting it — appends server-side without a read/write round-trip. Paths are absolute (e.g. `/Mine/log.md`).
+
+**Options:**
+
+| Option      | Type     | Required | Default | Possible Values | Description                                                                                    |
+| ----------- | -------- | -------- | ------- | --------------- | ---------------------------------------------------------------------------------------------- |
+| `<path>`    | `string` | ✅       | —       | —               | Absolute path of the file (must start with `/`).                                               |
+| `<content>` | `string` | ✅       | —       | —               | Content to append. Capped at 10 MB per call, and the resulting file must also fit under 10 MB. |
+
+**Usage:**
+
+```bash
+npx zapier-sdk append-vfs-file <path> <content>
+```
+
+#### `copy-vfs-file` 🧪 _experimental_
+
+Copy a file to a new path in the Zapier Virtual File System (VFS). Both `from` and `to` are absolute file paths (e.g. `/Mine/notes.md`), not directories.
+
+**Options:**
+
+| Option               | Type      | Required | Default | Possible Values | Description                                                                                                                                                                                          |
+| -------------------- | --------- | -------- | ------- | --------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `<from>`             | `string`  | ✅       | —       | —               | Absolute path of the source file.                                                                                                                                                                    |
+| `<to>`               | `string`  | ✅       | —       | —               | Absolute path of the destination file.                                                                                                                                                               |
+| `--overwrite`        | `boolean` | ❌       | —       | —               | When `true`, replace any existing file at `to`. Default `false` fails if `to` already exists.                                                                                                        |
+| `--expected-version` | `number`  | ❌       | —       | —               | Optional version pin for the destination. Requires `overwrite: true` and an existing file at `to`; the replace only succeeds if the destination's current version matches, otherwise the call fails. |
+
+**Usage:**
+
+```bash
+npx zapier-sdk copy-vfs-file <from> <to> [--overwrite] [--expected-version]
+```
+
+#### `create-vfs-directory` 🧪 _experimental_
+
+Create a directory in the Zapier Virtual File System (VFS). Paths are absolute (e.g. `/Mine/notes`). Idempotent — safe to call on an existing directory.
+
+**Options:**
+
+| Option   | Type     | Required | Default | Possible Values | Description                                           |
+| -------- | -------- | -------- | ------- | --------------- | ----------------------------------------------------- |
+| `<path>` | `string` | ✅       | —       | —               | Absolute path of the directory (must start with `/`). |
+
+**Usage:**
+
+```bash
+npx zapier-sdk create-vfs-directory <path>
+```
+
+#### `delete-vfs-path` 🧪 _experimental_
+
+Delete a file or directory in the Zapier Virtual File System (VFS). Works on either; paths are absolute (e.g. `/Mine/notes.md`). Deletes are recoverable — contact Zapier support to restore an entry.
+
+**Options:**
+
+| Option   | Type     | Required | Default | Possible Values | Description                                    |
+| -------- | -------- | -------- | ------- | --------------- | ---------------------------------------------- |
+| `<path>` | `string` | ✅       | —       | —               | Absolute path to delete (must start with `/`). |
+
+**Usage:**
+
+```bash
+npx zapier-sdk delete-vfs-path <path>
+```
+
+#### `list-vfs-directory` 🧪 _experimental_
+
+List one page of a directory's contents in the Zapier Virtual File System (VFS). Paths are absolute (e.g. `/Mine`). Pass the previous page's `nextCursor` back in `cursor` to fetch the next page.
+
+**Options:**
+
+| Option        | Type     | Required | Default | Possible Values | Description                                           |
+| ------------- | -------- | -------- | ------- | --------------- | ----------------------------------------------------- |
+| `<path>`      | `string` | ✅       | —       | —               | Absolute path of the directory (must start with `/`). |
+| `--page-size` | `number` | ❌       | —       | —               | Entries per page (default 50, max 500).               |
+| `--max-items` | `number` | ❌       | —       | —               | Maximum total entries to return across all pages.     |
+| `--cursor`    | `string` | ❌       | —       | —               | Cursor to resume from, as returned in `nextCursor`.   |
+
+**Usage:**
+
+```bash
+npx zapier-sdk list-vfs-directory <path> [--page-size] [--max-items] [--cursor]
+```
+
+#### `move-vfs-path` 🧪 _experimental_
+
+Move (rename) a file or directory in the Zapier Virtual File System (VFS). Both `from` and `to` are absolute paths (e.g. `/Mine/notes.md`). Fails if an entry already exists at `to` — delete or rename it first.
+
+**Options:**
+
+| Option   | Type     | Required | Default | Possible Values | Description                        |
+| -------- | -------- | -------- | ------- | --------------- | ---------------------------------- |
+| `<from>` | `string` | ✅       | —       | —               | Absolute path of the source entry. |
+| `<to>`   | `string` | ✅       | —       | —               | New absolute path for the entry.   |
+
+**Usage:**
+
+```bash
+npx zapier-sdk move-vfs-path <from> <to>
+```
+
+#### `read-vfs-file` 🧪 _experimental_
+
+Read a file from the Zapier Virtual File System (VFS), the file store behind your context repository. Paths are absolute, e.g. `/Mine/notes.md`. Returns the content as a UTF-8 string with its size, version, and last-modified time.
+
+**Options:**
+
+| Option        | Type     | Required | Default | Possible Values | Description                                                                                                        |
+| ------------- | -------- | -------- | ------- | --------------- | ------------------------------------------------------------------------------------------------------------------ |
+| `<path>`      | `string` | ✅       | —       | —               | Absolute path of the file to read (must start with `/`).                                                           |
+| `--max-bytes` | `number` | ❌       | —       | —               | Optional cap on returned content length, in bytes. Files are capped at 10 MB, so values above that have no effect. |
+
+**Usage:**
+
+```bash
+npx zapier-sdk read-vfs-file <path> [--max-bytes]
+```
+
+#### `stat-vfs-path` 🧪 _experimental_
+
+Inspect metadata for any path (file, directory, shortcut, or stream) in the Zapier Virtual File System (VFS). Paths are absolute (e.g. `/Mine/notes.md`). Check the `type` field before reading fields that only exist for certain types.
+
+**Options:**
+
+| Option   | Type     | Required | Default | Possible Values | Description                                  |
+| -------- | -------- | -------- | ------- | --------------- | -------------------------------------------- |
+| `<path>` | `string` | ✅       | —       | —               | Absolute path to stat (must start with `/`). |
+
+**Usage:**
+
+```bash
+npx zapier-sdk stat-vfs-path <path>
+```
+
+#### `write-vfs-file` 🧪 _experimental_
+
+Write (create or overwrite) a file in the Zapier Virtual File System (VFS). Paths are absolute (e.g. `/Mine/notes.md`); missing parent directories are created automatically.
+
+**Options:**
+
+| Option               | Type     | Required | Default | Possible Values | Description                                                                                                                                                                               |
+| -------------------- | -------- | -------- | ------- | --------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `<path>`             | `string` | ✅       | —       | —               | Absolute path of the file (must start with `/`).                                                                                                                                          |
+| `<content>`          | `string` | ✅       | —       | —               | New file contents. Capped at 10 MB per call.                                                                                                                                              |
+| `--expected-version` | `number` | ❌       | —       | —               | Optional expected current version for optimistic concurrency. The write fails if the file's actual version differs. Pass `0` to assert the file does not exist yet (versions start at 1). |
+
+**Usage:**
+
+```bash
+npx zapier-sdk write-vfs-file <path> <content> [--expected-version]
+```

package/dist/cli.cjs

@@ -602,7 +602,7 @@ var SHARED_COMMAND_CLI_OPTIONS = [
 
 // package.json
 var package_default = {
-  version: "0.80.2"};
+  version: "0.81.0"};
 var PACKAGE_MANAGERS = ["npm", "pnpm", "yarn", "bun"];
 var LOCKFILES = [
   ["pnpm-lock.yaml", "pnpm"],
@@ -8685,7 +8685,7 @@ function buildBoxLines(message) {
 // package.json with { type: 'json' }
 var package_default2 = {
   name: "@zapier/zapier-sdk-cli",
-  version: "0.80.2"};
+  version: "0.81.0"};
 
 // src/sdk.ts
 var warnedDeprecatedMethods = /* @__PURE__ */ new Set();

package/dist/cli.mjs

@@ -558,7 +558,7 @@ var SHARED_COMMAND_CLI_OPTIONS = [
 
 // package.json
 var package_default = {
-  version: "0.80.2"};
+  version: "0.81.0"};
 var PACKAGE_MANAGERS = ["npm", "pnpm", "yarn", "bun"];
 var LOCKFILES = [
   ["pnpm-lock.yaml", "pnpm"],
@@ -8641,7 +8641,7 @@ function buildBoxLines(message) {
 // package.json with { type: 'json' }
 var package_default2 = {
   name: "@zapier/zapier-sdk-cli",
-  version: "0.80.2"};
+  version: "0.81.0"};
 
 // src/sdk.ts
 var warnedDeprecatedMethods = /* @__PURE__ */ new Set();

package/dist/experimental.cjs

@@ -7178,7 +7178,7 @@ function collectDeprecationNoticeAndForward(event, onEvent) {
 // package.json with { type: 'json' }
 var package_default = {
   name: "@zapier/zapier-sdk-cli",
-  version: "0.80.2"};
+  version: "0.81.0"};
 
 // src/sdk.ts
 var warnedDeprecatedMethods = /* @__PURE__ */ new Set();

package/dist/experimental.mjs

@@ -7137,7 +7137,7 @@ function collectDeprecationNoticeAndForward(event, onEvent) {
 // package.json with { type: 'json' }
 var package_default = {
   name: "@zapier/zapier-sdk-cli",
-  version: "0.80.2"};
+  version: "0.81.0"};
 
 // src/sdk.ts
 var warnedDeprecatedMethods = /* @__PURE__ */ new Set();

package/dist/index.cjs

@@ -7179,7 +7179,7 @@ function collectDeprecationNoticeAndForward(event, onEvent) {
 // package.json with { type: 'json' }
 var package_default = {
   name: "@zapier/zapier-sdk-cli",
-  version: "0.80.2"};
+  version: "0.81.0"};
 
 // src/sdk.ts
 var warnedDeprecatedMethods = /* @__PURE__ */ new Set();
@@ -7263,7 +7263,7 @@ function createZapierCliSdk(options = {}) {
 
 // package.json
 var package_default2 = {
-  version: "0.80.2"};
+  version: "0.81.0"};
 
 // src/telemetry/builders.ts
 function createCliBaseEvent(context = {}) {

package/dist/index.mjs

@@ -7138,7 +7138,7 @@ function collectDeprecationNoticeAndForward(event, onEvent) {
 // package.json with { type: 'json' }
 var package_default = {
   name: "@zapier/zapier-sdk-cli",
-  version: "0.80.2"};
+  version: "0.81.0"};
 
 // src/sdk.ts
 var warnedDeprecatedMethods = /* @__PURE__ */ new Set();
@@ -7222,7 +7222,7 @@ function createZapierCliSdk(options = {}) {
 
 // package.json
 var package_default2 = {
-  version: "0.80.2"};
+  version: "0.81.0"};
 
 // src/telemetry/builders.ts
 function createCliBaseEvent(context = {}) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zapier/zapier-sdk-cli",
-  "version": "0.80.2",
+  "version": "0.81.0",
   "description": "Command line interface for Zapier SDK",
   "main": "dist/index.cjs",
   "module": "dist/index.mjs",
@@ -96,8 +96,8 @@
     "wrap-ansi": "^10.0.0",
     "zod": "4.3.6",
     "@zapier/kitcore": "0.20.0",
-    "@zapier/zapier-sdk": "0.107.2",
-    "@zapier/zapier-sdk-mcp": "0.22.2"
+    "@zapier/zapier-sdk-mcp": "0.23.0",
+    "@zapier/zapier-sdk": "0.108.0"
   },
   "devDependencies": {
     "@types/cross-spawn": "^6.0.6",