@zapier/zapier-sdk-cli 0.86.7 → 0.87.1

package/AGENTS.md

@@ -94,7 +94,7 @@ Some apps have fields that depend on your connection (e.g., "Select a Slack chan
 
 ```bash
 # Provide connection IDs for dynamic field resolution
-npx zapier-sdk add slack --connection-ids 123456
+npx zapier-sdk add slack --connections 123456
 ```
 
 ### When to Regenerate
@@ -157,7 +157,7 @@ Execute Zapier actions directly from the command line.
 ### Basic Usage
 
 ```bash
-npx zapier-sdk run-action slack read channels --connection-id 123456
+npx zapier-sdk run-action slack read channels --connection 123456
 ```
 
 ### With Inputs
@@ -165,7 +165,7 @@ npx zapier-sdk run-action slack read channels --connection-id 123456
 ```bash
 # Pass inputs as JSON
 npx zapier-sdk run-action slack write channel_message \
-  --connection-id 123456 \
+  --connection 123456 \
   --inputs '{"channel": "#general", "text": "Hello from CLI!"}'
 ```
 
@@ -183,7 +183,7 @@ npx zapier-sdk run-action
 ```bash
 # Get raw JSON output for scripting
 npx zapier-sdk run-action slack read channels \
-  --connection-id 123456 \
+  --connection 123456 \
   --json
 ```
 

package/CHANGELOG.md

@@ -1,5 +1,26 @@
 # @zapier/zapier-sdk-cli
 
+## 0.87.1
+
+### Patch Changes
+
+- Updated dependencies [db3e28a]
+  - @zapier/zapier-sdk@0.116.0
+  - @zapier/zapier-sdk-mcp@0.27.9
+
+## 0.87.0
+
+### Minor Changes
+
+- 794c383: Added `zapier-sdk setup --agent` to print the terminal wizard's questions and exact commands for one setup step. The agent asks the user, then runs `setup --step <name> --non-interactive` after approval. Use `--answer` for selections or text input. Printed commands carry `--flow` for login/signup and `--language` for the project language between steps. The guidance tells agents to show the active connections before continuing. Each successful operation prints the next step's question and execution commands directly, without another `--agent` call. Completion gives the current agent instructions to suggest ideas based on connected apps instead of asking which agent to open. Setup does not save progress or answers. Running `zapier-sdk setup` without a terminal now points to `--agent` in its error.
+
+### Patch Changes
+
+- 5bb041a: _This release contains no user-facing changes._
+- Updated dependencies [5bb041a]
+  - @zapier/zapier-sdk@0.115.2
+  - @zapier/zapier-sdk-mcp@0.27.8
+
 ## 0.86.7
 
 ### Patch Changes

package/README.md

@@ -163,6 +163,32 @@ Run the guided setup to add undeclared Zapier SDK dependencies, authenticate, an
 npx @zapier/zapier-sdk-cli setup
 ```
 
+For an AI agent or another non-interactive caller, start stepwise setup:
+
+```bash
+npx @zapier/zapier-sdk-cli setup --agent
+```
+
+Ask the printed wizard question verbatim. After approval, run the exact
+`setup --step <name> --non-interactive` command. Use `--answer` for selections or
+text input. On success, follow the next step's guidance printed by the command;
+no extra `--agent` call is needed.
+The agent owns approval and progress; setup saves neither.
+On completion, the current agent receives instructions to suggest ideas from
+connected apps instead of being asked which agent to open.
+
+Stay in the stated directory. Export shared SDK settings so later commands and
+generated scripts inherit them. Global CLI flags apply only to their invocation.
+Setup uses normal SDK credential and pending OAuth storage; a pending OAuth flow
+started by setup records that saved accounts must be kept. Local authorization
+finishes in the browser. Headless authorization asks the user to paste the final
+callback URL; pass it only to the printed command and do not save it.
+Never repeat a command whose outcome is unknown, especially a Slack send.
+
+Printed commands pin the CLI version and use POSIX shell syntax. Agent mode uses
+plain text, not `--json`, and never reads terminal input. Ordinary `setup`
+requires a terminal and points other callers to `--agent`.
+
 If you already have a project and want to add the CLI as a dependency:
 
 ```bash
@@ -199,7 +225,7 @@ npx zapier-sdk list-connections gmail --owner me
 npx zapier-sdk find-first-connection gmail --owner me
 
 # Make any API request to an app using your connection.
-npx zapier-sdk fetch "https://gmail.googleapis.com/gmail/v1/users/me/labels" --connection-id 123
+npx zapier-sdk curl "https://gmail.googleapis.com/gmail/v1/users/me/labels" --connection 123
 ```
 
 ## Global Options
@@ -2101,12 +2127,23 @@ npx zapier-sdk mcp [--port]
 
 #### `setup`
 
-Set up the Zapier SDK in an existing or new project
+Set up the Zapier SDK in an existing or new project. Runs an interactive terminal wizard; AI agents should use --agent instead.
+
+**Options:**
+
+| Option              | Type      | Required | Default | Possible Values                                                                                                                                                                                                                                 | Description                                                                                                               |
+| ------------------- | --------- | -------- | ------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------- |
+| `--agent`           | `boolean` | ❌       | —       | —                                                                                                                                                                                                                                               | For AI agents and callers without a terminal: print the next setup question and the exact command to run for each answer. |
+| `--step`            | `string`  | ❌       | —       | `directory`, `project`, `install`, `sdk-update`, `cli-update`, `skill`, `account`, `account-flow`, `account-environment`, `authorize`, `confirm-account`, `connections`, `slack`, `slack-overwrite`, `slack-existing`, `slack-retry`, `handoff` | Setup operation to inspect or execute.                                                                                    |
+| `--non-interactive` | `boolean` | ❌       | —       | —                                                                                                                                                                                                                                               | Execute the named setup step without terminal prompts.                                                                    |
+| `--answer`          | `string`  | ❌       | —       | —                                                                                                                                                                                                                                               | User selection or input for a non-interactive setup step. Omitted confirmations use the terminal wizard's default.        |
+| `--flow`            | `string`  | ❌       | —       | `login`, `signup`                                                                                                                                                                                                                               | Account flow selected for the environment and OAuth callback steps.                                                       |
+| `--language`        | `string`  | ❌       | —       | `javascript`, `typescript`                                                                                                                                                                                                                      | Project language for dependency installation and the Slack demo.                                                          |
 
 **Usage:**
 
 ```bash
-npx zapier-sdk setup
+npx zapier-sdk setup [--agent] [--step] [--non-interactive] [--answer] [--flow] [--language]
 ```
 
 ### Virtual File System (Experimental)