ping-a-human 0.1.2 → 0.1.3

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (2) hide show
  1. package/dist/index.js +2 -2
  2. package/package.json +1 -1
package/dist/index.js CHANGED
@@ -21,12 +21,12 @@ export function createServer(channelOptions = {}) {
21
21
  // 1.x registerTool: inputSchema is a ZodRawShape (plain object), NOT z.object(...).
22
22
  server.registerTool("notify_human", {
23
23
  title: "Notify human",
24
- description: "Send a fire-and-forget message to the configured human (via Telegram) and return immediately without waiting for a reply.",
24
+ 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.",
25
25
  inputSchema: { message: z.string() },
26
26
  }, async ({ message }) => notifyHuman(resolveChannel(), { message }));
27
27
  server.registerTool("ask_human", {
28
28
  title: "Ask human",
29
- 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.",
29
+ 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.",
30
30
  inputSchema: {
31
31
  question: z.string(),
32
32
  choices: z.array(z.string()).optional(),
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "ping-a-human",
3
- "version": "0.1.2",
3
+ "version": "0.1.3",
4
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).",
5
5
  "type": "module",
6
6
  "bin": {