stpr 1.0.8 → 1.0.10

package/README.md

@@ -0,0 +1,159 @@
+# stpr — Stepper Skills CLI
+
+Skill Sets are a Stepper feature that let you bundle integration actions into curated, authenticated toolkits — and expose them to AI agents, CLIs, and any MCP-compatible client.
+
+`stpr` is a command-line interface for interacting with [Stepper](https://stepper.io) Skill Sets. Discover, inspect, and execute integration actions directly from your terminal. This is perfect for OpenClaw or agents that can interact with a CLI, or for developers who want to use skills in their own scripts.
+
+If you prefer, you can directly use the Stepper MCP server at `https://mcp.stepper.io/skill-sets/mcp`instead of the CLI.
+
+## Installation
+
+```bash
+npm install -g stpr
+```
+
+## Authentication
+
+The CLI supports three authentication methods:
+
+### OAuth Login (recommended)
+
+```bash
+stpr login
+```
+
+Opens your browser to authenticate and select a Skill Set. Credentials are saved to `~/.config/stepper-skillsets/config.json` and automatically refreshed when they expire.
+
+### Static Token
+
+Generate a token from [Stepper](https://app.stepper.io/flow/skill-sets) and pass it directly:
+
+```bash
+stpr --token sst_your_token_here list
+```
+
+### Environment Variable
+
+```bash
+export STEPPER_SKILL_TOKEN=sst_your_token_here
+stpr list
+```
+
+## Commands
+
+### Profile Management
+
+```bash
+stpr login                # Authenticate via OAuth (opens browser)
+stpr logout [name]        # Remove a saved profile, or all profiles if no name given
+stpr profiles             # List all saved profiles
+stpr use <name>           # Switch the active profile
+stpr whoami               # Show active profile and server info
+```
+
+### Discovering Skills
+
+```bash
+stpr list                 # List all available skills, grouped by service
+stpr list --verbose       # Include full input schemas
+stpr list <service>       # List skills for a specific service
+stpr <service>            # Shorthand for listing a service's skills
+```
+
+### Inspecting Parameters
+
+Many skills have dynamic parameters — fields that change based on the values of other fields. Calling a skill without `--call` returns its current parameter schema.
+
+```bash
+# See what fields are needed for add_row, given a spreadsheet
+stpr google-sheets add_row -i '{"spreadsheet_id": "abc123"}'
+```
+
+Some parameters have dynamic dropdown options. Fetch them with `--options`:
+
+```bash
+stpr google-sheets add_row --options worksheet_id \
+  -i '{"spreadsheet_id": "abc123"}' \
+  --search "Sheet" \
+  --cursor "next_page"
+```
+
+### Calling Skills
+
+Use the `--call` flag to execute an action:
+
+```bash
+stpr google-sheets create_sheet --call \
+  -i '{"name": "Q1 Report", "columns": "Name, Email, Phone"}'
+```
+
+### Polling Async Results
+
+Component library tools run asynchronously. Poll for results with:
+
+```bash
+stpr status <statusId>
+```
+
+## Input
+
+Pass JSON input via the `-i` / `--input` flag or pipe it through stdin:
+
+```bash
+# Flag
+stpr slack send_message --call -i '{"channel": "#general", "text": "Hello!"}'
+
+# Stdin
+echo '{"channel": "#general", "text": "Hello!"}' | stpr slack send_message --call
+```
+
+## Options Reference
+
+| Flag                 | Description                                                     |
+| -------------------- | --------------------------------------------------------------- |
+| `--token <token>`    | Auth token (overrides saved profiles and `STEPPER_SKILL_TOKEN`) |
+| `--base-url <url>`   | Override MCP server URL (default: `https://mcp.stepper.io`)     |
+| `--skillset <name>`  | Use a specific saved profile instead of the active one          |
+| `--call`             | Execute the skill (default behavior is parameter inspection)    |
+| `--verbose`          | Include full `inputSchema` when listing skills                  |
+| `-i, --input <json>` | JSON input for calls, parameter fetches, or option queries      |
+| `--options <param>`  | Fetch dynamic dropdown options for a parameter                  |
+| `--search <query>`   | Filter dropdown options by search term                          |
+| `--cursor <cursor>`  | Pagination cursor for dropdown options                          |
+| `-h, --help`         | Show help                                                       |
+| `-v, --version`      | Show version                                                    |
+
+## Environment Variables
+
+| Variable              | Description                                                   |
+| --------------------- | ------------------------------------------------------------- |
+| `STEPPER_SKILL_TOKEN` | Auth token (used when no `--token` flag and no saved profile) |
+| `STEPPER_URL`         | Override the MCP server base URL                              |
+
+## Examples
+
+```bash
+# Authenticate
+stpr login
+
+# List everything available
+stpr list
+
+# Explore a service
+stpr google-sheets
+
+# Inspect dynamic parameters step by step
+stpr google-sheets add_row -i '{}'
+stpr google-sheets add_row -i '{"spreadsheet_id": "abc123"}'
+
+# Fetch dropdown options
+stpr google-sheets add_row --options worksheet_id -i '{"spreadsheet_id": "abc123"}'
+
+# Execute
+stpr google-sheets add_row --call -i '{"spreadsheet_id": "abc123", "worksheet_id": "Sheet1", "values": {"Name": "Alice"}}'
+
+# Switch between skill sets
+stpr profiles
+stpr use "Production Tools"
+stpr list
+```

package/dist/cli.js

@@ -118,7 +118,7 @@ var StepperClient = class {
       throw new Error(`tools/list failed: ${res.error.message}`);
     }
     const tools = res.result.tools;
-    allTools = tools.map(
+    allTools = tools.filter((tool) => !tool.name.startsWith("__")).map(
       (tool) => ({
         service: tool.name.split("__")[0],
         action: tool.name.split("__")[1],
@@ -128,7 +128,7 @@ var StepperClient = class {
     );
     writeCache(cacheKey, allTools);
     return allTools.filter(
-      (tool) => service ? tool.service === service : !tool.service.startsWith("__")
+      (tool) => service ? tool.service === service : true
     );
   }
   async callTool(name, args) {

package/package.json

@@ -1,10 +1,11 @@
 {
   "name": "stpr",
-  "version": "1.0.8",
+  "version": "1.0.10",
   "description": "CLI for Stepper skill sets",
   "type": "module",
   "files": [
-    "dist"
+    "dist",
+    "README.md"
   ],
   "bin": {
     "stpr": "./dist/cli.js"