@phnx-labs/agents-cli 1.20.76 → 1.20.77

package/dist/commands/sessions.js

@@ -32,14 +32,15 @@ import { filterTeamSessions } from '../lib/session/team-filter.js';
 import { parseSession } from '../lib/session/parse.js';
 import { runRemoteSessions, buildForwardedArgs, ensureWholeIndex } from '../lib/session/remote.js';
 import { formatRelativeTime } from '../lib/session/relative-time.js';
-import { renderConversationMarkdown, renderSummary, renderSummaryHeader, computeSummaryStats, renderJson, filterEvents, parseRoleList } from '../lib/session/render.js';
+import { renderConversationMarkdown, renderSummary, renderSummaryHeader, computeSummaryStats, renderJson, filterEvents, parseRoleList, linkUrl } from '../lib/session/render.js';
+import { linearIssueUrl } from '../lib/session/linear.js';
 import { renderMarkdown } from '../lib/markdown.js';
 import { AGENTS, colorAgent, resolveAgentName } from '../lib/agents.js';
 import { getShimsDir } from '../lib/state.js';
 import { fuzzyMatch, FUZZY_PRESETS } from '../lib/fuzzy.js';
 import { resolveVersionAliasLoose } from '../lib/versions.js';
 import { isInteractiveTerminal, isPromptCancelled } from './utils.js';
-import { sessionPicker, buildPreview } from './sessions-picker.js';
+import { sessionPicker, buildPreview, formatTodoCompact, githubRepoUrlFromCwd, } from './sessions-picker.js';
 import { setHelpSections } from '../lib/help.js';
 import { registerSessionsTailCommand } from './sessions-tail.js';
 import { registerSessionsSyncCommand } from './sessions-sync.js';
@@ -226,15 +227,24 @@ export function cleanPreview(text) {
         .trim();
 }
 /**
- * Build the live description for an active session: prefer the state engine's
- * preview (the latest turn), then a user label, then the first-prompt topic.
+ * Build the live description for an active session: checklist progress (when
+ * present) plus the state engine's preview (the latest turn), a user label, or
+ * the first-prompt topic. Used by both the flat listing's `doing` cell and as
+ * the snippet half of the --active row (identity is layered on in printActiveRow).
+ *
+ * Covers every ActiveSession context: terminal (interactive), headless, teams,
+ * cloud, and sub-agent rows that share the same ActiveSession.todos field.
  */
 function buildSessionDescription(s) {
+    const todo = formatTodoCompact(s.todos);
     if (s.context === 'cloud') {
-        return cleanPreview(s.preview || `${s.cloudProvider ?? ''}${s.cloudTaskId ? ` · ${s.cloudTaskId.slice(0, 12)}` : ''}`);
+        const base = s.preview || `${s.cloudProvider ?? ''}${s.cloudTaskId ? ` · ${s.cloudTaskId.slice(0, 12)}` : ''}`;
+        return cleanPreview([todo, base].filter(Boolean).join(' · '));
     }
     if (s.context === 'teams') {
         const parts = [s.teamName];
+        if (todo)
+            parts.push(todo);
         if (s.preview)
             parts.push(s.preview);
         else if (s.label)
@@ -243,8 +253,53 @@ function buildSessionDescription(s) {
             parts.push(s.topic);
         return cleanPreview(parts.filter(Boolean).join(' · '));
     }
-    // Terminal or headless: prefer the live preview, then label, then topic.
-    return cleanPreview(s.preview || s.label || s.topic || '');
+    // Terminal, headless, or sub-agent: todos + live preview, then label, then topic.
+    const base = s.preview || s.label || s.topic || '';
+    return cleanPreview([todo, base].filter(Boolean).join(' · '));
+}
+/**
+ * Identity + checklist + live snippet for an --active / cross-machine row.
+ * Surfaces agent-adjacent identity the flat table already has (label, project)
+ * with a clickable project when a GitHub URL is resolvable, then the checklist
+ * tally and the latest-turn snippet.
+ *
+ * Free-text fields are cleaned individually; OSC 8 hyperlinks are applied
+ * *after* cleaning so `cleanPreview` does not strip the clickable targets
+ * (RUSH-2045 review). Ticket is clickable via {@link signalBadges}, not here,
+ * so the id is not printed twice.
+ */
+export function formatActiveRowDescription(s) {
+    const parts = [];
+    const pushText = (t) => {
+        const c = t ? cleanPreview(t) : '';
+        if (c)
+            parts.push(c);
+    };
+    if (s.context === 'teams' && s.teamName)
+        pushText(s.teamName);
+    if (s.label)
+        pushText(s.label);
+    // Project = basename(cwd), same derivation as serializeActiveSessionsForJson.
+    const project = s.cwd ? path.basename(s.cwd) : '';
+    if (project && project !== s.label && project !== s.teamName) {
+        const label = cleanPreview(project);
+        const repoUrl = githubRepoUrlFromCwd(s.cwd);
+        parts.push(repoUrl ? linkUrl(repoUrl, label) : label);
+    }
+    const todo = formatTodoCompact(s.todos);
+    if (todo)
+        parts.push(todo);
+    // Latest-turn snippet — avoid repeating label/topic when already used as identity.
+    if (s.context === 'cloud') {
+        pushText(s.preview || `${s.cloudProvider ?? ''}${s.cloudTaskId ? ` · ${s.cloudTaskId.slice(0, 12)}` : ''}`);
+    }
+    else if (s.preview) {
+        pushText(s.preview);
+    }
+    else if (!s.label && s.topic) {
+        pushText(s.topic);
+    }
+    return parts.filter(Boolean).join(' · ');
 }
 /** Short human word for a session's activity (falls back to the coarse status). */
 function activityLabel(s) {
@@ -325,10 +380,15 @@ function signalBadges(s) {
         parts.push(chalk.yellow('ask'));
     else if (s.awaitingReason === 'permission')
         parts.push(chalk.yellow('perm'));
-    if (s.ticket)
-        parts.push(chalk.cyan(s.ticket.id));
-    if (s.pr)
-        parts.push(chalk.blue(`PR#${s.pr.number ?? '?'}`));
+    if (s.ticket) {
+        // Clickable when Linear workspace is resolvable (same helper as the picker header).
+        const url = linearIssueUrl(s.ticket.id);
+        parts.push(chalk.cyan(url ? linkUrl(url, s.ticket.id) : s.ticket.id));
+    }
+    if (s.pr) {
+        const label = `PR#${s.pr.number ?? '?'}`;
+        parts.push(chalk.blue(s.pr.url ? linkUrl(s.pr.url, label) : label));
+    }
     if (s.worktree)
         parts.push(chalk.magenta(`wt:${s.worktree.slug}`));
     return parts.join(' ');
@@ -343,8 +403,10 @@ function signalBadges(s) {
 function locatorBadge(s) {
     const p = s.provenance;
     const parts = [];
+    // An ssh-launched session shows where it was launched FROM when the client IP
+    // resolves to a registered device (`ssh←zion`); bare `ssh` when it doesn't.
     if (p?.transport === 'ssh')
-        parts.push(chalk.red('ssh'));
+        parts.push(chalk.red(p.origin ? `ssh←${p.origin.device}` : 'ssh'));
     if (p?.mux?.kind === 'tmux' && (s.tmuxTarget || p.mux.pane)) {
         parts.push(chalk.green(s.tmuxTarget ?? p.mux.pane));
         // For a tmux-hosted session, say which app+tab is looking at it right now
@@ -373,13 +435,17 @@ function locatorBadge(s) {
  * terminal width so the row never wraps.
  */
 function printActiveRow(s, indent) {
+    // shortId (8-char) · agent · host · status · badges · identity+todos+snippet
     const idCol = chalk.dim(padToWidth((s.sessionId?.slice(0, 8)) ?? '-', 9));
     const kindCol = colorAgent(s.kind)(padToWidth(truncateToWidth(s.kind, 8), 9));
     const hostCol = chalk.gray(padToWidth(truncateToWidth(s.host ?? '-', 8), 9));
     const statusCol = statusColor(s.status)(padToWidth(truncateToWidth(activityLabel(s), 8), 9));
     const fork = s.pidCount && s.pidCount > 1 ? chalk.dim(`×${s.pidCount} `) : '';
     const badges = (fork ? fork : '') + [signalBadges(s), locatorBadge(s)].filter(Boolean).join(' ');
-    const desc = buildSessionDescription(s) || '-';
+    // Identity (label/project/ticket clickable) + checklist + live snippet.
+    // Cross-machine rows use the same path — remote ActiveSession fields arrive
+    // via the SSH fan-out already populated (including todos when the peer has them).
+    const desc = formatActiveRowDescription(s) || '-';
     // Fill the remaining width with the preview so nothing wraps under tmux/SSH.
     const fixed = stringWidth(indent) + 9 + 9 + 9 + 9 + (badges ? stringWidth(badges) + 1 : 0);
     const room = Math.max(12, terminalWidth() - fixed - 1);
@@ -1247,9 +1313,12 @@ function flatSessionRow(session, live, showTicket = false, cols = {}) {
     const tag = originTag(session) || teamTag(session);
     const label = session.label;
     const { glyph, preview } = liveGlyphAndPreview(live);
-    // A running session's live preview says what the agent is doing now; a
-    // resting one falls back to its opening topic.
-    const doing = preview || (tag ? `${tag}${session.topic ?? ''}` : session.topic);
+    // A running session's live preview (via liveGlyphAndPreview → buildSessionDescription)
+    // already folds in ActiveSession.todos. For resting / not-live rows, surface
+    // SessionMeta.todos when the scan attached it.
+    const restingTodo = !live ? formatTodoCompact(session.todos) : '';
+    const topicBase = tag ? `${tag}${session.topic ?? ''}` : session.topic;
+    const doing = [restingTodo, preview || topicBase].filter(Boolean).join(' · ') || undefined;
     const wt = session.worktreeSlug ? chalk.magenta(`wt:${session.worktreeSlug}`) : '';
     // The machine column only earns its width when the listing spans more than one
     // box (i.e. the cross-machine fan-out folded remotes in) — same rule and
@@ -1285,7 +1354,11 @@ function treeSessionRow(session, live) {
     const tag = originTag(session) || teamTag(session);
     const label = session.label;
     const { glyph, preview } = liveGlyphAndPreview(live);
-    const topic = (preview || (tag ? `${tag}${session.topic ?? ''}` : session.topic)) || '-';
+    // Match flatSessionRow: live preview already folds ActiveSession.todos; resting
+    // rows surface SessionMeta.todos when present (RUSH-2045).
+    const restingTodo = !live ? formatTodoCompact(session.todos) : '';
+    const topicBase = preview || (tag ? `${tag}${session.topic ?? ''}` : session.topic);
+    const topic = [restingTodo, topicBase].filter(Boolean).join(' · ') || '-';
     const badges = signalBadges(metaSignals(session));
     const badgeW = badges ? stringWidth(badges) + 1 : 0;
     const head = label ? `${label} · ${topic}` : topic;
@@ -1652,10 +1725,18 @@ export function pickerColumnsFor(sessions) {
         showTicket: sessions.some((s) => ticketLabel(s) !== ''),
     };
 }
-export function formatPickerLabel(s, query, cols = {}) {
+export function formatPickerLabel(s, query, cols = {}, ssh) {
     const agentColor = colorAgent(s.agent);
     const when = formatRelativeTime(s.lastActivity ?? s.timestamp);
     const project = s.project || '-';
+    // SSH-launch origin (live rows only): mirrors the flat listing's `ssh←<device>`
+    // badge. Rendered as its OWN red segment before the topic cell — folding it into
+    // the topic string loses the colour, because renderTopicCell strips ANSI and
+    // re-whitens every slice. Its width is reserved from the topic budget below
+    // (exactly like `wt`), so the fixed-width columns stay aligned.
+    const sshPlain = ssh ? (ssh.device ? `ssh←${ssh.device} ` : 'ssh ') : '';
+    const sshSeg = sshPlain ? chalk.red(sshPlain) : '';
+    const sshW = sshPlain ? stringWidth(sshPlain) : 0;
     const tag = originTag(s) || teamTag(s);
     const label = s.label;
     const topic = tag ? `${tag}${s.topic ?? ''}` : s.topic;
@@ -1676,12 +1757,13 @@ export function formatPickerLabel(s, query, cols = {}) {
     const machineColW = cols.showMachine ? machineW : 0;
     const ticketW = cols.showTicket ? TICKET_W + 1 : 0;
     const wtW = wt ? stringWidth(wt) + 1 : 0;
-    const topicW = Math.max(16, terminalWidth() - gutter - (10 + 9 + 8 + 16) - machineColW - ticketW - wtW - stringWidth(when) - 1);
+    const topicW = Math.max(16, terminalWidth() - gutter - (10 + 9 + 8 + 16) - machineColW - ticketW - wtW - sshW - stringWidth(when) - 1);
     return (chalk.white(padRight(s.shortId, 10)) +
         agentColor(padRight(truncate(s.agent, 8), 9)) +
         chalk.yellow(padRight(truncate(versionStr, 7), 8)) +
         machineCell +
         chalk.cyan(padRight(truncate(project, 14), 16)) +
+        sshSeg +
         renderTopicCell(label, topic, query, topicW, topicW) +
         ticketCell +
         (wt ? wt + ' ' : '') +
@@ -2062,9 +2144,10 @@ function formatSearchMessage(options) {
 /**
  * The single entry point for turning a `sessions <query>` argument into rows.
  *
- * A complete session id resolves by id alone. Anything else keeps the existing
- * ladder: id lookup first (so a short id still wins), then the ranked
- * metadata+content search.
+ * An id-shaped query — a complete id OR a hex short-id/prefix (looksLikeSessionId)
+ * — resolves by id alone, through the index, and never falls back to content
+ * search (a bare id must not surface every transcript that merely mentions it).
+ * A genuine search phrase keeps the ranked metadata+content search.
  */
 export function resolveSessionQuery(pool, query) {
     // Normalize ONCE here. isCompleteSessionId trims but resolveSessionById does
@@ -2076,12 +2159,16 @@ export function resolveSessionQuery(pool, query) {
     const byIdMatches = resolveSessionById(pool, normalized);
     if (byIdMatches.length > 0)
         return { matches: byIdMatches, byId: true, completeId };
-    if (completeId) {
-        // The pool is only what discoverSessions walked — a minority of the index
-        // (measured: 2,798 of 7,614 rows), because it re-reads live agent homes and
-        // skips whole classes of indexed session. Declaring absence from the pool
-        // alone denied 1,315 sessions whose transcript is on this disk right now.
-        // Ask the index itself, the same authoritative lookup `fork` and `exec` use.
+    if (looksLikeSessionId(normalized)) {
+        // Any id-shaped query — a complete id OR a bare hex short-id/prefix —
+        // resolves by id ONLY, never by content. The pool is a minority of the
+        // index (measured: 2,798 of 7,614 rows) because it re-reads live agent homes
+        // and skips whole classes of indexed session, so a pool miss isn't absence:
+        // ask the index directly, the same authoritative lookup `fork` and `exec`
+        // use. And an id that resolves to nothing must report "no session with that
+        // id" — NOT fall back to fuzzy content search. A short id like "d3470b57"
+        // otherwise surfaces every transcript that merely MENTIONS the string (a
+        // resume prompt echoes the parent id into the body of many later sessions).
         return { matches: findSessionsById(normalized), byId: true, completeId };
     }
     return { matches: filterSessionsByQuery(pool, normalized), byId: false, completeId };
@@ -2237,7 +2324,7 @@ async function renderArtifactsGlobal(query, listAll, name, scope) {
         const { matches: queryMatches, byId, completeId } = resolveSessionQuery(allSessions, query);
         if (queryMatches.length === 0) {
             spinner.stop();
-            if (completeId)
+            if (byId)
                 notFoundByIdMessage(query).forEach(l => console.error(l));
             else
                 console.error(chalk.red(`No session found matching: ${query}`));
@@ -2281,11 +2368,14 @@ async function renderOneSession(query, mode, scope) {
         let queryMatches = resolution.matches;
         let byId = resolution.byId;
         const completeId = resolution.completeId;
-        // Widen to the transcript content index only for a genuine search phrase. A
-        // complete id is unique, so widening could only ever surface a DIFFERENT
-        // session that happens to mention the id — which is what made `sessions
-        // <uuid>` render an unrelated transcript.
-        if (queryMatches.length === 0 && !completeId) {
+        // Widen to the transcript content index only for a genuine search phrase.
+        // ANY id-shaped query (a complete id OR a hex short-id/prefix) names a
+        // specific session; widening could only surface a DIFFERENT session that
+        // happens to MENTION the id — which is what made `sessions <uuid>` render an
+        // unrelated transcript and `sessions <shortid>` list every session that
+        // echoes the id in a resume prompt. Gate on looksLikeSessionId, not just
+        // completeId, so a short id resolves to "no match" rather than fuzzy content.
+        if (queryMatches.length === 0 && !looksLikeSessionId(query)) {
             const contentResults = searchContentIndex(allSessions, query);
             if (contentResults.size > 0) {
                 const matchedSessions = Array.from(contentResults.values())
@@ -2312,7 +2402,7 @@ async function renderOneSession(query, mode, scope) {
                     process.exit(1);
                 }
             }
-            else if (completeId) {
+            else if (byId) {
                 notFoundByIdMessage(query).forEach(l => console.error(l));
                 process.exit(1);
             }
@@ -2377,10 +2467,10 @@ export function registerSessionsCommands(program) {
         .option('--markdown', 'Render the session as markdown (user, assistant, thinking, tool calls)')
         .option('--no-redact', 'Disable default secret redaction in rendered session output (--markdown and --json)')
         .option('--json', 'Output JSON (session list when browsing, event array when rendering one session)')
-        .option('--include <roles>', 'Only include these roles (comma-separated): user, assistant, thinking, tools')
+        .option('--include <roles>', 'Only include these roles (comma-separated): user, assistant, thinking, tools. "user" is genuine user turns only, not harness-injected scaffolding (bash-input, system-reminder)')
         .option('--exclude <roles>', 'Exclude these roles (comma-separated): user, assistant, thinking, tools')
-        .option('--first <n>', 'Keep only the first N turns (a turn starts at each user message)')
-        .option('--last <n>', 'Keep only the last N turns (a turn starts at each user message)')
+        .option('--first <n>', 'Keep only the first N turns (a turn starts at each genuine user message, not harness-injected scaffolding)')
+        .option('--last <n>', 'Keep only the last N turns (a turn starts at each genuine user message, not harness-injected scaffolding)')
         .option('--artifacts', 'List all files written or edited during a session')
         .option('--artifact <name>', 'Read a specific artifact by filename or path (outputs to stdout)')
         .option('--active', 'Show only sessions running right now across terminals, teams, cloud, and headless agents')

package/dist/commands/ssh.d.ts

@@ -10,6 +10,7 @@
  * rsync / `agents sessions --host` resolve the same logical names.
  */
 import type { Command } from 'commander';
+import { type FanOutDeviceTarget } from '../lib/devices/fleet.js';
 import { type CrabboxBox } from '../lib/crabbox/cli.js';
 /**
  * Live "Leased boxes" section for `agents devices` (F4, RUSH-1923), computed
@@ -19,5 +20,17 @@ import { type CrabboxBox } from '../lib/crabbox/cli.js';
  * the row formatting is deterministic in tests.
  */
 export declare function renderLeasedBoxesSection(boxes: CrabboxBox[], nowSecs: number): string[];
+/**
+ * Race `fanOut` against an overall wall-clock deadline (RUSH-2041).
+ *
+ * If `fanOut` settles first the result passes through unchanged. If the
+ * deadline fires first every pending remote target is mapped to `failed` (or
+ * `skipped` for pre-skipped targets), so callers always get a complete result
+ * array and the command exits promptly rather than hanging.
+ *
+ * Exported so the unit test can exercise the real path with a hanging probe
+ * instead of reimplementing the logic.
+ */
+export declare function raceFleetPingDeadline<T, Target extends FanOutDeviceTarget>(fanOut: Promise<import('../lib/devices/fleet.js').FanOutDeviceResult<T>[]>, remoteTargets: Target[], overallTimeoutMs: number): Promise<import('../lib/devices/fleet.js').FanOutDeviceResult<T>[]>;
 /** Register both `agents ssh` and `agents devices`. */
 export declare function registerSshCommands(program: Command): void;

package/dist/commands/ssh.js

@@ -441,13 +441,43 @@ async function probeRemoteAuth(target) {
     const isWin = /^win/i.test((target.platform ?? '').trim());
     const env = isWin ? undefined : { PATH: '$HOME/.agents/.cache/shims:$HOME/.local/bin:$PATH' };
     const cmd = buildRemoteAgentsInvocation(['devices', 'ping', '--local', '--json'], undefined, isWin ? 'windows' : undefined, env);
-    const res = await sshExecAsync(target.dialTarget, cmd, { timeoutMs: 60000, multiplex: true });
+    const res = await sshExecAsync(target.dialTarget, cmd, { timeoutMs: 15000, multiplex: true });
     if (res.code !== 0) {
         throw new Error(res.timedOut ? 'timed out' : (res.stderr.trim() || `exit ${res.code ?? 'unknown'}`));
     }
     const parsed = JSON.parse(res.stdout);
     return parsed.rows ?? [];
 }
+/**
+ * Race `fanOut` against an overall wall-clock deadline (RUSH-2041).
+ *
+ * If `fanOut` settles first the result passes through unchanged. If the
+ * deadline fires first every pending remote target is mapped to `failed` (or
+ * `skipped` for pre-skipped targets), so callers always get a complete result
+ * array and the command exits promptly rather than hanging.
+ *
+ * Exported so the unit test can exercise the real path with a hanging probe
+ * instead of reimplementing the logic.
+ */
+export async function raceFleetPingDeadline(fanOut, remoteTargets, overallTimeoutMs) {
+    const overallDeadline = new Promise((_, reject) => setTimeout(() => reject(new Error('fleet ping overall deadline exceeded')), overallTimeoutMs));
+    try {
+        return await Promise.race([fanOut, overallDeadline]);
+    }
+    catch (err) {
+        // Overall deadline hit before all devices settled — mark every pending
+        // device as failed so the command exits promptly. Individual probes that
+        // already settled are not retrievable (Promise.all internals), so we
+        // record all remote targets as timed out / skipped.
+        const errMsg = err instanceof Error ? err.message : String(err);
+        return remoteTargets.map((t) => ({
+            name: t.name,
+            status: t.skip ? 'skipped' : 'failed',
+            reason: t.skip,
+            error: t.skip ? undefined : errMsg,
+        }));
+    }
+}
 async function runFleetPing(opts) {
     const self = machineId();
     const cliVersion = getCliVersion();
@@ -484,9 +514,16 @@ async function runFleetPing(opts) {
     const spinner = isInteractiveTerminal() && !opts.json
         ? ora(`Pinging ${probeable} device${probeable === 1 ? '' : 's'}…`).start()
         : undefined;
+    // Per-device: 15 s (matches the version probe budget; enough for the ~8 s
+    // provider-fetch inside the remote local auth probe, with headroom).
+    // Overall: 30 s hard cap so the command can never outlast a reasonable
+    // budget when several devices are simultaneously unreachable (RUSH-2041).
+    const FLEET_PING_DEVICE_TIMEOUT_MS = 15_000;
+    const FLEET_PING_OVERALL_TIMEOUT_MS = 30_000;
     let remote;
     try {
-        remote = await fanOutDevices(remoteTargets, probeRemoteAuth);
+        const fanOut = fanOutDevices(remoteTargets, probeRemoteAuth, { perDeviceTimeoutMs: FLEET_PING_DEVICE_TIMEOUT_MS });
+        remote = await raceFleetPingDeadline(fanOut, remoteTargets, FLEET_PING_OVERALL_TIMEOUT_MS);
     }
     finally {
         spinner?.stop();

package/dist/index.js

@@ -64,7 +64,8 @@ if (process.argv[2] === SYNC_GET_CMD ||
     process.argv[2] === SYNC_LOCK_CMD) {
     const { runAgentGetSync, runAgentPingSync, runAgentLockSync } = await import('./lib/secrets/agent.js');
     const name = process.argv[3] ?? '';
-    const code = process.argv[2] === SYNC_GET_CMD ? await runAgentGetSync(name)
+    const harness = process.argv[4] ?? 'cli';
+    const code = process.argv[2] === SYNC_GET_CMD ? await runAgentGetSync(name, harness)
         : process.argv[2] === SYNC_PING_CMD ? await runAgentPingSync()
             : await runAgentLockSync(name);
     process.exit(code);

package/dist/lib/activity.d.ts

@@ -1,6 +1,6 @@
 import type { EventRecord } from './events.js';
 /** Recognizable milestone events, ordered first in any activity lane. */
-export type MilestoneEvent = 'plan.created' | 'pr.opened' | 'pr.merged' | 'worktree.created' | 'worktree.removed' | 'commit.created' | 'pushed' | 'subagent.spawned' | 'artifact.created'
+export type MilestoneEvent = 'plan.created' | 'pr.opened' | 'pr.merged' | 'worktree.created' | 'worktree.removed' | 'commit.created' | 'pushed' | 'subagent.spawned' | 'artifact.created' | 'task.completed' | 'checklist.created'
 /** Deliberate agent-authored progress post (`agents feed post`). */
  | 'status.posted';
 /** Routine activity events, collapsed to counts by readers. */
@@ -117,10 +117,11 @@ export declare function formatActivityLine(ev: ActivityEvent, opts?: {
  * line per event to ~/.agents/.history/activity/<sessionId>.jsonl.
  *
  * Matcher-gated to mutating/milestone tools (Bash|Task|ExitPlanMode|Write|
- * Edit|MultiEdit) so read-only tools never pay the hook cost. Fail-open: any
- * error is swallowed so a logging hiccup never blocks a tool call.
+ * Edit|MultiEdit|TodoWrite|update_plan|TaskUpdate|todo_write|TaskCreate) so
+ * read-only tools never pay the hook cost. Fail-open: any error is swallowed so
+ * a logging hiccup never blocks a tool call.
  */
-export declare const ACTIVITY_LOG_HOOK_SCRIPT = "#!/usr/bin/env python3\n\"\"\"Append agent-activity events for `agents feed` / `agents activity`.\n\nBound to PreToolUse (ExitPlanMode, Task) and PostToolUse (Bash, Write, Edit,\nMultiEdit). One append-only file per session; read-only tools never trigger it\nbecause the manifest matcher excludes them.\n\nSub-agent gate: when the payload carries `agent_type`, this is a Task/Agent\nsub-agent -- skip so only the top-level agent logs its own activity.\n\nFail-open: ANY error is swallowed so a logging hiccup never blocks a tool call.\n\"\"\"\nimport os\nimport re\nimport sys\nimport json\nimport shlex\nimport socket\nfrom datetime import datetime, timezone\n\nMAX_LOG_BYTES = 5 * 1024 * 1024  # cap a pathological session's log\nMILESTONE_EVENTS = {\n    \"plan.created\", \"pr.opened\", \"pr.merged\", \"worktree.created\",\n    \"worktree.removed\", \"commit.created\", \"pushed\", \"subagent.spawned\",\n    \"artifact.created\", \"status.posted\",\n}\n\n# Deliverable file types + locations -- a Write here is a recognizable artifact\n# (an HTML plan, a PDF report, a rendered image), not a routine code edit.\nARTIFACT_EXTS = {\n    \".html\", \".htm\", \".pdf\", \".png\", \".jpg\", \".jpeg\", \".gif\", \".svg\",\n    \".webp\", \".mp4\", \".mov\", \".webm\", \".csv\", \".xlsx\", \".pptx\", \".docx\",\n}\nARTIFACT_DIR_HINTS = (\"/tmp/\", \"/downloads/\", \"/.agents/artifacts/\")\n\n\ndef is_artifact(file_path):\n    low = (file_path or \"\").lower()\n    if os.path.splitext(low)[1] in ARTIFACT_EXTS:\n        return True\n    return any(hint in low for hint in ARTIFACT_DIR_HINTS)\n\n\ndef first_line(text, limit=140):\n    for raw in (text or \"\").splitlines():\n        s = raw.strip().lstrip(\"#\").strip()\n        if s:\n            return s[:limit]\n    return \"\"\n\n\ndef _subcommand(tokens, tool):\n    \"\"\"First non-flag token after `tool`, i.e. its subcommand (skips -C <path>,\n    -c <cfg>, and other leading flags). None if `tool` isn't the invoked command.\"\"\"\n    try:\n        i = tokens.index(tool) + 1\n    except ValueError:\n        return None, []\n    while i < len(tokens):\n        t = tokens[i]\n        if t in (\"-C\", \"-c\", \"--git-dir\", \"--work-tree\"):\n            i += 2  # flag that consumes the next token\n            continue\n        if t.startswith(\"-\"):\n            i += 1\n            continue\n        return t, tokens[i + 1:]\n    return None, []\n\n\ndef classify_bash(command):\n    \"\"\"Return the milestone event for a git/gh command, else None. Tokenizes so a\n    path like `git diff -- src/commit.ts` is not mistaken for a commit.\"\"\"\n    try:\n        tokens = shlex.split(command or \"\")\n    except Exception:\n        tokens = (command or \"\").split()\n\n    verb, rest = _subcommand(tokens, \"git\")\n    if verb == \"worktree\":\n        sub = rest[0] if rest else \"\"\n        if sub == \"add\":\n            return \"worktree.created\"\n        if sub == \"remove\":\n            return \"worktree.removed\"\n    elif verb == \"commit\":\n        return \"commit.created\"\n    elif verb == \"push\":\n        return \"pushed\"\n\n    verb, rest = _subcommand(tokens, \"gh\")\n    if verb == \"pr\" and rest:\n        if rest[0] == \"create\":\n            return \"pr.opened\"\n        if rest[0] == \"merge\":\n            return \"pr.merged\"\n    return None\n\n\ndef extract_url(tool_response):\n    \"\"\"Pull the first https URL out of a Bash tool response (stdout).\"\"\"\n    text = \"\"\n    if isinstance(tool_response, dict):\n        text = str(tool_response.get(\"stdout\") or tool_response.get(\"output\") or \"\")\n    elif isinstance(tool_response, str):\n        text = tool_response\n    m = re.search(r\"https?://\\S+\", text)\n    return m.group(0).rstrip(\").,\") if m else None\n\n\ndef build_event(payload, hook_event):\n    tool_name = payload.get(\"tool_name\", \"\")\n    tool_input = payload.get(\"tool_input\", {}) or {}\n    tool_response = payload.get(\"tool_response\", {})\n\n    event = None\n    detail = None\n    url = None\n\n    if hook_event == \"PreToolUse\":\n        if tool_name == \"ExitPlanMode\":\n            event = \"plan.created\"\n            detail = first_line(tool_input.get(\"plan\", \"\")) or \"plan presented\"\n        elif tool_name == \"Task\":\n            event = \"subagent.spawned\"\n            role = tool_input.get(\"subagent_type\") or \"agent\"\n            desc = tool_input.get(\"description\") or tool_input.get(\"prompt\") or \"\"\n            detail = (role + \": \" + first_line(desc)).strip(\": \").strip()\n    elif hook_event == \"PostToolUse\":\n        if tool_name == \"Bash\":\n            event = classify_bash(tool_input.get(\"command\", \"\"))\n            if event:\n                detail = first_line(tool_input.get(\"command\", \"\"))\n                url = extract_url(tool_response)\n        elif tool_name in (\"Write\", \"Edit\", \"MultiEdit\"):\n            fp = tool_input.get(\"file_path\") or tool_input.get(\"path\") or \"\"\n            # A freshly-written deliverable is a milestone; edits and code\n            # writes stay routine and collapse to a count.\n            if tool_name == \"Write\" and is_artifact(fp):\n                event = \"artifact.created\"\n            else:\n                event = \"file.edited\"\n            detail = os.path.basename(fp) if fp else tool_name\n\n    if not event:\n        return None, tool_name\n\n    tier = \"milestone\" if event in MILESTONE_EVENTS else \"activity\"\n    record = {\n        \"v\": 1,\n        \"ts\": datetime.now(timezone.utc).isoformat(),\n        \"event\": event,\n        \"tier\": tier,\n    }\n    if detail:\n        record[\"detail\"] = detail\n    if url:\n        record[\"url\"] = url\n    record[\"tool\"] = tool_name\n    return record, tool_name\n\n\ndef main():\n    raw = sys.stdin.read()\n    try:\n        payload = json.loads(raw) if raw.strip() else {}\n    except Exception:\n        return\n\n    # Sub-agent gate -- only the top-level agent logs.\n    if payload.get(\"agent_type\"):\n        return\n\n    session_id = payload.get(\"session_id\", \"\")\n    if not session_id:\n        return\n\n    hook_event = payload.get(\"hook_event_name\", \"\")\n    record, tool_name = build_event(payload, hook_event)\n    if not record:\n        return\n\n    safe_session = re.sub(r\"[^A-Za-z0-9._-]\", \"-\", session_id) or \"unknown\"\n    home = os.environ.get(\"HOME\") or os.path.expanduser(\"~\")\n    activity_dir = os.path.join(home, \".agents\", \".history\", \"activity\")\n    target = os.path.join(activity_dir, safe_session + \".jsonl\")\n\n    # Identity (mirrors 10-feed-publish.py).\n    mailbox_id = os.path.basename(\n        os.environ.get(\"AGENTS_MAILBOX_DIR\", \"\").rstrip(\"/\")\n    ) or session_id\n    hostname = os.environ.get(\"AGENTS_SYNC_MACHINE_ID\") or socket.gethostname()\n    host = re.sub(r\"[^a-z0-9_-]\", \"-\", hostname.split(\".\")[0].strip().lower()) or \"unknown\"\n\n    record[\"sessionId\"] = session_id\n    record[\"mailboxId\"] = mailbox_id\n    record[\"host\"] = host\n    record[\"runtime\"] = os.environ.get(\"AGENTS_RUNTIME\", \"headless\")\n    cwd = payload.get(\"cwd\") or os.environ.get(\"AGENTS_CWD\")\n    if cwd:\n        record[\"cwd\"] = cwd\n    agent = os.environ.get(\"AGENTS_AGENT_NAME\") or \"claude\"\n    record[\"agent\"] = agent\n\n    try:\n        os.makedirs(activity_dir, exist_ok=True)\n        # Cap growth: once over the size limit, keep only milestones.\n        if record[\"tier\"] != \"milestone\":\n            try:\n                if os.path.getsize(target) > MAX_LOG_BYTES:\n                    return\n            except OSError:\n                pass\n        with open(target, \"a\") as f:\n            f.write(json.dumps(record) + \"\\n\")\n    except Exception:\n        pass  # fail open\n\n\nif __name__ == \"__main__\":\n    try:\n        main()\n    except Exception:\n        pass  # fail open\n";
+export declare const ACTIVITY_LOG_HOOK_SCRIPT = "#!/usr/bin/env python3\n\"\"\"Append agent-activity events for `agents feed` / `agents activity`.\n\nBound to PreToolUse (ExitPlanMode, Task) and PostToolUse (Bash, Write, Edit,\nMultiEdit, TodoWrite, update_plan, TaskUpdate, todo_write, TaskCreate). One\nappend-only file per session; read-only tools never trigger it because the\nmanifest matcher excludes them.\n\nSub-agent gate: when the payload carries `agent_type`, this is a Task/Agent\nsub-agent -- skip so only the top-level agent logs its own activity.\n\nFail-open: ANY error is swallowed so a logging hiccup never blocks a tool call.\n\"\"\"\nimport os\nimport re\nimport sys\nimport json\nimport shlex\nimport socket\nfrom datetime import datetime, timezone\n\nMAX_LOG_BYTES = 5 * 1024 * 1024  # cap a pathological session's log\nMILESTONE_EVENTS = {\n    \"plan.created\", \"pr.opened\", \"pr.merged\", \"worktree.created\",\n    \"worktree.removed\", \"commit.created\", \"pushed\", \"subagent.spawned\",\n    \"artifact.created\", \"task.completed\", \"checklist.created\", \"status.posted\",\n}\n\n# Deliverable file types + locations -- a Write here is a recognizable artifact\n# (an HTML plan, a PDF report, a rendered image), not a routine code edit.\nARTIFACT_EXTS = {\n    \".html\", \".htm\", \".pdf\", \".png\", \".jpg\", \".jpeg\", \".gif\", \".svg\",\n    \".webp\", \".mp4\", \".mov\", \".webm\", \".csv\", \".xlsx\", \".pptx\", \".docx\",\n}\nARTIFACT_DIR_HINTS = (\"/tmp/\", \"/downloads/\", \"/.agents/artifacts/\")\n\n# Checklist tools across harnesses. The value is the key that holds the item list.\nCHECKLIST_TOOLS = {\n    \"TodoWrite\": \"todos\",\n    \"todo_write\": \"todos\",\n    \"TaskUpdate\": \"tasks\",\n    \"update_plan\": \"plan\",\n}\n\n\ndef is_artifact(file_path):\n    low = (file_path or \"\").lower()\n    if os.path.splitext(low)[1] in ARTIFACT_EXTS:\n        return True\n    return any(hint in low for hint in ARTIFACT_DIR_HINTS)\n\n\ndef first_line(text, limit=140):\n    for raw in (text or \"\").splitlines():\n        s = raw.strip().lstrip(\"#\").strip()\n        if s:\n            return s[:limit]\n    return \"\"\n\n\ndef _subcommand(tokens, tool):\n    \"\"\"First non-flag token after `tool`, i.e. its subcommand (skips -C <path>,\n    -c <cfg>, and other leading flags). None if `tool` isn't the invoked command.\"\"\"\n    try:\n        i = tokens.index(tool) + 1\n    except ValueError:\n        return None, []\n    while i < len(tokens):\n        t = tokens[i]\n        if t in (\"-C\", \"-c\", \"--git-dir\", \"--work-tree\"):\n            i += 2  # flag that consumes the next token\n            continue\n        if t.startswith(\"-\"):\n            i += 1\n            continue\n        return t, tokens[i + 1:]\n    return None, []\n\n\ndef classify_bash(command):\n    \"\"\"Return the milestone event for a git/gh command, else None. Tokenizes so a\n    path like `git diff -- src/commit.ts` is not mistaken for a commit.\"\"\"\n    try:\n        tokens = shlex.split(command or \"\")\n    except Exception:\n        tokens = (command or \"\").split()\n\n    verb, rest = _subcommand(tokens, \"git\")\n    if verb == \"worktree\":\n        sub = rest[0] if rest else \"\"\n        if sub == \"add\":\n            return \"worktree.created\"\n        if sub == \"remove\":\n            return \"worktree.removed\"\n    elif verb == \"commit\":\n        return \"commit.created\"\n    elif verb == \"push\":\n        return \"pushed\"\n\n    verb, rest = _subcommand(tokens, \"gh\")\n    if verb == \"pr\" and rest:\n        if rest[0] == \"create\":\n            return \"pr.opened\"\n        if rest[0] == \"merge\":\n            return \"pr.merged\"\n    return None\n\n\ndef extract_url(tool_response):\n    \"\"\"Pull the first https URL out of a Bash tool response (stdout).\"\"\"\n    text = \"\"\n    if isinstance(tool_response, dict):\n        text = str(tool_response.get(\"stdout\") or tool_response.get(\"output\") or \"\")\n    elif isinstance(tool_response, str):\n        text = tool_response\n    m = re.search(r\"https?://\\S+\", text)\n    return m.group(0).rstrip(\").,\") if m else None\n\n\ndef _checklist_items(tool_input, kind):\n    \"\"\"Extract normalized checklist items from tool input.\"\"\"\n    if not isinstance(tool_input, dict):\n        return []\n    if kind == \"todos\":\n        arr = tool_input.get(\"todos\") or []\n    elif kind == \"tasks\":\n        arr = tool_input.get(\"tasks\") or []\n        if not arr and \"taskId\" in tool_input:\n            arr = [tool_input]\n    elif kind == \"plan\":\n        arr = tool_input.get(\"plan\") or []\n    else:\n        return []\n    if not isinstance(arr, list):\n        return []\n\n    items = []\n    for t in arr:\n        if not isinstance(t, dict):\n            continue\n        subject = (\n            t.get(\"content\") or\n            t.get(\"text\") or\n            t.get(\"step\") or\n            t.get(\"title\") or\n            t.get(\"description\") or\n            t.get(\"activeForm\") or\n            \"\"\n        )\n        if not isinstance(subject, str):\n            subject = str(subject)\n        subject = subject.strip()\n        item_id = t.get(\"id\") or t.get(\"taskId\") or subject\n        if not item_id:\n            continue\n        status = str(t.get(\"status\", \"\") or \"\").lower()\n        items.append({\"id\": item_id, \"subject\": subject, \"status\": status})\n    return items\n\n\ndef _read_transcript_checklists(transcript_path, current_tool, current_items):\n    \"\"\"Tail-read the session transcript and return the previous checklist state.\n\n    The most recent checklist entry is assumed to be the current tool call if\n    it carries the same ids; skip that one and return the next older checklist\n    state (or None if there isn't one).\n    \"\"\"\n    if not transcript_path or not os.path.exists(transcript_path):\n        return None\n    try:\n        size = os.path.getsize(transcript_path)\n        start = max(0, size - 512 * 1024)\n        with open(transcript_path, \"r\", encoding=\"utf-8\", errors=\"ignore\") as f:\n            f.seek(start)\n            if start > 0:\n                f.readline()  # drop a leading partial line\n            lines = f.readlines()\n    except Exception:\n        return None\n\n    current_ids = {str(item.get(\"id\")) for item in current_items if item.get(\"id\")}\n    skipped_current = False\n    for line in reversed(lines):\n        line = line.strip()\n        if not line:\n            continue\n        try:\n            record = json.loads(line)\n        except Exception:\n            continue\n        if not isinstance(record, dict):\n            continue\n\n        tool_uses = []\n        if isinstance(record.get(\"tool_use\"), list):\n            tool_uses = record[\"tool_use\"]\n        elif record.get(\"name\"):\n            tool_uses = [record]\n        elif record.get(\"tool_name\"):\n            tool_uses = [record]\n\n        for tu in reversed(tool_uses):\n            if not isinstance(tu, dict):\n                continue\n            name = tu.get(\"name\") or tu.get(\"tool_name\") or \"\"\n            if name not in CHECKLIST_TOOLS:\n                continue\n            kind = CHECKLIST_TOOLS[name]\n            args = tu.get(\"input\") or tu.get(\"tool_input\") or tu.get(\"arguments\") or {}\n            if isinstance(args, str):\n                try:\n                    args = json.loads(args)\n                except Exception:\n                    continue\n            items = _checklist_items(args, kind)\n            if not items:\n                continue\n            ids = {str(item.get(\"id\")) for item in items if item.get(\"id\")}\n            # Skip the most recent matching checklist entry once; that is the\n            # current call already reflected in the transcript.\n            if not skipped_current and name == current_tool and ids == current_ids:\n                skipped_current = True\n                continue\n            return items\n    return None\n\n\ndef _has_previous_task_create(transcript_path, current_tool_use_id=\"\"):\n    \"\"\"Return True if the transcript contains a TaskCreate before the current one.\"\"\"\n    if not transcript_path or not os.path.exists(transcript_path):\n        return False\n    try:\n        with open(transcript_path, \"r\", encoding=\"utf-8\", errors=\"ignore\") as f:\n            lines = f.readlines()\n    except Exception:\n        return False\n\n    for line in reversed(lines):\n        line = line.strip()\n        if not line:\n            continue\n        try:\n            record = json.loads(line)\n        except Exception:\n            continue\n        if not isinstance(record, dict):\n            continue\n\n        tool_uses = []\n        msg = record.get(\"message\", {})\n        if isinstance(msg, dict) and isinstance(msg.get(\"content\"), list):\n            tool_uses = [\n                c for c in msg[\"content\"]\n                if isinstance(c, dict) and c.get(\"type\") == \"tool_use\"\n            ]\n        elif isinstance(record.get(\"tool_use\"), list):\n            tool_uses = record[\"tool_use\"]\n        elif record.get(\"name\"):\n            tool_uses = [record]\n\n        for tu in reversed(tool_uses):\n            if not isinstance(tu, dict):\n                continue\n            if (tu.get(\"name\") or tu.get(\"tool_name\")) == \"TaskCreate\":\n                if tu.get(\"id\") != current_tool_use_id:\n                    return True\n    return False\n\n\ndef _claude_task_state(transcript_path, exclude_task_id=None):\n    \"\"\"Fold Claude TaskCreate/TaskUpdate calls into a task id -> subject/status map.\n\n    TaskCreate provides the subject (and id via toolUseResult); TaskUpdate\n    provides the status. If exclude_task_id is given, the last TaskUpdate for\n    that id is skipped (it is the current call already reflected in the\n    transcript).\n    \"\"\"\n    state = {}\n    if not transcript_path or not os.path.exists(transcript_path):\n        return state\n    try:\n        with open(transcript_path, \"r\", encoding=\"utf-8\", errors=\"ignore\") as f:\n            lines = f.readlines()\n    except Exception:\n        return state\n\n    updates = []  # (task_id, status, line_index)\n    for idx, line in enumerate(lines):\n        line = line.strip()\n        if not line:\n            continue\n        try:\n            record = json.loads(line)\n        except Exception:\n            continue\n        if not isinstance(record, dict):\n            continue\n\n        tool_uses = []\n        msg = record.get(\"message\", {})\n        if isinstance(msg, dict) and isinstance(msg.get(\"content\"), list):\n            tool_uses = [\n                c for c in msg[\"content\"]\n                if isinstance(c, dict) and c.get(\"type\") == \"tool_use\"\n            ]\n        elif isinstance(record.get(\"tool_use\"), list):\n            tool_uses = record[\"tool_use\"]\n        elif record.get(\"name\"):\n            tool_uses = [record]\n\n        for tu in tool_uses:\n            if not isinstance(tu, dict):\n                continue\n            name = tu.get(\"name\") or \"\"\n            args = tu.get(\"input\") or tu.get(\"tool_input\") or {}\n            if isinstance(args, str):\n                try:\n                    args = json.loads(args)\n                except Exception:\n                    continue\n            if name == \"TaskCreate\":\n                subject = (\n                    args.get(\"subject\") or\n                    args.get(\"description\") or\n                    args.get(\"title\") or\n                    \"\"\n                )\n                if subject:\n                    # Link subject to the tool_use id so the result can map it.\n                    tool_id = tu.get(\"id\")\n                    if tool_id:\n                        state.setdefault(\"__pending_subject\", {})[tool_id] = subject\n\n        tool_result = record.get(\"toolUseResult\") or {}\n        if not isinstance(tool_result, dict):\n            continue\n        task = tool_result.get(\"task\")\n        if isinstance(task, dict):\n            task_id = str(task.get(\"id\") or task.get(\"taskId\") or \"\")\n            if task_id:\n                state.setdefault(task_id, {})\n                if task.get(\"subject\"):\n                    state[task_id][\"subject\"] = task[\"subject\"]\n                if task.get(\"status\"):\n                    state[task_id][\"status\"] = str(task.get(\"status\")).lower()\n                # Link any pending subject from the matching tool_use id.\n                tool_use_id = record.get(\"tool_use_id\") or \"\"\n                pending = state.get(\"__pending_subject\", {})\n                if tool_use_id and tool_use_id in pending:\n                    state[task_id][\"subject\"] = pending[tool_use_id]\n        task_id = str(tool_result.get(\"taskId\") or \"\")\n        status_change = tool_result.get(\"statusChange\") or {}\n        status = status_change.get(\"to\") or tool_result.get(\"status\")\n        if task_id and status:\n            state.setdefault(task_id, {})\n            state[task_id][\"status\"] = str(status).lower()\n            updates.append((task_id, str(status).lower(), idx))\n\n    if exclude_task_id and updates:\n        for i in range(len(updates) - 1, -1, -1):\n            if updates[i][0] == exclude_task_id:\n                del updates[i]\n                break\n        # Rebuild statuses from remaining updates.\n        for task_id in list(state.keys()):\n            if task_id.startswith(\"__\"):\n                continue\n            if \"subject\" not in state[task_id]:\n                del state[task_id]\n            else:\n                state[task_id].pop(\"status\", None)\n        for task_id, status, _ in updates:\n            if task_id in state:\n                state[task_id][\"status\"] = status\n\n    # Drop tasks removed from the checklist (deleted/cancelled): they are gone\n    # from the user-visible list, so they must not count toward the N/M total.\n    for task_id in list(state.keys()):\n        if task_id.startswith(\"__\"):\n            continue\n        if state[task_id].get(\"status\") in (\"deleted\", \"cancelled\", \"canceled\", \"removed\"):\n            del state[task_id]\n\n    # Drop internal bookkeeping.\n    state.pop(\"__pending_subject\", None)\n    return state\n\n\ndef _checklist_events(payload, hook_event):\n    \"\"\"Return a list of (event, detail) tuples for checklist tool calls.\"\"\"\n    if hook_event != \"PostToolUse\":\n        return []\n    tool_name = payload.get(\"tool_name\", \"\")\n    tool_input = payload.get(\"tool_input\", {}) or {}\n\n    if tool_name == \"TaskCreate\":\n        subject = (\n            tool_input.get(\"subject\") or\n            tool_input.get(\"description\") or\n            tool_input.get(\"title\") or\n            \"task\"\n        )\n        # Only announce the checklist on the very first task creation.\n        current_tool_use_id = payload.get(\"tool_use_id\", \"\")\n        transcript_path = payload.get(\"transcript_path\")\n        if _has_previous_task_create(transcript_path, current_tool_use_id):\n            return []\n        return [(\"checklist.created\", subject)]\n\n    if tool_name not in CHECKLIST_TOOLS:\n        return []\n\n    kind = CHECKLIST_TOOLS[tool_name]\n    items = _checklist_items(tool_input, kind)\n    if not items:\n        return []\n\n    # Full-list tools (TodoWrite, update_plan) send the whole checklist every\n    # time. Per-task update tools (TaskUpdate) send only the changed item, so\n    # totals and subject must be resolved from the previous full-list state.\n    list_key = {\"todos\": \"todos\", \"tasks\": \"tasks\", \"plan\": \"plan\"}.get(kind)\n    is_full_list = list_key is not None and list_key in tool_input\n\n    previous = _read_transcript_checklists(\n        payload.get(\"transcript_path\"), tool_name, items\n    )\n\n    if not is_full_list and previous:\n        total = len(previous)\n        previous_done = {\n            str(i.get(\"id\")) for i in previous\n            if i.get(\"status\") == \"completed\" and i.get(\"id\")\n        }\n        done_count = len(previous_done)\n        events = []\n        for item in items:\n            if item.get(\"status\") != \"completed\":\n                continue\n            item_id = str(item.get(\"id\"))\n            if item_id in previous_done:\n                continue\n            subject = item.get(\"subject\")\n            if not subject:\n                for p in previous:\n                    if str(p.get(\"id\")) == item_id and p.get(\"subject\"):\n                        subject = p[\"subject\"]\n                        break\n            if not subject:\n                subject = \"task\"\n            done_count += 1\n            events.append((\"task.completed\", f\"{subject} {done_count}/{total} done\"))\n        return events\n\n    # For TaskUpdate without a previous full-list state, fold the Claude\n    # TaskCreate/TaskUpdate history to resolve subject and N/M.\n    if tool_name == \"TaskUpdate\" and previous is None:\n        task_id = str(items[0].get(\"id\")) if items else \"\"\n        task_state = _claude_task_state(\n            payload.get(\"transcript_path\"), exclude_task_id=task_id\n        )\n        if task_state:\n            total = len(task_state)\n            previous_done = {\n                tid for tid, info in task_state.items()\n                if info.get(\"status\") == \"completed\"\n            }\n            done_count = len(previous_done)\n            if task_id in task_state and items[0].get(\"status\") == \"completed\" and task_id not in previous_done:\n                subject = task_state[task_id].get(\"subject\") or \"task\"\n                return [(\"task.completed\", f\"{subject} {done_count + 1}/{total} done\")]\n            return []\n\n    total = len(items)\n    completed = [i for i in items if i.get(\"status\") == \"completed\"]\n\n    if previous is None:\n        # First checklist call in this session.\n        events = []\n        events.append((\"checklist.created\", f\"{total} task{'s' if total != 1 else ''}\"))\n        for item in completed:\n            events.append((\n                \"task.completed\",\n                f\"{item['subject']} {len(completed)}/{total} done\",\n            ))\n        return events\n\n    previous_done = {\n        str(i.get(\"id\")) for i in previous\n        if i.get(\"status\") == \"completed\" and i.get(\"id\")\n    }\n    newly_completed = [\n        i for i in completed\n        if str(i.get(\"id\")) not in previous_done\n    ]\n    if not newly_completed:\n        return []\n\n    done_count = len(completed)\n    events = []\n    for item in newly_completed:\n        events.append((\n            \"task.completed\",\n            f\"{item['subject']} {done_count}/{total} done\",\n        ))\n    return events\n\n\ndef _make_record(event, detail, tool_name):\n    tier = \"milestone\" if event in MILESTONE_EVENTS else \"activity\"\n    record = {\n        \"v\": 1,\n        \"ts\": datetime.now(timezone.utc).isoformat(),\n        \"event\": event,\n        \"tier\": tier,\n    }\n    if detail:\n        record[\"detail\"] = detail\n    record[\"tool\"] = tool_name\n    return record\n\n\ndef build_event(payload, hook_event):\n    tool_name = payload.get(\"tool_name\", \"\")\n    tool_input = payload.get(\"tool_input\", {}) or {}\n    tool_response = payload.get(\"tool_response\", {})\n\n    # Checklist completions first -- cheap guard above already filtered tool name.\n    checklist = _checklist_events(payload, hook_event)\n    if checklist:\n        return [_make_record(event, detail, tool_name) for event, detail in checklist], tool_name\n\n    event = None\n    detail = None\n    url = None\n\n    if hook_event == \"PreToolUse\":\n        if tool_name == \"ExitPlanMode\":\n            event = \"plan.created\"\n            detail = first_line(tool_input.get(\"plan\", \"\")) or \"plan presented\"\n        elif tool_name == \"Task\":\n            event = \"subagent.spawned\"\n            role = tool_input.get(\"subagent_type\") or \"agent\"\n            desc = tool_input.get(\"description\") or tool_input.get(\"prompt\") or \"\"\n            detail = (role + \": \" + first_line(desc)).strip(\": \").strip()\n    elif hook_event == \"PostToolUse\":\n        if tool_name == \"Bash\":\n            event = classify_bash(tool_input.get(\"command\", \"\"))\n            if event:\n                detail = first_line(tool_input.get(\"command\", \"\"))\n                url = extract_url(tool_response)\n        elif tool_name in (\"Write\", \"Edit\", \"MultiEdit\"):\n            fp = tool_input.get(\"file_path\") or tool_input.get(\"path\") or \"\"\n            # A freshly-written deliverable is a milestone; edits and code\n            # writes stay routine and collapse to a count.\n            if tool_name == \"Write\" and is_artifact(fp):\n                event = \"artifact.created\"\n            else:\n                event = \"file.edited\"\n            detail = os.path.basename(fp) if fp else tool_name\n\n    if not event:\n        return [], tool_name\n\n    record = _make_record(event, detail, tool_name)\n    if url:\n        record[\"url\"] = url\n    return [record], tool_name\n\n\ndef main():\n    raw = sys.stdin.read()\n    try:\n        payload = json.loads(raw) if raw.strip() else {}\n    except Exception:\n        return\n\n    # Sub-agent gate -- only the top-level agent logs.\n    if payload.get(\"agent_type\"):\n        return\n\n    session_id = payload.get(\"session_id\", \"\")\n    if not session_id:\n        return\n\n    hook_event = payload.get(\"hook_event_name\", \"\")\n    records, tool_name = build_event(payload, hook_event)\n    if not records:\n        return\n\n    safe_session = re.sub(r\"[^A-Za-z0-9._-]\", \"-\", session_id) or \"unknown\"\n    home = os.environ.get(\"HOME\") or os.path.expanduser(\"~\")\n    activity_dir = os.path.join(home, \".agents\", \".history\", \"activity\")\n    target = os.path.join(activity_dir, safe_session + \".jsonl\")\n\n    # Identity (mirrors 10-feed-publish.py).\n    mailbox_id = os.path.basename(\n        os.environ.get(\"AGENTS_MAILBOX_DIR\", \"\").rstrip(\"/\")\n    ) or session_id\n    hostname = os.environ.get(\"AGENTS_SYNC_MACHINE_ID\") or socket.gethostname()\n    host = re.sub(r\"[^a-z0-9_-]\", \"-\", hostname.split(\".\")[0].strip().lower()) or \"unknown\"\n\n    for record in records:\n        record[\"sessionId\"] = session_id\n        record[\"mailboxId\"] = mailbox_id\n        record[\"host\"] = host\n        record[\"runtime\"] = os.environ.get(\"AGENTS_RUNTIME\", \"headless\")\n        cwd = payload.get(\"cwd\") or os.environ.get(\"AGENTS_CWD\")\n        if cwd:\n            record[\"cwd\"] = cwd\n        agent = os.environ.get(\"AGENTS_AGENT_NAME\") or \"claude\"\n        record[\"agent\"] = agent\n\n    try:\n        os.makedirs(activity_dir, exist_ok=True)\n        # Cap growth: once over the size limit, keep only milestones.\n        try:\n            over_limit = os.path.getsize(target) > MAX_LOG_BYTES\n        except OSError:\n            over_limit = False\n        with open(target, \"a\") as f:\n            for record in records:\n                if over_limit and record.get(\"tier\") != \"milestone\":\n                    continue\n                f.write(json.dumps(record) + \"\\n\")\n    except Exception:\n        pass  # fail open\n\n\nif __name__ == \"__main__\":\n    try:\n        main()\n    except Exception:\n        pass  # fail open\n";
 /** Hook manifest entries (agents.yaml shape) for the activity-log hook. */
 export declare const ACTIVITY_HOOK_DEFINITIONS: Record<string, Record<string, unknown>>;
 /**