pendingyou 0.14.0 → 0.16.0

package/dist/apps/codex.js

@@ -4,13 +4,15 @@ import { join } from 'node:path';
 import { removeSkill, saveSkill } from "../claude.js";
 import { readCredential } from "../credentials.js";
 import { configDir, readJson, readText, writeWhole } from "../files.js";
-import { isOurHook, mergeHooks, originArgs, removeHooks, shWord, } from "../hooks.js";
+import { isOurHook, lineKey, mergeHooks, originArgs, removeHooks, shWord, } from "../hooks.js";
 import { atLeast } from "../mod.js";
+import { removePresenceFiles } from "../presence.js";
 import { checkHelper, foundBy, headlessReason, helperCommand, helperPath, isOurHelper, } from "../remote.js";
 import { connectionTitle, FINISH_SAY, setupOf, setupStatus } from "../setup.js";
 import { basicString, definedInline, headerOf, renameTable, tableSpans, tableValues, withTable, } from "../toml.js";
 import { findCodex } from "./codex-app.js";
 import { APP_NAMES } from "./ids.js";
+import { switches } from "./switch.js";
 const NAME = APP_NAMES.codex;
 const SERVER = ['mcp_servers', 'pendingyou'];
 export const CODEX_MIN = '0.152.0';
@@ -27,11 +29,25 @@ export const CODEX_HOOKS = [
     { event: 'PostToolUse', sub: 'posted', matcher: CARD_TOOLS },
     { event: 'Stop', sub: 'stopcheck' },
 ];
+export const CODEX_PERMISSION_HOOKS = [
+    { event: 'PermissionRequest', sub: 'permission' },
+    { event: 'PostToolUse', sub: 'permission-done' },
+];
+export const CODEX_PRESENCE_HOOKS = [
+    { event: 'SessionEnd', sub: 'presence', timeout: 3 },
+];
+export const ALL_CODEX_HOOKS = [
+    ...CODEX_HOOKS,
+    ...CODEX_PERMISSION_HOOKS,
+    ...CODEX_PRESENCE_HOOKS,
+];
 const EVENT_LABELS = {
     SessionStart: 'session_start',
     UserPromptSubmit: 'user_prompt_submit',
     PostToolUse: 'post_tool_use',
     Stop: 'stop',
+    PermissionRequest: 'permission_request',
+    SessionEnd: 'session_end',
 };
 const NO_MATCHER = new Set(['UserPromptSubmit', 'Stop']);
 const SIGN_IN_KEYS = new Set([
@@ -151,7 +167,7 @@ async function hookTrust(io) {
     const hooks = 'json' in file && file.json.hooks && typeof file.json.hooks === 'object'
         ? file.json.hooks
         : {};
-    return CODEX_HOOKS.map((spec) => {
+    return ALL_CODEX_HOOKS.map((spec) => {
         const groups = Array.isArray(hooks[spec.event]) ? hooks[spec.event] : [];
         for (const [g, group] of groups.entries())
             for (const [h, handler] of (group?.hooks ?? []).entries()) {
@@ -159,13 +175,14 @@ async function hookTrust(io) {
                     continue;
                 const state = tableValues(config, ['hooks', 'state', trustKey(file.path, spec.event, g, h)]);
                 if (state.enabled === false)
-                    return { event: spec.event, trust: 'off' };
+                    return { event: spec.event, sub: spec.sub, trust: 'off' };
                 const hash = hookHash(spec.event, group.matcher, {
                     command: handler.command,
                     ...(typeof handler.timeout === 'number' ? { timeout: handler.timeout } : {}),
                 });
                 return {
                     event: spec.event,
+                    sub: spec.sub,
                     trust: state.trusted_hash === hash
                         ? 'trusted'
                         : typeof state.trusted_hash === 'string'
@@ -173,7 +190,7 @@ async function hookTrust(io) {
                             : 'untrusted',
                 };
             }
-        return { event: spec.event, trust: 'missing' };
+        return { event: spec.event, sub: spec.sub, trust: 'missing' };
     });
 }
 async function signedInByItself(io, program) {
@@ -191,15 +208,12 @@ async function signedInByItself(io, program) {
         return null;
     }
 }
-async function switches(io, ctx) {
-    if (ctx.headless || ctx.yes)
-        return true;
-    if (!io.interactive)
-        return false;
-    io.out('Codex signs in to Pending You by itself here (codex mcp login). init can move it to this computer’s own sign-in, which its hooks use too: one sign-in for both. The connection it has now stays on your Assistants page until you remove it, and answers to cards it asked through that one won’t reach Codex by themselves.\n');
-    const answer = await io.ask('Switch Codex to this computer’s sign-in? [Y/n] ');
-    return !/^\s*no?\s*$/i.test(answer);
-}
+const switchesFor = (io, ctx) => switches(io, ctx, {
+    name: 'Codex',
+    what: 'Codex signs in to Pending You by itself here (codex mcp login).',
+    uses: 'its hooks use',
+    headless: true,
+});
 async function writeConfig(path, text) {
     return writeWhole(path, text).then(() => true, () => false);
 }
@@ -210,24 +224,26 @@ function keepTheirTrust(config, file, before) {
         'state',
         trustKey(file, event, group, handler),
     ];
-    for (const spec of CODEX_HOOKS) {
-        const groups = Array.isArray(before[spec.event]) ? before[spec.event] : [];
+    for (const event of [...new Set(ALL_CODEX_HOOKS.map((spec) => spec.event))]) {
+        const subs = ALL_CODEX_HOOKS.filter((spec) => spec.event === event).map((spec) => spec.sub);
+        const ours = (hook) => subs.some((sub) => isOurHook(hook?.command, sub));
+        const groups = Array.isArray(before[event]) ? before[event] : [];
         for (const [g, group] of groups.entries())
             for (const [h, hook] of (Array.isArray(group?.hooks) ? group.hooks : []).entries())
-                if (isOurHook(hook?.command, spec.sub))
-                    next = withTable(next, state(spec.event, g, h), null);
+                if (ours(hook))
+                    next = withTable(next, state(event, g, h), null);
         let at = 0;
         for (const [g, group] of groups.entries()) {
             if (!Array.isArray(group?.hooks)) {
                 at++;
                 continue;
             }
-            const kept = group.hooks.flatMap((hook, h) => (isOurHook(hook?.command, spec.sub) ? [] : [h]));
+            const kept = group.hooks.flatMap((hook, h) => (ours(hook) ? [] : [h]));
             if (kept.length === 0)
                 continue;
             for (const [h, was] of kept.entries())
                 if (g !== at || was !== h)
-                    next = renameTable(next, state(spec.event, g, was), state(spec.event, at, h));
+                    next = renameTable(next, state(event, g, was), state(event, at, h));
             at++;
         }
     }
@@ -315,7 +331,7 @@ export const codex = {
             else if ((await signedInByItself(io, program)) !== true) {
                 action = 'write';
             }
-            else if (await switches(io, ctx))
+            else if (await switchesFor(io, ctx))
                 action = 'write';
             else {
                 mode = 'oauth';
@@ -327,6 +343,7 @@ export const codex = {
             }
         }
         const version = detected.version;
+        let newHooks = null;
         return {
             app: codex,
             detected,
@@ -384,7 +401,15 @@ export const codex = {
                 }
                 const skill = await saveSkill(io, ictx.origin, codexSkillPath(io), before?.skill ?? null);
                 report(skill.step);
-                const lines = Object.fromEntries(CODEX_HOOKS.map((spec) => [spec.event, ictx.hookLine(spec.sub)]));
+                const cards = ctx.permissionCards ?? before?.permissionCards !== false;
+                const extra = mode === 'helper' && ictx.helper !== null;
+                const wanted = [
+                    ...CODEX_HOOKS,
+                    ...(extra && cards ? CODEX_PERMISSION_HOOKS : []),
+                    ...(extra ? CODEX_PRESENCE_HOOKS : []),
+                ];
+                const unwanted = ALL_CODEX_HOOKS.filter((spec) => !wanted.includes(spec));
+                const lines = Object.fromEntries(wanted.map((spec) => [lineKey(spec), ictx.hookLine(spec.sub)]));
                 const file = await readHooksFile(io);
                 if ('invalid' in file)
                     report({ ok: false, text: file.invalid });
@@ -393,14 +418,25 @@ export const codex = {
                         const hooks = file.json.hooks && typeof file.json.hooks === 'object'
                             ? file.json.hooks
                             : {};
-                        const merged = mergeHooks(hooks, CODEX_HOOKS, lines, file.path);
-                        if (merged.changed)
-                            await writeWhole(file.path, `${JSON.stringify({ ...file.json, hooks: merged.hooks }, null, 2)}\n`);
+                        const merged = mergeHooks(hooks, wanted, lines, file.path);
+                        const removed = removeHooks(merged.hooks, unwanted);
+                        if (merged.changed || removed.changed)
+                            await writeWhole(file.path, `${JSON.stringify({ ...file.json, hooks: removed.hooks }, null, 2)}\n`);
+                        const fresh = wanted.filter((spec) => !CODEX_HOOKS.includes(spec) && !(lineKey(spec) in (before?.hooks ?? {})));
+                        if (before && merged.changed && fresh.length)
+                            newHooks = [
+                                ...(fresh.some((spec) => spec.sub === 'presence') ? ['session end'] : []),
+                                ...(fresh.some((spec) => spec.sub.startsWith('permission'))
+                                    ? ['permission prompts']
+                                    : []),
+                            ].join(' and ');
                         report({
                             ok: true,
                             text: merged.changed
-                                ? `Installed or updated Codex’s session-start pickup, next-message hand-off, card and Stop check hooks in ${file.path}. Codex asks you to trust them once.`
-                                : 'Codex’s hooks were already installed.',
+                                ? `Installed or updated Codex’s session-start pickup, next-message hand-off, card and Stop check hooks${extra ? `, ${cards ? 'its permission-prompt hooks (a card when Codex waits for your OK; --no-permission-cards leaves them out) ' : ''}and its session-end hook (Pending You hears when a thread is open)` : ''} in ${file.path}. Codex asks you to trust them once.`
+                                : removed.changed
+                                    ? `Took out Codex’s permission-prompt hooks, as you asked: no card when Codex waits for your OK. To turn them on: npx pendingyou init --app codex --permission-cards${originArgs(ictx.origin)}`
+                                    : 'Codex’s hooks were already installed.',
                         });
                     }
                     catch (error) {
@@ -426,6 +462,7 @@ export const codex = {
                     hooks: lines,
                     helper: mode === 'helper' ? ictx.helper : null,
                     setup: { since: new Date(io.now()).toISOString() },
+                    permissionCards: cards,
                 };
                 await writeWhole(manifestPath(io), `${JSON.stringify(manifest, null, 2)}\n`, {
                     secret: true,
@@ -438,9 +475,19 @@ export const codex = {
                 const start = detected.command
                     ? `open the Codex app, start a chat in the folder you work in, and trust Pending You’s hooks: click Review hooks › Allow all (or Settings › Hooks › Trust all)`
                     : `start codex here, or in the folder you work in, and trust Pending You’s hooks: ${TRUST_CLI}; ${TRUST_APP}`;
+                const again = newHooks
+                    ? `Codex has new Pending You hooks (${newHooks}), which it skips until you trust them once: ${detected.command ? TRUST_APP : `${TRUST_CLI}; ${TRUST_APP}`}.`
+                    : null;
                 return {
-                    lines: [`Next: ${first}${start}.`, DONT_SAVE, 'Then say this to it:', '', FINISH_SAY],
-                    together: `- Codex: ${first}${start}, then say the line below to it. ${DONT_SAVE}`,
+                    lines: [
+                        `Next: ${first}${start}.`,
+                        ...(again ? [again] : []),
+                        DONT_SAVE,
+                        'Then say this to it:',
+                        '',
+                        FINISH_SAY,
+                    ],
+                    together: `- Codex: ${first}${start}, then say the line below to it.${again ? ` ${again}` : ''} ${DONT_SAVE}`,
                     say: true,
                 };
             },
@@ -454,7 +501,7 @@ export const codex = {
         let doc = (await readText(config).catch(() => null)) ?? null;
         if ('json' in file) {
             const hooks = file.json.hooks && typeof file.json.hooks === 'object' ? file.json.hooks : {};
-            const removed = removeHooks(hooks, CODEX_HOOKS);
+            const removed = removeHooks(hooks, ALL_CODEX_HOOKS);
             if (removed.changed) {
                 const rest = { ...file.json, hooks: removed.hooks };
                 if (Object.keys(removed.hooks).length === 0)
@@ -484,6 +531,7 @@ export const codex = {
             steps.push(skill);
         await rm(join(configDir(io), 'codex-threads.json'), { force: true });
         await rm(join(configDir(io), 'codex-listen'), { recursive: true, force: true });
+        await removePresenceFiles(io, 'codex');
         await rm(manifestPath(io), { force: true });
         return steps;
     },
@@ -541,10 +589,30 @@ export const codex = {
             off: 'turned off',
             missing: 'missing',
         };
-        const hooksOk = trust.every((hook) => hook.trust === 'trusted');
-        const hooksText = trust.some((hook) => hook.trust === 'missing')
+        const core = trust.filter((hook) => CODEX_HOOKS.some((spec) => spec.sub === hook.sub));
+        const hooksOk = core.every((hook) => hook.trust === 'trusted');
+        const hooksText = core.some((hook) => hook.trust === 'missing')
             ? `not installed; run npx pendingyou init --app codex${flag}`
-            : `${trust.map((hook) => `${hook.event} ${words[hook.trust]}`).join(', ')}${hooksOk ? '' : `. Codex skips a hook you haven’t trusted: ${TRUST_CLI}; ${TRUST_APP}`}`;
+            : `${core.map((hook) => `${hook.event} ${words[hook.trust]}`).join(', ')}${hooksOk ? '' : `. Codex skips a hook you haven’t trusted: ${TRUST_CLI}; ${TRUST_APP}`}`;
+        const extraLine = (label, what, subs, off) => {
+            const hooks = trust.filter((hook) => subs.includes(hook.sub));
+            if (off)
+                return `          ${label} ${off}`;
+            if (hooks.some((hook) => hook.trust === 'missing'))
+                return `  missing ${label} ${what}: not installed; run npx pendingyou@latest init --app codex${flag}`;
+            const trusted = hooks.every((hook) => hook.trust === 'trusted');
+            return trusted
+                ? `  ok      ${label} ${what} (${hooks.map((hook) => `${hook.event} trusted`).join(', ')})`
+                : `  missing ${label} ${what}, once you trust ${hooks.length === 1 ? 'its hook' : 'its hooks'} (${hooks.map((hook) => `${hook.event} ${words[hook.trust]}`).join(', ')}): ${TRUST_CLI}; ${TRUST_APP}`;
+        };
+        const ownConnection = credential?.kind === 'connection' && helper;
+        const notOwn = 'off: it needs Codex signed in through this computer’s own connection';
+        const permissionText = extraLine('Permission prompts:', 'a card when Codex waits for your OK', CODEX_PERMISSION_HOOKS.map((spec) => spec.sub), !ownConnection
+            ? notOwn
+            : manifest?.permissionCards === false
+                ? `off, as you chose; for a card when Codex waits for your OK, run npx pendingyou init --app codex --permission-cards${flag}`
+                : null);
+        const presenceText = extraLine('Presence:', 'tells Pending You when this session is open', CODEX_PRESENCE_HOOKS.map((spec) => spec.sub), ownConnection ? null : notOwn);
         const wakes = detected
             ? atLeast(detected.version, detected.command ? CODEX_APP_WAKE : CODEX_WAKE)
             : false;
@@ -562,6 +630,8 @@ export const codex = {
                 : []),
             `  ${mark(skill !== null)} Skill: ${skill !== null ? `saved (${codexSkillPath(io)})` : `not saved; run npx pendingyou init --app codex${flag}`}`,
             `  ${mark(hooksOk)} Hooks: ${hooksText}`,
+            permissionText,
+            presenceText,
             `  ${mark(wakes)} Wake: ${wakes
                 ? detected?.command
                     ? 'codex queue wakes a chat the Codex app has open when you answer, while the app runs (one it let go, idle 3 hours or behind 10 newer idle chats, hears it when you open it again)'

package/dist/apps/opencode-plugin.js

@@ -5,6 +5,7 @@ import { homedir } from 'node:os';
 import { join } from 'node:path';
 import { createInterface } from 'node:readline';
 import { fileURLToPath } from 'node:url';
+export const PRESENCE_EVERY_MS = 5 * 60_000;
 const PRODUCTION = 'https://www.pendingyou.com';
 const HOOK_MS = 5000;
 const TURN_MESSAGES = 200;
@@ -43,7 +44,7 @@ export function partId(now = Date.now()) {
     const random = [...randomBytes(14)].map((byte) => BASE62[byte % 62]).join('');
     return `prt_${time}${random}`;
 }
-function viaShim(config, origin) {
+function viaShim(config, origin, directory) {
     const shim = join(config, 'bin', 'pendingyou-hook');
     const args = (sub) => [
         sub,
@@ -112,6 +113,29 @@ function viaShim(config, origin) {
             }
         },
         partId: () => partId(),
+        presence: (session, state) => {
+            try {
+                const child = spawn(shim, [
+                    ...args('presence'),
+                    '--state',
+                    state,
+                    '--session',
+                    session,
+                    '--cwd',
+                    directory,
+                    '--at',
+                    String(Date.now()),
+                ], { detached: true, stdio: 'ignore' });
+                child.on('error', () => { });
+                child.unref();
+            }
+            catch { }
+        },
+        every: (ms, run) => {
+            const timer = setInterval(run, ms);
+            timer.unref?.();
+            return () => clearInterval(timer);
+        },
         wanted: (session) => {
             try {
                 return wantsListener(JSON.parse(readFileSync(join(config, 'opencode-threads.json'), 'utf8')), session);
@@ -129,7 +153,7 @@ export const PendingYou = async (input) => {
         const origin = isObject(manifest) && typeof manifest.origin === 'string' ? manifest.origin : null;
         if (!origin)
             return {};
-        return pendingYou(input, viaShim(config, origin));
+        return pendingYou(input, viaShim(config, origin, input.directory));
     }
     catch {
         return {};
@@ -138,6 +162,24 @@ export const PendingYou = async (input) => {
 export async function pendingYou(input, deps) {
     const { client, directory } = input;
     const sessions = new Map();
+    const present = new Set();
+    let stopBeat = null;
+    const live = (id) => {
+        if (present.has(id) || !deps.presence)
+            return;
+        present.add(id);
+        deps.presence(id, 'live');
+        stopBeat ??=
+            deps.every?.(PRESENCE_EVERY_MS, () => {
+                for (const each of present)
+                    deps.presence?.(each, 'live');
+            }) ?? null;
+    };
+    const closed = (id) => {
+        if (!present.delete(id))
+            return;
+        deps.presence?.(id, 'closed');
+    };
     const known = async (id) => {
         const found = sessions.get(id);
         if (found && found.parent !== undefined)
@@ -328,6 +370,8 @@ export async function pendingYou(input, deps) {
                     session.fresh = true;
                     session.parent = typeof info.parentID === 'string' && info.parentID ? info.parentID : null;
                     sessions.set(info.id, session);
+                    if (!session.parent)
+                        live(info.id);
                 }
                 else if (event.type === 'session.deleted' && isObject(properties.info)) {
                     const id = properties.info.id;
@@ -338,6 +382,7 @@ export async function pendingYou(input, deps) {
                         deleted.gone = true;
                     deleted?.listener?.stop();
                     sessions.delete(id);
+                    closed(id);
                 }
                 else if (event.type === 'session.status' &&
                     typeof properties.sessionID === 'string' &&
@@ -353,6 +398,7 @@ export async function pendingYou(input, deps) {
                 const session = await known(id);
                 if (session.parent)
                     return;
+                live(id);
                 if (typeof output.message.id === 'string')
                     session.turn = output.message.id;
                 if (output.parts.some((part) => ourMark(part) !== null))
@@ -409,6 +455,10 @@ export async function pendingYou(input, deps) {
                 session.gone = true;
                 session.listener?.stop();
             }
+            stopBeat?.();
+            stopBeat = null;
+            for (const id of [...present])
+                closed(id);
         },
     };
 }

package/dist/apps/opencode.js

@@ -8,11 +8,13 @@ import { configDir, readJson, readText, writeWhole } from "../files.js";
 import { originArgs } from "../hooks.js";
 import { cliPackage } from "../install.js";
 import { JsoncError, jsonOf, nodeAt, parse, removeAt, setAt } from "../jsonc.js";
+import { removePresenceFiles } from "../presence.js";
 import { foundBy, headlessReason } from "../remote.js";
 import { connectionTitle, FINISH_SAY, setupOf, setupStatus } from "../setup.js";
 import { VERSION } from "../version.js";
 import { threadFiles } from "./codex-wake.js";
 import { APP_NAMES } from "./ids.js";
+import { switches } from "./switch.js";
 const NAME = APP_NAMES.opencode;
 const SCHEMA = 'https://opencode.ai/config.json';
 export const OPENCODE_MIN = '1.17.0';
@@ -170,15 +172,12 @@ async function sharedSkill(io) {
             return place;
     return null;
 }
-async function switches(io, ctx) {
-    if (ctx.headless || ctx.yes)
-        return true;
-    if (!io.interactive)
-        return false;
-    io.out('OpenCode signs in to Pending You by itself here (opencode mcp auth). init can move it to this computer’s own sign-in, which its plugin uses too: one sign-in for both. The connection it has now stays on your Assistants page until you remove it, and answers to cards it asked through that one won’t reach OpenCode by themselves.\n');
-    const answer = await io.ask('Switch OpenCode to this computer’s sign-in? [Y/n] ');
-    return !/^\s*no?\s*$/i.test(answer);
-}
+const switchesFor = (io, ctx) => switches(io, ctx, {
+    name: 'OpenCode',
+    what: 'OpenCode signs in to Pending You by itself here (opencode mcp auth).',
+    uses: 'its plugin uses',
+    headless: true,
+});
 const writeConfig = (path, text) => mkdir(dirname(path), { recursive: true })
     .then(() => writeWhole(path, text))
     .then(() => true, () => false);
@@ -347,7 +346,7 @@ export const opencode = {
         else if (server?.kind === 'remote') {
             if (mode === 'oauth')
                 action = 'keep';
-            else if (await switches(io, ctx))
+            else if (await switchesFor(io, ctx))
                 action = 'write';
             else {
                 mode = 'oauth';
@@ -554,6 +553,7 @@ export const opencode = {
             steps.push(skill);
         for (const path of threadFiles(io, 'opencode'))
             await rm(path, { recursive: true, force: true });
+        await removePresenceFiles(io, 'opencode');
         await rm(manifestPath(io), { force: true });
         if (steps.length === 0)
             steps.push({ ok: true, text: 'Nothing of Pending You’s was in OpenCode.' });
@@ -648,6 +648,9 @@ export const opencode = {
             ...(bridgeLine ? [`  ${mark(bridgeOk)} Bridge: ${bridgeLine}`] : []),
             `  ${mark(pluginOk)} Plugin: ${pluginLine}`,
             `  ${mark(own || shared !== null)} Skill: ${own ? `saved (${opencodeSkillPath(io)})` : shared ? `OpenCode reads the one at ${shared}` : `not saved; run ${init}`}`,
+            connected && pluginOk
+                ? '  ok      Presence: tells Pending You when this session is open (the plugin says so every 5 minutes while OpenCode runs)'
+                : `          Presence: off: it needs ${connected ? 'the plugin' : 'OpenCode signed in through this computer’s own connection'}`,
         ];
         const setup = setupStatus(NAME, signIn.state === 'ok' ? setupOf(signIn.for) : null);
         if (setup)

package/dist/apps/pi-extension.js

@@ -11,6 +11,12 @@ 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 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, ';
+const isHandedWake = (text) => {
+    const first = text.trimStart().split('\n')[0] ?? '';
+    return (first.startsWith(HANDED_PREFIX) ||
+        (first.startsWith('Pending You: ') && first.includes(HANDED_REPLY)));
+};
 const SOURCES = {
     startup: 'startup',
     reload: 'startup',
@@ -24,6 +30,7 @@ export const SETUP_LINES = [
     'Pending You: your person answered setup’s test question',
     'Pending You: this computer is connected (',
 ];
+export const PRESENCE_EVERY_MS = 5 * 60_000;
 const MAX_STRING = 20_000;
 const SESSION = /^[A-Za-z0-9][A-Za-z0-9-]{0,99}$/;
 const isObject = (value) => typeof value === 'object' && value !== null && !Array.isArray(value);
@@ -146,6 +153,27 @@ export function pendingYou(setup, options = {}) {
         let listener = null;
         let again = false;
         const handedWakes = new Set();
+        let present = '';
+        let beat = null;
+        const presence = (id, state) => {
+            if (!id)
+                return;
+            try {
+                const child = spawn(setup.shim, args('presence', '--state', state, '--session', id, '--at', String(Date.now()), ...(cwd ? ['--cwd', cwd] : [])), { detached: true, stdio: 'ignore' });
+                child.on('error', () => { });
+                unref(child);
+            }
+            catch { }
+        };
+        const heartbeat = () => {
+            beat = later(() => {
+                if (closed || !present)
+                    return;
+                presence(present, 'live');
+                heartbeat();
+            }, PRESENCE_EVERY_MS);
+            unref(beat);
+        };
         const hook = (command, input) => new Promise((resolve) => {
             let out = '';
             let done = false;
@@ -249,7 +277,7 @@ export function pendingYou(setup, options = {}) {
                 for (let end = buffer.indexOf('\n'); end !== -1; end = buffer.indexOf('\n')) {
                     const message = wakeOf(buffer.slice(0, end));
                     buffer = buffer.slice(end + 1);
-                    if (message?.startsWith(HANDED_PREFIX)) {
+                    if (message && isHandedWake(message)) {
                         if (handedWakes.size >= 20)
                             handedWakes.clear();
                         handedWakes.add(message.trim());
@@ -281,6 +309,14 @@ export function pendingYou(setup, options = {}) {
                 session = '';
             }
             cwd = ctx.cwd;
+            if (session && session !== present) {
+                if (present)
+                    presence(present, 'closed');
+                present = session;
+                presence(session, 'live');
+                cancel(beat);
+                heartbeat();
+            }
             const said = await hook('pickup', {
                 cwd,
                 session_id: session,
@@ -356,6 +392,10 @@ export function pendingYou(setup, options = {}) {
         });
         pi.on('session_shutdown', async () => {
             closed = true;
+            cancel(beat);
+            if (present)
+                presence(present, 'closed');
+            present = '';
             const child = listener;
             listener = null;
             if (!child || child.exitCode !== null || child.signalCode !== null)

package/dist/apps/pi.js

@@ -8,12 +8,14 @@ import { originArgs } from "../hooks.js";
 import { cliPackage } from "../install.js";
 import { editJson, isObject, readObject } from "../json.js";
 import { atLeast } from "../mod.js";
+import { removePresenceFiles } from "../presence.js";
 import { foundBy, headlessReason } from "../remote.js";
 import { connectionTitle, FINISH_SAY, setupOf, setupStatus } from "../setup.js";
 import { shimPath } from "../shim.js";
 import { VERSION } from "../version.js";
 import { threadFiles } from "./codex-wake.js";
 import { APP_NAMES } from "./ids.js";
+import { switches } from "./switch.js";
 const NAME = APP_NAMES.pi;
 export const PI_MIN = '0.99.0';
 export const PI_CIMD = '1.0.1';
@@ -133,15 +135,12 @@ function entryFor(bridge, origin, version, before) {
         ...kept,
     };
 }
-async function switches(io, ctx) {
-    if (ctx.yes)
-        return true;
-    if (!io.interactive)
-        return false;
-    io.out('Pi signs in to Pending You by itself here (pi mcp login). init can move it to this computer’s own sign-in, which Pending You’s extension for Pi uses too: one sign-in for both. The connection it has now stays on your Assistants page until you remove it, and answers to cards it asked through that one won’t reach Pi by themselves.\n');
-    const answer = await io.ask('Switch Pi to this computer’s sign-in? [Y/n] ');
-    return !/^\s*no?\s*$/i.test(answer);
-}
+const switchesFor = (io, ctx) => switches(io, ctx, {
+    name: 'Pi',
+    what: 'Pi signs in to Pending You by itself here (pi mcp login).',
+    uses: 'Pending You’s extension for Pi uses',
+    headless: false,
+});
 async function extensionSource(io, copy) {
     const places = [
         ...(copy ? [join(cliPackage(copy.prefix), 'dist', 'apps', 'pi-extension.js')] : []),
@@ -289,7 +288,7 @@ export const pi = {
         else if (server?.url) {
             if (how === 'pi')
                 action = server.exposure === 'direct' ? 'keep' : 'expose';
-            else if (await switches(io, ctx))
+            else if (await switchesFor(io, ctx))
                 action = 'write';
             else {
                 how = 'pi';
@@ -502,6 +501,7 @@ export const pi = {
             steps.push(skill);
         for (const path of threadFiles(io, 'pi'))
             await rm(path, { recursive: true, force: true });
+        await removePresenceFiles(io, 'pi');
         await rm(manifestPath(io), { force: true });
         return steps;
     },
@@ -601,6 +601,9 @@ export const pi = {
             ...(bridgeLine ? [`  ${mark(bridgeOk)} Bridge: ${bridgeLine}`] : []),
             `  ${mark(skillOk)} Skill: ${skillText}`,
             `  ${mark(extensionOk)} Extension: ${extensionText}`,
+            connected && extensionOk
+                ? '  ok      Presence: tells Pending You when this session is open (the extension says so every 5 minutes while Pi runs)'
+                : `          Presence: off: it needs ${connected ? 'the extension' : 'Pi signed in through this computer’s own connection'}`,
         ];
         const setup = setupStatus(NAME, signIn.state === 'ok' ? setupOf(signIn.for) : null);
         if (setup)

package/dist/apps/switch.js

@@ -0,0 +1,15 @@
+export const movesOver = (name) => `Once ${name} shows up on this computer’s sign-in, Pending You moves the old sign-in’s agents over to it, with their cards and the questions you delegated to them, and signs the old one out.`;
+export async function switches(io, ctx, options) {
+    const { name } = options;
+    if (ctx.yes)
+        return true;
+    if (options.headless && ctx.headless) {
+        io.out(`${options.what} There’s no browser here (${ctx.headless}), where that sign-in can’t finish, so init is switching ${name} to this computer’s own sign-in, which ${options.uses} too. ${movesOver(name)}\n`);
+        return true;
+    }
+    if (!io.interactive)
+        return false;
+    io.out(`${options.what} init can move ${name} to this computer’s own sign-in, which ${options.uses} too: one sign-in for both. ${movesOver(name)}\n`);
+    const answer = await io.ask(`Switch ${name} to this computer’s sign-in? [Y/n] `);
+    return !/^\s*no?\s*$/i.test(answer);
+}