@phnx-labs/agents-cli 1.22.43 → 1.22.45

package/dist/lib/session/active.d.ts

@@ -59,7 +59,7 @@ export declare function attributedSetLostPids(prev: Set<number>, next: Set<numbe
  * the same pid-reuse guard {@link isPidAlive} uses elsewhere.
  */
 export declare function filterCachedUnattributed(sessions: ActiveSession[], attributed: Set<number>, alive: (pid: number, startedAtMs?: number) => boolean): ActiveSession[];
-export type ActiveContext = 'terminal' | 'teams' | 'cloud' | 'headless';
+type ActiveContext = 'terminal' | 'teams' | 'cloud' | 'headless';
 /** The SessionMeta fields the live-row backfill reads — the enrichment a running process cannot report. */
 export type BackfillMeta = Pick<SessionMeta, 'version' | 'timestamp' | 'label' | 'ticketId' | 'prUrl' | 'prNumber' | 'origin' | 'routineName'>;
 export declare function backfillActiveRowsFromMeta(sessions: ActiveSession[], metaById: Map<string, BackfillMeta>): void;
@@ -335,7 +335,7 @@ export interface ActiveSession {
     paneId?: string;
 }
 export declare function activeStatusFromCloudStatus(status: CloudTaskStatus): ActiveStatus;
-export interface ActiveQueryOptions {
+interface ActiveQueryOptions {
     /** Skip the `ps` scan for ad-hoc headless agents. */
     skipHeadless?: boolean;
     /**
@@ -359,14 +359,6 @@ export interface ActiveQueryOptions {
 export declare class TmuxDiscoveryDegradedError extends Error {
     constructor(message: string);
 }
-/**
- * A live process can only borrow an indexed session file if that transcript
- * has been touched recently enough to plausibly belong to the process. This is
- * deliberately wider than ACTIVE_MTIME_WINDOW_MS: an inactive-but-live CLI can
- * be idle for longer than 2 minutes, but it must not attach to a weeks-old
- * transcript just because a GUI app service with the same basename is alive.
- */
-export declare const ACTIVE_SESSION_STALE_MS: number;
 /**
  * A session whose transcript hasn't been written in this long is ABANDONED /
  * dangling — the framework can no longer treat it as live work, whether its PID
@@ -420,8 +412,6 @@ export declare function resolveNamesToSessionIds(sessionNames: string[], deps: {
  * the start time can't be read, we keep the existence answer.
  */
 export declare function isPidAlive(pid: number, startedAtMs?: number): boolean;
-/** Test seam: drop the Claude session-file path memo. */
-export declare function clearClaudeSessionFileCacheForTest(): void;
 /**
  * Resolve a Claude transcript for `cwd` across the given project roots, newest
  * mtime winning when the same id/cwd resolves in more than one version home
@@ -553,8 +543,6 @@ export declare function listTeamsActive(opts?: {
 }): Promise<ActiveSession[]>;
 /** Live editor-terminal agents across every IDE window. */
 export declare function listTerminalsActive(): Promise<ActiveSession[]>;
-/** Cloud tasks still in a non-terminal state. `tasks.db` may not exist; that's fine. */
-export declare function listCloudActive(): ActiveSession[];
 interface ProcRow {
     pid: number;
     ppid: number;
@@ -628,7 +616,7 @@ export declare function foldSubordinateAgents(candidates: AgentCandidate[], ppid
  */
 export declare function listUnattributedActive(attributed: Set<number>): Promise<ActiveSession[]>;
 /** One tmux pane's resolved agent identity for the authoritative source. */
-export interface PaneIdentity {
+interface PaneIdentity {
     agent: string;
     /** Exact session id when resolvable (launch registry, or the hook join). */
     sessionId?: string;
@@ -679,7 +667,7 @@ export declare function listTmuxAgentSessions(): Promise<ActiveSession[]>;
  */
 export declare function getActiveSessions(opts?: ActiveQueryOptions): Promise<ActiveSession[]>;
 /** Local discovery sources probed by {@link describeActiveDiscoveryHealth}. */
-export interface ActiveDiscoveryHealth {
+interface ActiveDiscoveryHealth {
     /** Sources that failed on the probe (currently only `'tmux'`). Empty = nothing degraded locally. */
     degradedSources: string[];
 }

package/dist/lib/session/active.js

@@ -262,7 +262,7 @@ export class TmuxDiscoveryDegradedError extends Error {
  * be idle for longer than 2 minutes, but it must not attach to a weeks-old
  * transcript just because a GUI app service with the same basename is alive.
  */
-export const ACTIVE_SESSION_STALE_MS = 24 * 60 * 60_000;
+const ACTIVE_SESSION_STALE_MS = 24 * 60 * 60_000;
 /**
  * A session whose transcript hasn't been written in this long is ABANDONED /
  * dangling — the framework can no longer treat it as live work, whether its PID
@@ -541,10 +541,6 @@ function claudeProjectDirName(cwd) {
  */
 const CLAUDE_SESSION_FILE_CACHE_MAX = 256;
 const claudeSessionFileCache = new Map();
-/** Test seam: drop the Claude session-file path memo. */
-export function clearClaudeSessionFileCacheForTest() {
-    claudeSessionFileCache.clear();
-}
 /**
  * Locate the active Claude session file for a process. If we know the session
  * UUID (from terminal env or team parent), prefer the exact match. Otherwise
@@ -1094,7 +1090,7 @@ export async function listTerminalsActive() {
     });
 }
 /** Cloud tasks still in a non-terminal state. `tasks.db` may not exist; that's fine. */
-export function listCloudActive() {
+function listCloudActive() {
     let tasks;
     try {
         tasks = listActiveTasks();

package/dist/lib/session/db.d.ts

@@ -13,13 +13,6 @@ import { type IndexedToolCall } from './tool-calls.js';
  * assert against the constant instead of hardcoding a number that every bump
  * then has to chase (docs/sessions.md calls the constant the source of truth). */
 export declare const SCHEMA_VERSION = 39;
-/**
- * Bump to force `agents sessions backfill resources` to re-derive every
- * session's skill/slash-command tallies on its next run (resource_scan_ledger
- * rows with a lower version are treated as stale — the same mechanism
- * TOOL_INDEX_VERSION gives the tool backfill).
- */
-export declare const RESOURCE_INDEX_VERSION = 1;
 /**
  * Bumping this invalidates every cached facet row without touching the schema
  * version, so a change to the extraction logic (a new metric, a corrected bucket)
@@ -28,67 +21,6 @@ export declare const RESOURCE_INDEX_VERSION = 1;
  */
 /** Bump when facet extraction changes so cached rows recompute (stalls-by-model v6). */
 export declare const INSIGHTS_EXTRACTOR_VERSION = 6;
-export declare const PREVIEW_EXTRACTOR_VERSION = 1;
-/** Raw row shape returned from the sessions table. */
-export interface SessionRow {
-    id: string;
-    short_id: string;
-    agent: string;
-    origin: string | null;
-    routine_name: string | null;
-    routine_run_id: string | null;
-    version: string | null;
-    account: string | null;
-    account_key: string | null;
-    account_org: string | null;
-    mode: string | null;
-    timestamp: string;
-    last_activity: string | null;
-    project: string | null;
-    cwd: string | null;
-    git_branch: string | null;
-    topic: string | null;
-    label: string | null;
-    message_count: number | null;
-    token_count: number | null;
-    output_tokens: number | null;
-    input_tokens: number | null;
-    cache_read_tokens: number | null;
-    cache_write_tokens: number | null;
-    cost_usd: number | null;
-    cost_usd_nocache: number | null;
-    duration_ms: number | null;
-    model: string | null;
-    tool_call_count: number | null;
-    file_path: string;
-    file_mtime_ms: number | null;
-    file_size: number | null;
-    scanned_at: number | null;
-    is_team_origin: number;
-    pr_url: string | null;
-    pr_number: number | null;
-    worktree_slug: string | null;
-    ticket_id: string | null;
-    spawned_team: string | null;
-    plan: string | null;
-    machine: string | null;
-    todos: string | null;
-    recent_directories_touched: string | null;
-    linear_project: string | null;
-    linear_project_url: string | null;
-    actor: string | null;
-    initiated_by: string | null;
-    /** NULL means "not yet computed" (a row scanned before this field existed) — see rowToMeta. */
-    used_browser: number | null;
-    used_computer: number | null;
-    /**
-     * Epoch ms the transcript file was first confirmed gone while content survived
-     * (RUSH-2436); NULL = live/never archived. Optional because the scanner upsert
-     * write-payload never sets it — the INSERT column list omits it, so a rescan
-     * preserves the sticky stamp; it is written only by querySessions.
-     */
-    archived_at?: number | null;
-}
 /** File stat snapshot used to detect changes between scan runs. */
 export interface ScanStamp {
     fileMtimeMs: number;
@@ -143,7 +75,7 @@ export interface QueryOptions {
 export declare function getDB(): Database.Database;
 /** Close the cached database connection. */
 export declare function closeDB(): void;
-export interface FtsOptimizeResult {
+interface FtsOptimizeResult {
     table: string;
     segmentsBefore: number;
     segmentsAfter: number;
@@ -224,7 +156,7 @@ export declare function getScanStampsForPaths(filePaths: string[]): Map<string,
  * written by the Claude scan (B-2) and consumed on the next scan to decide
  * full-vs-incremental and to hydrate the resume.
  */
-export interface ParserStateRow {
+interface ParserStateRow {
     parserState: string | null;
     contentText: string | null;
     fileMtimeMs: number;
@@ -348,7 +280,7 @@ export declare function querySessions(options?: QueryOptions): SessionMeta[];
 /** Count sessions matching the given filter options. */
 export declare function countSessions(options?: QueryOptions): number;
 /** One grouped row in a cost/duration rollup. */
-export interface UsageRollupRow {
+interface UsageRollupRow {
     /**
      * Grouping key value: the agent id, project name, ISO date (YYYY-MM-DD), or
      * account identity (`claude:org=<uuid>` / `unattributed:<reason>`).
@@ -454,7 +386,7 @@ export type UsageRollupGroup = 'agent' | 'project' | 'day' | 'account';
  * Account rotation is NOT done here — that stays on live rate-limit windows
  * via `--strategy balanced` / rotate.ts.
  */
-export type AffinityGroup = 'machine' | 'agent' | 'machine_agent';
+type AffinityGroup = 'machine' | 'agent' | 'machine_agent';
 export interface AffinityRow {
     /** Group key: machine name, agent id, or "machine\\tagent". */
     key: string;
@@ -540,7 +472,7 @@ export declare function resourceUsageCoverage(): {
     total: number;
 };
 /** Outcome of a resource-usage backfill run. */
-export interface ResourceBackfillResult {
+interface ResourceBackfillResult {
     /** Sessions considered (matched the filter, had a real transcript). */
     scanned: number;
     /** Sessions (re)parsed and written this run. */
@@ -585,7 +517,7 @@ export interface TeamSpawner {
  */
 export declare function teamSpawners(): Map<string, TeamSpawner>;
 /** A session with its cost, for the top-N-by-cost listing. */
-export interface TopCostSession {
+interface TopCostSession {
     meta: SessionMeta;
     costUsd: number;
     durationMs: number;
@@ -638,7 +570,7 @@ export declare function findSessionsById(idQuery: string, scope?: Pick<QueryOpti
  */
 export declare function findSessionsByShortIds(shortIds: string[]): Map<string, SessionMeta>;
 /** A single full-text search result with ranking score. */
-export interface FtsHit {
+interface FtsHit {
     sessionId: string;
     score: number;
     matchedTerms: string[];
@@ -667,11 +599,6 @@ export declare function buildFtsQuery(input: string): {
  * so "higher = better" is consistent across all tiers.
  */
 export declare function ftsSearch(input: string, limit?: number): FtsHit[];
-/** Return the total row counts for the sessions and FTS5 tables (diagnostic). */
-export declare function getRowCount(): {
-    sessions: number;
-    textRows: number;
-};
 /**
  * Rewrite file_path for all sessions whose path starts with oldPrefix, replacing
  * it with newPrefix + the unchanged suffix. Also clears the matching scan_ledger
@@ -683,14 +610,14 @@ export declare function getRowCount(): {
  */
 export declare function updateSessionFilePaths(oldPrefix: string, newPrefix: string): number;
 /** Per-kind capture tallies for a browser task. Counts only -- never the bytes. */
-export interface BrowserCaptureCounts {
+interface BrowserCaptureCounts {
     screenshot: number;
     pdf: number;
     recording: number;
     download: number;
 }
 /** One durable browser-task row. `machine` defaults to this device. */
-export interface BrowserSessionRecord {
+interface BrowserSessionRecord {
     task: string;
     profile: string;
     sessionId?: string;
@@ -704,7 +631,7 @@ export interface BrowserSessionRecord {
     capturesRemote?: string;
 }
 /** One durable computer-use invocation row. `machine` defaults to this device. */
-export interface ComputerSessionRecord {
+interface ComputerSessionRecord {
     invocationId: string;
     sessionId?: string;
     launchId?: string;
@@ -743,7 +670,7 @@ export declare function recordBrowserSession(record: BrowserSessionRecord): void
  */
 export declare function recordComputerSession(record: ComputerSessionRecord): void;
 /** A stored browser row as read back, with counts rehydrated. */
-export interface StoredBrowserSession extends Required<Pick<BrowserSessionRecord, 'task' | 'profile'>> {
+interface StoredBrowserSession extends Required<Pick<BrowserSessionRecord, 'task' | 'profile'>> {
     sessionId?: string;
     launchId?: string;
     actor?: string;
@@ -771,7 +698,7 @@ export declare function listBrowserSessionRecords(profile?: string, opts?: {
 /** One stored browser task by its (profile, task) key, or null. */
 export declare function getBrowserSessionRecord(profile: string, task: string): StoredBrowserSession | null;
 /** A stored computer-use invocation as read back. */
-export interface StoredComputerSession {
+interface StoredComputerSession {
     invocationId: string;
     sessionId?: string;
     launchId?: string;
@@ -782,19 +709,6 @@ export interface StoredComputerSession {
     actionCount: number;
     taskPreview?: string;
 }
-/**
- * Retention for the tool-session tables.
- *
- * These are the durable answer to a ledger that prunes at 7 days, so they are
- * deliberately long-lived — but "durable" is not "unbounded". `computer_sessions`
- * takes one row per `agents computer` CLI PROCESS (`COMPUTER_INVOCATION_ID` is
- * minted per process), and an agent driving a desktop invokes that hundreds of
- * times a day, so an unbounded table would grow without limit and be read in
- * full on every listing.
- */
-export declare const TOOL_SESSION_MAX_AGE_DAYS = 365;
-/** Default ceiling on rows one listing will read. */
-export declare const TOOL_SESSION_LIST_LIMIT = 2000;
 /**
  * Drop tool-session rows past {@link TOOL_SESSION_MAX_AGE_DAYS}.
  *
@@ -813,3 +727,4 @@ export declare function listComputerSessionRecords(opts?: {
     limit?: number;
     startedBeforeMs?: number;
 }): StoredComputerSession[];
+export {};

package/dist/lib/session/db.js

@@ -34,7 +34,7 @@ export const SCHEMA_VERSION = 39;
  * rows with a lower version are treated as stale — the same mechanism
  * TOOL_INDEX_VERSION gives the tool backfill).
  */
-export const RESOURCE_INDEX_VERSION = 1;
+const RESOURCE_INDEX_VERSION = 1;
 /**
  * Canonicalize a file path for use as a scan_ledger key. The same physical
  * session file is reachable via multiple aliases — `~/.claude/projects/x.jsonl`
@@ -397,7 +397,7 @@ CREATE INDEX IF NOT EXISTS idx_computer_sessions_started ON computer_sessions(st
  */
 /** Bump when facet extraction changes so cached rows recompute (stalls-by-model v6). */
 export const INSIGHTS_EXTRACTOR_VERSION = 6;
-export const PREVIEW_EXTRACTOR_VERSION = 1;
+const PREVIEW_EXTRACTOR_VERSION = 1;
 let dbInstance = null;
 /**
  * Apply schema migrations from `fromVersion` → SCHEMA_VERSION. The new
@@ -3365,13 +3365,6 @@ export function ftsSearch(input, limit = 200) {
     hits.sort((a, b) => b.score - a.score);
     return hits.slice(0, limit);
 }
-/** Return the total row counts for the sessions and FTS5 tables (diagnostic). */
-export function getRowCount() {
-    const db = getDB();
-    const sessions = db.prepare(`SELECT COUNT(*) AS c FROM sessions`).get().c;
-    const textRows = db.prepare(`SELECT COUNT(*) AS c FROM session_text`).get().c;
-    return { sessions, textRows };
-}
 /**
  * Rewrite file_path for all sessions whose path starts with oldPrefix, replacing
  * it with newPrefix + the unchanged suffix. Also clears the matching scan_ledger
@@ -3520,9 +3513,9 @@ export function getBrowserSessionRecord(profile, task) {
  * times a day, so an unbounded table would grow without limit and be read in
  * full on every listing.
  */
-export const TOOL_SESSION_MAX_AGE_DAYS = 365;
+const TOOL_SESSION_MAX_AGE_DAYS = 365;
 /** Default ceiling on rows one listing will read. */
-export const TOOL_SESSION_LIST_LIMIT = 2000;
+const TOOL_SESSION_LIST_LIMIT = 2000;
 /**
  * Drop tool-session rows past {@link TOOL_SESSION_MAX_AGE_DAYS}.
  *

package/dist/lib/session/discover.d.ts

@@ -10,8 +10,6 @@ import type { SessionAgentId, SessionEvent, SessionMeta, TodoProgress } from './
 export { machineForSessionFile } from './origin-machine.js';
 import { type ScanStamp } from './db.js';
 import { ToolCallCollector, type IndexedToolCall, type ToolCallCollectorSnapshot } from './tool-calls.js';
-/** One JSONL record may not force an unbounded string allocation. */
-export declare const SESSION_JSONL_LINE_MAX_BYTES: number;
 /** Options controlling which sessions to discover and how to report progress. */
 export interface DiscoverOptions {
     agent?: SessionAgentId;
@@ -172,7 +170,7 @@ interface CodexSessionScan {
  */
 export declare function discoverSessions(options?: DiscoverOptions): Promise<SessionMeta[]>;
 /** What one incremental scan actually did. */
-export interface IncrementalScanResult {
+interface IncrementalScanResult {
     /** True when this process won the single-flight claim and ran the scan. */
     claimed: boolean;
     /**
@@ -362,7 +360,7 @@ export declare function filterChangedFiles(filePaths: string[]): Array<{
     scan: ScanStamp;
 }>;
 /** A path already stat'd by the walk — mtime is the raw (unfloored) fs value. */
-export interface PreStatEntry {
+interface PreStatEntry {
     filePath: string;
     fileMtimeMs: number;
     fileSize: number;
@@ -378,64 +376,13 @@ export declare function filterChangedEntries(entries: PreStatEntry[]): Array<{
     scan: ScanStamp;
 }>;
 export declare function shouldDeferRecentAppend(prev: ScanStamp, current: ScanStamp, nowMs: number, debounceMs?: number): boolean;
-/** One leaf directory of transcripts to change-detect, plus its live-root flag. */
-export interface LeafDir {
-    /** Absolute path to the directory that directly holds transcript files. */
-    dirPath: string;
-    /**
-     * True if this dir is under the agent's LIVE `~/.<agent>` root — the only tree
-     * an agent process appends to live. Every file in such a dir is treated as
-     * hot (always re-stat'd), so an in-place append is never missed there.
-     */
-    isLiveRoot: boolean;
-}
-/** The changed files a leaf-dir walk surfaced, ready to parse + upsert. */
-export interface LeafDirScan {
-    /** Files whose (mtime, size) changed vs the ledger — the parse set. */
-    changed: Array<{
-        filePath: string;
-        scan: ScanStamp;
-    }>;
-    /**
-     * Every transcript file seen across all leaf dirs (changed or not), in
-     * live-root-first order, each tagged with whether its dir is a live root.
-     * Lets a caller restore cross-root, session-id precedence (prefer the live
-     * copy of a session over a frozen backup copy) independent of which copy
-     * happened to be flagged "changed" this run.
-     */
-    allFiles: Array<{
-        filePath: string;
-        isLiveRoot: boolean;
-    }>;
-}
-/**
- * Walk a set of leaf transcript directories and return the files that changed,
- * skipping the per-file `stat` of directories whose (mtime, entry_count) matches
- * the dir_ledger.
- *
- * Per leaf dir:
- *   - `stat` the dir once and `readdir` it (one cheap syscall) to get the entry
- *     count and the file list.
- *   - If the dir matches the dir_ledger (floored mtime AND entry_count), no file
- *     was created / deleted / renamed since we last walked it. We then stat ONLY
- *     the hot files (live-root files, or files scanned within HOT_FILE_WINDOW_MS)
- *     and run just those through the ledger compare — so an in-place append to a
- *     still-live session is still caught, while immutable backup/version dirs
- *     collapse to a single dir stat and zero per-file stats.
- *   - Else (changed dir, or no ledger row) we stat every file (today's full
- *     walk) and record the fresh dir stamp so the next run can short-circuit.
- *
- * The kill-switch (`AGENTS_SESSIONS_NO_DIR_LEDGER=1`) forces the full-walk branch
- * for every dir and never consults or records the dir_ledger.
- */
-export declare function collectChangedFilesInLeafDirs(leafDirs: LeafDir[], ext: string): LeafDirScan;
 /**
  * Collect all directories to scan for an agent's sessions. Deduplicates by
  * realpath to avoid double-counting symlinked version homes.
  */
 export declare function getAgentSessionDirs(agent: string, subdir: string): string[];
 /** A session-agent's on-disk watch roots (every version home + backup mirror). */
-export interface SessionRoots {
+interface SessionRoots {
     agent: SessionAgentId;
     /** Absolute directories that hold this agent's transcripts, existing right now. */
     dirs: string[];
@@ -492,7 +439,7 @@ export declare function readCodexMeta(filePath: string, resolveAccount?: () => s
  * both a full parse and a resumable incremental parse (see
  * {@link scanClaudeSessionIncremental}).
  */
-export interface ClaudeParseState {
+interface ClaudeParseState {
     timestamp?: string;
     cwd?: string;
     gitBranch?: string;
@@ -680,7 +627,7 @@ export declare function __resetClaudeScanBranchCountsForTest(): void;
  * fold ({@link applyCodexLine}) runs for both a full parse and an incremental
  * resume. Mirrors {@link ClaudeParseState}.
  */
-export interface CodexParseState {
+interface CodexParseState {
     sessionId?: string;
     timestamp?: string;
     cwd?: string;
@@ -712,18 +659,6 @@ export interface CodexParseState {
 }
 /** Zero-value accumulator for a fresh (from-byte-0) Codex parse. */
 export declare function initCodexParseState(): CodexParseState;
-/**
- * Fold one parsed Codex line into the accumulator — the exact loop body
- * {@link scanCodexSession} used to run inline, extracted verbatim and mutating
- * `state.*` in place. `parsed` is the already-`JSON.parse`d line (the
- * malformed-line skip happens in the caller, as before).
- */
-export declare function applyCodexLine(state: CodexParseState, parsed: any): void;
-/**
- * Build the {@link CodexSessionScan} return object from an accumulator — the
- * exact return-building {@link scanCodexSession} used to run inline.
- */
-export declare function finalizeCodexScan(state: CodexParseState): CodexSessionScan;
 /**
  * SERIALIZED continuation blob persisted in `scan_ledger.parser_state` for a
  * Codex rollout. Carries everything {@link hydrateCodexParseState} needs to
@@ -769,17 +704,6 @@ export interface CodexParserState {
  * incremental replay equals a full parse.
  */
 export declare function serializeCodexParserState(state: CodexParseState, offset: number, jsonlDroppingOversizedLine?: boolean): CodexParserState;
-/**
- * Rebuild a live {@link CodexParseState} from a persisted continuation so that
- * applying the appended lines yields the same accumulator a full parse would.
- *
- * `userTexts` is rehydrated as a single joined blob from `contentText`: only
- * `userTexts.join('\n')` (detectTicket + contentText) and `userTexts.length > 0`
- * are ever read downstream, and both are preserved by a one-element array
- * holding the joined content. Topic is first-wins and already persisted, so a
- * collapsed userTexts never changes it.
- */
-export declare function hydrateCodexParseState(prior: CodexParserState): CodexParseState;
 /**
  * Resume a Codex parse from `fromOffset` bytes into the file, folding only the
  * newly-appended lines into `prior`. Returns the finalized scan, the next

package/dist/lib/session/discover.js

@@ -55,7 +55,7 @@ const MUSE_SESSIONS_DIR = path.join(HOME, '.local', 'share', 'muse', 'sessions')
 const OPENCLAW_TTL_MS = 60_000;
 const ACTIVE_APPEND_RESCAN_DEBOUNCE_MS = 5_000;
 /** One JSONL record may not force an unbounded string allocation. */
-export const SESSION_JSONL_LINE_MAX_BYTES = 1024 * 1024;
+const SESSION_JSONL_LINE_MAX_BYTES = 1024 * 1024;
 /**
  * Stream one appended JSONL range, applying only newline-terminated records.
  * Memory is bounded to one record. An ordinary unterminated tail remains for the
@@ -728,7 +728,7 @@ export function shouldDeferRecentAppend(prev, current, nowMs, debounceMs = ACTIV
  * The kill-switch (`AGENTS_SESSIONS_NO_DIR_LEDGER=1`) forces the full-walk branch
  * for every dir and never consults or records the dir_ledger.
  */
-export function collectChangedFilesInLeafDirs(leafDirs, ext) {
+function collectChangedFilesInLeafDirs(leafDirs, ext) {
     const disabled = dirLedgerDisabled();
     const dirStamps = disabled ? new Map() : getDirLedgerForPaths(leafDirs.map(d => d.dirPath));
     const now = Date.now();
@@ -3619,7 +3619,7 @@ export function initCodexParseState() {
  * `state.*` in place. `parsed` is the already-`JSON.parse`d line (the
  * malformed-line skip happens in the caller, as before).
  */
-export function applyCodexLine(state, parsed) {
+function applyCodexLine(state, parsed) {
     collectCodexToolCalls(state.toolCollector, parsed);
     // PR signal, structurally: a Codex `function_call` whose command is
     // `gh pr create`, then the pull URL from a `function_call_output`.
@@ -3730,7 +3730,7 @@ export function applyCodexLine(state, parsed) {
  * Build the {@link CodexSessionScan} return object from an accumulator — the
  * exact return-building {@link scanCodexSession} used to run inline.
  */
-export function finalizeCodexScan(state) {
+function finalizeCodexScan(state) {
     // Codex reports one cumulative snapshot: uncached input, cached (cache-read)
     // input, and output+reasoning. It has no cache-write bucket. Derive the burn
     // split and both costs (actual + no-cache) from that final snapshot (RUSH-2287).
@@ -3869,7 +3869,7 @@ export function serializeCodexParserState(state, offset, jsonlDroppingOversizedL
  * holding the joined content. Topic is first-wins and already persisted, so a
  * collapsed userTexts never changes it.
  */
-export function hydrateCodexParseState(prior) {
+function hydrateCodexParseState(prior) {
     return {
         sessionId: prior.sessionId,
         timestamp: prior.timestamp,

package/dist/lib/session/remote/remote-bundle.d.ts

@@ -0,0 +1,12 @@
+import { type ParsedBundle } from '../bundle.js';
+export interface RemotePullResult {
+    bundles: ParsedBundle[];
+    errors: string[];
+}
+/**
+ * Run `agents sessions export …exportArgs --stdout` on each host and parse the
+ * streamed bundle. A host that fails (unreachable, remote error, bad output) is
+ * collected in `errors` and skipped — one asleep peer never aborts the pull.
+ * `exportArgs` must NOT contain --device (the remote export runs for itself only).
+ */
+export declare function pullBundlesFromHosts(hosts: string[], exportArgs: string[]): Promise<RemotePullResult>;

package/dist/lib/session/remote/remote-bundle.js

@@ -0,0 +1,61 @@
+/**
+ * Multi-device session transfer over the EXISTING SSH fleet transport
+ * (RUSH-1712) — no R2, no daemon. `agents sessions export --device <h>` and
+ * `agents sessions import --from-host <h>` both run `agents sessions export
+ * … --stdout` ON the peer and stream the bundle back over the same SSH path the
+ * cross-machine listing already uses (resolveExplicitTargets + ssh-exec), then
+ * either write it (export) or import it (import) locally.
+ *
+ * This deliberately reuses ssh-exec / resolve-target rather than adding a second
+ * transport: the raw form `agents ssh boxA 'agents sessions export --stdout' |
+ * agents sessions import -` works with plain export/import; this module is just
+ * the one-shot wrapper around it.
+ */
+import chalk from 'chalk';
+import { sshExec } from '../../ssh-exec.js';
+import { shellQuote } from '../../ssh-exec.js';
+import { resolveExplicitTargets } from '../../devices/resolve-target.js';
+import { remoteShellFor, buildWindowsAgentsCommand } from '../../hosts/remote-cmd.js';
+import { parseBundle } from '../bundle.js';
+/** Remote export can traverse many sessions; give it a generous ceiling. */
+const REMOTE_EXPORT_TIMEOUT_MS = 300_000;
+/** Build `agents <args>` for the peer's login shell (bash or PowerShell). */
+function remoteAgentsCommand(args, os) {
+    if (remoteShellFor(os) === 'powershell') {
+        return buildWindowsAgentsCommand({ args });
+    }
+    const inner = ['agents', ...args].map((t, i) => (i === 0 ? t : shellQuote(t))).join(' ');
+    return `bash -lc ${shellQuote(inner)}`;
+}
+/**
+ * Run `agents sessions export …exportArgs --stdout` on each host and parse the
+ * streamed bundle. A host that fails (unreachable, remote error, bad output) is
+ * collected in `errors` and skipped — one asleep peer never aborts the pull.
+ * `exportArgs` must NOT contain --device (the remote export runs for itself only).
+ */
+export async function pullBundlesFromHosts(hosts, exportArgs) {
+    const targets = await resolveExplicitTargets(hosts);
+    const bundles = [];
+    const errors = [];
+    for (const t of targets) {
+        const cmd = remoteAgentsCommand(['sessions', 'export', ...exportArgs, '--stdout'], t.os);
+        process.stderr.write(chalk.dim(`Pulling sessions from ${t.name}…\n`));
+        const res = sshExec(t.target, cmd, { timeoutMs: REMOTE_EXPORT_TIMEOUT_MS, extraSshArgs: t.extraSshArgs });
+        if (res.timedOut) {
+            errors.push(`${t.name}: timed out after ${Math.round(REMOTE_EXPORT_TIMEOUT_MS / 1000)}s`);
+            continue;
+        }
+        if (res.code !== 0) {
+            const tail = res.stderr.trim().split('\n').filter(Boolean).pop();
+            errors.push(`${t.name}: remote export failed (${res.code ?? 'ssh error'})${tail ? ': ' + tail : ''}`);
+            continue;
+        }
+        try {
+            bundles.push(parseBundle(res.stdout));
+        }
+        catch (err) {
+            errors.push(`${t.name}: ${err.message}`);
+        }
+    }
+    return { bundles, errors };
+}