ping-a-human 0.1.2 → 0.1.4

package/dist/index.d.ts

@@ -1,12 +1,4 @@
 #!/usr/bin/env node
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 import { type CreateChannelOptions } from "./channel-factory.js";
-/**
- * Build the MCP server with notify_human and ask_human registered.
- *
- * The Channel is resolved lazily (per tool call) via {@link createChannel} so
- * the server still boots without configuration; a missing/invalid config
- * surfaces as a tool error result instead of crashing at startup. Tests inject
- * a stub Channel through `channelOptions.channel`.
- */
 export declare function createServer(channelOptions?: CreateChannelOptions): McpServer;

package/dist/index.js

@@ -1,7 +1,8 @@
 #!/usr/bin/env node
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
-import { realpathSync } from "node:fs";
+import { readFileSync, realpathSync } from "node:fs";
+import { dirname, join } from "node:path";
 import { fileURLToPath } from "node:url";
 import { z } from "zod";
 import { createChannel } from "./channel-factory.js";
@@ -15,18 +16,30 @@ import { runSetup } from "./setup.js";
  * surfaces as a tool error result instead of crashing at startup. Tests inject
  * a stub Channel through `channelOptions.channel`.
  */
+/** Read this package's version from package.json so MCP serverInfo never drifts. */
+function packageVersion() {
+    try {
+        const here = dirname(fileURLToPath(import.meta.url));
+        // dist/index.js -> ../package.json
+        const pkg = JSON.parse(readFileSync(join(here, "..", "package.json"), "utf8"));
+        return pkg.version ?? "0.0.0";
+    }
+    catch {
+        return "0.0.0";
+    }
+}
 export function createServer(channelOptions = {}) {
-    const server = new McpServer({ name: "ping-a-human", version: "0.1.0" });
+    const server = new McpServer({ name: "ping-a-human", version: packageVersion() });
     const resolveChannel = () => createChannel(channelOptions);
     // 1.x registerTool: inputSchema is a ZodRawShape (plain object), NOT z.object(...).
     server.registerTool("notify_human", {
         title: "Notify human",
-        description: "Send a fire-and-forget message to the configured human (via Telegram) and return immediately without waiting for a reply.",
+        description: "Send a one-way, fire-and-forget message to the configured human (via Telegram) and return IMMEDIATELY. Use this ONLY to inform the human (status updates, 'task finished', 'deploy succeeded', FYIs) when you do NOT need anything back. The human's reply, if any, is NOT captured or returned. If you need a decision, approval, or any answer before continuing, DO NOT use this — use ask_human instead.",
         inputSchema: { message: z.string() },
     }, async ({ message }) => notifyHuman(resolveChannel(), { message }));
     server.registerTool("ask_human", {
         title: "Ask human",
-        description: "Send a question to the configured human and block until they reply (or a timeout elapses). Optionally provide choices to render tappable buttons. Returns the human's answer, or a clear timed-out result.",
+        description: "Ask the configured human a question and BLOCK until they reply on their messaging app (Telegram) or a timeout elapses. Use this whenever you need a human decision, approval, confirmation, clarification, or any answer before you can continue — the human's reply is captured and returned to you. Optionally provide `choices` to render tappable buttons (the tapped value is returned). Returns the human's answer, or a clear timed-out result if they don't respond in time. If you only need to inform the human and do NOT need a response, use notify_human instead.",
         inputSchema: {
             question: z.string(),
             choices: z.array(z.string()).optional(),

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ping-a-human",
-  "version": "0.1.2",
+  "version": "0.1.4",
   "description": "An MCP server that adds a human-in-the-loop step to any AI pipeline by reaching a human on their own messaging app (Telegram first).",
   "type": "module",
   "bin": {