@keystrokehq/cli 0.0.30 → 0.0.31

package/README.md

@@ -89,8 +89,10 @@ keystroke --api-key sk_... --server-url https://api.example.com workflows list
 | `keystroke test` | Test agent-callable tools. |
 | `keystroke connect` | Connect official integrations through OAuth. |
 | `keystroke listen` | Create a temporary URL and print the first captured request body. |
-| `keystroke integrations` | List available integrations and registration metadata. |
-| `keystroke credentials` | List credential sets, inspect requirements, and upload credential values. |
+| `keystroke search` | Ranked discovery across operations, integrations, or credential definitions. |
+| `keystroke operations` | List and show operations (catalog metadata, including JSON schemas). |
+| `keystroke integrations` | List integrations; `integrations show` returns one integration and its operations. |
+| `keystroke credentials` | Per-org credential sets, requirements, and upload. Use `credentials definitions` for catalog auth shapes. |
 | `keystroke org` | View and switch organization context. |
 | `keystroke projects` | List or clear locally tracked projects. |
 | `keystroke runs inspect` | Inspect workflow and agent runs. |
@@ -174,6 +176,37 @@ The relevant configuration sources are:
 
 Use `--debug` on any command to show diagnostic output.
 
+## Catalog discovery
+
+Discovery commands call the server catalog API via `@keystroke/workflow-sdk`. They require the same auth as deploy: API key plus organization context.
+
+```bash
+export KEYSTROKE_API_KEY=sk_...
+export KEYSTROKE_ORG_ID=<your-org-uuid>
+export SERVER_URL=http://localhost:3001   # local API (port 3001, not the web app on 3000)
+
+keystroke search "put object"
+keystroke search "slack" --type integrations
+keystroke search "oauth" --type credentials --integration keystroke:slack
+
+keystroke operations list --integration aws-s3
+keystroke operations show aws-s3.put-object
+keystroke operations show aws-s3.put-object --schema --json
+
+keystroke integrations list
+keystroke integrations show keystroke:slack   # bare `slack` also works today
+
+keystroke credentials definitions list --role connection
+keystroke credentials definitions show keystroke:aws-s3
+```
+
+Flags shared across discovery commands:
+
+- `--json` — machine-readable output (field names match shared-types schemas).
+- `--full` on `search`, `operations list`, and `credentials definitions list` — pass `include=full` for schemas and extended fields in one round-trip.
+
+`keystroke credentials list` lists **your organization's credential sets**, not catalog definitions.
+
 ## Integrations And Credentials
 
 Connect an OAuth integration:
@@ -188,6 +221,7 @@ Inspect integration and credential state:
 
 ```bash
 keystroke integrations list
+keystroke credentials definitions list --role connection
 keystroke credentials requirements --path .
 keystroke credentials list
 ```

package/dist/{credentials-LmhgE-Co.mjs → credentials-CsncZ52a.mjs}

@@ -279,7 +279,7 @@ function createCredentialsDefinitionsCommand() {
 			optionsConfig: DEFINITION_SHOW_OPTIONS_CONFIG,
 			argument: {
 				name: "id",
-				description: "Credential definition id, e.g. official.aws-s3",
+				description: "Credential definition id, e.g. keystroke:aws-s3",
 				key: "id"
 			},
 			loadHandler: async () => (await import("./show.handler-CsidInW8.mjs")).handleCredentialDefinitionShow

package/dist/keystroke.mjs

@@ -521,7 +521,7 @@ const logger = {
 };
 //#endregion
 //#region package.json
-var version = "0.0.30";
+var version = "0.0.31";
 //#endregion
 //#region src/command-registry.ts
 const ROOT_OPTIONS_WITH_VALUES$1 = new Set([
@@ -553,7 +553,7 @@ const lazyCommandDefinitions = [
 	},
 	{
 		name: "credentials",
-		loadCommand: async () => (await import("./credentials-LmhgE-Co.mjs")).createCredentialsCommand(),
+		loadCommand: async () => (await import("./credentials-CsncZ52a.mjs")).createCredentialsCommand(),
 		copyInheritedSettings: true
 	},
 	{
@@ -586,7 +586,7 @@ const lazyCommandDefinitions = [
 	},
 	{
 		name: "operations",
-		loadCommand: async () => (await import("./operations-wXS1s3du.mjs")).createOperationsCommand()
+		loadCommand: async () => (await import("./operations-AWMLs6mE.mjs")).createOperationsCommand()
 	},
 	{
 		name: "projects",

package/dist/{operations-wXS1s3du.mjs → operations-AWMLs6mE.mjs}

@@ -70,7 +70,7 @@ function createOperationsCommand() {
 			optionsConfig: OPERATION_SHOW_OPTIONS_CONFIG,
 			argument: {
 				name: "id",
-				description: "Operation id, e.g. aws-s3.upload-object",
+				description: "Operation id, e.g. aws-s3.put-object",
 				key: "id"
 			},
 			loadHandler: async () => (await import("./show.handler-Wmv0tkxx.mjs")).handleOperationShow

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@keystrokehq/cli",
-  "version": "0.0.30",
+  "version": "0.0.31",
   "private": false,
   "description": "Command-line interface for creating, managing, and deploying Keystroke automations.",
   "type": "module",
@@ -32,19 +32,19 @@
     "rolldown": "1.0.0",
     "tsx": "^4.21.0",
     "zod": "4.4.3",
-    "@keystrokehq/skills": "0.0.8"
+    "@keystrokehq/skills": "0.0.9"
   },
   "devDependencies": {
     "tsdown": "0.21.10",
     "typescript": "^5.9.3",
     "vitest": "^4.1.5",
     "@keystroke/local-memory": "0.0.2",
+    "@keystroke/env-utils": "0.0.0",
     "@keystrokehq/config": "0.0.2",
     "@keystroke/shared-types": "0.0.11",
+    "@keystroke/test-utils": "0.0.6",
     "@keystroke/typescript-config": "0.0.0",
-    "@keystroke/env-utils": "0.0.0",
     "@keystroke/utils": "0.0.0",
-    "@keystroke/test-utils": "0.0.6",
     "@keystroke/workflow-builder": "0.0.15",
     "@keystrokehq/core": "0.0.10",
     "@keystrokehq/runtime": "0.0.7",