@myapihq/cli 1.0.84 → 1.1.0-wip.0

package/dist/skills/my-workflow-api/SKILL.md

@@ -0,0 +1,98 @@
+---
+name: my-workflow-api
+description: >
+  Run actions when a webhook fires. Trigger emails, Slack notifications, or HTTP calls in response to inbound webhook deliveries — without writing a backend.
+---
+
+# MyWorkflowAPI
+
+Workflows bind a list of steps to a webhook endpoint. Every time the webhook receives a POST, the workflow runs its steps in order. Each run is recorded with its status, attempt count, and any error.
+
+## How It Fits Together
+
+- Requires `api_key` and `org_id` from **myapihq**.
+- Requires a webhook endpoint id from **mywebhookapi** as the trigger.
+- Steps can reference other services — e.g. send an email via **myemailapi**.
+
+## Quick Start
+
+```bash
+# 1. Create the webhook that will trigger the workflow
+WID=$(myapi webhook create --name "leads" --json | jq -r .id)
+
+# 2. Create a workflow bound to that webhook
+myapi workflow create \
+  --name "Slack on new lead" \
+  --endpoint-id $WID \
+  --steps '[{"type":"slack","webhook_url":"https://hooks.slack.com/..."}]'
+
+# 3. POST to the webhook → workflow fires
+curl -X POST <webhook-inbound-url> -d '{"name":"Alice"}'
+
+# 4. Inspect runs
+myapi workflow runs <workflow_id>
+myapi workflow get-run <run_id>
+```
+
+## All Commands
+
+| Command | What it does |
+|---|---|
+| `myapi workflow create` | Create a new workflow (`--name --endpoint-id --steps`) |
+| `myapi workflow list` | List workflows in your org |
+| `myapi workflow get <id>` | Inspect a workflow's steps + trigger config |
+| `myapi workflow update <id>` | Change name, endpoint, or steps |
+| `myapi workflow enable <id>` | Enable firing |
+| `myapi workflow disable <id>` | Stop firing without deleting |
+| `myapi workflow delete <id>` | Permanently remove workflow + run history |
+| `myapi workflow runs <id>` | List recent runs (status, attempt, errors) |
+| `myapi workflow get-run <run_id>` | Get full run details + step output |
+
+## Steps
+
+`--steps` is a JSON array of step objects. Each step has a `type` and type-specific fields.
+
+```json
+[
+  {
+    "type": "send_email",
+    "from": "hello@yourdomain.com",
+    "to": "{{ payload.email }}",
+    "subject": "Welcome, {{ payload.name }}",
+    "template_id": "<template_id>"
+  },
+  {
+    "type": "http",
+    "method": "POST",
+    "url": "https://crm.example.com/contacts",
+    "body": "{{ payload | json }}"
+  }
+]
+```
+
+The webhook payload is available as `{{ payload }}` and individual fields as `{{ payload.fieldname }}`.
+
+## Lifecycle
+
+```bash
+# Create disabled, test, then enable
+myapi workflow create --name "X" --endpoint-id $WID --steps '...' --no-enable
+
+# Trigger via webhook POST, inspect
+myapi workflow runs <id>
+
+# When ready
+myapi workflow enable <id>
+
+# To temporarily stop
+myapi workflow disable <id>
+```
+
+## Notes
+
+- Workflows fire on every webhook delivery. Failed runs don't block subsequent runs.
+- Each run records its attempt number, started_at/finished_at, and any error.
+- A workflow can be disabled to stop firing without losing the configuration.
+- Deleting a workflow purges its run history; the webhook endpoint remains.
+
+Run `myapi workflow --help` for full flag reference.

package/dist/skills/my-workflow-api/claude/.claude-plugin/plugin.json

@@ -0,0 +1,6 @@
+{
+  "name": "my-workflow-api",
+  "description": "React to inbound webhooks with step chains: send email, post to Slack, call HTTP URLs.",
+  "version": "1.0.0",
+  "published": true
+}

package/dist/utils.d.ts

@@ -1,7 +1,3 @@
-export declare function parseArgs(argv: string[]): {
-    args: string[];
-    flags: Record<string, string | boolean>;
-};
 export declare function sleep(ms: number): Promise<unknown>;
 /**
  * Formats an ISO/Go timestamp string to "YYYY-MM-DD HH:mm" (UTC).

package/dist/utils.js

@@ -1,36 +1,3 @@
-export function parseArgs(argv) {
-    const args = [];
-    const flags = {};
-    for (let i = 0; i < argv.length; i++) {
-        const arg = argv[i];
-        if (arg === '-h') {
-            flags['help'] = true;
-        }
-        else if (arg === '-v') {
-            flags['version'] = true;
-        }
-        else if (arg.startsWith('--')) {
-            if (arg.includes('=')) {
-                const [key, value] = arg.slice(2).split('=', 2);
-                flags[key] = value;
-            }
-            else {
-                const next = argv[i + 1];
-                if (next && !next.startsWith('--')) {
-                    flags[arg.slice(2)] = next;
-                    i++;
-                }
-                else {
-                    flags[arg.slice(2)] = true;
-                }
-            }
-        }
-        else {
-            args.push(arg);
-        }
-    }
-    return { args, flags };
-}
 export function sleep(ms) {
     return new Promise(resolve => setTimeout(resolve, ms));
 }

package/dist/utils.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/utils.test.js

@@ -0,0 +1,48 @@
+import { describe, it, expect } from 'vitest';
+import { parseArgs } from './utils.js';
+describe('parseArgs', () => {
+    it('treats unknown flags as boolean', () => {
+        const { args, flags } = parseArgs(['funnel', 'get', '--json', 'abc-123']);
+        expect(flags.json).toBe(true);
+        expect(args).toEqual(['funnel', 'get', 'abc-123']);
+    });
+    it('treats --yes, --help, --verbose as boolean', () => {
+        const { flags } = parseArgs(['--yes', '--help', '--verbose']);
+        expect(flags.yes).toBe(true);
+        expect(flags.help).toBe(true);
+        expect(flags.verbose).toBe(true);
+    });
+    it('consumes next token for value flags', () => {
+        const { args, flags } = parseArgs(['org', 'create', '--name', 'Acme Inc', '--yes']);
+        expect(flags.name).toBe('Acme Inc');
+        expect(flags.yes).toBe(true);
+        expect(args).toEqual(['org', 'create']);
+    });
+    it('supports --key=value syntax for any flag', () => {
+        const { flags } = parseArgs(['--org=abc-123', '--json']);
+        expect(flags.org).toBe('abc-123');
+        expect(flags.json).toBe(true);
+    });
+    it('value flag with no next token becomes boolean true', () => {
+        const { flags } = parseArgs(['--name']);
+        expect(flags.name).toBe(true);
+    });
+    it('value flag followed by another flag does not consume it', () => {
+        const { flags } = parseArgs(['--org', '--json']);
+        expect(flags.org).toBe(true);
+        expect(flags.json).toBe(true);
+    });
+    it('-h maps to help', () => {
+        const { flags } = parseArgs(['-h']);
+        expect(flags.help).toBe(true);
+    });
+    it('-v maps to version', () => {
+        const { flags } = parseArgs(['-v']);
+        expect(flags.version).toBe(true);
+    });
+    it('collects positional args correctly', () => {
+        const { args, flags } = parseArgs(['domain', 'register', 'example.com', '--org', 'uuid-here']);
+        expect(args).toEqual(['domain', 'register', 'example.com']);
+        expect(flags.org).toBe('uuid-here');
+    });
+});

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@myapihq/cli",
-  "version": "1.0.84",
+  "version": "1.1.0-wip.0",
   "description": "MyAPI command-line interface",
   "type": "module",
   "files": [
@@ -13,10 +13,14 @@
   "scripts": {
     "prebuild": "node scripts/copy-skills.js",
     "build": "tsc && rm -rf dist/skills && cp -r src/skills dist/skills",
-    "dev": "tsc --watch"
+    "dev": "tsc --watch",
+    "test": "vitest run src",
+    "test:smoke": "npm run build && vitest run src test/smoke",
+    "test:online": "npm run build && MYAPI_RUN_RESET=1 vitest run test/online",
+    "test:all": "npm run build && MYAPI_RUN_RESET=1 vitest run src test/smoke test/online"
   },
   "dependencies": {
-    "@myapihq/sdk": "*",
+    "@myapihq/sdk": "1.1.0-wip.0",
     "omelette": "^0.4.17",
     "update-notifier": "^7.3.1"
   },
@@ -24,6 +28,7 @@
     "@types/node": "^25.6.0",
     "@types/omelette": "^0.4.5",
     "@types/update-notifier": "^6.0.8",
-    "typescript": "^5.4.0"
+    "typescript": "^5.4.0",
+    "vitest": "^4.1.5"
   }
 }

package/dist/commands/account.d.ts

@@ -1,4 +0,0 @@
-export declare function create(): Promise<void>;
-export declare function token(flags: Record<string, string | boolean>): Promise<void>;
-export declare function listKeys(flags: Record<string, string | boolean>): Promise<void>;
-export declare function revokeKey(id: string, flags: Record<string, string | boolean>): Promise<void>;

package/dist/commands/account.js

@@ -1,80 +0,0 @@
-"use strict";
-var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    var desc = Object.getOwnPropertyDescriptor(m, k);
-    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
-      desc = { enumerable: true, get: function() { return m[k]; } };
-    }
-    Object.defineProperty(o, k2, desc);
-}) : (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    o[k2] = m[k];
-}));
-var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
-    Object.defineProperty(o, "default", { enumerable: true, value: v });
-}) : function(o, v) {
-    o["default"] = v;
-});
-var __importStar = (this && this.__importStar) || (function () {
-    var ownKeys = function(o) {
-        ownKeys = Object.getOwnPropertyNames || function (o) {
-            var ar = [];
-            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
-            return ar;
-        };
-        return ownKeys(o);
-    };
-    return function (mod) {
-        if (mod && mod.__esModule) return mod;
-        var result = {};
-        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
-        __setModuleDefault(result, mod);
-        return result;
-    };
-})();
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.create = create;
-exports.token = token;
-exports.listKeys = listKeys;
-exports.revokeKey = revokeKey;
-const sdk_1 = require("@myapihq/sdk");
-const config_js_1 = require("../config.js");
-const output_js_1 = require("../output.js");
-const readline = __importStar(require("readline"));
-async function create() {
-    const rl = readline.createInterface({ input: process.stdin, output: process.stdout });
-    const key = await new Promise(resolve => rl.question('Paste your API key (get it from https://myapihq.com): ', resolve));
-    rl.close();
-    if (!key.trim()) {
-        (0, output_js_1.error)('API key cannot be empty.');
-        return;
-    }
-    (0, config_js_1.saveConfig)({ api_key: key.trim(), account_id: '', pin: '' });
-    (0, output_js_1.success)(`API key saved to ~/.myapi/config.json`);
-}
-async function token(flags) {
-    let pin = flags.pin;
-    if (!pin) {
-        const rl = readline.createInterface({ input: process.stdin, output: process.stdout });
-        pin = await new Promise(resolve => rl.question('Enter PIN: ', resolve));
-        rl.close();
-    }
-    const result = await sdk_1.hq.recoverAgentToken(pin);
-    const keyInfo = await sdk_1.hq.createApiKey(result.token, 'recovered');
-    const config = (0, config_js_1.requireConfig)();
-    config.api_key = keyInfo.api_key;
-    (0, config_js_1.saveConfig)(config);
-    (0, output_js_1.success)(`Token recovered! New API Key: ${keyInfo.api_key}`);
-}
-async function listKeys(flags) {
-    const config = (0, config_js_1.requireConfig)();
-    const keys = await sdk_1.hq.listApiKeys(config.api_key);
-    (0, output_js_1.printTable)(keys);
-}
-async function revokeKey(id, flags) {
-    if (!id)
-        (0, output_js_1.error)("Missing key id");
-    const config = (0, config_js_1.requireConfig)();
-    await sdk_1.hq.revokeApiKey(config.api_key, id);
-    (0, output_js_1.success)(`Key ${id} revoked`);
-}