@zeph-to/hook-sdk 1.1.0 → 1.2.0

package/README.md

@@ -157,6 +157,20 @@ try {
 }
 ```
 
+## Supported Agents
+
+`zeph install` detects and configures these agents automatically:
+
+| Agent | What gets installed |
+|-------|-------------------|
+| Claude Code | Plugin (hooks + MCP server) |
+| Cursor | MCP server + stop hook + rules |
+| Windsurf | MCP server + response hook |
+| Gemini CLI | MCP server + AfterAgent hook |
+| Codex CLI | Stop hook |
+| Copilot CLI | Session end hook |
+| Cline | Rules file |
+
 ## Requirements
 
 - Node.js >= 18 (uses native `fetch`)

package/dist/installer.js

@@ -71,13 +71,13 @@ const injectMcpJson = (filePath) => {
 };
 const installClaude = () => {
     try {
-        (0, child_process_1.execSync)('claude plugin marketplace add zeph-to/agent-plugin', { stdio: 'pipe' });
+        (0, child_process_1.execSync)('claude plugin marketplace add zeph-to/plugin', { stdio: 'pipe' });
         (0, child_process_1.execSync)('claude plugin install zeph@zeph', { stdio: 'pipe' });
         ok('Plugin installed');
     }
     catch {
         fail('Plugin install failed. Manual:');
-        console.log('      claude plugin marketplace add zeph-to/agent-plugin');
+        console.log('      claude plugin marketplace add zeph-to/plugin');
         console.log('      claude plugin install zeph@zeph');
     }
 };

package/dist/types.d.ts

@@ -13,6 +13,19 @@ export interface NotifyPayload {
 }
 export interface NotifyResult {
     pushId: string;
+    fileKey?: string;
+    autoFile?: boolean;
+}
+export interface FileAttachment {
+    fileKey: string;
+    fileName: string;
+    fileSize: number;
+    fileType: string;
+}
+export interface UploadRequestResult {
+    fileId: string;
+    fileKey: string;
+    uploadUrl: string;
 }
 export interface ListParams {
     limit?: number;

package/dist/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,WAAW;IAC1B,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,aAAa;IAC5B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,GAAG,MAAM,CAAC;IACzC,QAAQ,CAAC,EAAE,KAAK,GAAG,QAAQ,GAAG,MAAM,GAAG,QAAQ,CAAC;IAChD,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,UAAU;IACzB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,GAAG,WAAW,GAAG,MAAM,CAAC;CACxD;AAED,MAAM,WAAW,QAAQ;IACvB,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,UAAU;IACzB,MAAM,EAAE,QAAQ,EAAE,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,WAAW,gBAAgB;IAC/B,SAAS,EAAE,IAAI,CAAC;CACjB;AAED,MAAM,WAAW,gBAAgB;IAC/B,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE;QACL,IAAI,EAAE,MAAM,CAAC;QACb,OAAO,EAAE,MAAM,CAAC;QAChB,MAAM,EAAE,MAAM,CAAC;KAChB,CAAC;CACH"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,WAAW;IAC1B,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,aAAa;IAC5B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,GAAG,MAAM,CAAC;IACzC,QAAQ,CAAC,EAAE,KAAK,GAAG,QAAQ,GAAG,MAAM,GAAG,QAAQ,CAAC;IAChD,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,mBAAmB;IAClC,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,UAAU;IACzB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,GAAG,WAAW,GAAG,MAAM,CAAC;CACxD;AAED,MAAM,WAAW,QAAQ;IACvB,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,UAAU;IACzB,MAAM,EAAE,QAAQ,EAAE,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,WAAW,gBAAgB;IAC/B,SAAS,EAAE,IAAI,CAAC;CACjB;AAED,MAAM,WAAW,gBAAgB;IAC/B,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE;QACL,IAAI,EAAE,MAAM,CAAC;QACb,OAAO,EAAE,MAAM,CAAC;QAChB,MAAM,EAAE,MAAM,CAAC;KAChB,CAAC;CACH"}

package/dist/zeph-hook.d.ts

@@ -1,10 +1,17 @@
-import type { ZephOptions, NotifyPayload, NotifyResult, ListParams, ListResult, DismissOneResult, DismissAllResult } from './types.js';
+import type { ZephOptions, NotifyPayload, NotifyResult, ListParams, ListResult, DismissOneResult, DismissAllResult, UploadRequestResult } from './types.js';
 export declare class ZephHook {
     private readonly apiKey;
     private readonly baseUrl;
     private readonly timeoutMs;
     constructor(options: ZephOptions);
     notify(payload: NotifyPayload): Promise<NotifyResult>;
+    private notifyWithFile;
+    requestUpload(params: {
+        fileName: string;
+        fileType: string;
+        fileSize: number;
+    }): Promise<UploadRequestResult>;
+    uploadToS3(url: string, content: string, contentType: string): Promise<void>;
     list(params?: ListParams): Promise<ListResult>;
     dismiss(pushId: string): Promise<DismissOneResult>;
     dismissAll(): Promise<DismissAllResult>;

package/dist/zeph-hook.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"zeph-hook.d.ts","sourceRoot":"","sources":["../src/zeph-hook.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,aAAa,EAAE,YAAY,EAAE,UAAU,EAAE,UAAU,EAAY,gBAAgB,EAAE,gBAAgB,EAAoB,MAAM,YAAY,CAAC;AAMnK,qBAAa,QAAQ;IACnB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;gBAEvB,OAAO,EAAE,WAAW;IAS1B,MAAM,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,YAAY,CAAC;IASrD,IAAI,CAAC,MAAM,CAAC,EAAE,UAAU,GAAG,OAAO,CAAC,UAAU,CAAC;IAmB9C,OAAO,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAKlD,UAAU,IAAI,OAAO,CAAC,gBAAgB,CAAC;YAK/B,OAAO;IAiCrB,OAAO,CAAC,UAAU;CASnB"}
+{"version":3,"file":"zeph-hook.d.ts","sourceRoot":"","sources":["../src/zeph-hook.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,aAAa,EAAE,YAAY,EAAE,UAAU,EAAE,UAAU,EAAY,gBAAgB,EAAE,gBAAgB,EAAoB,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAcxL,qBAAa,QAAQ;IACnB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;gBAEvB,OAAO,EAAE,WAAW;IAS1B,MAAM,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,YAAY,CAAC;YAiB7C,cAAc;IAsBtB,aAAa,CAAC,MAAM,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,mBAAmB,CAAC;IAK7G,UAAU,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAY5E,IAAI,CAAC,MAAM,CAAC,EAAE,UAAU,GAAG,OAAO,CAAC,UAAU,CAAC;IAmB9C,OAAO,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAKlD,UAAU,IAAI,OAAO,CAAC,gBAAgB,CAAC;YAK/B,OAAO;IAiCrB,OAAO,CAAC,UAAU;CASnB"}

package/dist/zeph-hook.js

@@ -4,6 +4,13 @@ exports.ZephHook = void 0;
 const errors_js_1 = require("./errors.js");
 const DEFAULT_BASE_URL = 'https://api.zeph.to/v1';
 const DEFAULT_TIMEOUT_MS = 30_000;
+const BODY_FILE_THRESHOLD = 1024;
+const PREVIEW_LENGTH = 200;
+const inferMimeType = (fileName) => {
+    const ext = fileName.split('.').pop()?.toLowerCase();
+    const map = { md: 'text/markdown', txt: 'text/plain', json: 'application/json' };
+    return map[ext ?? ''] ?? 'text/plain';
+};
 class ZephHook {
     apiKey;
     baseUrl;
@@ -17,6 +24,12 @@ class ZephHook {
         this.timeoutMs = options.timeout ?? DEFAULT_TIMEOUT_MS;
     }
     async notify(payload) {
+        const body = payload.body;
+        const bodyBytes = body ? new TextEncoder().encode(body).byteLength : 0;
+        const isLongBody = bodyBytes > BODY_FILE_THRESHOLD;
+        if (isLongBody && body) {
+            return this.notifyWithFile(payload, body, bodyBytes);
+        }
         const json = await this.request('POST', '/pushes/send', payload);
         const pushId = json.data?.pushId;
         if (!pushId) {
@@ -24,6 +37,39 @@ class ZephHook {
         }
         return { pushId };
     }
+    async notifyWithFile(payload, body, fileSize) {
+        const fileName = 'response.md';
+        const fileType = inferMimeType(fileName);
+        const upload = await this.requestUpload({ fileName, fileType, fileSize });
+        await this.uploadToS3(upload.uploadUrl, body, fileType);
+        const preview = body.length > PREVIEW_LENGTH ? body.slice(0, PREVIEW_LENGTH) + '...' : body;
+        const json = await this.request('POST', '/pushes/send', {
+            ...payload,
+            body: preview,
+            type: 'file',
+            files: [{ fileKey: upload.fileKey, fileName, fileSize, fileType }],
+        });
+        const pushId = json.data?.pushId;
+        if (!pushId) {
+            throw new errors_js_1.ZephError('Server returned no pushId', 'INVALID_RESPONSE', 500);
+        }
+        return { pushId, fileKey: upload.fileKey, autoFile: true };
+    }
+    async requestUpload(params) {
+        const json = await this.request('POST', '/files/upload-request', params);
+        return json.data;
+    }
+    async uploadToS3(url, content, contentType) {
+        const response = await fetch(url, {
+            method: 'PUT',
+            headers: { 'Content-Type': contentType },
+            body: content,
+            signal: AbortSignal.timeout(this.timeoutMs),
+        });
+        if (!response.ok) {
+            throw new errors_js_1.ZephError(`S3 upload failed with status ${response.status}`, 'UPLOAD_FAILED', response.status);
+        }
+    }
     async list(params) {
         const query = new URLSearchParams();
         if (params?.limit)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zeph-to/hook-sdk",
-  "version": "1.1.0",
+  "version": "1.2.0",
   "description": "Zeph push notification SDK + CLI — zero dependencies",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",