@astrosheep/square 0.3.4 → 0.3.6

package/dist/paseo-timeline.js

@@ -1,206 +1,76 @@
-import { randomUUID } from 'node:crypto';
 import { setTimeout as sleep } from 'node:timers/promises';
-const DEFAULT_POLL_INTERVAL_MS = 100;
-const DEFAULT_REQUEST_TIMEOUT_MS = 3000;
-function paseoWebSocketUrl() {
-    const override = process.env['SQUARE_PASEO_WS_URL']?.trim();
-    if (override)
-        return override;
-    const listen = process.env['PASEO_LISTEN']?.trim();
-    if (!listen)
-        return 'ws://127.0.0.1:6767/ws';
-    if (/^wss?:\/\//i.test(listen)) {
-        const url = new URL(listen);
-        if (url.pathname === '/' || url.pathname === '')
-            url.pathname = '/ws';
-        return url.toString();
-    }
-    if (/^tcp:\/\//i.test(listen)) {
-        const url = new URL(listen);
-        const secure = url.searchParams.get('ssl') === 'true';
-        url.protocol = secure ? 'wss:' : 'ws:';
-        url.pathname = '/ws';
-        return url.toString();
-    }
-    if (/^\d+$/.test(listen))
-        return `ws://127.0.0.1:${listen}/ws`;
-    return `ws://${listen.replace(/\/$/, '')}/ws`;
-}
-function parseSnapshot(payload) {
-    if (payload === null || typeof payload !== 'object') {
-        throw new Error('Invalid Paseo timeline response.');
-    }
-    const response = payload;
-    if (typeof response.error === 'string' && response.error) {
-        throw new Error(response.error);
-    }
-    const latestTools = new Map();
-    for (const entry of response.entries ?? []) {
-        const item = entry.item;
-        if (item?.['type'] !== 'tool_call' ||
-            typeof item['callId'] !== 'string' ||
-            (item['status'] !== 'running' && item['status'] !== 'completed' && item['status'] !== 'failed')) {
-            continue;
-        }
-        latestTools.set(item['callId'], item['status']);
-    }
-    return {
-        agentStatus: typeof response.agent?.status === 'string' ? response.agent.status : 'unknown',
-        toolCalls: Array.from(latestTools, ([callId, status]) => ({ callId, status })),
-    };
-}
-class PaseoTimelineProbe {
-    socket;
-    pending = new Map();
-    constructor(socket) {
-        this.socket = socket;
-        socket.addEventListener('message', (event) => {
-            let envelope;
-            try {
-                envelope = JSON.parse(String(event.data));
-            }
-            catch {
-                return;
-            }
-            if (envelope === null || typeof envelope !== 'object')
-                return;
-            const outer = envelope;
-            if (outer.type !== 'session' || outer.message === null || typeof outer.message !== 'object') {
-                return;
-            }
-            const message = outer.message;
-            if (message.type !== 'fetch_agent_timeline_response' ||
-                message.payload === null ||
-                typeof message.payload !== 'object') {
-                return;
-            }
-            const requestId = message.payload.requestId;
-            if (typeof requestId !== 'string')
-                return;
-            const request = this.pending.get(requestId);
-            if (!request)
-                return;
-            clearTimeout(request.timer);
-            this.pending.delete(requestId);
-            try {
-                request.resolve(parseSnapshot(message.payload));
-            }
-            catch (error) {
-                request.reject(error instanceof Error ? error : new Error(String(error)));
-            }
-        });
-        const rejectPending = () => {
-            for (const [requestId, request] of this.pending) {
-                clearTimeout(request.timer);
-                request.reject(new Error('Paseo timeline connection closed.'));
-                this.pending.delete(requestId);
-            }
-        };
-        socket.addEventListener('close', rejectPending);
-        socket.addEventListener('error', rejectPending);
-    }
-    static async connect(timeoutMs = DEFAULT_REQUEST_TIMEOUT_MS) {
-        const socket = new WebSocket(paseoWebSocketUrl());
-        await new Promise((resolvePromise, reject) => {
-            const timer = setTimeout(() => {
-                socket.close();
-                reject(new Error('Timed out connecting to Paseo.'));
-            }, timeoutMs);
-            socket.addEventListener('open', () => {
-                clearTimeout(timer);
-                resolvePromise();
-            }, { once: true });
-            socket.addEventListener('error', () => {
-                clearTimeout(timer);
-                reject(new Error('Could not connect to Paseo.'));
-            }, { once: true });
-        });
-        const probe = new PaseoTimelineProbe(socket);
-        socket.send(JSON.stringify({
-            type: 'hello',
-            clientId: `square-wake-${process.pid}-${randomUUID()}`,
-            clientType: 'cli',
-            protocolVersion: 1,
-        }));
-        return probe;
-    }
-    snapshot(agentId, timeoutMs = DEFAULT_REQUEST_TIMEOUT_MS) {
-        const requestId = randomUUID();
-        return new Promise((resolvePromise, reject) => {
-            const timer = setTimeout(() => {
-                this.pending.delete(requestId);
-                reject(new Error('Timed out reading Paseo timeline.'));
-            }, timeoutMs);
-            this.pending.set(requestId, { resolve: resolvePromise, reject, timer });
-            this.socket.send(JSON.stringify({
-                type: 'session',
-                message: {
-                    type: 'fetch_agent_timeline_request',
-                    agentId,
-                    requestId,
-                    direction: 'tail',
-                    limit: 200,
-                    projection: 'projected',
-                },
-            }));
-        });
-    }
-    close() {
-        this.socket.close();
-    }
-}
-async function waitWithSnapshots(agentId, readSnapshot, options) {
-    const initial = await readSnapshot(agentId);
+async function waitSnapshots(agentId, read, opts) {
+    const initial = await read(agentId);
     if (initial.agentStatus === 'idle')
         return true;
     if (initial.agentStatus !== 'running')
         return false;
-    const currentCalls = new Set(initial.toolCalls.filter((tool) => tool.status === 'running').map((tool) => tool.callId));
-    if (currentCalls.size === 0)
+    const running = new Set(initial.toolCalls.filter((tool) => tool.status === 'running').map((tool) => tool.callId));
+    if (running.size === 0)
         return true;
-    const pollIntervalMs = options.pollIntervalMs ?? DEFAULT_POLL_INTERVAL_MS;
-    const delay = options.delay ?? ((ms) => sleep(ms));
-    const deadline = options.timeoutMs === undefined ? null : Date.now() + options.timeoutMs;
-    while (deadline === null || Date.now() < deadline) {
-        await delay(pollIntervalMs);
-        const snapshot = await readSnapshot(agentId);
-        if (snapshot.agentStatus === 'idle')
+    const delay = opts.delay ?? ((ms) => sleep(ms));
+    const interval = opts.pollIntervalMs ?? 100;
+    const deadline = Date.now() + (opts.timeoutMs ?? 30_000);
+    while (Date.now() < deadline) {
+        await delay(interval);
+        const current = await read(agentId);
+        if (current.agentStatus === 'idle')
             return true;
-        if (snapshot.agentStatus !== 'running')
+        if (current.agentStatus !== 'running')
             return false;
-        const latest = new Map(snapshot.toolCalls.map((tool) => [tool.callId, tool.status]));
-        const allTerminal = Array.from(currentCalls).every((callId) => {
-            const status = latest.get(callId);
-            return status === 'completed' || status === 'failed';
-        });
-        if (allTerminal)
+        const states = new Map(current.toolCalls.map((tool) => [tool.callId, tool.status]));
+        if ([...running].every((id) => states.get(id) === 'completed' || states.get(id) === 'failed'))
             return true;
     }
     return false;
 }
-/**
- * Wait until the tool calls that were running at the initial snapshot finish.
- * Tool calls that start later are intentionally ignored: the subsequent
- * `paseo send` may replace the next tool call under the transitional policy.
- */
-export async function waitForPaseoToolBoundary(agentId, options = {}) {
-    if (options.readSnapshot) {
-        try {
-            return await waitWithSnapshots(agentId, options.readSnapshot, options);
-        }
-        catch {
-            return false;
-        }
-    }
-    let probe = null;
+function paseoUrl() {
+    const value = process.env.SQUARE_PASEO_WS_URL?.trim() || process.env.PASEO_LISTEN?.trim();
+    if (!value)
+        return 'ws://127.0.0.1:6767/ws';
+    if (/^wss?:\/\//i.test(value))
+        return value.replace(/\/$/, '') + (value.endsWith('/ws') ? '' : '/ws');
+    if (/^\d+$/.test(value))
+        return `ws://127.0.0.1:${value}/ws`;
+    return `ws://${value.replace(/\/$/, '')}/ws`;
+}
+async function remoteSnapshot(agentId) {
+    const socket = new WebSocket(paseoUrl());
+    await new Promise((resolve, reject) => {
+        const timer = setTimeout(() => { socket.close(); reject(new Error('Paseo timeline connection timed out.')); }, 3000);
+        socket.addEventListener('open', () => { clearTimeout(timer); resolve(); }, { once: true });
+        socket.addEventListener('error', () => { clearTimeout(timer); reject(new Error('Paseo timeline unavailable.')); }, { once: true });
+    });
+    return await new Promise((resolve, reject) => {
+        const timer = setTimeout(() => { socket.close(); reject(new Error('Paseo timeline request timed out.')); }, 3000);
+        const requestId = `${process.pid}-${Date.now()}`;
+        socket.addEventListener('message', (event) => {
+            try {
+                const outer = JSON.parse(String(event.data));
+                const payload = outer?.message?.payload;
+                if (outer?.message?.type !== 'fetch_agent_timeline_response' || payload?.requestId !== requestId)
+                    return;
+                clearTimeout(timer);
+                socket.close();
+                const tools = new Map();
+                for (const entry of payload.entries ?? []) {
+                    const item = entry?.item;
+                    if (item?.type === 'tool_call' && typeof item.callId === 'string' && ['running', 'completed', 'failed'].includes(item.status))
+                        tools.set(item.callId, item.status);
+                }
+                resolve({ agentStatus: typeof payload.agent?.status === 'string' ? payload.agent.status : 'unknown', toolCalls: [...tools].map(([callId, status]) => ({ callId, status })) });
+            }
+            catch { /* ignore unrelated frames */ }
+        });
+        socket.send(JSON.stringify({ type: 'hello', clientId: `square-${process.pid}`, clientType: 'cli', protocolVersion: 1 }));
+        socket.send(JSON.stringify({ type: 'session', message: { type: 'fetch_agent_timeline_request', agentId, requestId, direction: 'tail', limit: 200, projection: 'projected' } }));
+    });
+}
+export async function waitForPaseoToolBoundary(agentId, opts = {}) {
     try {
-        probe = await PaseoTimelineProbe.connect();
-        return await waitWithSnapshots(agentId, (id) => probe.snapshot(id), options);
+        return await waitSnapshots(agentId, opts.readSnapshot ?? remoteSnapshot, opts);
     }
     catch {
         return false;
     }
-    finally {
-        probe?.close();
-    }
 }

package/dist/presentation.js

@@ -83,16 +83,16 @@ export function renderPresenceLines(participants, now, limit = 5) {
         lines.push(`  ○ …and ${remaining} more`);
     return lines;
 }
-const ACT_HINTS = [
+const EXPRESS_HINTS = [
     '*asterisks* are your body — *slams table*, *sketches in the air*, *shrugs*',
-    "you're standing in a square, not posting to a feed",
+    "you're standing in a square — words and gestures both land",
     'half-shaped is welcome — a sketch, an objection, a joke, a fragment',
     '@ only who you need — step back with catch --mention',
 ];
-export function actHintLine(ownActCount) {
-    if (ownActCount !== 1 && ownActCount % 5 !== 0)
+export function expressHintLine(ownActivityCount) {
+    if (ownActivityCount !== 1 && ownActivityCount % 5 !== 0)
         return undefined;
-    const hint = ACT_HINTS[Math.floor(ownActCount / 5) % ACT_HINTS.length];
+    const hint = EXPRESS_HINTS[Math.floor(ownActivityCount / 5) % EXPRESS_HINTS.length];
     return `· ${hint}`;
 }
 const BODY_PREVIEW_LENGTH = 200;
@@ -201,26 +201,21 @@ function renderUnreadSummary(opts) {
                 return `  · ${item.name} spoke — ${formatAge(item.latestActivityAgeMs)} ago · "${previewActivityBody(preview.act.body)}"`;
             }),
         ]),
-        ...opts.roomChanges.map(({ act }) => `  · ${renderRoomChangeText(act)}`),
+        ...opts.roomChanges.map((act) => `  · ${renderRoomChangeText(act)}`),
     ];
 }
-export function renderPendingFeed(publicItems, roomChanges, viewer = '') {
+export function renderPendingFeed(history, publicItems, roomChanges, viewer = '') {
     const lines = [];
-    for (const item of publicItems) {
-        if (item.act.kind === 'say' && item.number !== undefined && item.act.at) {
-            const rendered = renderVisibleEvent(publicItems
-                .filter((entry) => (entry.act.kind === 'say' || entry.act.kind === 'done') && entry.act.at !== undefined)
-                .map((entry, index) => ({ ...entry.act, index })), { kind: 'say', actor: item.act.actor, at: item.act.at, body: item.act.body ?? '', index: item.index }, viewer, { actNumber: item.number });
-            if (rendered !== '')
-                lines.push(rendered);
-        }
-        else if (item.act.kind === 'done' && item.act.at) {
-            lines.push(renderEventCli({ kind: 'done', actor: item.act.actor, at: item.act.at, body: item.act.body ?? '', index: item.index }));
-        }
+    for (const act of publicItems) {
+        const rendered = renderVisibleEvent(history, act, viewer, {
+            actNumber: act.kind === 'say' ? sayNumberFor(history, act) : undefined,
+        });
+        if (rendered !== '')
+            lines.push(rendered);
     }
     const publicIndexes = new Set(publicItems.map((item) => item.index));
-    for (const { act, index } of roomChanges) {
-        if (publicIndexes.has(index))
+    for (const act of roomChanges) {
+        if (publicIndexes.has(act.index))
             continue;
         lines.push(`· ${renderRoomChangeText(act)}`);
     }
@@ -229,32 +224,23 @@ export function renderPendingFeed(publicItems, roomChanges, viewer = '') {
 export function renderActivityBlocked(opts) {
     const readNowCommand = `${participantCommandPrefix(opts.squarePath, opts.name)} catch --now`;
     return withPathOutput(opts.squarePath, [
-        "✕ your act doesn't land — the square moved behind your back",
+        "✕ your activity doesn't land — the square moved behind your back",
         ...renderUnreadSummary({ activitySummaries: opts.activitySummaries, roomChanges: opts.unreadRoomChanges, viewer: opts.name }),
         ...draftSavedLines(opts.draftPath),
         `» ${readNowCommand}`,
-        '  read, then act again',
+        '  take it in, then express again',
         `» ${withDraftInput(opts.forceCommand, opts.draftPath)}`,
-        '  only if you truly mean to speak over them',
+        '  only if you truly mean to express over unread activity',
     ].join('\n'), { participantCount: opts.participantCount, held: opts.held });
 }
-export function withJoinNextOutput(squarePath, body, opts = {}) {
-    return withPathOutput(squarePath, body.trimEnd(), opts);
-}
-export function withActivityNextOutput(squarePath, body = '', opts = {}) {
-    return withPathOutput(squarePath, body.trimEnd(), opts);
-}
-export function withWatchNextOutput(squarePath, body, opts = {}) {
-    return withPathOutput(squarePath, body.trimEnd(), opts);
-}
-export function renderActWaiting(opts) {
+export function renderExpressWaiting(opts) {
     if (opts.reason === 'throttled') {
-        return ['✕ the square is packed', `  · your act is waiting · next opening in ${formatDuration(opts.delayMs)}`].join('\n');
+        return ['✕ the square is packed', `  · your activity is waiting · next opening in ${formatDuration(opts.delayMs)}`].join('\n');
     }
-    return ["✕ your act doesn't land — a hand is raised", '  · your act is waiting'].join('\n');
+    return ["✕ your activity doesn't land — a hand is raised", '  · your activity is waiting'].join('\n');
 }
-export function renderActNoWait(opts) {
-    const retryCommand = `${participantCommandPrefix(opts.squarePath, opts.name)} act -`;
+export function renderExpressNoWait(opts) {
+    const retryCommand = `${participantCommandPrefix(opts.squarePath, opts.name)} express -`;
     const lines = opts.reason === 'throttled'
         ? [
             '✕ the square is packed',
@@ -263,7 +249,7 @@ export function renderActNoWait(opts) {
             `» ${withDraftInput(retryCommand, opts.draftPath)}`,
         ]
         : [
-            "✕ your act doesn't land — a hand is raised",
+            "✕ your activity doesn't land — a hand is raised",
             `  · ${opts.holdReason ?? 'the square holds its breath'}`,
             ...draftSavedLines(opts.draftPath),
             `» ${withDraftInput(retryCommand, opts.draftPath)}`,
@@ -295,7 +281,7 @@ function renderLastPresenceMarker(name) {
     return `· ${name}'s footprints reach here`;
 }
 export function renderActivitiesView(doc, visible, lastN, full, squarePath, viewer = '') {
-    const publicVisible = visible.filter((item) => item.act.kind === 'say' || item.act.kind === 'done');
+    const publicVisible = visible.filter((act) => act.kind === 'say' || act.kind === 'done');
     const shown = lastN == null ? publicVisible : publicVisible.slice(-lastN);
     const previewLen = full ? undefined : BODY_PREVIEW_LENGTH;
     const markers = new Map();
@@ -305,23 +291,23 @@ export function renderActivitiesView(doc, visible, lastN, full, squarePath, view
             markers.set(anchor, [...(markers.get(anchor) ?? []), participant]);
     }
     const chunks = [];
-    for (const item of shown) {
-        const rendered = renderVisibleEvent(doc.acts, item.act, viewer, {
+    for (const act of shown) {
+        const rendered = renderVisibleEvent(doc.acts, act, viewer, {
             preview: previewLen,
-            actNumber: item.act.kind === 'say' ? sayNumberFor(doc.acts, item.act) : undefined,
+            actNumber: act.kind === 'say' ? sayNumberFor(doc.acts, act) : undefined,
         });
         if (rendered !== '')
             chunks.push(rendered);
-        for (const participant of markers.get(item.index) ?? []) {
+        for (const participant of markers.get(act.index) ?? []) {
             chunks.push(renderLastPresenceMarker(participant));
         }
     }
     if (chunks.length === 0)
         return 'latest\n  ○ no public activity in this view';
     if (previewLen !== undefined) {
-        const truncated = shown.some((item) => item.act.kind === 'say' && item.act.body.length > previewLen);
+        const truncated = shown.some((act) => act.kind === 'say' && act.body.length > previewLen);
         if (truncated)
-            chunks.push(`» ${commandPrefix(squarePath)} echo --full`);
+            chunks.push(`» ${commandPrefix(squarePath)} history --full`);
     }
     return chunks.join('\n\n');
 }
@@ -332,22 +318,25 @@ function highlightGrepMatch(text) {
     return `\x1b[38;5;222m\x1b[1m${text}\x1b[0m`;
 }
 export function renderGrepActivitiesView(visible, totalMatches, full, squarePath, pattern, fixed = false) {
-    const publicVisible = visible.filter((item) => item.act.kind === 'say' || item.act.kind === 'done');
+    const publicVisible = visible.filter((act) => act.kind === 'say' || act.kind === 'done');
     if (totalMatches === 0)
         return `○ no activity matched ${quoteShell(pattern)}`;
     const matchLabel = totalMatches === 1 ? 'match' : 'matches';
     const chunks = [publicVisible.length === totalMatches ? `${totalMatches} ${matchLabel}` : `${publicVisible.length} of ${totalMatches} ${matchLabel}`];
     let truncated = false;
-    for (const item of publicVisible) {
-        const rawBody = item.act.body ?? '';
+    for (const act of publicVisible) {
+        const rawBody = act.body ?? '';
         if (full === true) {
             const body = rawBody.split('\n').map((line) => `  ${line}`).join('\n');
-            chunks.push(`${actId(item.index)} · ${item.act.actor ?? 'unknown'} · ${formatTimestamp(item.act.at)}\n${body}`);
+            chunks.push(`${actId(act.index)} · ${act.actor ?? 'unknown'} · ${formatTimestamp(act.at)}\n${body}`);
             continue;
         }
         const snippet = grepSnippet(rawBody, pattern, GREP_PREVIEW_CHARS, fixed);
-        if (snippet === undefined)
+        if (snippet === undefined) {
+            const preview = previewBody(rawBody, GREP_PREVIEW_CHARS);
+            chunks.push(`${actId(act.index)} · ${act.actor ?? 'unknown'} · ${formatTimestamp(act.at)}${preview === '' ? '' : `\n  ${preview}`}`);
             continue;
+        }
         const clippedBefore = snippet.beforeOmitted > 0;
         const clippedAfter = snippet.afterOmitted > 0;
         truncated ||= clippedBefore || clippedAfter;
@@ -355,13 +344,13 @@ export function renderGrepActivitiesView(visible, totalMatches, full, squarePath
         const omitted = clippedBefore || clippedAfter
             ? `\n  · ${snippet.beforeOmitted} chars before · ${snippet.afterOmitted} chars after`
             : '';
-        chunks.push(`${actId(item.index)} · ${item.act.actor ?? 'unknown'} · ${formatTimestamp(item.act.at)}\n  ${text.trim()}${omitted}`);
+        chunks.push(`${actId(act.index)} · ${act.actor ?? 'unknown'} · ${formatTimestamp(act.at)}\n  ${text.trim()}${omitted}`);
     }
     if (publicVisible.length === 1) {
-        chunks.push(`» ${commandPrefix(squarePath)} echo --at ${actId(publicVisible[0].index)} -C 2${truncated ? ' --full' : ''}`);
+        chunks.push(`» ${commandPrefix(squarePath)} history --at ${actId(publicVisible[0].index)} -C 2${truncated ? ' --full' : ''}`);
     }
     else if (truncated && publicVisible.length > 1) {
-        chunks.push(`» ${commandPrefix(squarePath)} echo --at ${actId(publicVisible[0].index)} -C 2 --full`);
+        chunks.push(`» ${commandPrefix(squarePath)} history --at ${actId(publicVisible[0].index)} -C 2 --full`);
     }
     return chunks.join('\n\n');
 }
@@ -369,7 +358,7 @@ function renderActivityLimitBody(opts) {
     const countText = opts.count !== undefined && opts.hardCap !== undefined ? ` (${opts.count}/${opts.hardCap})` : '';
     const doneCommand = `${participantCommandPrefix(opts.squarePath, opts.name)} done -`;
     return [
-        `✕ your act doesn't land — the cap is reached${countText}`,
+        `✕ your activity doesn't land — the cap is reached${countText}`,
         ...draftSavedLines(opts.draftPath),
         `» ${withDraftInput(doneCommand, opts.draftPath)}`,
     ].join('\n');
@@ -377,11 +366,8 @@ function renderActivityLimitBody(opts) {
 export function renderActivityLimit(opts) {
     return withPathOutput(opts.squarePath, renderActivityLimitBody(opts), { participantCount: opts.participantCount, held: opts.held });
 }
-export function renderWatchInterrupted(_opts) {
-    return '✕ catch stopped';
-}
 export function renderWatchAlreadyActive(opts) {
-    return ['✕ you are already catching', `» ${participantCommandPrefix(opts.squarePath, opts.name)} catch --force`].join('\n');
+    return ['✕ you are already catching', `» ${participantCommandPrefix(opts.squarePath, opts.name)} catch --idle 30m --replace`].join('\n');
 }
 export function renderWatchForceTakeover(_opts) {
     return '✓ your new catch takes over';
@@ -400,8 +386,11 @@ export function renderWatchStatus(opts) {
         case 'stale':
         case 'empty-now': {
             const prefix = participantCommandPrefix(opts.squarePath, opts.name);
+            const quiet = opts.status === 'stale' && opts.idleMs !== undefined
+                ? `○ ${formatDuration(opts.idleMs)} of quiet — nothing new for you`
+                : '○ only footsteps in the square — nothing new for you';
             return [
-                '○ only footsteps in the square — nothing new for you',
+                quiet,
                 ...(opts.showCatchHint === false
                     ? []
                     : [`» ${prefix} catch --idle 30m`, `  glance: ${prefix} catch --now`]),
@@ -417,7 +406,7 @@ export function renderWatchStatus(opts) {
 function renderRoomChanges(changes) {
     if (changes.length === 0)
         return '';
-    return ['▲ while your back was turned', ...changes.map(({ act }) => `  · ${renderRoomChangeText(act)}`)].join('\n');
+    return ['▲ while your back was turned', ...changes.map((act) => `  · ${renderRoomChangeText(act)}`)].join('\n');
 }
 export function renderDoctorClean() {
     return '✓ no problems found';
@@ -441,8 +430,11 @@ export function renderWatchOutput(history, publicItems, roomChanges, opts) {
     const sections = [];
     if (opts.stalePartial) {
         const prefix = participantCommandPrefix(opts.squarePath, opts.viewer);
+        const quiet = opts.idleMs === undefined
+            ? '○ only footsteps in the square — nothing new for you'
+            : `○ ${formatDuration(opts.idleMs)} of quiet — nothing else for you`;
         sections.push([
-            '○ only footsteps in the square — nothing new for you',
+            quiet,
             ...(opts.showCatchHint === false
                 ? []
                 : [`» ${prefix} catch --idle 30m`, `  glance: ${prefix} catch --now`]),
@@ -455,8 +447,8 @@ export function renderWatchOutput(history, publicItems, roomChanges, opts) {
         sections.push(room);
     if (publicItems.length > 0) {
         const rendered = publicItems
-            .map((item) => renderVisibleEvent(history, item.act, opts.viewer, {
-            actNumber: item.act.kind === 'say' ? sayNumberFor(history, item.act) : undefined,
+            .map((act) => renderVisibleEvent(history, act, opts.viewer, {
+            actNumber: act.kind === 'say' ? sayNumberFor(history, act) : undefined,
             mention: opts.mention,
         }))
             .filter(Boolean)

package/dist/presented.js

@@ -35,7 +35,6 @@ function readRows(filePath, now = Date.now()) {
             if (parsed.v !== 2 ||
                 typeof parsed.ts !== 'number' ||
                 typeof parsed.owner_id !== 'string' ||
-                typeof parsed.presenter_session_id !== 'string' ||
                 typeof parsed.square_path !== 'string' ||
                 typeof parsed.name !== 'string' ||
                 typeof parsed.act_index !== 'number' ||
@@ -155,17 +154,20 @@ function selectUnpresented(sessionId, inbox, rows) {
             : [{ membership: { ...membership, notifications }, ownerId }];
     });
 }
-/** True when the current participant owner has already received this attention. */
-export function hasPresentedAttention(squarePath, name, actIndex, env = process.env) {
-    const ownerIds = new Set(lookupParticipant(squarePath, name).map((binding) => binding.ownerId));
-    if (ownerIds.size === 0)
-        return false;
+export function hasPresentedForOwner(ownerId, squarePath, name, actIndex, env = process.env) {
     const resolved = canonicalSquarePath(squarePath);
-    return readRows(presentedPath(env)).some((row) => ownerIds.has(row.owner_id) &&
+    return readRows(presentedPath(env)).some((row) => row.owner_id === ownerId &&
         canonicalSquarePath(row.square_path) === resolved &&
         sameName(row.name, name) &&
         row.act_index === actIndex);
 }
+/** True when any current participant owner has already received this attention. */
+export function hasPresentedAttention(squarePath, name, actIndex, env = process.env) {
+    const ownerIds = new Set(lookupParticipant(squarePath, name).map((binding) => binding.ownerId));
+    if (ownerIds.size === 0)
+        return false;
+    return [...ownerIds].some((ownerId) => hasPresentedForOwner(ownerId, squarePath, name, actIndex, env));
+}
 /**
  * Serialize presentation only for the affected participants. Delivery runs
  * outside the short ledger-write lock, so unrelated owners never wait on an
@@ -192,7 +194,6 @@ export function presentOnce(sessionId, lookup, deliver, env = process.env, at =
                         v: 2,
                         ts: at,
                         owner_id: ownerId,
-                        presenter_session_id: sessionId,
                         square_path: canonicalSquarePath(membership.squarePath),
                         name: membership.name,
                         act_index: notification.actIndex,