@phnx-labs/agents-cli 1.22.112 → 1.22.114

package/dist/commands/config.js

@@ -15,11 +15,11 @@
 import chalk from 'chalk';
 import { AGENTS } from '../lib/agents.js';
 import { setHelpSections } from '../lib/help.js';
-import { parseConfigKey, formatAgentVersion, devicePropertyToConfigName, configKeyStorageHint, } from '../lib/config-keys.js';
+import { parseConfigKey, formatConfigKey, formatAgentVersion, devicePropertyToConfigName, configKeyStorageHint, MENUBAR_MENU_PROPERTIES, } from '../lib/config-keys.js';
 import { registerBudgetCommand } from './budget.js';
 import { resolveRunDefaults, setRunDefaultModel, setRunDefaultMode, setRunDefaultEffort, unsetRunDefault, } from '../lib/run-defaults.js';
 import { resolveTierOverride, setTierOverride, clearTierOverride } from '../lib/model-tier-overrides.js';
-import { getConfigValue, setConfigValue, unsetConfigValue, listConfig, } from '../lib/device-config.js';
+import { getConfigValue, setConfigValue, unsetConfigValue, listConfig, configKeySpec, } from '../lib/device-config.js';
 import { readMeta, updateMeta } from '../lib/state.js';
 import { MODEL_TIERS } from '../lib/model-tiers.js';
 import { machineId } from '../lib/machine-id.js';
@@ -51,6 +51,20 @@ function parseValue(key, parsed, raw) {
             return parsed.property === 'enabled' ? parseBool(raw, key) : raw.trim();
         case 'updates':
             return parseBool(raw, key);
+        case 'menubar': {
+            // The type (and enum validation) live in the device-config spec; parse the
+            // raw string to that type here so setConfigValue's assertion passes.
+            const spec = configKeySpec(formatConfigKey(parsed));
+            if (spec.type === 'bool')
+                return parseBool(raw, key);
+            if (spec.type === 'int') {
+                if (!/^\d+$/.test(raw.trim())) {
+                    throw new Error(`Config key '${key}' expects an integer, got '${raw}'.`);
+                }
+                return Number.parseInt(raw.trim(), 10);
+            }
+            return raw.trim();
+        }
         case 'device': {
             const property = parsed.property;
             switch (property) {
@@ -74,8 +88,11 @@ function parseValue(key, parsed, raw) {
                     return Number.parseInt(raw.trim(), 10);
                 case 'notes':
                     return raw.trim();
+                case 'formFactor':
+                    return raw.trim();
                 case 'browser.profile':
                 case 'browser.viewer':
+                case 'computer.host':
                     return raw.trim();
             }
             // A device property with no arm above used to fall out of the switch and
@@ -143,6 +160,10 @@ function setConfig(parsed, value) {
                 setGlobalAutoUpdateEnabled(value);
             return;
         }
+        case 'menubar': {
+            setConfigValue(formatConfigKey(parsed), value);
+            return;
+        }
         case 'device': {
             const configName = devicePropertyToConfigName(parsed.property);
             if (parsed.property === 'notes') {
@@ -217,6 +238,12 @@ function unsetConfig(parsed) {
             unsetGlobalAutoUpdateEnabled();
             return had;
         }
+        case 'menubar': {
+            const name = formatConfigKey(parsed);
+            const had = getConfigValue(name).value !== undefined;
+            unsetConfigValue(name);
+            return had;
+        }
         case 'device': {
             const configName = devicePropertyToConfigName(parsed.property);
             const had = getConfigValue(configName, { device: parsed.device }).value !== undefined;
@@ -251,6 +278,8 @@ function getConfig(parsed) {
             return getConfigValue(`summarizer.${parsed.property}`).value;
         case 'updates':
             return parsed.agent ? rawAgentAutoUpdateSetting(parsed.agent) : rawGlobalAutoUpdateSetting();
+        case 'menubar':
+            return getConfigValue(formatConfigKey(parsed)).value;
         case 'device': {
             const configName = devicePropertyToConfigName(parsed.property);
             return getConfigValue(configName, { device: parsed.device }).value;
@@ -345,6 +374,15 @@ function* listCentralConfigEntries() {
             yield { key, value, hint: configKeyStorageHint(parseConfigKey(key)) };
         }
     }
+    // AGI Menu preferences (PHNX-3999) — user scope, syncs fleet-wide. Only set
+    // keys are listed; the native menu falls back to its own defaults for the rest.
+    for (const prop of MENUBAR_MENU_PROPERTIES) {
+        const key = `menubar.menu.${prop}`;
+        const value = getConfigValue(key).value;
+        if (value !== undefined) {
+            yield { key, value, hint: configKeyStorageHint(parseConfigKey(key)) };
+        }
+    }
 }
 /** Collect device-scope config entries. */
 function* listDeviceConfigEntries(device) {
@@ -378,6 +416,9 @@ function* listDeviceConfigEntries(device) {
             case 'notes':
                 key = `${prefix}notes`;
                 break;
+            case 'formFactor':
+                key = `${prefix}formFactor`;
+                break;
             case 'browser.profile':
                 // The self device's default browser profile is already surfaced as the
                 // top-level `browser.profile` key; skip it here to avoid duplication.
@@ -391,6 +432,9 @@ function* listDeviceConfigEntries(device) {
                     continue;
                 key = `${prefix}browser.viewer`;
                 break;
+            case 'computer.host':
+                key = `${prefix}computer.host`;
+                break;
             default:
                 // A `default: continue` here silently drops any device property with no
                 // arm — which is how browser.viewer was invisible to `config list` after

package/dist/commands/daemon.d.ts

@@ -17,29 +17,6 @@
  * duplicating it.
  */
 import type { Command } from 'commander';
-import { type DaemonServiceId } from '../lib/daemon-services.js';
-/** Parse a `ps -o etime=` value (`[[dd-]hh:]mm:ss`) into elapsed seconds. */
-export declare function parseEtimeToSeconds(raw: string): number | null;
 /** Elapsed wall-clock seconds since `pid` started, or null if unavailable (best-effort, POSIX only). */
 export declare function uptimeSeconds(pid: number): number | null;
-/** One row of the roster every registered daemon service — supervisor-managed or legacy — renders in `agents daemon services`. */
-export interface DaemonServiceRow {
-    id: DaemonServiceId;
-    title: string;
-    description: string;
-    enabled: boolean;
-    /**
-     * `ServiceSupervisor`'s real lifecycle state when `supervised` is true
-     * (`idle`/`running`/`parked`/`stopped`, written cross-process via
-     * `recordSubsystemState`). A legacy `setInterval`-driven service has no such
-     * record, so its state is inferred from `enabled` + whether the daemon
-     * process is up — labelled distinctly so a reader can't mistake it for a
-     * measured value.
-     */
-    state: string;
-    supervised: boolean;
-    lastRunMs: number | null;
-    lastError: string | null;
-    consecutiveFailures: number;
-}
 export declare function registerDaemonCommand(program: Command): void;

package/dist/commands/daemon.js

@@ -254,7 +254,7 @@ function registryScopedDuplicates(processes, ownerPid) {
     return processes.filter((p) => registered.has(p.pid));
 }
 /** Parse a `ps -o etime=` value (`[[dd-]hh:]mm:ss`) into elapsed seconds. */
-export function parseEtimeToSeconds(raw) {
+function parseEtimeToSeconds(raw) {
     const m = raw.match(/^(?:(\d+)-)?(?:(\d+):)?(\d+):(\d+)$/);
     if (!m)
         return null;

package/dist/commands/detach-core.d.ts

@@ -18,7 +18,7 @@ export declare const BACKGROUND_NUDGE: string;
  */
 export declare function buildBackgroundArgv(agent: string, sessionId: string, cwd?: string): string[];
 /** What to do with a resolved session, given which machine we're on. */
-export type DetachTarget = {
+type DetachTarget = {
     kind: 'local';
     sessionId: string;
 } | {
@@ -44,3 +44,4 @@ export declare function resolveDetachTarget(s: ActiveSession, self: string): Det
 export declare function resolveOne(activeById: Map<string, ActiveSession>, id: string): ActiveSession | {
     error: string;
 };
+export {};

package/dist/commands/detach.d.ts

@@ -13,6 +13,3 @@ export declare function registerDetachCommand(program: Command): void;
  * socket; it is a parameter only so a test can drive an isolated tmux server.
  */
 export declare function stopInteractive(s: ActiveSession, socket?: string): Promise<void>;
-export declare function detachAction(id: string, opts?: {
-    local?: boolean;
-}): Promise<void>;

package/dist/commands/detach.js

@@ -2,7 +2,7 @@
  * `agents sessions detach <id>` — send a live agent session to the background:
  * stop its interactive process and continue it headless, unattended, so it drives
  * its task to completion without holding a terminal. Bring it back with
- * `agents sessions attach`. A sibling of `sessions focus`/`resume` on the session
+ * `agents sessions resume`. A sibling of `sessions focus` on the session
  * lifecycle axis.
  *
  * Agent-agnostic and version-pinned by construction: it re-invokes
@@ -18,7 +18,7 @@ import { gatherLiveTargets } from './go.js';
 import { killSession } from '../lib/tmux/index.js';
 import { getDefaultSocketPath } from '../lib/tmux/paths.js';
 import { getAgentsInvocation } from '../lib/daemon/daemon.js';
-import { captureProcessStartTime } from '../lib/pty-server.js';
+import { captureProcessStartTime } from '../lib/platform/process.js';
 import { writeDetachRecord } from '../lib/session/detached.js';
 import { getLogsDir } from '../lib/state.js';
 import { runOnPeer } from '../lib/session/remote-list.js';
@@ -122,7 +122,7 @@ function spawnHeadless(command, args, logFile) {
         });
     });
 }
-export async function detachAction(id, opts = {}) {
+async function detachAction(id, opts = {}) {
     const { self, activeById } = await gatherLiveTargets(!!opts.local, { includeCloud: true, selector: id });
     const resolved = resolveOne(activeById, id);
     if ('error' in resolved) {

package/dist/commands/feed.d.ts

@@ -21,7 +21,6 @@ import { type OutcomeGroup, type SessionOutcomeHint } from '../lib/feed-outcome.
 import { filterBlocksForFeed } from '../lib/ask-classifier.js';
 import { type FeedSessionSignal } from '../lib/feed-ranking.js';
 export declare const FEED_POST_HELP = "\nExamples:\n  # Title (subject) + body. Phone broadcasts put title first, body after a\n  # blank line, then a \"Sent from agent/session on host\" footer.\n  agents feed post --title \"CHANGELOG pushed\" \"Watching CI and mac-mini E2E\"\n  agents feed post --title \"Cover ready\" \"render at ./out/cover.png\" --attach ./out/cover.png\n  agents feed post --title \"Ready for review\" \"PR opened, waiting on prix-cloud\" --json\n\n  # Worth interrupting someone over - reaches sinks gated on minLevel: important:\n  agents feed post --title \"npm token expired\" \"Cannot publish the release\" --level important\n\n  # Also raise a local desktop banner on THIS machine (same notifier as run\n  # --notify), on top of any configured broadcast - useful when you are at the box:\n  agents feed post --title \"Build green\" \"all checks passed\" --notify\n\n  # Stuck: opens a needs-you block and always broadcasts at important:\n  agents feed post --title \"Force-push denied\" \"git-guard blocked PR #1749\" --blocked\n  agents feed post --title \"Publish or wait?\" \"npm publish now or after review\" --blocked --option publish --option wait\n  agents feed post --title \"Delete preview env?\" \"stale preview still running\" --blocked --default \"leave it\"\n\n  # Exhaust self-serve FIRST. A block is for what you genuinely cannot do:\n  # a credential only the user holds, a decision only they can make, an\n  # approval only they can give. Not \"should I do the obvious next step?\".\n\n  # Outside a run, pass the session explicitly:\n  agents feed post --title \"Manual note\" \"context for the next agent\" --session 00998b0e-2d15-4d2f-a58b-974a886c9b47\n\nIdentity (session, agent, host, runtime, pid, launchId) is stamped automatically\nand rides the phone footer of feed.broadcast {message}. Domain facts (tickets,\nPRs) are not CLI flags - the ticket is joined from the session index at post\ntime. No em-dashes in title/body - they are scrubbed on the way out.\n\nConfigure where a post is mirrored under feed.broadcast in agents.yaml - see\ndocs/observability.md. A channel sink may set message: with placeholders such\nas {message} and {ticket}; a missing placeholder skips that sink. A milestone is always recorded, but it does not text\nthe owner when the sink has minLevel: important. Add --level important for a\nphone-worthy successful update. Use --blocked only when work cannot continue.\nThe owner destination comes from humans.yaml; do not duplicate it in agents.yaml.\n";
-export declare const FEED_NO_FANOUT_ENV = "AGENTS_FEED_LOCAL";
 /** Right-hand masthead summary: `N blocks · M agents`. */
 export declare function formatFeedMastheadRight(blocks: OpenBlock[]): string;
 /** Reply hint matching the shared fleet-comms reply line. */
@@ -29,7 +28,7 @@ export declare function formatFeedReplyHint(mailboxId: string): string;
 export declare function parseRemoteFeed(stdout: string, machine: string): OpenBlock[];
 /** Merge local and remote rows, keeping the first copy of a host/session block. */
 export declare function mergeFeedBlocks(...groups: OpenBlock[][]): OpenBlock[];
-export type FeedControlAction = 'pause' | 'kill';
+type FeedControlAction = 'pause' | 'kill';
 export declare function controlFeedSession(action: FeedControlAction, target: string, signals: FeedSessionSignal[]): Promise<string>;
 export declare function shouldIncludeLocalFeed(hosts: string[] | undefined, self: string): boolean;
 export declare function remoteFeedHostsToDial(hosts: string[] | undefined, self: string): string[] | undefined;
@@ -85,6 +84,7 @@ export declare function loadSessionMetasForFeedEnrichment<T>(load: () => Promise
 }>;
 export declare function registerFeedCommand(program: Command): void;
 /** Feed view selector (RUSH-2015): decisions, progress, or both. */
-export type FeedFilter = 'needs' | 'updates' | 'all';
+type FeedFilter = 'needs' | 'updates' | 'all';
 /** Normalize a raw --filter value; unknown/empty falls back to the default. */
 export declare function resolveFeedFilter(raw: string | undefined): FeedFilter;
+export {};

package/dist/commands/feed.js

@@ -65,7 +65,7 @@ the owner when the sink has minLevel: important. Add --level important for a
 phone-worthy successful update. Use --blocked only when work cannot continue.
 The owner destination comes from humans.yaml; do not duplicate it in agents.yaml.
 `;
-export const FEED_NO_FANOUT_ENV = 'AGENTS_FEED_LOCAL';
+const FEED_NO_FANOUT_ENV = 'AGENTS_FEED_LOCAL';
 /** Right-hand masthead summary: `N blocks · M agents`. */
 export function formatFeedMastheadRight(blocks) {
     const agents = new Set(blocks.map((b) => b.mailboxId)).size;

package/dist/commands/focus.d.ts

@@ -20,7 +20,7 @@ export { looksLikeTmuxAlias, resolveTmuxAliasState, shouldAttachLocalTmuxAliasBe
 import { type LiveStatusFilter } from './sessions.js';
 import { openSurfaces, type Backend } from '../lib/terminal/index.js';
 /** Options for `sessions focus` — device scope + the `--active` live-state filters. */
-export interface FocusOptions {
+interface FocusOptions {
     /**
      * Resolve the target from the launcher's AGENT_LAUNCH_ID instead of a session
      * id (RUSH-3125).
@@ -123,7 +123,7 @@ export declare function focusSelectedSession(meta: SessionMeta, active: ActiveSe
  *    running); never a silent drop.
  *  - `skip` — not resumable AND no rail: reported, not dropped.
  */
-export type FocusSurfacePlan = {
+type FocusSurfacePlan = {
     kind: 'attach';
     command: string[];
     note: string;
@@ -152,9 +152,9 @@ export declare function tmuxAttachScript(mux: {
  */
 export declare function planFocusSurface(s: ActiveSession, self: string, resumeCommandFor: (s: ActiveSession) => string[] | null, rail?: AttachRailLiveness): FocusSurfacePlan;
 /** The engine seam — real `openSurfaces`, overridable in tests to assert the tab requests. */
-export type OpenSurfacesFn = typeof openSurfaces;
+type OpenSurfacesFn = typeof openSurfaces;
 /** Test seams for `openFocusTabs`: inject the engine boundary + force a backend. */
-export interface OpenFocusTabsDeps {
+interface OpenFocusTabsDeps {
     open?: OpenSurfacesFn;
     /** Skip `resolveBackend` (which needs a live terminal) when set — tests pass 'tmux'. */
     backend?: Backend | 'inplace';

package/dist/commands/harness-hooks.d.ts

@@ -18,13 +18,6 @@
 import type { AgentId } from '../lib/types.js';
 import { type ModelInfo } from '../lib/models.js';
 import { type WizardHooks, type WizardIO, type WizardChoice } from './harness-wizard.js';
-/**
- * The installed version whose model catalog to read for a host. The wizard has
- * no version in hand for a fresh create, so it reads the host's default (or its
- * sole installed) version — the same version a bare `agents run <host>` uses.
- * Null when the host has no installed version to probe (→ free-text model).
- */
-export declare function catalogVersionFor(host: AgentId): string | null;
 /**
  * Build the model `select` choices from a catalog. Pure, so the labelling +
  * escape-hatch rows are unit-tested with no catalog probe. Every list ends with

package/dist/commands/harness-hooks.js

@@ -29,7 +29,7 @@ const KEEP_MODEL = '__keep_model__';
  * sole installed) version — the same version a bare `agents run <host>` uses.
  * Null when the host has no installed version to probe (→ free-text model).
  */
-export function catalogVersionFor(host) {
+function catalogVersionFor(host) {
     return getGlobalDefault(host) || listInstalledVersions(host)[0] || null;
 }
 /**

package/dist/commands/harness-wizard.d.ts

@@ -132,13 +132,13 @@ export interface HarnessEditable {
     fallback: boolean;
 }
 /** One field's editability plus, when disabled, the one-line reason to surface. */
-export interface EditableField {
+interface EditableField {
     enabled: boolean;
     /** Set only when `enabled` is false — the greyed field's stated reason. */
     reason?: string;
 }
 /** Per-host editability with a reason attached to every disabled field. */
-export interface HarnessEditability {
+interface HarnessEditability {
     model: EditableField;
     baseUrl: EditableField;
     auth: EditableField;

package/dist/commands/harness.d.ts

@@ -12,7 +12,7 @@
  */
 import type { Command } from 'commander';
 import { type AddProfileOptions } from './profiles.js';
-import { type Profile, type ForkProfileOptions } from '../lib/profiles.js';
+import { type Profile } from '../lib/profiles.js';
 import { type HarnessDraft } from './harness-wizard.js';
 /**
  * Print one custom harness. Shared by `agents harness view <name>` and by
@@ -62,12 +62,6 @@ export interface EditOptions {
  * copy a model from.
  */
 export declare function buildFork(source: string, name: string, opts: ForkOptions): Profile;
-/** Map `agents harness edit` flags onto {@link ForkProfileOptions} — the same
- * override shape `editProfile`/`forkProfile` apply. `--version ''` (unpin) is
- * handled by the caller ({@link buildEdit}), not here: `forkProfile`'s own
- * ternary treats an empty string as "no override" and would otherwise inherit
- * the source's version instead of clearing it. */
-export declare function buildEditOverrides(opts: EditOptions): ForkProfileOptions;
 /** True when at least one recognized edit flag was given. */
 export declare function hasEditFlags(opts: EditOptions): boolean;
 /**
@@ -85,7 +79,7 @@ export declare function forkNeedsWizard(source: string | undefined, name: string
  * fallback instead of being routed into the wizard. */
 export declare function addNeedsWizard(name: string | undefined, opts: AddProfileOptions): boolean;
 /** Whether the pre-save connection test runs, or must be asked for on a TTY. */
-export type ConnectionTestGate = 'on' | 'off' | 'ask';
+type ConnectionTestGate = 'on' | 'off' | 'ask';
 /**
  * Resolve the tri-state connection-test gate (RUSH-2221), pure so the branching
  * is unit-tested with no prompt or spawn. `--test` forces it on, `--no-test`
@@ -106,3 +100,4 @@ export declare function connectionTestGate(testFlag: boolean | undefined, intera
  */
 export declare function draftToEditOptions(draft: HarnessDraft, original: Profile): EditOptions;
 export declare function registerHarnessCommands(program: Command): void;
+export {};

package/dist/commands/harness.js

@@ -122,7 +122,7 @@ function authEnvKeyForHostOrThrow(host) {
  * handled by the caller ({@link buildEdit}), not here: `forkProfile`'s own
  * ternary treats an empty string as "no override" and would otherwise inherit
  * the source's version instead of clearing it. */
-export function buildEditOverrides(opts) {
+function buildEditOverrides(opts) {
     const overrides = {};
     if (opts.model !== undefined)
         overrides.model = opts.model;

package/dist/commands/inspect.d.ts

@@ -62,7 +62,6 @@ export interface InspectOptions {
     routine?: string;
 }
 export declare function registerInspectCommand(program: Command): void;
-export declare function inspectAction(target: string, options: InspectOptions): Promise<void>;
 export interface RepoTarget {
     /** Display label: 'user' | 'system' | 'project', an extra-repo alias, or a path-derived name. */
     label: string;
@@ -134,7 +133,7 @@ export declare function pathSize(p: string): {
     files: number;
 };
 /** Human byte size: "84 KB", "3.1 MB". */
-export interface ManifestSummary {
+interface ManifestSummary {
     /** `run.<agent>.strategy` pairs from agents.yaml. */
     strategies: Array<{
         agent: string;
@@ -148,7 +147,7 @@ export interface ManifestSummary {
 }
 /** Parse the repo's own agents.yaml into the version pins + run strategies it declares. */
 export declare function repoManifestSummary(root: string): ManifestSummary | null;
-export interface RepoGitInfo {
+interface RepoGitInfo {
     branch: string;
     dirty: number;
     dirtyFiles: string[];

package/dist/commands/inspect.js

@@ -139,7 +139,7 @@ export function registerInspectCommand(program) {
     });
 }
 // ─── Main dispatcher ─────────────────────────────────────────────────────────
-export async function inspectAction(target, options) {
+async function inspectAction(target, options) {
     const agentKey = target.split('@')[0].toLowerCase();
     if (!(agentKey in AGENTS)) {
         const repo = resolveRepoTarget(target);

package/dist/commands/message.d.ts

@@ -3,7 +3,7 @@
  *
  * Delivery is routed by agent state (RUSH-1474):
  *   - running, between tool calls → mailbox spool (PreToolUse inject)
- *   - parked on AskUserQuestion with a tmux/iterm/pty rail → keystroke inject
+ *   - parked on AskUserQuestion with a tmux/iterm rail → keystroke inject
  *   - parked headless (no rail) → `agents run --resume <id> -- <answer>`
  *   - cloud task → provider.message()
  *

package/dist/commands/message.js

@@ -157,7 +157,7 @@ async function deliverViaHostReroute(route, text, opts) {
  */
 const CONTROL_PLANE_NOTES = `
   Planes (do not mix them up):
-    message / sessions inject  - CONTROL a running agent (mailbox answer, PTY keystroke, or resume by runtime)
+    message / sessions inject  - CONTROL a running agent (mailbox answer, terminal keystroke, or resume by runtime)
     send / notify              - DELIVER a message to a human recipient over a channel provider
     feed post                  - RECORD progress / milestones (optional broadcast may call send/notify)
 
@@ -169,7 +169,7 @@ const CONTROL_PLANE_NOTES = `
 export function registerMessageCommand(program) {
     const messageCmd = program
         .command('message <target> <text>')
-        .description('Send a message to a running or parked agent (mailbox / PTY-select / resume by runtime).')
+        .description('Send a message to a running or parked agent (mailbox / terminal-select / resume by runtime).')
         .option('--from <who>', 'Label recorded as the sender of this message')
         .option('--as <operator>', 'Verified operator id answering a high-consequence block')
         .option('--surface <surface>', 'Surface that is sending this answer (feed, terminal, etc.)', 'cli')
@@ -222,7 +222,7 @@ export function registerMessageCommand(program) {
                         await deliverViaMailbox(res.id, text, block, { from: opts.from, ttlSeconds });
                         return;
                     }
-                    if (route.kind === 'tmux' || route.kind === 'iterm' || route.kind === 'pty') {
+                    if (route.kind === 'tmux' || route.kind === 'iterm') {
                         await deliverViaInject(route, res.id);
                         if (block) {
                             recordMessageReceipt(block.blockId, {

package/dist/commands/projects.d.ts

@@ -10,8 +10,6 @@
 import type { Command } from 'commander';
 import { type ProjectDef, type ProjectRepo } from '../lib/projects.js';
 import { type LinearMilestone } from '../lib/linear-project-counts.js';
-/** Recursion guard: a peer answering a probe fan-out never re-fans-out itself. */
-export declare const PROJECTS_NO_FANOUT_ENV = "AGENTS_PROJECTS_LOCAL";
 /**
  * A path-shaped `agents projects view` argument — `.`, `..`, a `~`-prefixed
  * value, or anything containing a path separator — means "auto-detect the
@@ -20,7 +18,7 @@ export declare const PROJECTS_NO_FANOUT_ENV = "AGENTS_PROJECTS_LOCAL";
  */
 export declare function looksLikePath(token: string): boolean;
 /** Machine-readable shape of `agents projects view <path> --json`. */
-export interface ViewDetection {
+interface ViewDetection {
     /** Detected project name, or null when no definition contains the path. */
     name: string | null;
     /** The detected project's Linear binding; fields are null when unbound. */
@@ -121,19 +119,5 @@ export declare function formatMilestoneDue(targetDate: string, nowMs: number): s
 export declare function formatMilestoneLines(milestones: LinearMilestone[], next: LinearMilestone | undefined, nowMs: number, limit: number): string[];
 /** The `next` card line: what this project is due to hit, and how far along it is. */
 export declare function formatNextMilestone(ms: LinearMilestone, nowMs: number): string;
-/** Options shared by `status` and `view`. */
-export type ProjectCardOpts = {
-    json?: boolean;
-    window?: string;
-    remote?: boolean;
-    /** Scope the fleet fan-out to specific devices; undefined = the whole fleet. */
-    deviceFilter?: string[];
-};
-/**
- * Merge `--device a b` (variadic) and `--devices a,b,c` (comma list) into one
- * deduped device filter; undefined when neither was given (= whole fleet).
- */
-export declare function resolveDeviceFilter(device?: string[], devices?: string): string[] | undefined;
-/** Print the YAML-side fields that sit under the shared card in `view` mode. */
-export declare function printProjectDefinition(def: ProjectDef, name: string): void;
 export declare function registerProjectsCommands(program: Command): void;
+export {};

package/dist/commands/projects.js

@@ -30,8 +30,9 @@ import { checkRepoSlug } from '../lib/project-doctor.js';
 import { formatFocusAreas, readFocusAreas } from '../lib/project-focus.js';
 import { formatVerdict, scheduleVerdict } from '../lib/project-schedule.js';
 import { buildLinearImportCandidates, validateImportOpts, } from '../lib/project-import.js';
+import { buildProjectPrs } from '../lib/github/project-prs.js';
 /** Recursion guard: a peer answering a probe fan-out never re-fans-out itself. */
-export const PROJECTS_NO_FANOUT_ENV = 'AGENTS_PROJECTS_LOCAL';
+const PROJECTS_NO_FANOUT_ENV = 'AGENTS_PROJECTS_LOCAL';
 /** Max peers named in the skipped note before the rest collapse to `+N`. */
 const SKIPPED_NAME_LIMIT = 4;
 /**
@@ -482,7 +483,7 @@ warnWorkspaces = []) {
  * Merge `--device a b` (variadic) and `--devices a,b,c` (comma list) into one
  * deduped device filter; undefined when neither was given (= whole fleet).
  */
-export function resolveDeviceFilter(device, devices) {
+function resolveDeviceFilter(device, devices) {
     const merged = [
         ...(device ?? []),
         ...(devices ? devices.split(',').map((s) => s.trim()).filter(Boolean) : []),
@@ -490,7 +491,7 @@ export function resolveDeviceFilter(device, devices) {
     return merged.length ? [...new Set(merged)] : undefined;
 }
 /** Print the YAML-side fields that sit under the shared card in `view` mode. */
-export function printProjectDefinition(def, name) {
+function printProjectDefinition(def, name) {
     console.log();
     if (def.root)
         console.log(`  ${chalk.dim('root')}     ${def.root}`);
@@ -818,6 +819,91 @@ export function registerProjectsCommands(program) {
         const mode = name ? 'view' : 'status';
         await runProjectCard(name, opts, mode);
     });
+    // ---- prs ----
+    const prsCmd = projects
+        .command('prs <name>')
+        .description('Every OPEN pull request across a project\'s attached repos (drafts included, no author filter).')
+        .option('--json', 'Machine-readable output (the AGI Menu contract shape)')
+        .option('--repo <owner/repo>', 'Restrict to one of the project\'s attached repos')
+        .option('--number <n>', 'Lazy detail: enrich exactly this PR with checks + reviewDecision (requires --repo)')
+        .action(async (name, opts) => {
+        const def = loadProjectDef(name);
+        if (!def) {
+            console.error(chalk.red(`No project named "${name}". List them: agents projects list`));
+            process.exit(1);
+        }
+        let number;
+        if (opts.number !== undefined) {
+            if (!opts.repo) {
+                console.error(chalk.red('--number names one PR in one repo; pass --repo <owner/repo> with it.'));
+                process.exit(1);
+            }
+            // Require the WHOLE token to be digits — Number.parseInt would accept
+            // "12junk" / "12.9" as 12 and silently query the wrong PR.
+            const raw = opts.number.trim();
+            number = /^\d+$/.test(raw) ? Number.parseInt(raw, 10) : NaN;
+            if (!Number.isSafeInteger(number) || number <= 0) {
+                console.error(chalk.red(`--number expects a positive integer, got "${opts.number}".`));
+                process.exit(1);
+            }
+        }
+        let envelope;
+        try {
+            envelope = await buildProjectPrs(def, { repo: opts.repo, number }, undefined);
+        }
+        catch (e) {
+            // A restriction error (repo not attached) is a hard, up-front failure —
+            // distinct from a per-repo fetch failure, which rides in the envelope.
+            console.error(chalk.red(e instanceof Error ? e.message : String(e)));
+            process.exit(1);
+        }
+        if (opts.json) {
+            // A machine caller reads the envelope from stdout regardless of exit
+            // code: `partial` + per-repo `error` ARE the failure signal, and the
+            // successful repositories ride alongside them. So --json always exits 0
+            // (the envelope is authoritative); a native consumer must not discard
+            // stdout on a non-zero exit. Only the human path below exits non-zero.
+            console.log(JSON.stringify(envelope, null, 2));
+            return;
+        }
+        else {
+            for (const r of envelope.repositories) {
+                if (r.error) {
+                    console.log(`${chalk.bold(r.slug)}  ${chalk.red(`— fetch failed: ${r.error}`)}`);
+                    continue;
+                }
+                console.log(`${chalk.bold(r.slug)}  ${chalk.dim(`${r.pullRequests.length} open`)}`);
+                for (const pr of r.pullRequests) {
+                    const draft = pr.isDraft ? chalk.gray(' [draft]') : '';
+                    console.log(`  #${pr.number}${draft}  ${pr.title}  ${chalk.gray(`@${pr.author.login} · ${pr.headRefName}`)}`);
+                }
+            }
+            if (envelope.partial) {
+                console.log(chalk.yellow('\nSome repositories could not be fetched — the list above is incomplete.'));
+            }
+        }
+        // A partial result (any repo fetch failed) is not a clean success.
+        if (envelope.partial)
+            process.exit(1);
+    });
+    setHelpSections(prsCmd, {
+        examples: `
+      agents projects prs rush --json                       # every open PR across rush's repos
+      agents projects prs rush --json --repo phnx-labs/agi-cli
+      agents projects prs rush --json --repo phnx-labs/agi-cli --number 3646  # one PR, with checks + review
+    `,
+        notes: `
+      Repos come from the project definition's attached repos only (repo + repos[].slug);
+      --repo is refused unless it is one of them.
+
+      The list is read from GitHub over REST and paginated in full, drafts included,
+      with no author filter. checks and reviewDecision are null in the list; --number
+      enriches exactly that one PR against its live head SHA.
+
+      A repository whose fetch fails is reported with an error and marks the result
+      partial (JSON reports errors per repository; text mode exits non-zero).
+    `,
+    });
     // ---- edit ----
     projects
         .command('edit <name>')

package/dist/commands/resource-view.d.ts

@@ -22,7 +22,7 @@ export interface ResourceRow {
     targets: SyncTarget[];
     buildDetail: () => string;
 }
-export interface ResourceViewOptions {
+interface ResourceViewOptions {
     resourcePlural: string;
     resourceSingular: string;
     extraLabel?: string;
@@ -55,7 +55,7 @@ export interface ResourceViewOptions {
 }
 /** Display a resource list: interactive picker in TTY mode, plain table otherwise. */
 export declare function showResourceList(opts: ResourceViewOptions): Promise<void>;
-export interface ResourceLayout {
+interface ResourceLayout {
     mode: 'table' | 'cards';
     nameW: number;
     extraW: number;
@@ -77,4 +77,5 @@ export declare function resourceLayout(cols: number, o: {
 }): ResourceLayout;
 /** Build the sync targets section showing version pills grouped by agent. */
 export declare function buildTargetsSection(targets: SyncTarget[]): string;
+export {};
 /** Pad a string to a fixed width, accounting for ANSI escape codes in length calculation. */

package/dist/commands/resume.d.ts

@@ -1,5 +1,4 @@
 import type { SessionMeta } from '../lib/session/types.js';
-export declare const RESUME_SOURCE_ENV = "AGENTS_RESUME_SOURCE_JSON";
 /** Inspect local archived context after the owner hop fails. Recovery still
  * requires readable content and explicit replay consent before starting a run. */
 export declare function resumeLocalFallbackSource(session: SessionMeta, self?: string): SessionMeta;

package/dist/commands/resume.js

@@ -8,7 +8,7 @@ import chalk from 'chalk';
 import { resolveSessionMetadataValue } from './sessions.js';
 import { sessionOwnerDevice, consumeResumePinned, RESUME_PINNED_ENV } from '../lib/session/resume-owner.js';
 import { machineId } from '../lib/machine-id.js';
-export const RESUME_SOURCE_ENV = 'AGENTS_RESUME_SOURCE_JSON';
+const RESUME_SOURCE_ENV = 'AGENTS_RESUME_SOURCE_JSON';
 /** Inspect local archived context after the owner hop fails. Recovery still
  * requires readable content and explicit replay consent before starting a run. */
 export function resumeLocalFallbackSource(session, self = machineId()) {