@zeph-to/mcp-server 1.2.0 → 1.2.2

package/README.md

@@ -48,11 +48,13 @@ Add to `~/.claude/settings.json`:
 
 | Variable | Required | Description |
 |----------|----------|-------------|
-| `ZEPH_API_KEY` | Yes | API key from Settings > API Keys |
+| `ZEPH_API_KEY` | Yes* | API key from Settings > API Keys |
 | `ZEPH_HOOK_ID` | No | Hook ID for interactive tools (`zeph_prompt`, `zeph_input`) |
 | `ZEPH_DEVICE_ID` | No | Target device ID. Omit to send to all devices |
 | `ZEPH_BASE_URL` | No | API base URL (default: `https://api.zeph.to/v1`) |
 
+\* All env vars fall back to `~/.zeph/config.json` if not set or if the value is an unresolved `${...}` interpolation.
+
 ## Tools
 
 ### zeph_notify

package/dist/api-client.js

@@ -57,7 +57,7 @@ class ZephApiClient {
     async uploadToS3(url, content, contentType) {
         const response = await fetch(url, {
             method: 'PUT',
-            headers: { 'Content-Type': contentType },
+            headers: { 'Content-Type': `${contentType}; charset=utf-8` },
             body: content,
             signal: AbortSignal.timeout(DEFAULT_TIMEOUT_MS),
         });

package/dist/config.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAKA,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAkBD,eAAO,MAAM,UAAU,QAAO,eAgB7B,CAAC"}
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAKA,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAuBD,eAAO,MAAM,UAAU,QAAO,eAgB7B,CAAC"}

package/dist/config.js

@@ -4,6 +4,10 @@ exports.loadConfig = void 0;
 const fs_1 = require("fs");
 const path_1 = require("path");
 const DEFAULT_BASE_URL = 'https://api.zeph.to/v1';
+const resolvedEnv = (key) => {
+    const val = process.env[key];
+    return val && !val.startsWith('${') ? val : undefined;
+};
 const loadFileConfig = () => {
     try {
         const configPath = (0, path_1.join)(process.env.HOME ?? '~', '.zeph', 'config.json');
@@ -15,15 +19,15 @@ const loadFileConfig = () => {
 };
 const loadConfig = () => {
     const fileConfig = loadFileConfig();
-    const apiKey = process.env['ZEPH_API_KEY'] || fileConfig.apiKey;
+    const apiKey = resolvedEnv('ZEPH_API_KEY') ?? fileConfig.apiKey;
     if (!apiKey) {
         throw new Error('ZEPH_API_KEY not found. Run "npx @zeph-to/hook-sdk install" or set ZEPH_API_KEY env var.');
     }
     return {
         apiKey,
-        baseUrl: (process.env['ZEPH_BASE_URL'] ?? fileConfig.baseUrl ?? DEFAULT_BASE_URL).replace(/\/$/, ''),
-        hookId: process.env['ZEPH_HOOK_ID'] || fileConfig.hookId,
-        deviceId: process.env['ZEPH_DEVICE_ID'] || fileConfig.deviceId,
+        baseUrl: (resolvedEnv('ZEPH_BASE_URL') ?? fileConfig.baseUrl ?? DEFAULT_BASE_URL).replace(/\/$/, ''),
+        hookId: resolvedEnv('ZEPH_HOOK_ID') ?? fileConfig.hookId,
+        deviceId: resolvedEnv('ZEPH_DEVICE_ID') ?? fileConfig.deviceId,
     };
 };
 exports.loadConfig = loadConfig;

package/dist/error-format.js

@@ -35,7 +35,7 @@ const formatToolError = (err) => {
             toolError.suggestion = 'Monthly quota exceeded. Upgrade plan for higher limits';
         }
         else if (err.code === 'UNAUTHORIZED') {
-            toolError.suggestion = 'Check ZEPH_API_KEY environment variable';
+            toolError.suggestion = 'Check ZEPH_API_KEY environment variable or ~/.zeph/config.json';
         }
         else if (err.code === 'HOOK_DISABLED') {
             toolError.suggestion = 'Enable the Hook in Settings → Hooks';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zeph-to/mcp-server",
-  "version": "1.2.0",
+  "version": "1.2.2",
   "description": "Zeph MCP server — AI agent notifications, prompts, and input via MCP protocol",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",