@phnx-labs/agents-cli 1.20.49 → 1.20.51

package/dist/lib/hosts/progress.js

@@ -19,6 +19,41 @@ import { localLogPath } from './tasks.js';
 function sleep(ms) {
     return new Promise((resolve) => setTimeout(resolve, ms));
 }
+/**
+ * Cap for the LOCAL mirror of a distributed teammate's remote log. `followHostTask`
+ * appends remote bytes into the local mirror forever; a team can spin 10+ chatty
+ * remote teammates, so the orchestrator must keep a bounded window (the full log
+ * always lives on the host). The teams remote path (agents.ts readNewEvents) writes
+ * its own append into each teammate's `stdout.log`, then truncates that file to its
+ * trailing `REMOTE_MIRROR_MAX_BYTES` — the parser has already consumed the bytes
+ * (status/digest updated via lastReadPos), so trailing-tail history is dead weight.
+ */
+export const REMOTE_MIRROR_MAX_BYTES = 512 * 1024;
+/**
+ * Pull the new bytes of a remote log since `offset` in ONE ssh round-trip.
+ *
+ * The teams remote-teammate monitor calls this each poll to advance its offset-tail
+ * cursor into the host's log, mirroring only the delta into the local `stdout.log`
+ * the stream-json parser consumes. Byte-exact (raw Buffer, no UTF-8 decode) so a
+ * multibyte character split at the `tail -c` boundary neither drifts the offset nor
+ * renders as U+FFFD — the same discipline `fetchProgress` uses. `bytes.length` is
+ * the exact wire count; `newOffset` is `offset + bytes.length`.
+ *
+ * Returns null on a transient ssh failure (the caller retries next poll without
+ * advancing). `remoteLog` is a $HOME-prefixed path with a safe basename; it's
+ * shell-quoted defensively even so.
+ */
+export function pullRemoteLogDelta(target, opts) {
+    // remoteLog is a dispatch-generated `$HOME/.agents/.cache/hosts/<hex>.log` path —
+    // interpolate UNQUOTED so the remote shell expands `$HOME` (shellQuote would
+    // single-quote it into a literal `$HOME`, and the tail would find nothing). The
+    // hex basename is injection-safe, matching fetchProgress below.
+    const remote = `tail -c +${opts.offset + 1} ${opts.remoteLog} 2>/dev/null`;
+    const res = sshExecRaw(target, remote, { timeoutMs: 20000, multiplex: true });
+    if (res.code === null)
+        return null; // ssh itself failed / timed out
+    return { bytes: res.stdout, newOffset: opts.offset + res.stdout.length };
+}
 /**
  * Build the per-task sentinel that separates the log tail from the exit-file
  * contents in one combined fetch. The task id (8 hex chars) makes collision with

package/dist/lib/hosts/remote-cmd.d.ts

@@ -44,7 +44,7 @@ export declare const HOST_ROUTING_SPECS: StripSpec[];
  * does not exist). Anything else — including an unknown/absent OS — keeps the
  * POSIX form, so linux/macos are byte-for-byte unchanged.
  */
-export declare function buildRemoteAgentsInvocation(forwardedArgs: string[], remoteCwd?: string, os?: string): string;
+export declare function buildRemoteAgentsInvocation(forwardedArgs: string[], remoteCwd?: string, os?: string, env?: Record<string, string>): string;
 /** The two remote shell dialects we build commands for. */
 export type RemoteShell = 'posix' | 'powershell';
 /**

package/dist/lib/hosts/remote-cmd.js

@@ -61,13 +61,23 @@ export const HOST_ROUTING_SPECS = [
  * does not exist). Anything else — including an unknown/absent OS — keeps the
  * POSIX form, so linux/macos are byte-for-byte unchanged.
  */
-export function buildRemoteAgentsInvocation(forwardedArgs, remoteCwd, os) {
+export function buildRemoteAgentsInvocation(forwardedArgs, remoteCwd, os, env) {
     if (remoteShellFor(os) === 'powershell') {
-        return buildWindowsAgentsCommand({ args: forwardedArgs, cwd: remoteCwd });
+        return buildWindowsAgentsCommand({ args: forwardedArgs, cwd: remoteCwd, env });
     }
     const inner = ['agents', ...forwardedArgs].map(shellQuote).join(' ');
     const withCwd = remoteCwd ? `cd ${shellQuote(remoteCwd)} && ${inner}` : inner;
-    return `bash -lc ${shellQuote(withCwd)}`;
+    if (!env || Object.keys(env).length === 0) {
+        return `bash -lc ${shellQuote(withCwd)}`;
+    }
+    // Prepend env exports so the remote command sees the shims dir even when the
+    // login shell hasn't sourced the interactive rc files that usually add it.
+    // Values are double-quoted (not single-quoted) so remote variables like
+    // $HOME and $PATH are expanded by the login shell.
+    const exports = Object.entries(env)
+        .map(([k, v]) => `export ${shellQuote(k)}="${v.replace(/[\\"]/g, '\\$&')}"`)
+        .join('; ');
+    return `bash -lc ${shellQuote(`${exports}; ${withCwd}`)}`;
 }
 /**
  * Pick the remote shell dialect from a recorded OS/platform string. A Windows

package/dist/lib/platform/exec.d.ts

@@ -14,7 +14,10 @@ export declare function needsWindowsShell(binary: string, platform?: NodeJS.Plat
  * Resolve an executable name to its absolute path via the OS PATH search, or
  * `null` if not found. On Windows `where` can return several lines (one per
  * PATHEXT match, e.g. `agents.cmd` and `agents.ps1`) — the first is the one the
- * shell would actually run, matching `which` semantics on POSIX.
+ * shell would actually run, matching `which` semantics on POSIX. stderr is
+ * dropped: a miss is an expected outcome here, and `where.exe` announces every
+ * miss on stderr ("INFO: Could not find files..."), which would otherwise leak
+ * into the caller's terminal once per probe.
  */
 export declare function findExecutable(name: string, platform?: NodeJS.Platform): string | null;
 /**

package/dist/lib/platform/exec.js

@@ -27,11 +27,17 @@ export function needsWindowsShell(binary, platform = process.platform) {
  * Resolve an executable name to its absolute path via the OS PATH search, or
  * `null` if not found. On Windows `where` can return several lines (one per
  * PATHEXT match, e.g. `agents.cmd` and `agents.ps1`) — the first is the one the
- * shell would actually run, matching `which` semantics on POSIX.
+ * shell would actually run, matching `which` semantics on POSIX. stderr is
+ * dropped: a miss is an expected outcome here, and `where.exe` announces every
+ * miss on stderr ("INFO: Could not find files..."), which would otherwise leak
+ * into the caller's terminal once per probe.
  */
 export function findExecutable(name, platform = process.platform) {
     try {
-        const out = execFileSync(whichCommand(platform), [name], { encoding: 'utf-8' });
+        const out = execFileSync(whichCommand(platform), [name], {
+            encoding: 'utf-8',
+            stdio: ['ignore', 'pipe', 'ignore'],
+        });
         const first = out.trim().split(/\r?\n/)[0]?.trim();
         return first || null;
     }

package/dist/lib/resources.d.ts

@@ -74,11 +74,3 @@ export interface GetAgentResourcesOptions {
  * This is the source of truth - not the tracking data in agents.yaml.
  */
 export declare function getAgentResources(agentId: AgentId, options?: GetAgentResourcesOptions): AgentResources;
-/**
- * Get resources for all agents.
- */
-export declare function getAllAgentResources(agentIds: AgentId[], options?: GetAgentResourcesOptions & {
-    cliStates?: Record<AgentId, {
-        installed: boolean;
-    }>;
-}): AgentResources[];

package/dist/lib/resources.js

@@ -180,13 +180,3 @@ export function getAgentResources(agentId, options = {}) {
         workflows,
     };
 }
-/**
- * Get resources for all agents.
- */
-export function getAllAgentResources(agentIds, options = {}) {
-    const { cliStates, ...restOptions } = options;
-    return agentIds.map((agentId) => {
-        const cliInstalled = cliStates?.[agentId]?.installed ?? true;
-        return getAgentResources(agentId, { ...restOptions, cliInstalled });
-    });
-}

package/dist/lib/runner.js

@@ -74,8 +74,16 @@ export function buildJobCommand(config, resolvedPrompt) {
         appendModelAndReasoning(cmd, config);
     }
     if (config.agent === 'codex') {
-        if (mode === 'edit') {
-            cmd.push('--dangerously-bypass-approvals-and-sandbox');
+        if (mode === 'plan') {
+            // The template defaults to workspace-write; plan means read-only.
+            const sbIndex = cmd.indexOf('--sandbox');
+            if (sbIndex !== -1)
+                cmd[sbIndex + 1] = 'read-only';
+        }
+        else if (mode === 'edit' || mode === 'auto') {
+            // Keep the workspace-write sandbox — no approval bypass; only skip drops
+            // the guardrails. Re-enable network, which workspace-write turns off.
+            cmd.push('-c', 'sandbox_workspace_write.network_access=true');
         }
         else if (mode === 'skip') {
             // Remove sandbox restriction, just --dangerously-bypass-approvals-and-sandbox

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

@@ -1,5 +1,5 @@
 import { type PidSessionEntry } from './pid-registry.js';
-import { type SessionActivity, type AwaitingReason, type DetectedPr, type DetectedWorktree, type DetectedTicket } from './state.js';
+import { type SessionActivity, type AwaitingReason, type StructuredQuestion, type DetectedPr, type DetectedWorktree, type DetectedTicket } from './state.js';
 import { type SessionProvenance } from './provenance.js';
 /**
  * Per-PID `lsof` probes run bounded and staggered rather than as one parallel
@@ -30,6 +30,16 @@ export interface ActiveSession {
     activity?: SessionActivity;
     /** Why the agent is waiting, when activity is waiting_input. */
     awaitingReason?: AwaitingReason;
+    /** The structured decision (question/plan/permission + options) the agent is waiting on. */
+    question?: StructuredQuestion;
+    /**
+     * Plan markdown from the last `ExitPlanMode` tool call. Present when the
+     * transcript ever entered plan-review; `awaitingReason === 'plan_review'`
+     * says whether it is still pending.
+     */
+    plan?: string;
+    /** Last few assistant turns (most-recent last), for at-a-glance context in the UI. */
+    tail?: string[];
     /** PR opened during the session. */
     pr?: DetectedPr;
     /** Worktree the session runs in. */

package/dist/lib/session/active.js

@@ -236,6 +236,9 @@ function applyState(base, state, fallbackFile) {
         status: statusFromActivity(state.activity),
         activity: state.activity,
         awaitingReason: state.awaitingReason,
+        question: state.question,
+        plan: state.plan,
+        tail: state.tail,
         // Prefer the live preview (latest turn); keep the first-prompt topic as a fallback.
         preview: state.preview ?? base.preview,
         pr: state.pr,

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

@@ -35,6 +35,7 @@ export interface SessionRow {
     pr_number: number | null;
     worktree_slug: string | null;
     ticket_id: string | null;
+    plan: string | null;
 }
 /** File stat snapshot used to detect changes between scan runs. */
 export interface ScanStamp {
@@ -199,10 +200,6 @@ export interface TopCostSession {
  * vanished, mirroring querySessions' liveness filter.
  */
 export declare function topSessionsByCost(n: number, options?: QueryOptions): TopCostSession[];
-/** Return the set of all file paths currently tracked in the sessions table. */
-export declare function getAllFilePaths(): Set<string>;
-/** Look up sessions by their source file paths. */
-export declare function getSessionsByFilePaths(paths: string[]): Map<string, SessionMeta>;
 /** Look up a single session by its unique ID. */
 export declare function getSessionById(id: string): SessionMeta | null;
 /**

package/dist/lib/session/db.js

@@ -13,7 +13,7 @@ import { getSessionsDir, getSessionsDbPath } from '../state.js';
 const SESSIONS_DIR = getSessionsDir();
 const DB_PATH = getSessionsDbPath();
 /** Current schema version; bumped when migrations are added. */
-const SCHEMA_VERSION = 10;
+const SCHEMA_VERSION = 11;
 /**
  * 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`
@@ -64,7 +64,8 @@ CREATE TABLE IF NOT EXISTS sessions (
   pr_url TEXT,
   pr_number INTEGER,
   worktree_slug TEXT,
-  ticket_id TEXT
+  ticket_id TEXT,
+  plan TEXT
 );
 CREATE INDEX IF NOT EXISTS idx_sessions_timestamp ON sessions(timestamp DESC);
 CREATE INDEX IF NOT EXISTS idx_sessions_cwd ON sessions(cwd);
@@ -213,6 +214,16 @@ function migrateSchema(db, fromVersion) {
             db.exec(`ALTER TABLE sessions DROP COLUMN name`);
         }
     }
+    if (fromVersion < 11) {
+        // v10 → v11: the Claude scanner now captures the ExitPlanMode plan markdown
+        // at scan time so `agents sessions --json` can surface it without forcing
+        // consumers (the Factory NEEDS-YOU panel) to re-read raw JSONL. Additive
+        // column; rescan to backfill.
+        const cols = db.prepare(`PRAGMA table_info(sessions)`).all();
+        if (!cols.some(c => c.name === 'plan'))
+            db.exec(`ALTER TABLE sessions ADD COLUMN plan TEXT`);
+        db.exec(`DELETE FROM scan_ledger;`);
+    }
 }
 /** Open (or return the cached) sessions database, applying migrations as needed. */
 export function getDB() {
@@ -429,13 +440,13 @@ const upsertSessionStmt = (db) => db.prepare(`
     project, cwd, git_branch, topic, label, message_count, token_count,
     cost_usd, duration_ms,
     file_path, file_mtime_ms, file_size, scanned_at, is_team_origin,
-    pr_url, pr_number, worktree_slug, ticket_id
+    pr_url, pr_number, worktree_slug, ticket_id, plan
   ) VALUES (
     @id, @short_id, @agent, @version, @account, @timestamp, @last_activity,
     @project, @cwd, @git_branch, @topic, @label, @message_count, @token_count,
     @cost_usd, @duration_ms,
     @file_path, @file_mtime_ms, @file_size, @scanned_at, @is_team_origin,
-    @pr_url, @pr_number, @worktree_slug, @ticket_id
+    @pr_url, @pr_number, @worktree_slug, @ticket_id, @plan
   )
   ON CONFLICT(id) DO UPDATE SET
     short_id = excluded.short_id,
@@ -461,7 +472,8 @@ const upsertSessionStmt = (db) => db.prepare(`
     pr_url = excluded.pr_url,
     pr_number = excluded.pr_number,
     worktree_slug = excluded.worktree_slug,
-    ticket_id = excluded.ticket_id
+    ticket_id = excluded.ticket_id,
+    plan = excluded.plan
 `);
 const deleteTextStmt = (db) => db.prepare(`DELETE FROM session_text WHERE session_id = ?`);
 const insertTextStmt = (db) => db.prepare(`INSERT INTO session_text (session_id, label, topic, project, content) VALUES (?, ?, ?, ?, ?)`);
@@ -509,6 +521,7 @@ export function upsertSession(meta, content, scan) {
         pr_number: meta.prNumber ?? null,
         worktree_slug: meta.worktreeSlug ?? null,
         ticket_id: meta.ticketId ?? null,
+        plan: meta.plan ?? null,
     };
     const txn = db.transaction(() => {
         upsert.run(row);
@@ -597,6 +610,7 @@ export function upsertSessionsBatch(entries) {
                     pr_number: meta.prNumber ?? null,
                     worktree_slug: meta.worktreeSlug ?? null,
                     ticket_id: meta.ticketId ?? null,
+                    plan: meta.plan ?? null,
                 });
                 delText.run(meta.id);
                 insText.run(meta.id, meta.label ?? '', meta.topic ?? '', meta.project ?? '', content ?? '');
@@ -769,6 +783,7 @@ function rowToMeta(row) {
         prNumber: row.pr_number ?? undefined,
         worktreeSlug: row.worktree_slug ?? undefined,
         ticketId: row.ticket_id ?? undefined,
+        plan: row.plan ?? undefined,
     };
 }
 /**
@@ -954,26 +969,6 @@ export function topSessionsByCost(n, options = {}) {
         durationMs: r.duration_ms ?? 0,
     }));
 }
-/** Return the set of all file paths currently tracked in the sessions table. */
-export function getAllFilePaths() {
-    const db = getDB();
-    const rows = db.prepare(`SELECT file_path FROM sessions`).all();
-    return new Set(rows.map(r => r.file_path));
-}
-/** Look up sessions by their source file paths. */
-export function getSessionsByFilePaths(paths) {
-    if (paths.length === 0)
-        return new Map();
-    const db = getDB();
-    const placeholders = paths.map(() => '?').join(',');
-    const rows = db
-        .prepare(`SELECT * FROM sessions WHERE file_path IN (${placeholders})`)
-        .all(...paths);
-    const result = new Map();
-    for (const row of rows)
-        result.set(row.file_path, rowToMeta(row));
-    return result;
-}
 /** Look up a single session by its unique ID. */
 export function getSessionById(id) {
     const db = getDB();

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

@@ -68,6 +68,8 @@ interface ClaudeSessionScan {
     createdTickets?: string[];
     /** Team name this session SPAWNED via `agents teams create/add` (not team-of-origin). */
     spawnedTeam?: string;
+    /** Plan markdown from the last ExitPlanMode tool call (Claude sessions only). */
+    plan?: string;
 }
 /**
  * Discover sessions. Scans only files whose (mtime, size) have changed since
@@ -152,8 +154,6 @@ export declare function readCodexMeta(filePath: string, resolveAccount?: () => s
 } | null>;
 /** Stream a Claude JSONL file and extract scan-level metadata (timestamp, cwd, topic, tokens). */
 export declare function scanClaudeSession(filePath: string): Promise<ClaudeSessionScan>;
-/** Read up to maxLines non-empty lines from the beginning of a file. */
-export declare function readFirstLines(filePath: string, maxLines: number): Promise<string[]>;
 /** Parse a single Kimi session state.json file to extract session metadata. */
 export declare function readKimiMeta(filePath: string): {
     meta: SessionMeta;

package/dist/lib/session/discover.js

@@ -13,6 +13,7 @@ import * as crypto from 'crypto';
 import * as readline from 'readline';
 import { execFile } from 'child_process';
 import { promisify } from 'util';
+import Database from '../sqlite.js';
 import { getAgentsDir, getHistoryDir } from '../state.js';
 const execFileAsync = promisify(execFile);
 import { AGENTS, agentConfigDirName, getCliVersion } from '../agents.js';
@@ -485,6 +486,7 @@ async function readClaudeMeta(filePath, sessionId, account, label) {
             ticketId: scan.ticketId,
             createdTickets: scan.createdTickets,
             spawnedTeam: scan.spawnedTeam,
+            plan: scan.plan,
         };
     }
     else {
@@ -510,6 +512,7 @@ async function readClaudeMeta(filePath, sessionId, account, label) {
             ticketId: scan.ticketId,
             createdTickets: scan.createdTickets,
             spawnedTeam: scan.spawnedTeam,
+            plan: scan.plan,
         };
     }
     return { meta, content: scan.contentText || '' };
@@ -1065,20 +1068,29 @@ let cachedOpenCodeAccount;
 async function getOpenCodeAccount() {
     if (cachedOpenCodeAccount !== undefined)
         return cachedOpenCodeAccount || undefined;
+    // Read through the node/bun SQLite wrapper (not the `sqlite3` CLI) so this
+    // works on every OS — the CLI is absent on Windows.
+    let db;
     try {
         if (fs.existsSync(OPENCODE_DB)) {
-            const { stdout } = await execFileAsync('sqlite3', [
-                OPENCODE_DB,
-                'SELECT email FROM control_account WHERE active=1 LIMIT 1;',
-            ], { encoding: 'utf-8' });
-            const out = stdout.trim();
+            db = new Database(OPENCODE_DB);
+            const row = db
+                .prepare('SELECT email FROM control_account WHERE active=1 LIMIT 1;')
+                .get();
+            const out = typeof row?.email === 'string' ? row.email.trim() : '';
             if (out) {
                 cachedOpenCodeAccount = out;
                 return out;
             }
         }
     }
-    catch { /* sqlite3 unavailable or DB locked */ }
+    catch { /* DB not accessible, sqlite module unavailable, or query failed */ }
+    finally {
+        try {
+            db?.close();
+        }
+        catch { /* best-effort close */ }
+    }
     cachedOpenCodeAccount = '';
     return undefined;
 }
@@ -1101,18 +1113,21 @@ async function scanOpenCodeIncremental() {
     }
     const account = await getOpenCodeAccount();
     const currentVersion = await getCurrentAgentVersion('opencode');
+    // Read through the node/bun SQLite wrapper (not the `sqlite3` CLI) so this
+    // works on every OS — the CLI is absent on Windows.
+    let db;
     try {
         const query = `
       SELECT
-        s.id,
-        s.title,
-        s.directory,
-        s.version,
-        s.time_created,
-        s.time_updated,
-        COALESCE(stats.message_count, 0),
-        stats.token_count,
-        COALESCE(stats.has_token_data, 0)
+        s.id AS id,
+        s.title AS title,
+        s.directory AS directory,
+        s.version AS version,
+        s.time_created AS time_created,
+        s.time_updated AS time_updated,
+        COALESCE(stats.message_count, 0) AS message_count,
+        stats.token_count AS token_count,
+        COALESCE(stats.has_token_data, 0) AS has_token_data
       FROM session s
       LEFT JOIN (
         SELECT
@@ -1133,23 +1148,22 @@ async function scanOpenCodeIncremental() {
       ORDER BY time_created DESC
       LIMIT 1000;
     `.replace(/\n/g, ' ');
-        const { stdout: out } = await execFileAsync('sqlite3', ['-separator', '|||', OPENCODE_DB, query], {
-            encoding: 'utf-8',
-            timeout: 5000,
-            maxBuffer: 32 * 1024 * 1024,
-        });
+        db = new Database(OPENCODE_DB);
+        const rows = db.prepare(query).all();
         const entries = [];
-        for (const line of out.split('\n')) {
-            if (!line.trim())
-                continue;
-            const [id, title, directory, version, timeCreatedStr, timeUpdatedStr, messageCountStr, tokenCountStr, hasTokenDataStr] = line.split('|||');
+        for (const row of rows) {
+            const id = typeof row.id === 'string' ? row.id : '';
             if (!id)
                 continue;
-            const timeCreated = parseInt(timeCreatedStr, 10);
-            const timeUpdated = parseInt(timeUpdatedStr, 10);
-            const messageCount = parseInt(messageCountStr, 10);
-            const tokenCount = parseInt(tokenCountStr, 10);
-            const hasTokenData = hasTokenDataStr === '1';
+            const title = typeof row.title === 'string' ? row.title : '';
+            const directory = typeof row.directory === 'string' ? row.directory : '';
+            const version = typeof row.version === 'string' ? row.version : '';
+            const asInt = (v) => typeof v === 'number' ? v : parseInt(String(v), 10);
+            const timeCreated = asInt(row.time_created);
+            const timeUpdated = asInt(row.time_updated);
+            const messageCount = asInt(row.message_count);
+            const tokenCount = asInt(row.token_count);
+            const hasTokenData = asInt(row.has_token_data) === 1;
             const timestamp = isNaN(timeCreated) ? new Date().toISOString() : new Date(timeCreated).toISOString();
             // OpenCode is one shared DB, not one file per session — its row carries a
             // per-session updated time. Set lastActivity explicitly (falling back to
@@ -1182,6 +1196,12 @@ async function scanOpenCodeIncremental() {
             console.error(`Warning: Could not query OpenCode sessions: ${err.message}`);
         }
     }
+    finally {
+        try {
+            db?.close();
+        }
+        catch { /* best-effort close */ }
+    }
 }
 // ---------------------------------------------------------------------------
 // OpenClaw
@@ -1770,6 +1790,9 @@ export async function scanClaudeSession(filePath) {
     const createdTickets = new Set();
     const pendingTicketTools = new Set();
     let spawnedTeam;
+    // The LAST ExitPlanMode plan wins so a re-planned session surfaces its most
+    // recent plan, matching the semantic the extension's re-parser relied on.
+    let plan;
     try {
         for await (const line of rl) {
             if (!line.trim())
@@ -1802,6 +1825,14 @@ export async function scanClaudeSession(filePath) {
                     if (typeof b?.id === 'string' && isTicketCreateTool(b?.name, b?.input?.command)) {
                         pendingTicketTools.add(b.id);
                     }
+                    // ExitPlanMode plan markdown — last one wins so a re-planned session
+                    // reports its most recent plan (the semantic parsePlanFromClaudeJsonl
+                    // implemented in the extension).
+                    if (b?.name === 'ExitPlanMode' && typeof b?.input?.plan === 'string') {
+                        const p = b.input.plan.trim();
+                        if (p)
+                            plan = b.input.plan;
+                    }
                 }
             }
             if (pendingTicketTools.size > 0 && parsed.type === 'user' && Array.isArray(parsed.message?.content)) {
@@ -1949,6 +1980,7 @@ export async function scanClaudeSession(filePath) {
         ticketId: ticket?.id,
         createdTickets: createdTickets.size > 0 ? [...createdTickets] : undefined,
         spawnedTeam,
+        plan,
     };
 }
 /** Stream a Codex JSONL file and extract scan-level metadata (session ID, cwd, topic, tokens). */
@@ -2152,25 +2184,6 @@ function getOpenClawWorkspaceMap() {
 // ---------------------------------------------------------------------------
 // Utilities
 // ---------------------------------------------------------------------------
-/** Read up to maxLines non-empty lines from the beginning of a file. */
-export function readFirstLines(filePath, maxLines) {
-    return new Promise((resolve) => {
-        const lines = [];
-        const stream = fs.createReadStream(filePath, { encoding: 'utf-8' });
-        const rl = readline.createInterface({ input: stream, crlfDelay: Infinity });
-        rl.on('line', (line) => {
-            if (line.trim()) {
-                lines.push(line);
-            }
-            if (lines.length >= maxLines) {
-                rl.close();
-                stream.destroy();
-            }
-        });
-        rl.on('close', () => resolve(lines));
-        rl.on('error', () => resolve(lines));
-    });
-}
 /** Compute the SHA-256 hex digest of a string. */
 function sha256(input) {
     return crypto.createHash('sha256').update(input).digest('hex');