@zeph-to/hook-sdk 1.8.0 → 1.9.0

package/README.md

@@ -1,6 +1,6 @@
 # @zeph-to/hook-sdk
 
-Push notification SDK + CLI for [Zeph](https://zeph.to). Zero dependencies — uses native `fetch`.
+Push notification SDK + CLI for [Zeph](https://zeph.to). The `ZephHook` SDK uses native `fetch` with no runtime dependencies; the `zeph` CLI adds `@inquirer/prompts` for its interactive installer.
 
 ## Installation
 
@@ -202,7 +202,8 @@ Push bodies are encrypted with AES-256-GCM. The wrapping key is derived via ECDH
 ## Requirements
 
 - Node.js >= 18 (uses native `fetch`)
-- Zero runtime dependencies
+- The `ZephHook` SDK has no runtime dependencies. The CLI depends on
+  `@inquirer/prompts` for the interactive `zeph install` picker.
 
 ## License
 

package/dist/cli.js

@@ -97,6 +97,9 @@ Install options:
   --key <api-key>    API key (non-interactive)
   --hook <hook-id>   Hook ID (non-interactive)
   --base-url <url>   Base URL (non-interactive)
+  --only <agents>    Comma-separated agent ids to install for
+                     (claude,cursor,windsurf,gemini,codex,copilot,cline,aider).
+                     Skips the interactive picker.
 
 Uninstall options:
   --dry-run          Preview what would be removed, change nothing

package/dist/installer.d.ts

@@ -1,2 +1,9 @@
+import type { Agent } from './agents.js';
+/**
+ * Resolve agents from a non-interactive `--only cursor,gemini` flag.
+ * Matches on agent id; unknown ids are silently dropped. Exported for
+ * unit testing.
+ */
+export declare const filterAgentsByIds: (detected: Agent[], only: string) => Agent[];
 export declare const handleInstall: (args: Record<string, string | boolean>) => Promise<number>;
 //# sourceMappingURL=installer.d.ts.map

package/dist/installer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"installer.d.ts","sourceRoot":"","sources":["../src/installer.ts"],"names":[],"mappings":"AA4RA,eAAO,MAAM,aAAa,GAAU,MAAM,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,KAAG,OAAO,CAAC,MAAM,CAoH1F,CAAC"}
+{"version":3,"file":"installer.d.ts","sourceRoot":"","sources":["../src/installer.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AAwSzC;;;;GAIG;AACH,eAAO,MAAM,iBAAiB,GAAI,UAAU,KAAK,EAAE,EAAE,MAAM,MAAM,KAAG,KAAK,EAKxE,CAAC;AAqBF,eAAO,MAAM,aAAa,GAAU,MAAM,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,KAAG,OAAO,CAAC,MAAM,CA4H1F,CAAC"}

package/dist/installer.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.handleInstall = void 0;
+exports.handleInstall = exports.filterAgentsByIds = void 0;
 const child_process_1 = require("child_process");
 const fs_1 = require("fs");
 const os_1 = require("os");
@@ -251,6 +251,52 @@ const AGENT_INSTALLERS = {
     cline: installCline,
     aider: installAider,
 };
+// One-line summary of what each agent's installer does — shown in the
+// interactive plan before anything is written.
+const AGENT_PLAN_LABELS = {
+    claude: 'Claude Code — install plugin',
+    cursor: 'Cursor — MCP + hooks + rules',
+    windsurf: 'Windsurf — MCP + hooks + rules',
+    gemini: 'Gemini CLI — MCP + hooks + rules',
+    codex: 'Codex CLI — hooks + rules',
+    copilot: 'Copilot CLI — hooks + rules',
+    cline: 'Cline — rules',
+    aider: 'Aider — conventions',
+};
+// ── Agent selection ──────────────────────────────────────────────
+/**
+ * Interactive agent picker — an @inquirer/prompts checkbox (arrow keys
+ * to move, space to toggle, enter to confirm). Every agent starts
+ * checked, so a bare Enter installs for all. Returns the chosen Agent[].
+ *
+ * Dynamic import keeps @inquirer/prompts (ESM) loadable from this
+ * CommonJS build, and means the dependency is only touched on the
+ * interactive path — `notify` / `list` / scripted `install --only`
+ * never load it.
+ */
+const pickAgentsInteractive = async (detected) => {
+    const { checkbox } = await import('@inquirer/prompts');
+    const picked = await checkbox({
+        message: 'Install Zeph for which agents? (space to toggle, enter to confirm)',
+        choices: detected.map((agent) => ({
+            name: AGENT_PLAN_LABELS[agent.id] ?? agent.name,
+            value: agent.id,
+            checked: true,
+        })),
+        loop: false,
+    });
+    return detected.filter((a) => picked.includes(a.id));
+};
+/**
+ * Resolve agents from a non-interactive `--only cursor,gemini` flag.
+ * Matches on agent id; unknown ids are silently dropped. Exported for
+ * unit testing.
+ */
+const filterAgentsByIds = (detected, only) => {
+    const ids = new Set(only.split(',').map((s) => s.trim().toLowerCase()).filter(Boolean));
+    return detected.filter((a) => ids.has(a.id));
+};
+exports.filterAgentsByIds = filterAgentsByIds;
 // ── Test Connection ──────────────────────────────────────────────
 const testConnection = async (apiKey, baseUrl) => {
     try {
@@ -291,7 +337,32 @@ const handleInstall = async (args) => {
     if (detected.length === 0) {
         console.log('\n  No supported agents found. Config will still be saved.\n');
     }
-    // 2. Collect credentials
+    // 2. Choose which agents to install for — asked up front so the user
+    //    sees the choice before being walked through credential prompts.
+    let selected = detected;
+    const onlyArg = args.only?.trim();
+    if (detected.length > 0) {
+        if (onlyArg) {
+            // Non-interactive or scripted: --only cursor,gemini
+            selected = (0, exports.filterAgentsByIds)(detected, onlyArg);
+            console.log(`\n  --only ${onlyArg} → ${selected.map((a) => a.name).join(', ') || '(no match)'}`);
+        }
+        else if (nonInteractive) {
+            // Scripted run with no --only: keep the all-detected default
+            selected = detected;
+        }
+        else {
+            try {
+                selected = await pickAgentsInteractive(detected);
+            }
+            catch {
+                // Ctrl-C in the picker (or no TTY) — treat as a clean cancel.
+                console.log('\n  Cancelled.\n');
+                return 0;
+            }
+        }
+    }
+    // 3. Collect credentials
     const existing = (0, config_js_1.loadConfig)();
     let apiKey;
     let hookId;
@@ -321,33 +392,19 @@ const handleInstall = async (args) => {
         console.error('\n  Error: API key is required.\n');
         return 1;
     }
-    // 3. Confirmation (interactive only)
+    // 4. Show the resolved plan before touching anything (interactive only).
     if (!nonInteractive) {
         console.log('\n  Will do:');
-        console.log('    1. Save config to ~/.zeph/config.json');
-        let step = 2;
-        for (const agent of detected) {
-            const labels = {
-                claude: 'Install Claude Code plugin',
-                cursor: 'Setup Cursor (MCP + hooks + rules)',
-                windsurf: 'Setup Windsurf (MCP + hooks + rules)',
-                gemini: 'Setup Gemini CLI (MCP + hooks + rules)',
-                codex: 'Setup Codex CLI (hooks + rules)',
-                copilot: 'Setup Copilot CLI (hooks + rules)',
-                cline: 'Setup Cline (rules)',
-                aider: 'Setup Aider (conventions)',
-            };
-            console.log(`    ${step}. ${labels[agent.id] ?? `Install for ${agent.name}`}`);
-            step++;
+        console.log(`    - Save config to ${config_js_1.CONFIG_FILE}`);
+        for (const agent of selected) {
+            console.log(`    - ${AGENT_PLAN_LABELS[agent.id] ?? `Install for ${agent.name}`}`);
         }
-        console.log(`    ${step}. Test connection`);
-        const confirm = await promptInput('  Continue? [Y/n] ');
-        if (confirm.toLowerCase() === 'n') {
-            console.log('\n  Cancelled.\n');
-            return 0;
+        if (selected.length === 0) {
+            console.log('    (no agents selected — only the config file will be saved)');
         }
+        console.log('    - Test connection');
     }
-    // 4. Save config
+    // 5. Save config
     console.log('');
     const config = {
         apiKey,
@@ -356,14 +413,14 @@ const handleInstall = async (args) => {
     };
     (0, config_js_1.saveConfig)(config);
     ok(`Config saved to ${config_js_1.CONFIG_FILE}`);
-    // 5. Install per-agent
-    for (const agent of detected) {
+    // 6. Install for the selected agents only
+    for (const agent of selected) {
         console.log(`\n  Installing for ${agent.name}...`);
         const installer = AGENT_INSTALLERS[agent.id];
         if (installer)
             installer();
     }
-    // 6. Test connection
+    // 7. Test connection
     console.log('\n  Testing connection...');
     await testConnection(apiKey, baseUrl);
     console.log('\n  Done! Restart your agents.\n');

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@zeph-to/hook-sdk",
-  "version": "1.8.0",
-  "description": "Zeph push notification SDK + CLI — zero dependencies",
+  "version": "1.9.0",
+  "description": "Zeph push notification SDK + CLI for AI agents",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
   "exports": {
@@ -62,5 +62,8 @@
     "claude",
     "devtools"
   ],
-  "license": "Apache-2.0"
+  "license": "Apache-2.0",
+  "dependencies": {
+    "@inquirer/prompts": "^8.4.3"
+  }
 }