pendingyou 0.3.0 → 0.5.0

package/CHANGELOG.md

@@ -1,5 +1,29 @@
 # Changelog
 
+## 0.5.0
+
+- A card with several questions (guide 2.6) prints each answer on its own line when `hold` ends (and when a hook
+  hands the answer over): `1. Pay Kaiser’s invoice 09/30 for $1,200? (pay): Approved`, numbered in the card's order,
+  with the question's id as `answer.answers` has it. A question your person split out into a card of its own is named
+  with its new request id: hear its answer there.
+- When an answer is ready, the line telling Claude Code to call `ack_answer` (or `reply_in_thread`) now names the
+  session too (`name “billing-webhooks”`): since guide 2.5 the sessions sharing a computer's sign-in each act only on
+  their own cards, and pass their name to do so.
+- The next-message hook's open-cards line names the session that asked each card (`(req_…, by dns-setup)`, from
+  servers on guide 2.5, cut to 24 characters) and says to cancel only one of yours, with `answeredHere` and your name.
+
+## 0.4.0
+
+- The next-message hook's reminder now names this folder's open cards still waiting on you, so a question you answer
+  in chat gets its card cancelled: `Pending You: anything you need from your person also goes on a card. Your open
+  cards here: "Which DNS host?" (req_…); … +2 more. If this message answers or settles one, cancel_request it with
+  answeredHere (or update_request if it changed).` At most 3 cards, newest first, titles cut to 50 characters; the
+  plain reminder when none are open. One small request per message while signed in (answers too while a hold is
+  outstanding), given up after 1.5 seconds; on any error, or against a server that doesn't list open cards yet, the
+  line is the plain reminder.
+- The Stop check no longer asks Claude Code to go on when its message says a card is coming ("you'll get a card to
+  publish it once it's merged", "I'll post a card", "I'll send you a card").
+
 ## 0.3.0
 
 - New Stop hook, `pendingyou stopcheck`: when Claude Code ends a turn with a question for you, a step only you can do

package/README.md

@@ -28,9 +28,13 @@ Deep into a long conversation, Claude Code tends to end a turn with a question f
 "Your part:" list, and not put it in Pending You. Two small things catch that while you're signed in:
 
 - Each message you send carries one line for Claude Code (about 18 tokens): *Pending You: anything you need from your
-  person also goes on a card.*
+  person also goes on a card.* While cards Claude Code posted from this folder are still waiting on you, the same line
+  names them (at most 3, newest first, about 20 tokens each) and asks it to `cancel_request` one with `answeredHere`
+  when your message answers it, so a question you answer in chat doesn't stay in your queue. That costs one small
+  request per message, given up after 1.5 seconds.
 - When Claude Code finishes a turn, `pendingyou stopcheck` looks at its last message. If it has something for you and
-  nothing was posted, updated or replied to in Pending You that turn (and the message doesn't say it's on a card),
+  nothing was posted, updated or replied to in Pending You that turn (and the message doesn't say it's on a card, or
+  that one is coming),
   Claude Code is asked to go on once (about 31 tokens): post them as cards, or say they don't need one. It never asks
   twice in a row.
 

package/dist/format.js

@@ -4,8 +4,11 @@
 const MAX_ANSWER = 600;
 const MAX_MESSAGE = 400;
 const MAX_TITLE = 140;
+/** A grouped card's question and its answer, each: four of them stay well under one long answer. */
+const MAX_QUESTION = 100;
+const MAX_QUESTION_ANSWER = 300;
 /** Cuts text to `max` characters on one line, and says so. */
-function clip(text, max) {
+export function clip(text, max) {
     const flat = text.replace(/\s+/g, ' ').trim();
     const chars = [...flat];
     if (chars.length <= max)
@@ -22,6 +25,11 @@ const quoted = (text, max) => {
     const { text: clipped, cut } = clip(text, max);
     return { line: `“${clipped}”`, cut };
 };
+/**
+ * The session's name, as it asked (its session label): the card tools take it, and need it where other sessions share
+ * the sign-in (guide 2.5).
+ */
+const named = (heard) => `“${clip(heard.sessionLabel, MAX_TITLE).text}”`;
 /** Closed for good: nothing more to wait for. */
 export const isClosed = (heard) => heard.status === 'answered' ||
     heard.status === 'resolved' ||
@@ -40,12 +48,24 @@ export function describe(heard, again) {
     const lines = [];
     switch (heard.status) {
         case 'answered': {
-            const answer = clip(heard.said ?? 'Answered', MAX_ANSWER);
-            cut ||= answer.cut;
-            lines.push(`Pending You: ${id} is answered.`, question, `Answer: ${answer.text}`);
+            if (heard.answers?.length) {
+                // One line per question, so each answer reads against its own question (and its id, as answer.answers has it).
+                lines.push(`Pending You: ${id} is answered, all ${heard.answers.length} questions.`, question);
+                for (const [index, each] of heard.answers.entries()) {
+                    const asked = clip(each.title, MAX_QUESTION);
+                    const answer = clip(each.said, MAX_QUESTION_ANSWER);
+                    cut ||= asked.cut || answer.cut;
+                    lines.push(`${index + 1}. ${asked.text} (${each.questionId}): ${answer.text}`);
+                }
+            }
+            else {
+                const answer = clip(heard.said ?? 'Answered', MAX_ANSWER);
+                cut ||= answer.cut;
+                lines.push(`Pending You: ${id} is answered.`, question, `Answer: ${answer.text}`);
+            }
             if (wrote.length)
                 lines.push(`They also wrote: ${wrote.join(' ')}`);
-            lines.push(`Act on it, then call ack_answer with requestId ${id}, expectedVersion ${heard.version} and a one-line outcome.`);
+            lines.push(`Act on it, then call ack_answer with requestId ${id}, name ${named(heard)}, expectedVersion ${heard.version} and a one-line outcome.`);
             break;
         }
         case 'expired':
@@ -59,12 +79,17 @@ export function describe(heard, again) {
             break;
         default:
             if (heard.turn === 'agent') {
-                lines.push(`Pending You: they wrote back on ${id}.`, question, `They wrote: ${wrote.join(' ') || '(a follow-up; call get_request to read it)'}`, `Answer with reply_in_thread (requestId ${id}), then ${again}.`);
+                lines.push(`Pending You: they wrote back on ${id}.`, question, `They wrote: ${wrote.join(' ') || '(a follow-up; call get_request to read it)'}`, `Answer with reply_in_thread (requestId ${id}, name ${named(heard)}), then ${again}.`);
             }
             else {
                 lines.push(`Pending You: ${id} is still waiting for them (${heard.status}).`, question);
             }
     }
+    // Questions split out of a grouped card are cards of their own now, with answers of their own.
+    if (heard.splits?.length && heard.status !== 'cancelled' && heard.status !== 'resolved')
+        lines.push(`They split ${heard.splits
+            .map((split) => `“${clip(split.title, MAX_QUESTION).text}” (${split.requestId})`)
+            .join(', ')} out into ${heard.splits.length === 1 ? 'a card of its own' : 'cards of their own'}: hear ${heard.splits.length === 1 ? 'its answer' : 'their answers'} there.`);
     if (cut)
         lines.push(`(Cut short: get_request ${id} has all of it.)`);
     return lines;

package/dist/pickup.js

@@ -3,19 +3,54 @@
 // - `pendingyou pickup` (SessionStart): a new or resumed session picks up answers that arrived while nothing was
 //   running, for questions asked from this folder.
 // - `pendingyou handoff` (UserPromptSubmit): your next message brings a waiting answer with it ("You answered in
-//   Pending You: …"). It only calls Pending You while a hold from this computer is outstanding, so an ordinary message
-//   costs no network call. While signed in, it also adds one short line (REMINDER) to every message, so an assistant
-//   deep in a long conversation still puts what it needs from the person on a card.
+//   Pending You: …"). While signed in, it also adds one short line (REMINDER) to every message, so an assistant
+//   deep in a long conversation still puts what it needs from the person on a card, and that line names this folder's
+//   cards still waiting on the person (openLine), so one they answer in chat gets cancelled with answeredHere. That's
+//   one small request per message (the open cards, and answers too while a hold from this computer is outstanding),
+//   time-boxed short; on any error, or from a server too old to list open cards, the line is the plain reminder.
 //
 // Whatever they print, Claude Code adds to the conversation. A hook must never get in the way: each is time-boxed,
 // prints nothing when there's nothing new, never repeats an answer it handed over, and always exits 0.
 import { getJson, SignInNeeded } from "./api.js";
 import { readCredential } from "./credentials.js";
-import { describe, isClosed } from "./format.js";
+import { clip, describe, isClosed } from "./format.js";
 import { markHanded, momentOf, waitingOn, wasHanded } from "./state.js";
-const TIME_BOX_MS = { pickup: 5000, handoff: 2500 };
+const TIME_BOX_MS = { pickup: 5000, handoff: 2500, open: 1500 };
 /** What every message carries while signed in (about 18 tokens). */
 export const REMINDER = 'Pending You: anything you need from your person also goes on a card.';
+/** The most open cards the line names, and how much of each title. */
+export const OPEN_SHOWN = 3;
+export const OPEN_TITLE = 50;
+/** How much of the asking session's name each card shows. */
+export const OPEN_NAME = 24;
+/**
+ * The reminder, naming this folder's open cards still waiting on the person when there are any (about 45 tokens plus
+ * 20 a card): `… Your open cards here: "Which DNS host?" (req_…); … +2 more. If this message answers …`.
+ */
+export function openLine(open) {
+    if (typeof open !== 'object' || open === null)
+        return REMINDER;
+    const { requests, total } = open;
+    if (!Array.isArray(requests))
+        return REMINDER;
+    const cards = requests
+        .filter((card) => typeof card?.requestId === 'string' &&
+        /^req_[A-Za-z0-9-]{1,40}$/.test(card.requestId) &&
+        typeof card.title === 'string')
+        .slice(0, OPEN_SHOWN);
+    if (cards.length === 0)
+        return REMINDER;
+    const more = typeof total === 'number' && total > cards.length ? total - cards.length : 0;
+    const named = cards
+        .map((card) => {
+        const by = typeof card.name === 'string' && card.name.trim()
+            ? `, by ${clip(card.name.replaceAll('"', "'"), OPEN_NAME).text}`
+            : '';
+        return `"${clip(card.title.replaceAll('"', "'"), OPEN_TITLE).text}" (${card.requestId}${by})`;
+    })
+        .join('; ');
+    return `${REMINDER} Your open cards here: ${named}${more ? ` +${more} more` : ''}. If this message answers or settles one of yours, cancel_request it with answeredHere and your name (or update_request if it changed).`;
+}
 /** The folder Claude Code says the session is in (the hook's stdin), or where this runs. */
 async function sessionFolder(io) {
     const text = await io.readStdin(500).catch(() => '');
@@ -38,19 +73,28 @@ export function folderForms(cwd, home) {
 export async function pickup(io, options) {
     const { origin, mode } = options;
     let remind = false;
+    let line = REMINDER;
     try {
         const cwd = await sessionFolder(io);
+        // The hand-off hears answers only while a hold from this computer is outstanding; it always asks for open cards.
+        let answers = true;
         if (mode === 'handoff') {
             remind = (await readCredential(io, origin)) !== null;
-            if ((await waitingOn(io, origin)).length === 0)
+            if (!remind)
                 return 0;
+            answers = (await waitingOn(io, origin)).length > 0;
         }
         const query = new URLSearchParams([
             ...folderForms(cwd, io.home).map((form) => ['cwd', form]),
-            ['limit', '5'],
+            ['limit', answers ? '5' : '0'],
+            ...(mode === 'handoff' ? [['open', String(OPEN_SHOWN)]] : []),
         ]);
-        const { status, body } = await getJson(io, origin, `/mcp/cli/answers?${query}`, TIME_BOX_MS[mode], io.signal);
-        if (status !== 200 || !Array.isArray(body.requests))
+        const { status, body } = await getJson(io, origin, `/mcp/cli/answers?${query}`, answers ? TIME_BOX_MS[mode] : TIME_BOX_MS.open, io.signal);
+        if (status !== 200)
+            return 0;
+        if (mode === 'handoff')
+            line = openLine(body.open);
+        if (!answers || !Array.isArray(body.requests))
             return 0;
         const fresh = [];
         for (const heard of body.requests)
@@ -83,6 +127,6 @@ export async function pickup(io, options) {
     }
     finally {
         if (remind)
-            io.out(`${REMINDER}\n`);
+            io.out(`${line}\n`);
     }
 }

package/dist/stopcheck.js

@@ -14,8 +14,11 @@ const CHUNK = 64 * 1024;
 export const STOP_REASON = 'Items for your person are in chat but not in Pending You: post them as cards (ask in both places), or say they don’t need one.';
 /** Tools that put something in front of the person: Pending You's, under any MCP server name. */
 const POSTING_TOOL = /^mcp__.+__(post_request|update_request|reply_in_thread)$/;
-/** Text that says the items are already in Pending You. */
-const SAYS_POSTED = /\b(posted|put|added|raised|filed)\b[^.\n]{0,60}\b(cards?|pending ?you)\b|\bon (a|the|its|their|your|that|this) cards?\b|\b(in|to|through|via|on) pending ?you\b|\bpending ?you cards?\b/i;
+/**
+ * Text that says the items are already in Pending You, or will be: "you'll get a card to publish it once it's merged"
+ * announces a card to come, not a step left in chat.
+ */
+const SAYS_POSTED = /\b(posted|put|added|raised|filed)\b[^.\n]{0,60}\b(cards?|pending ?you)\b|\bon (a|the|its|their|your|that|this) cards?\b|\b(in|to|through|via|on) pending ?you\b|\bpending ?you cards?\b|\b(i|we|you)(?:(?:'|’)ll| will)\s+(?:\w+\s+)?(post|send|put|add|raise|file|get|see|find)\b[^.\n]{0,40}\bcards?\b/i;
 /** Steps only the person can take, said to them. */
 const STEPS_FOR_THEM = /\b(you(?:'|’)ll need to|you will need to|you(?:'|’)ll have to|you will have to|your (?:next )?steps?\b|can you|could you|would you mind|please (?:run|confirm|approve|check|add|set|sign|create|open|paste|reply|send|choose|pick|decide|let me know)|in your terminal|only you can|waiting on you|waiting for you|needs? you to|over to you|parked for you|when you(?:'|’)re ready|up to you|your call\b|is yours\b|say the word|let me know (?:which|whether)|tell me (?:which|whether)|needs? your (?:ok|okay|approval|decision|sign-?off|go-ahead))/i;
 /** A heading over a list of things for the person. */

package/dist/version.js

@@ -1,2 +1,2 @@
 // The command line's version, as published (package.json). A test keeps them the same.
-export const VERSION = '0.3.0';
+export const VERSION = '0.5.0';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pendingyou",
-  "version": "0.3.0",
+  "version": "0.5.0",
   "description": "Pending You for Claude Code: hear your answers from Pending You in the background, and set Claude Code up in one command.",
   "license": "Apache-2.0",
   "homepage": "https://www.pendingyou.com",