pendingyou 0.35.0 → 0.36.0

package/CHANGELOG.md

@@ -1,5 +1,33 @@
 # Changelog
 
+## 0.36.0 (2026-10-19)
+
+- Your agents' answers to your questions land in Pending You too (guide 2.54). When you ask an agent something and
+  its last message answers it (30 words or more outside code, or a table) but it posted nothing to Pending You that
+  turn, the check at the end of its turn asks it once: “Your person asked you something and your answer is only in
+  chat: post_answer it too, or say it doesn’t need one.” Your question is read from your own message that started the
+  turn, leniently, since dictation often has no “?”: “pending you how many calls did billing get last week” counts.
+  A request for work doesn't (“Can you fix the flaky test?”, “Deploy it to staging”, “When you're done, push it”),
+  nor anything under four words without a “?”, nor a turn Pending You started. Pattern matching only, on your
+  computer, as before. Claude Code reads your message from its transcript; Codex's next-message hook notes whether it
+  asked (never your words), OpenCode's plugin reads the turn's first message, and Pi's extension hands over the
+  prompt that started the run.
+- Your next message marks the answers that session posted as read in Pending You, so they leave your Pending without
+  notifying you: you've seen them in the chat. Only that session's own, posted before your message, and only when it
+  posted one in the last day. It goes beside the hand-off's request, inside its 2 seconds, prints nothing, and
+  changes nothing if it fails.
+- Codex: `init` gives the hook for Pending You's tools post_answer, which changes it, so trust it again in Codex's
+  `/hooks` (init and status say how). Until then the check for an answer left in chat stays off there.
+- `post_answer` counts as a card call: the end-of-turn checks see it, and Codex's hook, OpenCode's plugin and Pi's
+  extension remember the answer for the session, so a Reply on it wakes the session there as an answer does. In
+  Claude Code a Reply comes with your next message, or at the next session start.
+
+- Fixed: the Pending You popup in Herdr no longer breaks on a kind of card it doesn't know yet (or a grouped card with
+  a question of such a kind). It shows the card and says "Answer this one in Pending You: o opens it."; reply, Later,
+  hand over and open still work.
+- The person API client inside the command line follows the SDK's 0.2.0 types: the enums in what /v1 sends are open
+  (any string beside the known values), since /v1 adds values over time.
+
 ## 0.35.0 (2026-10-09)
 
 - Claude Code hears a question handed to it within seconds. When you delegate a card to one of your Claude Code agents

package/README.md

@@ -234,6 +234,28 @@ it or hand it back instead (about 45 tokens). Codex's hook for Pending You's too
 tools, which doesn't name those two, so there the check knows only that the turn started with one (when Codex gives the
 message to its next-message hook), and says “unless you already did”.
 
+### Answers to your questions (0.36.0)
+
+When you ask an agent something and it answers, the answer goes in Pending You too (`post_answer`, guide 2.54): it
+waits in your Pending under your question, quiet while you're in the chat. Two things help:
+
+- **At the end of a turn**, when your own message started it and asked something, its last message answers it (30
+  words or more outside code, or a table, and not only a recap of cards), and nothing was posted to Pending You in
+  that turn, the agent is asked once (about 29 tokens): *Your person asked you something and your answer is only in
+  chat: post_answer it too, or say it doesn’t need one.* Your question is read leniently, since dictation often has
+  no "?": a "?" in its first sentence or one of its last three, a question word and three more words ("pending you how
+  many calls did billing get last week"), or asking for facts ("tell me what broke", "how many", "check whether"). Not
+  a request for work ("Can you fix the flaky test?", "Deploy it to staging", "When you're done, push it", "Do the
+  migration"), anything under four words without a "?" ("yes", "go on"), or a turn Pending You started. Claude Code's
+  question comes from its transcript; Codex's next-message hook notes whether it asked (never your words), and the
+  check stays off on a computer until `init` has given Codex's hook for Pending You's tools `post_answer` and you've
+  trusted it again in `/hooks`; OpenCode's plugin reads the turn's first message, and Pi's extension hands over the
+  prompt that started the run.
+- **Your next message** in that session marks the answers it posted as read in Pending You (`POST /mcp/cli/read`), so
+  they leave your Pending without a notification: you've seen them in the chat. Only that session's own, posted before
+  your message, and only when it posted one in the last day; beside the hand-off's request, inside its 2 seconds. It
+  prints nothing, and when it fails nothing changes: an unread answer notifies you once, after your hand-off time.
+
 **On 0.2.0 with another origin?** Its hooks blocked every message (`There's no "--origin" command`). Run
 `npx pendingyou@latest init --origin <url>` again to repair them; see [CHANGELOG.md](CHANGELOG.md).
 

package/dist/apps/codex-wake.js

@@ -27,10 +27,10 @@ const REQUEST_ID = /^req_[A-Za-z0-9-]{1,40}$/;
 export const THREAD = /^[A-Za-z0-9][A-Za-z0-9_-]{0,99}$/;
 const HANDED = '_handed';
 const NAMES = 5;
-const MCP_CARD_TOOL = /^mcp__([A-Za-z0-9_]*pendingyou[A-Za-z0-9_]*)__(post_request|update_request|reply_in_thread|cancel_request|answer_delegated|hand_back)$/i;
+const MCP_CARD_TOOL = /^mcp__([A-Za-z0-9_]*pendingyou[A-Za-z0-9_]*)__(post_request|post_answer|update_request|reply_in_thread|cancel_request|answer_delegated|hand_back)$/i;
 const CARD_TOOLS = {
     codex: MCP_CARD_TOOL,
-    opencode: /^([A-Za-z0-9_-]*pendingyou[A-Za-z0-9_-]*)_(post_request|update_request|reply_in_thread|cancel_request|answer_delegated|hand_back)$/i,
+    opencode: /^([A-Za-z0-9_-]*pendingyou[A-Za-z0-9_-]*)_(post_request|post_answer|update_request|reply_in_thread|cancel_request|answer_delegated|hand_back)$/i,
     pi: MCP_CARD_TOOL,
 };
 const HELPER_CALLS = new Set(['answer_delegated', 'hand_back']);
@@ -58,6 +58,9 @@ function threadOf(value) {
         ...(names.length ? { names: names.slice(-NAMES) } : {}),
         ...(typeof value.cwd === 'string' && value.cwd ? { cwd: value.cwd } : {}),
         ...(typeof value.herdr === 'string' && PANE_ID.test(value.herdr) ? { herdr: value.herdr } : {}),
+        ...(typeof value.answeredAt === 'number' && Number.isFinite(value.answeredAt)
+            ? { answeredAt: value.answeredAt }
+            : {}),
     };
 }
 async function load(io, app) {
@@ -192,6 +195,8 @@ export async function posted(io, options) {
                 waiting.cwd = cwd;
             if (pane)
                 waiting.herdr = pane.pane;
+            if (call === 'post_answer' && requestId)
+                waiting.answeredAt = now;
             waiting.origin = options.origin;
             waiting.at = now;
             state.threads[thread] = waiting;
@@ -287,6 +292,17 @@ export async function threadCards(io, app, thread) {
     const cards = (await load(io, app).catch(() => null))?.threads[thread]?.cards ?? {};
     return Object.keys(cards).filter((id) => REQUEST_ID.test(id));
 }
+export async function threadAnsweredAt(io, app, thread) {
+    if (!thread)
+        return null;
+    return (await load(io, app).catch(() => null))?.threads[thread]?.answeredAt ?? null;
+}
+export async function markAskedTurn(io, turn, app) {
+    const now = io.now();
+    await change(io, app, (state) => {
+        state.turns[turn] = { ...(state.turns[turn] ?? { cards: [] }), at: now, asked: true };
+    });
+}
 export async function markHandedTurn(io, turn, app) {
     const now = io.now();
     await change(io, app, (state) => {
@@ -346,6 +362,7 @@ export async function turnRecord(io, turn, app = 'codex') {
             cards: Array.isArray(record.cards) ? record.cards : [],
             nudged: record.nudged === true,
             delegated: record.delegated === true,
+            asked: record.asked === true,
         }
         : null;
 }

package/dist/apps/codex.js

@@ -37,7 +37,8 @@ export function trustSteps(found) {
     ];
 }
 const DONT_SAVE = 'In the Codex app, don’t press Save on pendingyou in Settings › MCP: that writes it again without this computer’s sign-in (if you did, run init again to put it back).';
-const CARD_TOOLS = '^mcp__pendingyou__(post_request|update_request|reply_in_thread|cancel_request)$';
+const CARD_TOOLS = '^mcp__pendingyou__(post_request|post_answer|update_request|reply_in_thread|cancel_request)$';
+const POST_ANSWER = 'mcp__pendingyou__post_answer';
 export const CODEX_HOOKS = [
     { event: 'SessionStart', sub: 'pickup', matcher: 'startup|resume|clear' },
     { event: 'UserPromptSubmit', sub: 'handoff' },
@@ -210,6 +211,22 @@ async function readHookTrust(io) {
     });
 }
 const untrusted = async (io) => (await readHookTrust(io)).filter((hook) => hook.trust === 'untrusted' || hook.trust === 'changed');
+export async function codexSeesAnswers(io) {
+    try {
+        const file = await readHooksFile(io);
+        if (!('json' in file))
+            return false;
+        const hooks = file.json.hooks && typeof file.json.hooks === 'object' ? file.json.hooks : {};
+        const groups = Array.isArray(hooks.PostToolUse) ? hooks.PostToolUse : [];
+        const ours = groups.find((group) => (group?.hooks ?? []).some((hook) => isOurHook(hook?.command, 'posted')));
+        if (typeof ours?.matcher !== 'string' || !new RegExp(ours.matcher).test(POST_ANSWER))
+            return false;
+        return (await readHookTrust(io)).some((hook) => hook.sub === 'posted' && hook.trust === 'trusted');
+    }
+    catch {
+        return false;
+    }
+}
 async function signedInByItself(io, program) {
     const result = await io.run(program, ['mcp', 'list', '--json'], 30_000);
     if (result.code !== 0)

package/dist/apps/opencode-plugin.js

@@ -10,7 +10,7 @@ const PRODUCTION = 'https://www.pendingyou.com';
 const HOOK_MS = 5000;
 const TURN_MESSAGES = 200;
 const TEXT_CHARS = 100_000;
-const CARD_TOOL = /^[A-Za-z0-9_-]*pendingyou[A-Za-z0-9_-]*_(post_request|update_request|reply_in_thread|cancel_request|answer_delegated|hand_back)$/i;
+const CARD_TOOL = /^[A-Za-z0-9_-]*pendingyou[A-Za-z0-9_-]*_(post_request|post_answer|update_request|reply_in_thread|cancel_request|answer_delegated|hand_back)$/i;
 export const HANDED_FOR_MS = 12 * 60 * 60_000;
 const NUDGED = 'Asked OpenCode to put what it needs from you on a card.';
 const isObject = (value) => typeof value === 'object' && value !== null && !Array.isArray(value);

package/dist/apps/pi-extension.js

@@ -8,7 +8,7 @@ export const READY_EVERY_MS = 500;
 export const READY_FOR_MS = 30_000;
 const WHOAMI = /^mcp__[A-Za-z0-9_]*pendingyou[A-Za-z0-9_]*__whoami$/i;
 const STOP_MS = 2000;
-export const CARD_TOOL = /^mcp__[A-Za-z0-9_]*pendingyou[A-Za-z0-9_]*__(post_request|update_request|reply_in_thread|cancel_request|answer_delegated|hand_back)$/i;
+export const CARD_TOOL = /^mcp__[A-Za-z0-9_]*pendingyou[A-Za-z0-9_]*__(post_request|post_answer|update_request|reply_in_thread|cancel_request|answer_delegated|hand_back)$/i;
 export const HANDED_FOR_MS = 12 * 60 * 60_000;
 export const HANDED_PREFIX = 'Pending You: your person handed you';
 const HANDED_REPLY = ' on the question handed to you, ';
@@ -148,6 +148,7 @@ export function pendingYou(setup, options = {}) {
         let cwd = '';
         let closed = false;
         let turn = null;
+        let prompt = null;
         let nudged = false;
         let posting = Promise.resolve();
         let listener = null;
@@ -328,7 +329,8 @@ export function pendingYou(setup, options = {}) {
                 nextTurn(said);
             listen();
         });
-        pi.on('before_agent_start', async (_event, ctx) => {
+        pi.on('before_agent_start', async (event, ctx) => {
+            prompt = typeof event?.prompt === 'string' ? event.prompt : null;
             listen();
             const said = await hook('handoff', { cwd: ctx.cwd || cwd, session_id: session });
             return said ? { message: { customType: TYPE, content: said, display: false } } : undefined;
@@ -373,6 +375,7 @@ export function pendingYou(setup, options = {}) {
                 last_assistant_message: text,
                 stop_hook_active: false,
                 ...(startedHanded(event.context?.contextMessages, handedWakes) ? { handed: true } : {}),
+                ...(prompt !== null ? { prompt } : {}),
             }));
             if (!reason)
                 return;
@@ -388,6 +391,7 @@ export function pendingYou(setup, options = {}) {
         });
         pi.on('agent_settled', () => {
             turn = null;
+            prompt = null;
             nudged = false;
         });
         pi.on('session_shutdown', async () => {

package/dist/asked.js

@@ -0,0 +1,102 @@
+import { isHandedWake } from "./format.js";
+const PENDING_YOU_LINE = /^Pending You: (?:your person|nobody answered|\d+ of your cards|this computer|anything you need|[\w .’'-]{1,40} is connected|.*\(req_[A-Za-z0-9-]+)/;
+const TAGGED = /^<[a-z][\w-]*>/i;
+const SLASH = /^\/[a-z]/i;
+const NOT_THEIRS = /^(?:\[Request interrupted|Stop hook feedback)/i;
+export function ownWords(text) {
+    const words = text.trim();
+    if (!words)
+        return null;
+    const first = words.split('\n')[0] ?? '';
+    if (PENDING_YOU_LINE.test(first) ||
+        isHandedWake(words) ||
+        TAGGED.test(words) ||
+        SLASH.test(words) ||
+        NOT_THEIRS.test(words))
+        return null;
+    return words;
+}
+function spoken(text) {
+    const kept = [];
+    let fence = null;
+    for (const line of text.split('\n')) {
+        const marker = /^\s*(`{3,}|~{3,})/.exec(line)?.[1];
+        if (fence) {
+            if (marker?.startsWith(fence))
+                fence = null;
+            continue;
+        }
+        if (marker) {
+            fence = marker;
+            continue;
+        }
+        if (/^\s*>/.test(line))
+            continue;
+        kept.push(line
+            .replace(/`[^`]*`/g, ' ')
+            .replace(/“[^”]*”|"[^"]*"/g, ' ')
+            .replace(/\b(?:https?:\/\/|www\.)\S+/gi, ' '));
+    }
+    return kept.join('\n');
+}
+const FILLER = /^(?:(?:pending\s*(?:you|new|view)|hey|hi|hello|yo|ok(?:ay)?|so|um+|uh+|well|alright|all right|right|oh|and|also|now|please|quick question)\b[\s,.:;!?-]*)+/i;
+const ASSISTANT = /^(?:claude|codex|opencode|pi|cursor|grok|chatgpt|gemini)\b[\s,.:;!-]*/i;
+const NAMED = /^[A-Z][\p{L}’'-]*,\s+/u;
+function opening(sentence) {
+    let text = sentence.trim();
+    for (let tries = 0; tries < 6; tries++) {
+        const next = text.replace(FILLER, '').replace(ASSISTANT, '').replace(NAMED, '').trim();
+        if (next === text)
+            break;
+        text = next;
+    }
+    return text;
+}
+export const wordsOf = (text) => text.match(/[\p{L}\p{N}][\p{L}\p{N}’'.,:%-]*/gu) ?? [];
+const QUESTION = /^(?:what|which|who|when|where|why|how|is|are|was|do|does|did|can|could|will|would|should|has|have|any)(?:n[’']t)?\b/i;
+const DO_OR_HAVE = /^(?:do|have)\s+(?!(?:you|we|i|they|he|she|it|any|all|both|our|my|your|their)\b)/i;
+const NEGATED = /^[a-z]+n[’']t\b/i;
+const STATEMENT = /^(?:what|which|when|where|why|how)\s+(?:i|we|you|they|he|she)\b/i;
+const FACTS = /\b(?:(?:tell me|let me know)\s+(?:what|which|who|whose|where|why|how|whether|about)|find out|look up|show me|how many|how much|i want to know|do you know|check (?:whether|if))\b/i;
+const WORK = String.raw `(?:fix|add|make|run|deploy|write|create|update|change|remove|commit|push|merge|install|set\s+up|try)`;
+const WORK_ASKED = new RegExp(String.raw `\b(?:can|could|would|will)\s+you\s+(?:please\s+|just\s+|also\s+|quickly\s+|now\s+)?${WORK}\b`, 'i');
+const WORK_FIRST = new RegExp(String.raw `^${WORK}\b`, 'i');
+const WORK_LATER = new RegExp(String.raw `(?:[,;:]\s*|\b(?:and|then)\s+)${WORK}\b`, 'i');
+const sentencesOf = (text) => text
+    .split(/(?<=[.!?])\s+|\n+/)
+    .map((sentence) => sentence.trim())
+    .filter(Boolean);
+function asks(sentence) {
+    const said = opening(sentence);
+    if (!said)
+        return false;
+    if (WORK_ASKED.test(said))
+        return false;
+    const facts = FACTS.test(said);
+    if (WORK_FIRST.test(said) && !facts)
+        return false;
+    if (said.includes('?'))
+        return true;
+    if (facts)
+        return true;
+    if (WORK_LATER.test(said))
+        return false;
+    return (QUESTION.test(said) &&
+        !DO_OR_HAVE.test(said) &&
+        !NEGATED.test(said) &&
+        !STATEMENT.test(said) &&
+        wordsOf(said).length >= 4);
+}
+export function askedQuestion(message) {
+    const plain = spoken(message);
+    const said = opening(plain);
+    if (!said.includes('?') && wordsOf(said).length < 4)
+        return false;
+    const sentences = sentencesOf(plain);
+    const looked = [...new Set([sentences[0], ...sentences.slice(-3)])].filter((sentence) => sentence !== undefined);
+    return looked.some(asks);
+}
+export function asksQuestion(message) {
+    const words = typeof message === 'string' ? ownWords(message) : null;
+    return words !== null && askedQuestion(words);
+}

package/dist/herdr/answer.js

@@ -22,6 +22,25 @@ export const askerOf = (card) => `${card.asker.agent?.name ?? card.asker.assista
 const askerName = (card) => card.asker.agent?.name ?? card.asker.assistant.name;
 export const HIGH_STAKES = 'High stakes: answer it in Pending You, where you hold to approve. o opens it.';
 export const NOT_HERE = 'Answer this one in Pending You: o opens it.';
+const KINDS = [
+    'choice',
+    'multi',
+    'approve',
+    'text',
+    'review',
+    'action',
+    'fyi',
+    'group',
+];
+const QUESTION_KINDS = [
+    'choice',
+    'multi',
+    'approve',
+    'text',
+];
+const answersHere = (card) => card.actions.includes('answer') &&
+    KINDS.includes(card.kind) &&
+    (card.questions ?? []).every((question) => QUESTION_KINDS.includes(question.kind));
 const NO_WORDS = 'Pending You takes no words on this card from Herdr: o opens it.';
 const NO_LATER = 'This card can’t go to Later from Herdr: o opens it.';
 const NO_HANDING = 'This card can’t be handed over from Herdr: o opens it.';
@@ -126,7 +145,7 @@ function listKey(state, key, now) {
             { kind: 'targets', card },
         ];
     }
-    if (!card.actions.includes('answer'))
+    if (!answersHere(card))
         return [{ ...state, note: NOT_HERE }, NONE];
     return answerKey(state, card, key);
 }
@@ -211,6 +230,8 @@ function answerKey(state, card, key) {
             return [{ ...state, note: 'y: got it.' }, NONE];
         case 'group':
             return groupKey(state, card, key, send);
+        default:
+            return [{ ...state, note: NOT_HERE }, NONE];
     }
 }
 const toggled = (chosen, id) => chosen.includes(id) ? chosen.filter((each) => each !== id) : [...chosen, id];
@@ -289,6 +310,8 @@ function groupKey(state, card, key, send) {
             const suggestion = n ? question.text?.suggestions?.[n - 1] : undefined;
             return suggestion ? answered({ text: suggestion }) : [state, NONE];
         }
+        default:
+            return [{ ...state, note: NOT_HERE }, NONE];
     }
 }
 function writeKey(state, screen, key) {
@@ -564,7 +587,7 @@ function askLines(card, state, room, now) {
         lines.push(DIM(fit(`If you don’t answer ${fromNow(card.fallback.at, now)}: ${card.fallback.text}`)));
     if (card.highStakes)
         lines.push(...wrap(HIGH_STAKES, room, 2));
-    else if (!card.actions.includes('answer'))
+    else if (!answersHere(card))
         lines.push(...wrap(NOT_HERE, room, 2));
     return lines;
 }
@@ -603,6 +626,8 @@ function answerKeys(card, state) {
                     : [`1–${count(question?.options)}`];
             return [...own, 'Tab next question', 'Enter send all'];
         }
+        default:
+            return [];
     }
 }
 export function keysLine(state, now) {
@@ -632,7 +657,7 @@ export function keysLine(state, now) {
     if (card) {
         const busy = state.sent?.cardId === card.id && now < state.sent.until;
         if (!card.highStakes && !busy) {
-            if (card.actions.includes('answer'))
+            if (answersHere(card))
                 keys.push(...answerKeys(card, state));
             if (card.actions.includes('reply'))
                 keys.push('r reply');

package/dist/permission.js

@@ -40,7 +40,7 @@ const KEEP_MS = 7 * 24 * 60 * 60_000;
 const STDIN_MAX = 8_000_000;
 const TRANSCRIPT_CAP = 4 * 1024 * 1024;
 const SESSION = /^[A-Za-z0-9][A-Za-z0-9_-]{0,99}$/;
-const NAMED_TOOL = /^mcp__.*pendingyou.*__(whoami|post_request|update_request|cancel_request|reply_in_thread|get_request|ack_answer|list_pending|get_attachment)$/i;
+const NAMED_TOOL = /^mcp__.*pendingyou.*__(whoami|post_request|post_answer|update_request|cancel_request|reply_in_thread|get_request|ack_answer|list_pending|get_attachment)$/i;
 const isObject = (value) => typeof value === 'object' && value !== null && !Array.isArray(value);
 const folderOf = (io) => join(configDir(io), PERMISSION_FOLDER);
 const pathOf = (io, session) => join(folderOf(io), `${session}.json`);
@@ -623,7 +623,7 @@ export async function sessionName(path) {
         await file.close().catch(() => { });
     }
 }
-const POST_TOOL = /^mcp__.*pendingyou.*__post_request$/i;
+const POST_TOOL = /^mcp__.*pendingyou.*__(post_request|post_answer)$/i;
 const POSTED_ID = /"requestId"\s*:\s*"(req_[A-Za-z0-9-]{1,40})"/;
 export const POSTED_MAX = 50;
 function resultText(content) {
@@ -650,9 +650,10 @@ export async function sessionPosted(path) {
         const results = new Map();
         const posted = [];
         let more = false;
+        let answeredAt;
         const read = (line) => {
             const asResult = line.includes('tool_result') && line.includes('req_');
-            const asCall = line.includes('post_request');
+            const asCall = line.includes('post_request') || line.includes('post_answer');
             if (!asResult && !asCall)
                 return;
             let entry;
@@ -678,7 +679,14 @@ export async function sessionPosted(path) {
                     block.type === 'tool_use' &&
                     POST_TOOL.test(text(block.name))) {
                     const id = results.get(text(block.id));
-                    if (!id || posted.includes(id))
+                    if (!id)
+                        continue;
+                    const at = Date.parse(text(entry.timestamp));
+                    if (answeredAt === undefined &&
+                        /post_answer$/i.test(text(block.name)) &&
+                        Number.isFinite(at))
+                        answeredAt = at;
+                    if (posted.includes(id))
                         continue;
                     if (posted.length < POSTED_MAX)
                         posted.push(id);
@@ -703,7 +711,11 @@ export async function sessionPosted(path) {
         }
         if (position === 0)
             read(carry.toString('utf8'));
-        return { posted, whole: position === 0 && !more };
+        return {
+            posted,
+            whole: position === 0 && !more,
+            ...(answeredAt !== undefined ? { answeredAt } : {}),
+        };
     }
     catch {
         return null;

package/dist/pickup.js

@@ -1,6 +1,7 @@
-import { getJson, SignInNeeded, Unavailable } from "./api.js";
-import { computerNames, hearsOnly, keepListening, markHandedTurn, sessionFor, threadCards, threadNames, touchThread, } from "./apps/codex-wake.js";
+import { getJson, postJson, SignInNeeded, Unavailable } from "./api.js";
+import { computerNames, hearsOnly, keepListening, markAskedTurn, markHandedTurn, sessionFor, threadAnsweredAt, threadCards, threadNames, touchThread, } from "./apps/codex-wake.js";
 import { APP_NAMES, DEFAULT_APP } from "./apps/ids.js";
+import { asksQuestion, ownWords } from "./asked.js";
 import { connectionMachine, readCredential } from "./credentials.js";
 import { environmentWarning } from "./environment.js";
 import { configDir, readJson } from "./files.js";
@@ -16,6 +17,8 @@ import { announce, keepPresent, readSaid } from "./presence.js";
 import { setupReminder } from "./setup.js";
 import { claimHanded, markHanded, momentOf, releaseHanded, wasHanded } from "./state.js";
 const TIME_BOX_MS = { pickup: 2500, handoff: 2000 };
+export const READ_PATH = '/mcp/cli/read';
+export const READ_FOR_MS = 24 * 60 * 60_000;
 export const ANSWERS_ASKED = 20;
 export const ANSWERS_SHOWN = 5;
 export const REMINDER = 'Pending You: anything you need from your person also goes on a card.';
@@ -113,29 +116,54 @@ export function folderForms(cwd, home) {
         forms.push(`~${cwd.slice(base.length)}`);
     return forms;
 }
-export async function askerParams(io, origin, app, session) {
+export async function askerOf(io, origin, app, session) {
     let name = session.name ?? undefined;
     let posted = [];
     let own = false;
+    let answeredAt = null;
     if (app === DEFAULT_APP) {
         const record = await sessionPosted(session.transcript ?? undefined);
         if (record) {
             posted = record.posted;
             own = record.whole;
+            answeredAt = record.answeredAt ?? null;
         }
     }
     else if (session.id) {
         name ??= (await threadNames(io, app, session.id).catch(() => [])).at(-1);
         posted = (await threadCards(io, app, session.id).catch(() => [])).slice(0, POSTED_MAX);
+        answeredAt = await threadAnsweredAt(io, app, session.id).catch(() => null);
     }
     const machine = await connectionMachine(io, origin, app).catch(() => null);
     const machines = [...new Set([io.host, machine].filter((each) => Boolean(each)))];
-    return [
-        ...(name ? [['name', name]] : []),
-        ...posted.map((id) => ['posted', id]),
-        ...(own ? [['own', '1']] : []),
-        ...machines.slice(0, 4).map((each) => ['machine', each]),
-    ];
+    return {
+        params: [
+            ...(name ? [['name', name]] : []),
+            ...posted.map((id) => ['posted', id]),
+            ...(own ? [['own', '1']] : []),
+            ...machines.slice(0, 4).map((each) => ['machine', each]),
+        ],
+        answeredAt,
+    };
+}
+export const askerParams = async (io, origin, app, session) => (await askerOf(io, origin, app, session)).params;
+export const readsAnswers = (asker, prompt, now) => asker.answeredAt !== null &&
+    now - asker.answeredAt < READ_FOR_MS &&
+    (prompt === null || ownWords(prompt) !== null);
+async function readHere(io, origin, app, cwd, asker) {
+    try {
+        const query = new URLSearchParams([
+            ...folderForms(cwd, io.home).map((form) => ['cwd', form]),
+            ['source', app],
+            ...asker.params,
+            ['at', new Date(io.now()).toISOString()],
+        ]);
+        await postJson(io, origin, `${READ_PATH}?${query}`, {}, TIME_BOX_MS.handoff, {
+            app,
+            signal: io.signal,
+        });
+    }
+    catch { }
 }
 export async function pickup(io, options, hook = { fallback: '' }) {
     const { origin, mode } = options;
@@ -145,6 +173,7 @@ export async function pickup(io, options, hook = { fallback: '' }) {
     let reminder = null;
     let unwoken = null;
     let stuck = null;
+    let reading = null;
     try {
         const input = await hookInput(io);
         const { cwd } = input;
@@ -186,6 +215,8 @@ export async function pickup(io, options, hook = { fallback: '' }) {
             await touchThread(io, app, input.session, input.given ? input.cwd : null);
             if (app === 'codex' && input.turn && isHandedWake(input.prompt ?? ''))
                 await markHandedTurn(io, input.turn, app).catch(() => { });
+            else if (app === 'codex' && mode === 'handoff' && input.turn && asksQuestion(input.prompt))
+                await markAskedTurn(io, input.turn, app).catch(() => { });
         }
         if (app === 'codex' && input.session)
             await keepListening(io, origin, input.session);
@@ -193,16 +224,19 @@ export async function pickup(io, options, hook = { fallback: '' }) {
             ? sessionName(input.transcript ?? undefined).then((name) => (name ? [name] : []))
             : null;
         const named = claudeNames ? (await claudeNames)[0] : undefined;
+        const asker = await askerOf(io, origin, app, {
+            id: input.session,
+            transcript: input.transcript,
+            name: named ?? null,
+        });
+        if (mode === 'handoff' && readsAnswers(asker, input.prompt, io.now()))
+            reading = readHere(io, origin, app, cwd, asker);
         const query = new URLSearchParams([
             ...folderForms(cwd, io.home).map((form) => ['cwd', form]),
             ['limit', String(ANSWERS_ASKED)],
             ...(mode === 'handoff' ? [['open', String(OPEN_SHOWN)]] : []),
             ['source', app],
-            ...(await askerParams(io, origin, app, {
-                id: input.session,
-                transcript: input.transcript,
-                name: named ?? null,
-            })),
+            ...asker.params,
         ]);
         const { status, body } = await getJson(io, origin, `/mcp/cli/answers?${query}`, TIME_BOX_MS[mode], io.signal, {
             hook: true,
@@ -309,5 +343,6 @@ export async function pickup(io, options, hook = { fallback: '' }) {
         const last = [line, warning, reminder, unwoken, stuck].filter(Boolean);
         if (last.length)
             io.out(`${last.join('\n')}\n`);
+        await reading;
     }
 }

package/dist/sdk/client.js

@@ -177,6 +177,7 @@ export function createClient(options) {
     const keyed = (given) => ({ idempotencyKey: given ?? newKey() });
     const client = {
         me: (opts) => request('GET', '/v1/me', opts),
+        snapshot: (opts) => request('GET', '/v1/snapshot', opts),
         cards: {
             list: (query, opts) => request('GET', '/v1/cards', {
                 ...opts,

package/dist/stopcheck.js

@@ -1,7 +1,9 @@
 import { open } from 'node:fs/promises';
 import { getJson } from "./api.js";
+import { codexSeesAnswers } from "./apps/codex.js";
 import { markNudged, turnRecord } from "./apps/codex-wake.js";
 import { APP_NAMES, DEFAULT_APP } from "./apps/ids.js";
+import { asksQuestion, wordsOf } from "./asked.js";
 import { asksToTypeHere, cardFits, confirmReason, sessionLink } from "./confirm.js";
 import { readCredential } from "./credentials.js";
 import { isHandedWake } from "./format.js";
@@ -11,7 +13,9 @@ export const READ_CAP = 4 * 1024 * 1024;
 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.';
 export const DELEGATED_REASON = 'Your person handed you that question to answer, not to ask them back: answer_delegated if you know, or hand_back with what you checked, unless you already did. Never post it as a card of your own.';
-const POSTING_TOOL = /^mcp__.+__(post_request|update_request|reply_in_thread|answer_delegated|hand_back)$/;
+export const ANSWER_REASON = 'Your person asked you something and your answer is only in chat: post_answer it too, or say it doesn’t need one.';
+export const ANSWER_WORDS = 30;
+const POSTING_TOOL = /^mcp__.+__(post_request|post_answer|update_request|reply_in_thread|answer_delegated|hand_back)$/;
 export const OPEN_TIME_BOX_MS = 1500;
 const OPEN_CARDS = 5;
 const CARD_TEXT = 20_000;
@@ -35,7 +39,7 @@ const CARDS_HEADING = /\b(?:your|open|pending|waiting)\s+(?:(?:open|pending|wait
 const SENTENCE_END = /(?<=[.!?])\s+/;
 const OTHER_CARDS = /\b(?:credit|debit|payment|gift|sim|sd|business|graphics|video|sound|network|memory|smart)\s+cards?\b|\bcards?\s+(?:numbers?|readers?|details|holders?)\b/gi;
 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|(?<!\b(?:no|nothing|none|not)\b[^.,;:!?\n]{0,40})waiting (?:on|for) you|(?<!\bif (?:it|he|she|they|that|this|anything|something|someone|anyone|one) )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;
-const SAYS_NO_CARD = /\bno (?:new |more |further )?cards? (?:is |are )?(?:needed|necessary|required)\b|\b(?:doesn(?:'|’)t|don(?:'|’)t|does not|do not|won(?:'|’)t|will not) need (?:a |any )?(?:new )?cards?\b|\bnothing (?:here |else |more |now )?(?:needs|requires) your (?:attention|input|action|answer)\b|\b(?:nothing|no cards?)\b[^.,;:!?\n]{0,40}\b(?:waiting|pending) (?:on|for) you\b/i;
+const SAYS_NO_CARD = /\bno (?:new |more |further |answer )?cards? (?:is |are )?(?:needed|necessary|required)\b|\b(?:doesn(?:'|’)t|don(?:'|’)t|does not|do not|won(?:'|’)t|will not) need (?:a |an |any )?(?:new |answer )?cards?\b|\bnothing (?:here |else |more |now )?(?:needs|requires) your (?:attention|input|action|answer)\b|\b(?:nothing|no cards?)\b[^.,;:!?\n]{0,40}\b(?:waiting|pending) (?:on|for) you\b/i;
 const FOR_THEM_HEADING = /\b(your part|your steps?|your to-?dos?|your turn|your call|for you|waiting on you|left for you|parked for you|needs you|over to you|what you need to do|you(?:'|’)ll need)\b/i;
 const LIST_ITEM = /^\s*(?:\d+[.)]|[-*•]|\[ \])\s+\S/;
 const YOU = /\byou(?:r|rs|(?:'|’)(?:ll|d|re|ve))?\b/i;
@@ -123,6 +127,36 @@ function withoutRecaps(plain) {
 export function itemsOutsideRecaps(text) {
     return itemsIn(withoutRecaps(plainText(text)));
 }
+function withoutCode(text) {
+    const kept = [];
+    let fence = null;
+    for (const line of text.split('\n')) {
+        const marker = /^\s*(`{3,}|~{3,})/.exec(line)?.[1];
+        if (fence) {
+            if (marker?.startsWith(fence))
+                fence = null;
+            continue;
+        }
+        if (marker) {
+            fence = marker;
+            continue;
+        }
+        kept.push(line.replace(/`[^`]*`/g, ' '));
+    }
+    return kept.join('\n');
+}
+function hasTable(text) {
+    const lines = text.split('\n');
+    return lines.some((line, index) => index > 0 &&
+        line.includes('|') &&
+        line.includes('-') &&
+        /^[\s|:-]+$/.test(line) &&
+        (lines[index - 1] ?? '').includes('|'));
+}
+export function isAnswer(text) {
+    const said = withoutRecaps(withoutCode(text));
+    return wordsOf(said).length >= ANSWER_WORDS || hasTable(said);
+}
 export const saysPosted = (text) => SAYS_POSTED.test(plainText(text));
 export const saysNoCard = (text) => SAYS_NO_CARD.test(plainText(text));
 export const mentionsCards = (text) => /\bcards?\b/i.test(plainText(text).replace(OTHER_CARDS, ''));
@@ -176,6 +210,7 @@ export async function lastTurn(path, cap = READ_CAP) {
         let finalDone = false;
         let posted = false;
         let handed = false;
+        let asked = false;
         const cards = [];
         const take = (raw) => {
             if (!raw.trim())
@@ -190,7 +225,9 @@ export async function lastTurn(path, cap = READ_CAP) {
             if (entry.isSidechain)
                 return false;
             if (startsTurn(entry)) {
-                handed = startsHanded(startText(entry));
+                const words = startText(entry);
+                handed = startsHanded(words);
+                asked = !handed && asksQuestion(words);
                 return true;
             }
             if (entry.type !== 'assistant' || !Array.isArray(entry.message?.content))
@@ -224,21 +261,29 @@ export async function lastTurn(path, cap = READ_CAP) {
             let newline = buffer.lastIndexOf(10);
             while (newline !== -1) {
                 if (take(buffer.subarray(newline + 1).toString('utf8')))
-                    return { text: texts.join('\n'), posted, cards, handed, complete: true, bytesRead };
+                    return { text: texts.join('\n'), posted, cards, handed, asked, complete: true, bytesRead };
                 buffer = buffer.subarray(0, newline);
                 newline = buffer.lastIndexOf(10);
             }
             carry = buffer;
         }
         if (position === 0 && take(carry.toString('utf8')))
-            return { text: texts.join('\n'), posted, cards, handed, complete: true, bytesRead };
-        return { text: texts.join('\n'), posted, cards, handed, complete: position === 0, bytesRead };
+            return { text: texts.join('\n'), posted, cards, handed, asked, complete: true, bytesRead };
+        return {
+            text: texts.join('\n'),
+            posted,
+            cards,
+            handed,
+            asked,
+            complete: position === 0,
+            bytesRead,
+        };
     }
     finally {
         await file.close();
     }
 }
-const OPENCODE_POSTING = /^[A-Za-z0-9_-]*pendingyou[A-Za-z0-9_-]*_(post_request|update_request|reply_in_thread|answer_delegated|hand_back)$/i;
+const OPENCODE_POSTING = /^[A-Za-z0-9_-]*pendingyou[A-Za-z0-9_-]*_(post_request|post_answer|update_request|reply_in_thread|answer_delegated|hand_back)$/i;
 const isObject = (value) => typeof value === 'object' && value !== null && !Array.isArray(value);
 function opencodeTurn(input) {
     const messages = Array.isArray(input.messages) ? input.messages.filter(isObject) : [];
@@ -252,6 +297,17 @@ function opencodeTurn(input) {
         part.type === 'text' &&
         typeof part.text === 'string' &&
         startsHanded(part.text));
+    const own = partsOf(first).some((part) => part.pendingyou === 'wake')
+        ? ''
+        : partsOf(first)
+            .flatMap((part) => part.type === 'text' &&
+            part.synthetic !== true &&
+            part.pendingyou === undefined &&
+            typeof part.text === 'string'
+            ? [part.text]
+            : [])
+            .join('\n');
+    const asked = !handed && asksQuestion(own);
     const answers = rest.filter((message) => message.role === 'assistant');
     if (answers.at(-1)?.error === 'MessageAbortedError')
         return null;
@@ -273,7 +329,7 @@ function opencodeTurn(input) {
                 final.push(part.text);
         }
     const text = final.join('\n').trim();
-    return text ? { text, posted, cards, handed } : null;
+    return text ? { text, posted, cards, handed, asked } : null;
 }
 async function openTitles(io, origin, cwd, app, session) {
     try {
@@ -305,11 +361,16 @@ async function turnOf(io, input, app) {
         const record = await turnRecord(io, input.turn_id, app);
         if (record?.nudged)
             return null;
+        const handed = Boolean(record?.delegated) || input.handed === true;
         return {
             text: final,
             posted: Boolean(record?.cards.length),
             cards: record?.cards ?? [],
-            handed: Boolean(record?.delegated) || input.handed === true,
+            handed,
+            asked: !handed &&
+                (app === 'codex'
+                    ? record?.asked === true
+                    : typeof input.prompt === 'string' && asksQuestion(input.prompt)),
         };
     }
     if (app === 'opencode') {
@@ -326,6 +387,7 @@ async function turnOf(io, input, app) {
             posted: turn.posted || Boolean(record?.cards.length),
             cards: [...turn.cards, ...(record?.cards ?? [])],
             handed: turn.handed,
+            asked: turn.asked,
         };
     }
     if (typeof input.transcript_path !== 'string' || !input.transcript_path)
@@ -334,8 +396,11 @@ async function turnOf(io, input, app) {
     if (!turn.complete)
         return null;
     const text = final || turn.text;
-    return text ? { text, posted: turn.posted, cards: turn.cards, handed: turn.handed } : null;
+    return text
+        ? { text, posted: turn.posted, cards: turn.cards, handed: turn.handed, asked: turn.asked }
+        : null;
 }
+const seesAnswers = (io, app) => app === 'codex' ? codexSeesAnswers(io).catch(() => false) : Promise.resolve(true);
 export async function stopcheck(io, options) {
     const app = options.app ?? DEFAULT_APP;
     try {
@@ -383,7 +448,11 @@ export async function stopcheck(io, options) {
                 return 0;
             return block(confirmReason(ask.words, sessionLink(io.env), APP_NAMES[app]));
         }
-        if (turn.posted || saysPosted(text) || saysNoCard(text) || !itemsOutsideRecaps(text))
+        if (turn.posted || saysPosted(text) || saysNoCard(text))
+            return 0;
+        if (turn.asked && isAnswer(text) && (await seesAnswers(io, app)))
+            return block(ANSWER_REASON);
+        if (!itemsOutsideRecaps(text))
             return 0;
         if (mentionsCards(text)) {
             const open = await openTitles(io, options.origin, cwd, app, session);

package/dist/version.js

@@ -1 +1 @@
-export const VERSION = '0.35.0';
+export const VERSION = '0.36.0';

package/mod/.claude-plugin/plugin.json

@@ -1,7 +1,7 @@
 {
   "name": "pendingyou-wake",
   "displayName": "Pending You",
-  "version": "2.50.0",
+  "version": "2.54.0",
   "description": "Wakes Claude Code when your person answers a Pending You card it posted, even while it sits idle. Installed by `npx pendingyou init`.",
   "author": {
     "name": "RecordPlane",

package/mod/README.md

@@ -4,4 +4,4 @@ The pendingyou command line’s copy of the Pending You plugin’s wake mod, for
 
 In each session it learns the cards the session posts to Pending You, checks them through the session’s own Pending You connection, and starts a turn when your person answers, writes back or a fallback comes due, or hands the session a question from another of their assistants (CLI 0.14.0), even while it sits idle. It answers `npx pendingyou hold` itself, so nothing waits in the background, and shows “2 waiting on you” under the prompt, after the plugin’s name. With the Pending You plugin installed too, only one copy acts.
 
-Generated from recordplane/pendingyou (packages/claude-plugin/src/wake) with Pending You’s guide 2.50.0; send changes there.
+Generated from recordplane/pendingyou (packages/claude-plugin/src/wake) with Pending You’s guide 2.54.0; send changes there.

package/mod/hooks/register.js

@@ -209,13 +209,13 @@ async function deliverHanded($) {
             view = handedView(resultObject(await $.mcp.call(server, 'get_request', args)), handed, name);
         }
         catch { }
-        const claim = await $.store.get(key);
+        const stored = await $.store.get(key);
         if (!view) {
-            if (claimHeld(claim, handed.updatedAt, me))
+            if (claimHeld(stored, handed.updatedAt, me))
                 await $.store.delete(key);
             continue;
         }
-        if (!claimHeld(claim, handed.updatedAt, me)) {
+        if (!claimHeld(stored, handed.updatedAt, me)) {
             live.handedTold.set(handed.requestId, handed.updatedAt);
             continue;
         }

package/package.json

@@ -1,7 +1,17 @@
 {
   "name": "pendingyou",
-  "version": "0.35.0",
+  "version": "0.36.0",
   "description": "Pending You for your coding agents: one command sets up Claude Code, Codex, OpenCode and Pi to ask you through Pending You and hear your answers, even while they sit idle.",
+  "keywords": [
+    "pendingyou",
+    "claude-code",
+    "codex",
+    "opencode",
+    "pi",
+    "mcp",
+    "human-in-the-loop",
+    "ai-agents"
+  ],
   "license": "Apache-2.0",
   "homepage": "https://www.pendingyou.com",
   "repository": {