@phnx-labs/agents-cli 1.20.90 → 1.20.92

package/dist/commands/sessions-resume.js

@@ -36,6 +36,7 @@ export function registerSessionsResumeCommand(sessionsCmd) {
         .option('--ghostty', 'Force the Ghostty backend')
         .option('--tmux', 'Force the tmux backend')
         .option('--vscodium', 'Force the VSCodium agent-terminal backend (swarm-ext)')
+        .option('--terminal-app', 'Force macOS Terminal.app (no split support — panes become tabs)')
         .option('--splits', 'Pack two sessions side by side per tab (default: one tab per session)');
     setHelpSections(cmd, {
         examples: `
@@ -156,6 +157,12 @@ async function sessionsResumeAction(query, options) {
     // recovery; callers can explicitly opt into pairs of side-by-side panes.
     const packing = resolveResumePacking(options);
     const where = options.host ? `${backend} on ${options.host}` : backend;
+    // Terminal.app has no scriptable split, so its buildSplit opens a tab. Say so
+    // when the user actually asked for panes — the layout silently not happening
+    // is worse than one line of warning.
+    if (backend === 'terminal' && packing === 'two-per-tab') {
+        console.log(chalk.yellow('Terminal.app cannot split panes — opening one tab per session instead.'));
+    }
     console.log(chalk.gray(`Opening ${items.length} session${items.length === 1 ? '' : 's'} in ${where} (${packing})…`));
     const results = await openSurfaces(items.map((it) => ({ cwd: it.cwd, command: it.command })), { backend, host: options.host, packing });
     let opened = 0;
@@ -185,7 +192,8 @@ async function resolveBackend(options, ctx, count) {
         : options.ghostty ? 'ghostty'
             : options.tmux ? 'tmux'
                 : options.vscodium ? 'vscodium-agent'
-                    : undefined;
+                    : options.terminalApp ? 'terminal'
+                        : undefined;
     if (forced)
         return forced;
     // Remote defaults to tmux (headless, no GUI session assumptions); override with a backend flag.

package/dist/commands/sessions.d.ts

@@ -1,4 +1,5 @@
 import { type Command } from 'commander';
+import { type ProjectDef } from '../lib/projects.js';
 import type { SessionAgentId, SessionMeta, ViewMode } from '../lib/session/types.js';
 import { type ActiveSession } from '../lib/session/active.js';
 import { gatherRemoteList, runOnPeer } from '../lib/session/remote-list.js';
@@ -351,11 +352,15 @@ export declare function teamBadge(session: SessionMeta): {
  * dashes and needlessly truncate the topic. Worktree stays a trailing badge. */
 export declare function flatSessionRow(session: SessionMeta, live?: ActiveSession, showTicket?: boolean, cols?: PickerColumns, favorite?: boolean): string;
 /**
- * Group key for the overview: prefer the indexed project name; else fold the cwd
- * to its repo — a worktree (`.../<repo>/.agents/worktrees/<slug>`) folds to the
- * repo, and a monorepo subdir falls back to its leaf dir basename. Pure.
+ * Group key for the overview: resolve the cwd through the same canonical
+ * resolver the `agents activity` timeline groups by — a defined project's name
+ * when `defs` contains the cwd (multi-repo projects read as one group), else
+ * the repo-level key, so a monorepo subdir (`<repo>/apps/cli`) reads as
+ * `<repo>` in both views. Falls back to the indexed project name (stamped at
+ * scan time) when the cwd carries nothing usable, e.g. a remote path this
+ * machine cannot see still folds by basename through the same resolver.
  */
-export declare function overviewProjectKey(s: Pick<SessionMeta, 'project' | 'cwd'>): string;
+export declare function overviewProjectKey(s: Pick<SessionMeta, 'project' | 'cwd'>, defs?: ProjectDef[]): string;
 export interface OverviewGroup {
     key: string;
     total: number;
@@ -369,7 +374,7 @@ export interface OverviewGroup {
  * are ordered by their most-recent session so the newest-active project leads.
  * `perProjectCap = Infinity` expands every group. Pure — unit-tested.
  */
-export declare function buildOverviewGroups(pool: SessionMeta[], perProjectCap: number): {
+export declare function buildOverviewGroups(pool: SessionMeta[], perProjectCap: number, defs?: ProjectDef[]): {
     groups: OverviewGroup[];
     projectCount: number;
 };

package/dist/commands/sessions.js

@@ -14,6 +14,8 @@ import { spawn } from 'child_process';
 import { Option } from 'commander';
 import chalk from 'chalk';
 import { truncate, padRight } from '../lib/format.js';
+import { resolveProjectKey } from '../lib/project-key.js';
+import { listProjectDefs, resolveProjectNameForCwd } from '../lib/projects.js';
 import ora from 'ora';
 import { SESSION_AGENTS } from '../lib/session/types.js';
 import { discoverArtifacts, readArtifact, resolveArtifact } from '../lib/session/artifacts.js';
@@ -32,7 +34,7 @@ import { findSessionsById, querySessions } from '../lib/session/db.js';
 import { filterTeamSessions, safeTeamText } 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 { formatRelativeTime, sessionAgeParts } from '../lib/session/relative-time.js';
 import { renderConversationMarkdown, renderSummary, renderSummaryHeader, computeSummaryStats, renderJson, filterEvents, parseRoleList, linkPath, linkUrl, shortenModel } from '../lib/session/render.js';
 import { linearIssueUrl } from '../lib/session/linear.js';
 import { renderMarkdown } from '../lib/markdown.js';
@@ -1768,6 +1770,33 @@ function metaSignals(s) {
         ticket: s.ticketId ? { id: s.ticketId } : undefined,
     };
 }
+/**
+ * Narrowest topic a row is willing to render. The time cell drops its creation
+ * field rather than squeeze the topic past this — a row that wraps is worse than
+ * a row missing one field.
+ */
+const MIN_TOPIC_W = 16;
+/**
+ * The trailing time cell, as two fields: `3d → 2 hours ago` — when the session
+ * was created, then when it was last active. One label answers neither "is this
+ * the old session I'm looking for" nor "how long did it run", since a session
+ * touched an hour ago may have started last week.
+ *
+ * Collapses to last-activity alone when the session ran under a minute (both
+ * halves would name the same moment) or when `topicSlack` — the columns the row
+ * has left for its topic — cannot spare the extra width. `extraW` is what the
+ * creation field cost, for the caller to take off the topic budget.
+ */
+function timeCell(age, topicSlack) {
+    const lastOnly = { plain: age.last, text: chalk.gray(age.last), extraW: 0 };
+    if (!age.created)
+        return lastOnly;
+    const prefix = `${age.created} → `;
+    const extraW = stringWidth(prefix);
+    if (topicSlack - extraW < MIN_TOPIC_W)
+        return lastOnly;
+    return { plain: prefix + age.last, text: chalk.dim(prefix) + chalk.gray(age.last), extraW };
+}
 /** One flat table row:
  *   shortId · agent · version · model · project · [glyph] label·doing · [ticket] · [wt] · time
  * `doing` is the live preview when running, else the topic. The `ticket` column
@@ -1776,7 +1805,7 @@ function metaSignals(s) {
  * dashes and needlessly truncate the topic. Worktree stays a trailing badge. */
 export function flatSessionRow(session, live, showTicket = false, cols = {}, favorite = false) {
     const agentColor = colorAgent(session.agent);
-    const when = formatRelativeTime(session.lastActivity ?? session.timestamp);
+    const age = sessionAgeParts(session.timestamp, session.lastActivity);
     const project = session.project || '-';
     const tag = originTag(session) || teamTag(session);
     const label = session.label;
@@ -1813,12 +1842,15 @@ export function flatSessionRow(session, live, showTicket = false, cols = {}, fav
     // Same conditional 2 cells as the picker's marker, for the same reason.
     const favW = cols.showFavorite ? 2 : 0;
     const favCell = cols.showFavorite ? (favorite ? chalk.yellow('★ ') : '  ') : '';
-    const fixedW = favW + (10 + 9 + 8 + 16) + glyphW + statusW + machineW + ticketW + wtW + team.width + stringWidth(when) + 1;
-    const modelSlack = width - fixedW - 16;
+    // Sized against the last-activity label alone, so the creation field is an
+    // additive decision the row makes only once it knows what space is left.
+    const fixedW = favW + (10 + 9 + 8 + 16) + glyphW + statusW + machineW + ticketW + wtW + team.width + stringWidth(age.last) + 1;
+    const modelSlack = width - fixedW - MIN_TOPIC_W;
     const modelW = requestedModelW <= modelSlack
         ? requestedModelW
         : modelSlack >= PICKER_MODEL_MIN ? modelSlack : 0;
-    const topicW = Math.max(16, width - fixedW - modelW);
+    const when = timeCell(age, width - fixedW - modelW);
+    const topicW = Math.max(MIN_TOPIC_W, width - fixedW - modelW - when.extraW);
     return (favCell +
         chalk.white(padToWidth(truncateToWidth(session.shortId, 9), 10)) +
         agentColor(padToWidth(truncateToWidth(session.agent, 8), 9)) +
@@ -1832,12 +1864,12 @@ export function flatSessionRow(session, live, showTicket = false, cols = {}, fav
         renderTopicCell(label, doing, '', topicW, topicW) +
         ticketCell +
         (wt ? wt + ' ' : '') +
-        chalk.gray(when));
+        when.text);
 }
 /** One tree-mode row (grouped under a dir header): id · agent · badges · topic · time. No version/project column. */
 function treeSessionRow(session, live) {
     const agentColor = colorAgent(session.agent);
-    const when = formatRelativeTime(session.lastActivity ?? session.timestamp);
+    const age = sessionAgeParts(session.timestamp, session.lastActivity);
     const tag = originTag(session) || teamTag(session);
     const label = session.label;
     const { glyph, preview } = liveGlyphAndPreview(live);
@@ -1853,7 +1885,9 @@ function treeSessionRow(session, live) {
     const head = label ? `${label} · ${topic}` : topic;
     const { cell: statusCell, width: statusW } = liveStatusCell(live);
     const glyphW = glyph ? 2 : 0;
-    const topicW = Math.max(12, terminalWidth() - (2 + 9 + 8) - glyphW - statusW - badgeW - team.width - stringWidth(when) - 1);
+    const baseTopicW = terminalWidth() - (2 + 9 + 8) - glyphW - statusW - badgeW - team.width - stringWidth(age.last) - 1;
+    const when = timeCell(age, baseTopicW);
+    const topicW = Math.max(12, baseTopicW - when.extraW);
     return ('  ' +
         chalk.dim(padToWidth(session.shortId, 9)) +
         agentColor(padToWidth(truncateToWidth(session.agent, 7), 8)) +
@@ -1862,7 +1896,7 @@ function treeSessionRow(session, live) {
         statusCell +
         teamSeg +
         padToWidth(chalk.white(truncateToWidth(head, topicW)), topicW) +
-        ' ' + chalk.gray(when));
+        ' ' + when.text);
 }
 /**
  * Live-session index for enriching the default listing, or undefined when
@@ -1884,21 +1918,21 @@ async function maybeLiveIndex(options) {
     }
 }
 /**
- * Group key for the overview: prefer the indexed project name; else fold the cwd
- * to its repo — a worktree (`.../<repo>/.agents/worktrees/<slug>`) folds to the
- * repo, and a monorepo subdir falls back to its leaf dir basename. Pure.
+ * Group key for the overview: resolve the cwd through the same canonical
+ * resolver the `agents activity` timeline groups by — a defined project's name
+ * when `defs` contains the cwd (multi-repo projects read as one group), else
+ * the repo-level key, so a monorepo subdir (`<repo>/apps/cli`) reads as
+ * `<repo>` in both views. Falls back to the indexed project name (stamped at
+ * scan time) when the cwd carries nothing usable, e.g. a remote path this
+ * machine cannot see still folds by basename through the same resolver.
  */
-export function overviewProjectKey(s) {
+export function overviewProjectKey(s, defs) {
+    const resolved = defs?.length ? resolveProjectNameForCwd(s.cwd, defs) : resolveProjectKey(s.cwd);
+    if (resolved)
+        return resolved;
     if (s.project && s.project.trim())
         return s.project.trim();
-    const cwd = (s.cwd ?? '').replace(/\/+$/, '');
-    if (!cwd)
-        return '(no project)';
-    const wt = cwd.match(/\/([^/]+)\/\.agents\/worktrees\//);
-    if (wt)
-        return wt[1];
-    const parts = cwd.split('/');
-    return parts[parts.length - 1] || cwd;
+    return '(no project)';
 }
 /**
  * Turn a recency-descending pool into project groups: each group shows its
@@ -1906,10 +1940,10 @@ export function overviewProjectKey(s) {
  * are ordered by their most-recent session so the newest-active project leads.
  * `perProjectCap = Infinity` expands every group. Pure — unit-tested.
  */
-export function buildOverviewGroups(pool, perProjectCap) {
+export function buildOverviewGroups(pool, perProjectCap, defs) {
     const byKey = new Map();
     for (const s of pool) {
-        const k = overviewProjectKey(s);
+        const k = overviewProjectKey(s, defs);
         (byKey.get(k) ?? byKey.set(k, []).get(k)).push(s);
     }
     const cap = Math.max(1, perProjectCap);
@@ -1927,7 +1961,7 @@ export function buildOverviewGroups(pool, perProjectCap) {
  * `· N more` per project and a `+N more projects` when the list is capped.
  */
 function printSessionOverview(pool, hiddenCount, liveIndex, opts) {
-    const { groups } = buildOverviewGroups(pool, opts.expand ? Infinity : opts.perProjectCap);
+    const { groups } = buildOverviewGroups(pool, opts.expand ? Infinity : opts.perProjectCap, listProjectDefs());
     const shownGroups = opts.expand ? groups : groups.slice(0, OVERVIEW_MAX_PROJECTS);
     const hiddenProjects = groups.length - shownGroups.length;
     const total = pool.length;
@@ -2252,7 +2286,7 @@ export function liveHostLabel(a) {
 }
 export function formatPickerLabel(s, query, cols = {}, ssh, host = '', favorite = false, live) {
     const agentColor = colorAgent(s.agent);
-    const when = formatRelativeTime(s.lastActivity ?? s.timestamp);
+    const age = sessionAgeParts(s.timestamp, s.lastActivity);
     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
@@ -2306,7 +2340,11 @@ export function formatPickerLabel(s, query, cols = {}, ssh, host = '', favorite
     const status = cols.showStatus ? liveStatusCell(live) : { cell: '', width: 0 };
     const statusW = cols.showStatus ? LIVE_STATUS_W : 0;
     const statusCell = cols.showStatus ? (status.cell || ' '.repeat(LIVE_STATUS_W)) : '';
-    const topicW = Math.max(16, terminalWidth() - gutter - favW - statusW - (10 + 9 + 8 + 16) - machineColW - hostW - ticketW - wtW - sshW - team.width - stringWidth(when) - 1);
+    // Sized against the last-activity label alone; the creation field is then an
+    // additive decision made against whatever width is left (see the flat listing).
+    const baseTopicW = terminalWidth() - gutter - favW - statusW - (10 + 9 + 8 + 16) - machineColW - hostW - ticketW - wtW - sshW - team.width - stringWidth(age.last) - 1;
+    const when = timeCell(age, baseTopicW);
+    const topicW = Math.max(MIN_TOPIC_W, baseTopicW - when.extraW);
     return (favCell +
         // Truncated, not just padded: an indexed shortId is always 8 chars, but a
         // live row with no session id is named by its pid or cloud task, which can
@@ -2323,7 +2361,7 @@ export function formatPickerLabel(s, query, cols = {}, ssh, host = '', favorite
         renderTopicCell(label, topic, query, topicW, topicW) +
         ticketCell +
         (wt ? wt + ' ' : '') +
-        chalk.gray(when));
+        when.text);
 }
 /** Hints rotated above the picker so the flags/features stay discoverable. */
 const PICKER_TIPS = [

package/dist/index.js

@@ -94,7 +94,7 @@ if (IS_DEV_BUILD) {
 // module on each invocation (which loaded the whole ~50-module tree before the
 // first byte of output), the registry maps a command name to a thunk that
 // imports only what that command needs. See src/lib/startup/command-registry.ts.
-import { COMMAND_LOADERS, LAZY_COMMAND_NAMES, loadView, loadInspect, loadFeedback, loadCommands, loadHooks, loadSkills, loadRules, loadMemory, loadPermissions, loadMcp, loadCli, loadSubagents, loadPlugins, loadWorkflows, loadWorktree, loadVersions, loadImport, loadExport, loadPackages, loadRoutines, loadMonitors, loadRun, loadFork, loadDefaults, loadSet, loadModels, loadPrune, loadTrash, loadRestore, loadDoctor, loadApply, loadStatus, loadProfiles, loadHarness, loadSecrets, loadLogin, loadWallet, loadHelper, loadMenubar, loadBeta, loadSync, loadLock, loadRefreshRules, loadDrive, loadFactory, loadUsage, loadCost, loadOutput, loadBudget, loadAlias, loadMine, loadPty, loadTmux, loadWatchdog, loadBrowser, loadComputer, loadHosts, loadLogs, loadEvents, loadAudit, loadWebhook, loadFunnel, loadSsh, loadPull, loadPush, loadRepo, loadSetup, loadUninstall, loadShare, loadSend, loadHq, loadFeed, loadActivity, loadMailboxes, } from './lib/startup/command-registry.js';
+import { COMMAND_LOADERS, LAZY_COMMAND_NAMES, loadView, loadInspect, loadFeedback, loadCommands, loadHooks, loadSkills, loadRules, loadMemory, loadPermissions, loadMcp, loadCli, loadSubagents, loadPlugins, loadWorkflows, loadWorktree, loadVersions, loadImport, loadExport, loadPackages, loadRoutines, loadMonitors, loadProjects, loadRun, loadFork, loadDefaults, loadSet, loadModels, loadPrune, loadTrash, loadRestore, loadDoctor, loadApply, loadStatus, loadProfiles, loadHarness, loadSecrets, loadLogin, loadWallet, loadHelper, loadMenubar, loadBeta, loadSync, loadLock, loadRefreshRules, loadDrive, loadFactory, loadUsage, loadCost, loadPerf, loadOutput, loadBudget, loadAlias, loadMine, loadPty, loadTmux, loadWatchdog, loadBrowser, loadComputer, loadHosts, loadLogs, loadEvents, loadAudit, loadWebhook, loadFunnel, loadSsh, loadPull, loadPush, loadRepo, loadSetup, loadUninstall, loadShare, loadSend, loadHq, loadFeed, loadActivity, loadMailboxes, } from './lib/startup/command-registry.js';
 import { applyGlobalHelpConventions } from './lib/help.js';
 import { renderWhatsNew } from './lib/whats-new.js';
 import { getCliLaunch } from './lib/cli-entry.js';
@@ -173,11 +173,24 @@ program.hook('postAction', (_thisCommand, actionCommand) => {
         if (parts.length === 0)
             return;
         const started = auditStarts.get(actionCommand);
+        const durationMs = started !== undefined ? Date.now() - started : undefined;
+        const command = parts.join(' ');
         emit('command.end', {
             module: parts[0],
-            command: parts.join(' '),
-            ...(started !== undefined ? { durationMs: Date.now() - started } : {}),
+            command,
+            ...(durationMs !== undefined ? { durationMs } : {}),
         });
+        // Disposable perf warehouse — fail-soft spool append (no SQLite on this path).
+        if (durationMs !== undefined && parts[0] !== 'perf') {
+            void import('./lib/perf/spool.js').then(({ recordSample }) => {
+                recordSample({
+                    kind: 'command.end',
+                    label: command,
+                    durationMs,
+                    cwd: process.cwd(),
+                });
+            }).catch(() => { });
+        }
     }
     catch {
         // Best-effort completion record; the start line is the durable audit fact.
@@ -269,6 +282,7 @@ Credentials and profiles:
 Diagnostics:
   doctor [agent[@version]]        Diagnose CLI availability, sync status, and resource divergence; --check for the CI drift gate
   usage [agent]                   Show rate-limit and quota usage per agent
+  perf                            Latency rollups (hooks, commands, runs) from the disposable perf warehouse
 
 Config sync:
   drive                           Sync session history across machines via rsync
@@ -857,6 +871,7 @@ async function registerAllEagerCommands() {
     await reg(loadPackages);
     await reg(loadRoutines);
     await reg(loadMonitors);
+    await reg(loadProjects);
     await reg(loadRun);
     await reg(loadFork);
     await reg(loadDefaults);
@@ -885,6 +900,7 @@ async function registerAllEagerCommands() {
     await reg(loadFactory);
     await reg(loadUsage);
     await reg(loadCost);
+    await reg(loadPerf);
     await reg(loadOutput);
     await reg(loadBudget);
     await reg(loadAlias);

package/dist/lib/activity.d.ts

@@ -1,10 +1,22 @@
 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' | 'task.completed' | 'checklist.created'
+/** Bash-driven deliverables detected by command parsing. */
+ | 'video.rendered' | 'video.converted' | 'image.upscaled' | 'metadata.edited'
 /** Deliberate agent-authored progress post (`agents feed post`). */
- | 'status.posted';
+ | 'status.posted'
+/**
+ * The same post, but the agent is STUCK (`agents feed post --blocked`).
+ *
+ * A distinct event rather than a flag on `status.posted` because it is a
+ * different kind of thing in the stream: a benign update is history the
+ * moment it lands, while a blocked post stays open until someone answers it.
+ * Readers that show "what needs a human" select on this; readers that show
+ * "what happened" get both.
+ */
+ | 'status.blocked';
 /** Routine activity events, collapsed to counts by readers. */
-export type ActivityKind = 'file.edited';
+export type ActivityKind = 'file.edited' | 'bash.executed';
 export type ActivityEventKind = MilestoneEvent | ActivityKind;
 export type ActivityTier = 'milestone' | 'activity';
 /** Well-known attachment kinds; the field is an open string, not an enum. */
@@ -74,6 +86,10 @@ export interface ActivityEvent {
     terminalId?: string;
     /** `$TMUX_PANE` at launch when recorded. */
     tmuxPane?: string;
+    /** Bash command taxonomy (set for bash.executed events). */
+    category?: string;
+    bashTool?: string;
+    bashAction?: string;
     /** Generic artifacts attached to a deliberate progress post. */
     attachments?: Attachment[];
 }
@@ -213,19 +229,29 @@ export interface ActivitySessionHint {
     project?: string | null;
 }
 /**
- * Resolve a stable project/repo name from a working directory. A worktree cwd
- * (`…/<repo>/.agents/worktrees/<slug>[/sub]`) resolves to the repo dir name so
- * a worktree session groups with its own repo; any other path resolves to its
- * basename. Pure — no filesystem access, so it works for remote events too.
+ * Resolve a stable project/repo name from a working directory — the same fold
+ * the `agents sessions` overview groups by ({@link projectKeyFromCwd}), so a
+ * project reads identically in both views.
  */
 export declare function projectFromCwd(cwd?: string | null): string | undefined;
 /**
  * Join session facts (ticket / project / execution host) onto each event by
- * `sessionId`. A hint wins; otherwise pre-baked enriched fields (from a remote
- * peer that already enriched its own stream) are preserved, and project/host
- * fall back to what the event itself carries (`cwd`, `host`). Pure.
+ * `sessionId`. A hint wins; otherwise a CANONICAL def match (`canonicalProject`)
+ * upgrades whatever the event carries; otherwise pre-baked enriched fields (from
+ * a remote peer that already enriched its own stream) are preserved, and
+ * project/host fall back to what the event itself carries (`cwd`, `host`).
+ *
+ * The def match ranks above the pre-baked stamp because the stamp may be stale
+ * (posted before the def existed) or skewed (a peer whose defs haven't synced);
+ * the match is pure prefix compare against local defs, so a different-home
+ * peer's path simply doesn't match and its stamp is honored as before.
+ *
+ * `resolveProject` is how a caller reading its OWN machine's logs upgrades the
+ * cwd fold to real repository detection ({@link resolveProjectKey}); it defaults
+ * to the pure {@link projectFromCwd}, which is all a path from another machine
+ * can be resolved with. Pure given pure resolvers.
  */
-export declare function enrichActivityEvents(events: EnrichedActivityEvent[], hints: ActivitySessionHint[]): EnrichedActivityEvent[];
+export declare function enrichActivityEvents(events: EnrichedActivityEvent[], hints: ActivitySessionHint[], resolveProject?: (cwd?: string | null) => string | undefined, canonicalProject?: (cwd?: string | null) => string | undefined): EnrichedActivityEvent[];
 /**
  * Validate + host-tag one peer's `activity --json` payload for the fan-out
  * merge. Mirrors {@link parseLine}: skip anything missing `event`/`sessionId`/
@@ -241,6 +267,22 @@ export declare function parseActivityPayload(stdout: string, machine: string): E
  * `mergeFeedBlocks`).
  */
 export declare function mergeActivityEvents(...groups: EnrichedActivityEvent[][]): EnrichedActivityEvent[];
+/**
+ * Apply `--limit` to the events a reader will actually SHOW.
+ *
+ * The default view collapses routine work (`file.edited`) to a count and shows
+ * milestones individually, so a plain `slice(limit)` spends the whole budget on
+ * churn: one busy machine editing 40 files hid every other device's PRs behind
+ * a single `file edited ×40` line. Milestones therefore carry the cap, and the
+ * routine events that ride along are the ones newer than the last milestone
+ * kept — so the collapsed counts describe exactly the window on screen.
+ *
+ * With `all` (routine shown inline) every event is displayed, so the cap is the
+ * plain slice again. Input must be newest-first; output preserves that order.
+ */
+export declare function capActivityEvents(events: EnrichedActivityEvent[], limit: number, opts?: {
+    all?: boolean;
+}): EnrichedActivityEvent[];
 export type ActivityGroupBy = 'project' | 'device' | 'agent';
 /** One bucket of the grouped view. */
 export interface ActivityGroup {
@@ -267,14 +309,39 @@ export declare function groupActivity(events: EnrichedActivityEvent[], by: Activ
  * no-op. Pure.
  */
 export declare function filterActivityEvents(events: EnrichedActivityEvent[], filter: string): EnrichedActivityEvent[];
+/**
+ * Narrow events to one resolved project, exact match on the enriched label
+ * (unlike {@link filterActivityEvents}'s cross-field substring). This is the
+ * `--project` flag: the label is canonical (a defined project's name) once the
+ * reader's resolver has run, so a multi-repo project matches as one bucket. Pure.
+ */
+export declare function filterActivityByProject(events: EnrichedActivityEvent[], project: string): EnrichedActivityEvent[];
 /** One rendered enriched line: the base activity line + `· project · ticket` tags. */
 export declare function formatEnrichedActivityLine(ev: EnrichedActivityEvent, opts?: {
     showHost?: boolean;
     showProject?: boolean;
     indent?: string;
 }): string;
-/** Human header for one grouped bucket: `<label> · N events · M milestones`. */
-export declare function formatActivityGroupHeader(group: ActivityGroup): string;
+/** Max device names named in a group header before the rest collapse to `+N`. */
+export declare const GROUP_HEADER_DEVICE_LIMIT = 3;
+/**
+ * The distinct machines a group's events ran on, most-active first then
+ * alphabetical — so a project header can say WHERE the work happened without
+ * sub-grouping the timeline. Prefers the session-joined `executionHost` (where
+ * the process really lives) over the raw emitting `host`. Pure.
+ */
+export declare function activityGroupDevices(events: EnrichedActivityEvent[]): string[];
+/**
+ * The trailing facts for one grouped bucket: `N events · M milestones`, plus
+ * the machines the work ran on when `showDevices` is set (redundant when the
+ * grouping dimension IS the device, so the caller decides). The device list is
+ * capped at {@link GROUP_HEADER_DEVICE_LIMIT} with a `+N` tail, so a project
+ * touched by a dozen boxes stays one scannable line. Separate from the label so
+ * a renderer can color the two differently without re-splitting a string.
+ */
+export declare function formatActivityGroupMeta(group: ActivityGroup, opts?: {
+    showDevices?: boolean;
+}): string;
 /**
  * The activity-log hook (Python), sibling to 10-feed-publish.py. Classifies
  * PreToolUse/PostToolUse payloads into activity events and appends one JSONL
@@ -285,7 +352,7 @@ export declare function formatActivityGroupHeader(group: ActivityGroup): string;
  * 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, 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";
+export declare const ACTIVITY_LOG_HOOK_SCRIPT: string;
 /** Hook manifest entries (agents.yaml shape) for the activity-log hook. */
 export declare const ACTIVITY_HOOK_DEFINITIONS: Record<string, Record<string, unknown>>;
 /**