nterminal 1.3.1 → 1.3.3

package/dist/server/system/processIdentity.js

@@ -0,0 +1,30 @@
+import path from 'node:path';
+export function identifyProcess(command, executable, args, pm2) {
+    const executablePath = executable.replace(/ \(deleted\)$/, '');
+    const binary = path.basename(executablePath);
+    const node = binary === 'node' || binary === 'nodejs';
+    // Only inspect the executable and a Node wrapper's script, not prompt text.
+    const entrypoint = node ? args[1] ?? '' : executablePath;
+    const entryName = path.basename(entrypoint);
+    const codex = entryName === 'codex' || (node && entrypoint.includes('/@openai/codex/'));
+    const nativeClaude = !node && /\/claude\/versions\/\d+\.\d+\.\d+(?:[-+][\w.-]+)?$/.test(executablePath);
+    const claude = entryName === 'claude' || nativeClaude || (node && entrypoint.includes('/@anthropic-ai/claude-code/'));
+    const daemonOffset = node ? 2 : 1;
+    const daemon = codex && args[daemonOffset] === 'app-server'
+        && (args.includes('--managed-daemon') || args[daemonOffset + 1] === 'daemon');
+    const codeServer = node && (entrypoint.includes('/code-server/') || entryName === 'code-server');
+    const category = daemon ? 'shared' : codex || claude || codeServer || binary === 'codex-code-mode' ? 'tools' : 'services';
+    const excluded = ['bash', 'sh', 'dash', 'zsh', 'fish', 'sleep', 'tmux', 'systemd', 'dbus-daemon'].includes(binary)
+        || (node && /^PM2 v[^\s]+: God/.test(command));
+    // PM2 sets process.title to "node /absolute/script.js", often leaving no argv[1].
+    // Extract only the script basename; never return the title or argument string.
+    const pm2Script = pm2 && node ? args[0]?.match(/^node(?:js)? (\/[^\r\n]+?\.(?:mjs|cjs|js|ts))(?:\s|$)/)?.[1] : undefined;
+    const script = node || /^python(?:\d+(?:\.\d+)*)?$/.test(binary)
+        ? args.slice(1, 3).find((arg) => !arg.startsWith('-') && /\.(?:m?js|cjs|ts|py)$/.test(arg) && !/[\r\n]/.test(arg))
+        : undefined;
+    const name = codex ? 'codex' : claude ? 'claude' : codeServer ? 'code-server'
+        : pm2Script ? path.basename(pm2Script) : script ? path.basename(script)
+            : command === 'MainThread' ? binary || 'process' : command;
+    return { name, category, excluded };
+}
+//# sourceMappingURL=processIdentity.js.map

package/dist/server/system/processIdentity.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"processIdentity.js","sourceRoot":"","sources":["../../../src/server/system/processIdentity.ts"],"names":[],"mappings":"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"}

package/dist/server/system/projectNames.d.ts

@@ -0,0 +1,25 @@
+export declare const projectNameSchema: {
+    body: {
+        type: string;
+        additionalProperties: boolean;
+        required: string[];
+        properties: {
+            path: {
+                type: string;
+                minLength: number;
+                maxLength: number;
+                pattern: string;
+            };
+            name: {
+                type: string;
+                minLength: number;
+                maxLength: number;
+                pattern: string;
+            };
+        };
+    };
+};
+export declare function readProjectNames(statePath: string): Promise<Map<string, string>>;
+export declare function saveProjectName(statePath: string, projectPath: string, label: string): Promise<{
+    name: string;
+}>;

package/dist/server/system/projectNames.js

@@ -0,0 +1,48 @@
+import { mkdir, readFile, rename, rm, writeFile } from 'node:fs/promises';
+import { randomUUID } from 'node:crypto';
+import path from 'node:path';
+const writes = new Map();
+const filename = (statePath) => path.join(path.dirname(statePath), 'project-names.json');
+export const projectNameSchema = { body: {
+        type: 'object', additionalProperties: false, required: ['path', 'name'],
+        properties: { path: { type: 'string', minLength: 1, maxLength: 4096, pattern: '^/' }, name: { type: 'string', minLength: 1, maxLength: 80, pattern: '\\S' } }
+    } };
+export async function readProjectNames(statePath) {
+    let raw;
+    try {
+        raw = JSON.parse(await readFile(filename(statePath), 'utf8'));
+    }
+    catch (error) {
+        if (error.code === 'ENOENT')
+            return new Map();
+        throw error;
+    }
+    if (!raw || typeof raw !== 'object' || Array.isArray(raw))
+        throw new Error('Invalid project names');
+    return new Map(Object.entries(raw).filter((entry) => path.isAbsolute(entry[0]) && typeof entry[1] === 'string'));
+}
+export function saveProjectName(statePath, projectPath, label) {
+    const name = label.trim();
+    if (!path.isAbsolute(projectPath) || projectPath.length > 4096 || !name || name.length > 80)
+        return Promise.reject(new Error('Invalid project name'));
+    const file = filename(statePath);
+    const operation = (writes.get(file) ?? Promise.resolve()).catch(() => undefined).then(async () => {
+        const names = await readProjectNames(statePath);
+        names.set(projectPath, name);
+        await mkdir(path.dirname(file), { recursive: true, mode: 0o700 });
+        const temporary = `${file}.${randomUUID()}.tmp`;
+        try {
+            await writeFile(temporary, JSON.stringify(Object.fromEntries(names)), { mode: 0o600 });
+            await rename(temporary, file);
+        }
+        finally {
+            await rm(temporary, { force: true });
+        }
+        return { name };
+    });
+    writes.set(file, operation);
+    void operation.finally(() => { if (writes.get(file) === operation)
+        writes.delete(file); }).catch(() => undefined);
+    return operation;
+}
+//# sourceMappingURL=projectNames.js.map

package/dist/server/system/projectNames.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"projectNames.js","sourceRoot":"","sources":["../../../src/server/system/projectNames.ts"],"names":[],"mappings":"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"}

package/dist/server/system/serverInfo.d.ts

@@ -0,0 +1,3 @@
+import type { ServerProcesses, ServerExternalIp } from '../../shared/protocol.js';
+export declare function externalIp(statePath: string, refresh: boolean): Promise<ServerExternalIp>;
+export declare function serverProcesses(statePath?: string): Promise<ServerProcesses>;

package/dist/server/system/serverInfo.js

@@ -0,0 +1,172 @@
+import { readFile, readdir, readlink, stat, mkdir, rename, writeFile } from 'node:fs/promises';
+import path from 'node:path';
+import os from 'node:os';
+import { isIPv4 } from 'node:net';
+import { execFile } from 'node:child_process';
+import { promisify } from 'node:util';
+import { identifyProcess } from './processIdentity.js';
+import { readProjectNames } from './projectNames.js';
+const exec = promisify(execFile);
+let pending;
+const ipRequests = new Map();
+export function externalIp(statePath, refresh) {
+    const key = path.join(path.dirname(statePath), 'external-ip.json');
+    const existing = ipRequests.get(key);
+    if (existing)
+        return existing;
+    const operation = (async () => {
+        let cached = { address: null, checkedAt: null, error: null };
+        try {
+            const value = JSON.parse(await readFile(key, 'utf8'));
+            if (typeof value.address === 'string' && isIPv4(value.address) && typeof value.checkedAt === 'string')
+                cached = { address: value.address, checkedAt: value.checkedAt, error: null };
+        }
+        catch { /* First lookup or invalid cache. */ }
+        if (cached.address && !refresh)
+            return cached;
+        try {
+            const { stdout } = await exec('curl', ['-4', '--fail', '--silent', '--show-error', '--max-time', '5', '--noproxy', '*', 'https://ifconfig.me/ip'], { timeout: 6000, maxBuffer: 1024 });
+            const address = stdout.trim();
+            if (!isIPv4(address))
+                throw new Error('Invalid IPv4');
+            const result = { address, checkedAt: new Date().toISOString(), error: null };
+            await mkdir(path.dirname(key), { recursive: true });
+            await writeFile(`${key}.tmp`, JSON.stringify(result), { mode: 0o600 });
+            await rename(`${key}.tmp`, key);
+            return result;
+        }
+        catch {
+            return { ...cached, error: 'Could not refresh external IPv4.' };
+        }
+    })();
+    ipRequests.set(key, operation);
+    void operation.finally(() => ipRequests.delete(key)).catch(() => undefined);
+    return operation;
+}
+async function sample() {
+    const result = [];
+    const ids = (await readdir('/proc')).filter((id) => /^\d+$/.test(id));
+    // Bound file I/O concurrency even on hosts with many processes.
+    let next = 0;
+    await Promise.all(Array.from({ length: 8 }, async () => {
+        while (next < ids.length) {
+            const id = ids[next++];
+            try {
+                const base = `/proc/${id}`;
+                const status = await readFile(`${base}/status`, 'utf8');
+                if (Number(status.match(/^Uid:\s+(\d+)/m)?.[1]) !== process.getuid?.())
+                    continue;
+                const raw = await readFile(`${base}/stat`, 'utf8');
+                const fields = raw.slice(raw.lastIndexOf(')') + 2).split(' ');
+                if (fields[0] === 'Z')
+                    continue;
+                const cwd = await readlink(`${base}/cwd`);
+                const cgroup = await readFile(`${base}/cgroup`, 'utf8');
+                const name = status.match(/^Name:\s+(.+)/m)?.[1]?.trim() ?? 'process';
+                result.push({ pid: Number(id), ppid: Number(fields[1]), name, ticks: Number(fields[11]) + Number(fields[12]), start: fields[19], memory: Number(status.match(/^VmRSS:\s+(\d+)/m)?.[1] ?? 0) * 1024, cwd, manager: cgroup.match(/\/([^/\n]+\.service)(?:\/|$)/m)?.[1] ?? null });
+            }
+            catch { /* Processes can exit during a snapshot. */ }
+        }
+    }));
+    return result;
+}
+async function cpuTicks() {
+    const line = (await readFile('/proc/stat', 'utf8')).split('\n')[0];
+    // Guest counters are already included in user/nice.
+    return line.trim().split(/\s+/).slice(1, 9).reduce((sum, value) => sum + Number(value), 0);
+}
+export async function serverProcesses(statePath) {
+    if (!pending) {
+        const work = collect();
+        pending = work;
+        void work.finally(() => { if (pending === work)
+            pending = undefined; }).catch(() => undefined);
+    }
+    const data = await pending;
+    if (!statePath)
+        return data;
+    const names = await readProjectNames(statePath);
+    return { ...data, projects: data.projects.map((project) => ({ ...project, name: names.get(project.path) ?? project.name })) };
+}
+async function collect() {
+    const startTicks = await cpuTicks();
+    const before = new Map((await sample()).map((entry) => [entry.pid, entry]));
+    await new Promise((resolve) => setTimeout(resolve, 250));
+    const entries = await sample();
+    const elapsed = Math.max(1, await cpuTicks() - startTicks);
+    const byId = new Map(entries.map((entry) => [entry.pid, entry]));
+    const roots = new Map();
+    function project(cwd) {
+        const cached = roots.get(cwd);
+        if (cached)
+            return cached;
+        const lookup = (async () => {
+            for (let dir = cwd; dir !== path.dirname(dir); dir = path.dirname(dir)) {
+                try {
+                    await stat(path.join(dir, '.git'));
+                    return dir;
+                }
+                catch { /* No Git root here. */ }
+            }
+            return cwd;
+        })();
+        roots.set(cwd, lookup);
+        return lookup;
+    }
+    const groups = new Map();
+    const packageNames = new Map();
+    function isNTerminal(script) {
+        if (!path.isAbsolute(script) || !script.endsWith('/dist/server/index.js'))
+            return Promise.resolve(false);
+        const packageFile = path.resolve(path.dirname(script), '../../package.json');
+        if (!packageNames.has(packageFile))
+            packageNames.set(packageFile, readFile(packageFile, 'utf8').then((value) => JSON.parse(value).name === 'nterminal').catch(() => false));
+        return packageNames.get(packageFile);
+    }
+    const coreCount = os.cpus().length;
+    for (const entry of entries) {
+        let args = [];
+        let executable;
+        try {
+            args = (await readFile(`/proc/${entry.pid}/cmdline`, 'utf8')).split('\0');
+            executable = await readlink(`/proc/${entry.pid}/exe`);
+        }
+        catch {
+            continue;
+        }
+        const parent = byId.get(entry.ppid);
+        const pm2 = parent?.name.startsWith('PM2') === true;
+        const identity = identifyProcess(entry.name, executable, args, pm2);
+        const nterminal = ['node', 'nodejs'].includes(path.basename(executable)) && await isNTerminal(args[1] ?? '');
+        const { name, category, excluded } = nterminal ? { name: 'NTerminal', category: 'tools', excluded: false } : identity;
+        if (excluded)
+            continue;
+        const root = category === 'shared' ? '' : await project(entry.cwd);
+        const key = `${category}:${root}`;
+        let group = groups.get(key);
+        if (!group) {
+            group = { path: root, name: root ? path.basename(root) : 'Shared tools', category, cpuPercent: 0, memoryBytes: 0, processes: [] };
+            groups.set(key, group);
+        }
+        const old = before.get(entry.pid);
+        const cpuPercent = old?.start === entry.start ? Math.max(0, entry.ticks - old.ticks) / elapsed * coreCount * 100 : 0;
+        group.cpuPercent += cpuPercent;
+        group.memoryBytes += entry.memory;
+        group.processes.push({ pid: entry.pid, ppid: entry.ppid, name, cpuPercent, memoryBytes: entry.memory, manager: pm2 ? 'PM2' : entry.manager });
+    }
+    // Link through omitted shell wrappers, without merging independent PM2 apps.
+    for (const group of groups.values()) {
+        const members = new Set(group.processes.map((entry) => entry.pid));
+        for (const proc of group.processes) {
+            let parent = proc.ppid;
+            const seen = new Set([proc.pid]);
+            while (parent > 1 && !seen.has(parent) && !members.has(parent)) {
+                seen.add(parent);
+                parent = byId.get(parent)?.ppid ?? 0;
+            }
+            proc.ppid = members.has(parent) && !seen.has(parent) ? parent : 0;
+        }
+    }
+    return { checkedAt: new Date().toISOString(), projects: [...groups.values()].sort((a, b) => b.memoryBytes - a.memoryBytes) };
+}
+//# sourceMappingURL=serverInfo.js.map

package/dist/server/system/serverInfo.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"serverInfo.js","sourceRoot":"","sources":["../../../src/server/system/serverInfo.ts"],"names":[],"mappings":"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"}

package/dist/server/terminal/PtyAdapter.d.ts

@@ -56,6 +56,17 @@ export interface PtyTranscriptSource {
     sessionId: string;
     filePath: string;
 }
+export interface PtyTranscriptCandidate extends PtyTranscriptSource {
+    cwd?: string;
+    title?: string;
+    updatedAt?: string;
+    verification?: 'verified' | 'unknown';
+    readable?: boolean;
+}
+export interface PtyTranscriptCandidates {
+    binding: string;
+    candidates: PtyTranscriptCandidate[];
+}
 export interface PtyAdapter {
     spawn(options: PtySpawnOptions & {
         title?: string;
@@ -72,6 +83,7 @@ export interface PtyAdapter {
     }>>;
     captureHistory?(sessionId: string, options: PtyHistoryCaptureOptions): MaybePromise<PtyHistoryCapture | null>;
     resolveTranscriptSource?(sessionId: string): MaybePromise<PtyTranscriptSource | null>;
+    resolveTranscriptCandidates?(sessionId: string): Promise<PtyTranscriptCandidates>;
     scrollbackScroll?(sessionId: string, lines: number): MaybePromise<boolean>;
     cancelScrollbackMode?(sessionId: string): MaybePromise<boolean>;
 }

package/dist/server/terminal/PtyAdapter.js.map

@@ -1 +1 @@
-{"version":3,"file":"PtyAdapter.js","sourceRoot":"","sources":["../../../src/server/terminal/PtyAdapter.ts"],"names":[],"mappings":"AA6BA,MAAM,OAAO,0BAA2B,SAAQ,KAAK;IACnD,YAAY,SAAiB;QAC3B,KAAK,CAAC,+BAA+B,SAAS,iBAAiB,CAAC,CAAC;QACjE,IAAI,CAAC,IAAI,GAAG,4BAA4B,CAAC;IAC3C,CAAC;CACF;AAgHD,4EAA4E;AAC5E,+DAA+D;AAC/D,MAAM,UAAU,sBAAsB,CAAC,GAAW;IAChD,MAAM,SAAS,GAAG,GAAG,CAAC,OAAO,CAAC,yBAAyB,EAAE,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC;IACrE,OAAO,SAAS,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,UAAU,CAAC;AAC9C,CAAC"}
+{"version":3,"file":"PtyAdapter.js","sourceRoot":"","sources":["../../../src/server/terminal/PtyAdapter.ts"],"names":[],"mappings":"AA6BA,MAAM,OAAO,0BAA2B,SAAQ,KAAK;IACnD,YAAY,SAAiB;QAC3B,KAAK,CAAC,+BAA+B,SAAS,iBAAiB,CAAC,CAAC;QACjE,IAAI,CAAC,IAAI,GAAG,4BAA4B,CAAC;IAC3C,CAAC;CACF;AAkID,4EAA4E;AAC5E,+DAA+D;AAC/D,MAAM,UAAU,sBAAsB,CAAC,GAAW;IAChD,MAAM,SAAS,GAAG,GAAG,CAAC,OAAO,CAAC,yBAAyB,EAAE,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC;IACrE,OAAO,SAAS,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,UAAU,CAAC;AAC9C,CAAC"}

package/dist/server/terminal/TerminalManager.d.ts

@@ -1,5 +1,5 @@
 import type { AppConfig } from '../config.js';
-import type { ServerTerminalMessage, TerminalHistoryCursor, TerminalHistoryResponse, TerminalSubagentsResponse, TerminalTranscriptHistoryResponse, TerminalTranscriptSourceResponse } from '../../shared/protocol.js';
+import type { ServerTerminalMessage, TerminalHistoryCursor, TerminalHistoryResponse, TerminalSubagentsResponse, TerminalTranscriptHistoryRequest, TerminalTranscriptHistoryResponse, TerminalTranscriptSourceResponse, TerminalTranscriptSearchRequest, TerminalTranscriptSearchResponse } from '../../shared/protocol.js';
 import type { TerminalCompletionOutcome, TerminalId, TerminalSummary } from '../../shared/types.js';
 import { type PtyAdapter } from './PtyAdapter.js';
 export interface CreateTerminalOptions {
@@ -69,6 +69,7 @@ export declare class TerminalManager {
     private readonly shellBasename;
     private readonly terminalCapabilities;
     private readonly agentTranscriptTracker;
+    private readonly transcriptStore;
     private readonly transcriptQueue;
     private readonly lastDiagnosticAt;
     private readonly completionStates;
@@ -117,13 +118,11 @@ export declare class TerminalManager {
         limit?: number;
     }): Promise<TerminalHistoryResponse | null>;
     private resolveLiveTranscriptSource;
+    private transcriptCandidateId;
+    private transcriptSelectionStillLive;
     private transcriptRequestStillLive;
-    getTerminalTranscriptHistory(id: TerminalId, options?: {
-        cursor?: string;
-        limit?: number;
-        maxLines?: number;
-        includeTools?: boolean;
-    }): Promise<TerminalTranscriptHistoryResponse | null>;
+    getTerminalTranscriptHistory(id: TerminalId, options?: TerminalTranscriptHistoryRequest, signal?: AbortSignal): Promise<TerminalTranscriptHistoryResponse | null>;
+    searchTerminalTranscript(id: TerminalId, options: TerminalTranscriptSearchRequest, signal?: AbortSignal): Promise<TerminalTranscriptSearchResponse | null>;
     getTerminalTranscriptSource(id: TerminalId): Promise<TerminalTranscriptSourceResponse | null>;
     getTerminalSubagents(id: TerminalId): Promise<TerminalSubagentsResponse | null>;
     getTerminalSubagentTranscript(id: TerminalId, subagentId: string, options?: {

package/dist/server/terminal/TerminalManager.js

@@ -1,9 +1,10 @@
-import { randomUUID } from 'node:crypto';
+import { createHash, randomUUID } from 'node:crypto';
 import path from 'node:path';
 import { normalizeTerminalTitle } from './PtyAdapter.js';
 import { resolveProcessCwd } from './cwdResolver.js';
 import { OutputBuffer } from './outputBuffer.js';
 import { readTranscriptHistoryPage } from './transcriptHistory.js';
+import { TranscriptStore } from './transcriptStore.js';
 import { AgentTranscriptTracker } from './agentTranscriptStatus.js';
 import { listTerminalSubagents, resolveSubagentTranscriptSource, subagentSummary } from './subagentSources.js';
 import { mapWithConcurrency } from './asyncCommand.js';
@@ -43,6 +44,7 @@ export class TerminalManager {
     shellBasename;
     terminalCapabilities;
     agentTranscriptTracker = new AgentTranscriptTracker();
+    transcriptStore;
     transcriptQueue = [];
     lastDiagnosticAt = new Map();
     completionStates = new Map();
@@ -63,6 +65,7 @@ export class TerminalManager {
     constructor(config, ptyAdapter, options = {}) {
         this.config = config;
         this.ptyAdapter = ptyAdapter;
+        this.transcriptStore = new TranscriptStore(path.join(path.dirname(config.statePath), 'transcript-cache'));
         this.resolveCwd = options.resolveCwd ?? resolveProcessCwd;
         this.now = options.now ?? (() => new Date());
         this.onCompletion = options.onCompletion ?? null;
@@ -279,6 +282,7 @@ export class TerminalManager {
     // interval — called by the server's graceful-shutdown path.
     dispose() {
         this.disposed = true;
+        this.transcriptStore.dispose();
         this.shutdownRequested = true;
         if (this.statusPollTimer) {
             clearInterval(this.statusPollTimer);
@@ -674,42 +678,84 @@ export class TerminalManager {
     // Shared liveness guard for the transcript endpoints: resolve the pane's
     // source, re-validating the record after the await so a pane that closed
     // or switched sessions mid-request never serves another session's data.
-    async resolveLiveTranscriptSource(id) {
+    async resolveLiveTranscriptSource(id, selection = {}) {
         const record = this.terminals.get(id);
         if (!record || record.summary.status !== 'running' || record.closing) {
             return null;
         }
         const generation = record.transcriptGeneration;
-        const source = await this.ptyAdapter.resolveTranscriptSource?.(id);
+        let source;
+        if (selection.candidateId) {
+            const result = await this.ptyAdapter.resolveTranscriptCandidates?.(id);
+            source = result?.candidates.find((candidate) => this.transcriptCandidateId(id, result.binding, candidate) === selection.candidateId);
+        }
+        else {
+            source = await this.ptyAdapter.resolveTranscriptSource?.(id);
+        }
         if (!source ||
+            (selection.expectedSessionId !== undefined && source.sessionId !== selection.expectedSessionId) ||
             !transcriptSourceMatchesForeground(record.summary, source.provider) ||
             !this.transcriptRequestStillLive(id, record, generation)) {
             return null;
         }
         return { record, generation, source };
     }
+    transcriptCandidateId(id, binding, source) {
+        return createHash('sha256').update(JSON.stringify([id, binding, source.provider, source.sessionId, source.filePath])).digest('hex');
+    }
+    async transcriptSelectionStillLive(id, live, selection) {
+        if (!this.transcriptRequestStillLive(id, live.record, live.generation))
+            return false;
+        const current = await this.resolveLiveTranscriptSource(id, selection);
+        return Boolean(current && current.source.provider === live.source.provider &&
+            current.source.sessionId === live.source.sessionId && current.source.filePath === live.source.filePath);
+    }
     transcriptRequestStillLive(id, record, generation) {
         return this.terminals.get(id) === record &&
             record.summary.status === 'running' &&
             !record.closing &&
             record.transcriptGeneration === generation;
     }
-    async getTerminalTranscriptHistory(id, options = {}) {
-        const live = await this.resolveLiveTranscriptSource(id);
-        if (!live) {
+    async getTerminalTranscriptHistory(id, options = {}, signal) {
+        if (signal?.aborted)
+            return null;
+        const live = await this.resolveLiveTranscriptSource(id, options);
+        if (!live || signal?.aborted) {
             return null;
         }
-        const page = await readTranscriptHistoryPage(id, live.source, options);
-        return this.transcriptRequestStillLive(id, live.record, live.generation) ? page : null;
+        const page = await this.transcriptStore.readPage(id, live.source, { ...options, includeTools: options.includeTools ?? false }, signal);
+        return !signal?.aborted && await this.transcriptSelectionStillLive(id, live, options) ? page : null;
+    }
+    async searchTerminalTranscript(id, options, signal) {
+        if (signal?.aborted)
+            return null;
+        const live = await this.resolveLiveTranscriptSource(id, options);
+        if (!live || signal?.aborted)
+            return null;
+        const result = await this.transcriptStore.search(id, live.source, options, signal);
+        if (!result || signal?.aborted || !await this.transcriptSelectionStillLive(id, live, options))
+            return null;
+        return { ...result, terminalId: id, source: { provider: live.source.provider, sessionId: live.source.sessionId } };
     }
     async getTerminalTranscriptSource(id) {
+        const record = this.terminals.get(id);
+        if (!record || record.summary.status !== 'running' || record.closing)
+            return null;
+        const generation = record.transcriptGeneration;
         const live = await this.resolveLiveTranscriptSource(id);
-        if (!live) {
+        // Exact matches need no extra process scan on every source poll. Manual
+        // selections still use the candidate resolver above for fresh validation.
+        const choices = live ? undefined : await this.ptyAdapter.resolveTranscriptCandidates?.(id);
+        if (!this.transcriptRequestStillLive(id, record, generation))
             return null;
-        }
         return {
             terminalId: id,
-            source: { provider: live.source.provider, sessionId: live.source.sessionId }
+            source: live ? { provider: live.source.provider, sessionId: live.source.sessionId } : null,
+            candidates: (choices?.candidates ?? []).filter((source) => transcriptSourceMatchesForeground(record.summary, source.provider)).map((source) => ({
+                id: this.transcriptCandidateId(id, choices.binding, source),
+                provider: source.provider, sessionId: source.sessionId,
+                title: (source.title ?? '').slice(0, 240), cwd: source.cwd ?? '', updatedAt: source.updatedAt ?? null
+            }))
         };
     }
     async getTerminalSubagents(id) {