proofscan 0.10.54 → 0.10.55

package/dist/shell/find-command.d.ts

@@ -0,0 +1,54 @@
+/**
+ * Find Command for psh Shell
+ *
+ * Cross-session search without changing `ls` semantics.
+ * Scope derived from cwd:
+ *   /         => all connectors
+ *   /<cid>:   => that connector's sessions
+ *   /<cid>/<sid>: => that session only
+ */
+import type { ShellContext } from './types.js';
+import type { PipelineValue } from './pipeline-types.js';
+/** Find command options */
+export interface FindOptions {
+    kind: 'session' | 'rpc' | 'event';
+    limit: number;
+    sessions: number;
+    errorsOnly: boolean;
+}
+/** Find result type */
+export type FindResult = {
+    ok: true;
+    result: PipelineValue;
+    stats: {
+        count: number;
+        sessions: number;
+    };
+} | {
+    ok: false;
+    error: string;
+} | {
+    ok: false;
+    error: string;
+    help: true;
+};
+/**
+ * Parse find command arguments
+ *
+ * Usage: find <kind> [--limit N] [--sessions N] [--errors-only]
+ */
+export declare function parseFindArgs(args: string[]): {
+    ok: true;
+    options: FindOptions;
+} | {
+    ok: false;
+    error: string;
+    help?: true;
+};
+/**
+ * Execute find command
+ *
+ * Loads rows from multiple sessions based on scope and options.
+ */
+export declare function executeFind(context: ShellContext, configPath: string, options: FindOptions): FindResult;
+//# sourceMappingURL=find-command.d.ts.map

package/dist/shell/find-command.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"find-command.d.ts","sourceRoot":"","sources":["../../src/shell/find-command.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC/C,OAAO,KAAK,EAAE,aAAa,EAAsB,MAAM,qBAAqB,CAAC;AAK7E,2BAA2B;AAC3B,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,SAAS,GAAG,KAAK,GAAG,OAAO,CAAC;IAClC,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,OAAO,CAAC;CACrB;AAUD,uBAAuB;AACvB,MAAM,MAAM,UAAU,GAClB;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,MAAM,EAAE,aAAa,CAAC;IAAC,KAAK,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAA;CAAE,GAC/E;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GAC5B;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,IAAI,CAAA;CAAE,CAAC;AA8B7C;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,OAAO,EAAE,WAAW,CAAA;CAAE,GAAG;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,IAAI,CAAA;CAAE,CAmD5H;AAED;;;;GAIG;AACH,wBAAgB,WAAW,CACzB,OAAO,EAAE,YAAY,EACrB,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,WAAW,GACnB,UAAU,CAoBZ"}

package/dist/shell/find-command.js

@@ -0,0 +1,330 @@
+/**
+ * Find Command for psh Shell
+ *
+ * Cross-session search without changing `ls` semantics.
+ * Scope derived from cwd:
+ *   /         => all connectors
+ *   /<cid>:   => that connector's sessions
+ *   /<cid>/<sid>: => that session only
+ */
+import { getContextLevel } from './router-commands.js';
+import { EventLineStore } from '../eventline/store.js';
+import { ConfigManager } from '../config/index.js';
+/** Default options */
+const DEFAULT_OPTIONS = {
+    kind: 'rpc',
+    limit: 200,
+    sessions: 50,
+    errorsOnly: false,
+};
+/** Help text for find command */
+const FIND_HELP = `find - cross-session search
+
+Usage: find <kind> [options]
+
+Kinds:
+  session     List sessions across scope
+  rpc         List RPC calls across sessions
+  event       List events (not yet implemented)
+
+Options:
+  --limit N        Max rows to return (default: 200)
+  --sessions N     Max sessions to search (default: 50)
+  --errors-only    Only return error RPCs
+  -h, --help       Show this help
+
+Scope (derived from cwd):
+  /                All connectors
+  /<connector>:    That connector's sessions
+  /<conn>/<sess>:  That session only
+
+Examples:
+  find rpc                           All RPCs in current scope
+  find rpc --errors-only             Only errors
+  find rpc --limit 50 --sessions 10  Limit results
+  find rpc | where tools.name ~= "read"   Chain with filter
+  find session --limit 10            Latest sessions`;
+/**
+ * Parse find command arguments
+ *
+ * Usage: find <kind> [--limit N] [--sessions N] [--errors-only]
+ */
+export function parseFindArgs(args) {
+    const options = { ...DEFAULT_OPTIONS };
+    // Handle help flags first
+    if (args.length === 0 || args.includes('-h') || args.includes('--help')) {
+        return { ok: false, error: FIND_HELP, help: true };
+    }
+    let i = 0;
+    const kindArg = args[0].toLowerCase();
+    if (!['session', 'rpc', 'event'].includes(kindArg)) {
+        return { ok: false, error: `Invalid kind: ${args[0]}. Must be one of: session, rpc, event` };
+    }
+    options.kind = kindArg;
+    i++;
+    // Parse optional flags
+    while (i < args.length) {
+        const arg = args[i];
+        if (arg === '--limit') {
+            const val = args[++i];
+            if (!val || isNaN(parseInt(val, 10))) {
+                return { ok: false, error: '--limit requires a number' };
+            }
+            const limitVal = parseInt(val, 10);
+            if (limitVal <= 0) {
+                return { ok: false, error: '--limit must be a positive number' };
+            }
+            options.limit = limitVal;
+        }
+        else if (arg === '--sessions') {
+            const val = args[++i];
+            if (!val || isNaN(parseInt(val, 10))) {
+                return { ok: false, error: '--sessions requires a number' };
+            }
+            const sessionsVal = parseInt(val, 10);
+            if (sessionsVal <= 0) {
+                return { ok: false, error: '--sessions must be a positive number' };
+            }
+            options.sessions = sessionsVal;
+        }
+        else if (arg === '--errors-only') {
+            options.errorsOnly = true;
+        }
+        else if (arg.startsWith('-')) {
+            return { ok: false, error: `Unknown option: ${arg}` };
+        }
+        i++;
+    }
+    return { ok: true, options };
+}
+/**
+ * Execute find command
+ *
+ * Loads rows from multiple sessions based on scope and options.
+ */
+export function executeFind(context, configPath, options) {
+    const manager = new ConfigManager(configPath);
+    const store = new EventLineStore(manager.getConfigDir());
+    const level = getContextLevel(context);
+    // Determine scope
+    const scope = determineScope(level, context);
+    // Load rows based on kind
+    switch (options.kind) {
+        case 'session':
+            return findSessions(store, scope, options);
+        case 'rpc':
+            return findRpcs(store, scope, options);
+        case 'event':
+            // Event kind is reserved for future implementation
+            return { ok: false, error: 'Event kind is not yet implemented' };
+        default:
+            return { ok: false, error: `Unknown kind: ${options.kind}` };
+    }
+}
+/**
+ * Determine search scope from context
+ */
+function determineScope(level, context) {
+    return {
+        level,
+        connectorId: context.connector,
+        sessionId: context.session,
+    };
+}
+/**
+ * Find sessions across scope
+ */
+function findSessions(store, scope, options) {
+    const rows = [];
+    let sessionCount = 0;
+    if (scope.level === 'session' && scope.sessionId) {
+        // Session level - return just this session info
+        const sessions = store.getSessions(scope.connectorId, options.sessions);
+        const session = sessions.find(s => s.session_id === scope.sessionId);
+        if (session) {
+            rows.push({
+                session_id: session.session_id,
+                connector_id: scope.connectorId,
+                started_at: session.started_at ?? '',
+                ended_at: session.ended_at ?? null,
+                event_count: session.event_count ?? 0,
+                rpc_count: session.rpc_count ?? 0,
+            });
+            sessionCount = 1;
+        }
+    }
+    else if (scope.level === 'connector' && scope.connectorId) {
+        // Connector level - return sessions for this connector
+        const sessions = store.getSessions(scope.connectorId, options.sessions);
+        for (const session of sessions) {
+            if (rows.length >= options.limit)
+                break;
+            rows.push({
+                session_id: session.session_id,
+                connector_id: scope.connectorId,
+                started_at: session.started_at ?? '',
+                ended_at: session.ended_at ?? null,
+                event_count: session.event_count ?? 0,
+                rpc_count: session.rpc_count ?? 0,
+            });
+        }
+        sessionCount = sessions.length;
+    }
+    else {
+        // Root level - return sessions across all connectors
+        const connectors = store.getConnectors();
+        for (const connector of connectors) {
+            if (rows.length >= options.limit)
+                break;
+            const sessions = store.getSessions(connector.id, options.sessions);
+            for (const session of sessions) {
+                if (rows.length >= options.limit)
+                    break;
+                rows.push({
+                    session_id: session.session_id,
+                    connector_id: connector.id,
+                    started_at: session.started_at ?? '',
+                    ended_at: session.ended_at ?? null,
+                    event_count: session.event_count ?? 0,
+                    rpc_count: session.rpc_count ?? 0,
+                });
+            }
+            sessionCount += sessions.length;
+        }
+    }
+    return {
+        ok: true,
+        result: { kind: 'rows', rows, rowType: 'session' },
+        stats: { count: rows.length, sessions: sessionCount },
+    };
+}
+/**
+ * Extract tool name from request JSON.
+ * Fallback chain: params.name ?? params.tool ?? params.toolName
+ */
+function extractToolName(rawJson) {
+    if (!rawJson)
+        return undefined;
+    try {
+        const parsed = JSON.parse(rawJson);
+        const params = parsed?.params;
+        if (!params || typeof params !== 'object')
+            return undefined;
+        if (typeof params.name === 'string' && params.name.length > 0) {
+            return params.name;
+        }
+        if (typeof params.tool === 'string' && params.tool.length > 0) {
+            return params.tool;
+        }
+        if (typeof params.toolName === 'string' && params.toolName.length > 0) {
+            return params.toolName;
+        }
+    }
+    catch {
+        // JSON parse error
+    }
+    return undefined;
+}
+/**
+ * Find RPCs across scope
+ */
+function findRpcs(store, scope, options) {
+    const rows = [];
+    let sessionCount = 0;
+    // Collect session IDs to search
+    const sessionIds = [];
+    if (scope.level === 'session' && scope.sessionId && scope.connectorId) {
+        // Session level - search only this session
+        sessionIds.push({ sessionId: scope.sessionId, connectorId: scope.connectorId });
+    }
+    else if (scope.level === 'connector' && scope.connectorId) {
+        // Connector level - search sessions for this connector
+        const sessions = store.getSessions(scope.connectorId, options.sessions);
+        for (const session of sessions) {
+            sessionIds.push({ sessionId: session.session_id, connectorId: scope.connectorId });
+        }
+    }
+    else {
+        // Root level - search across all connectors
+        const connectors = store.getConnectors();
+        for (const connector of connectors) {
+            const sessions = store.getSessions(connector.id, options.sessions);
+            for (const session of sessions) {
+                sessionIds.push({ sessionId: session.session_id, connectorId: connector.id });
+            }
+        }
+    }
+    sessionCount = sessionIds.length;
+    // Load RPCs from each session
+    for (const { sessionId, connectorId } of sessionIds) {
+        if (rows.length >= options.limit)
+            break;
+        const rpcs = store.getRpcCalls(sessionId);
+        // Build tool name map for tools/call RPCs in this session (batch lookup)
+        // This avoids N+1 query pattern by fetching raw events once per session
+        const toolsCallRpcIds = rpcs
+            .filter(rpc => rpc.method === 'tools/call')
+            .map(rpc => rpc.rpc_id);
+        const toolNameMap = new Map();
+        if (toolsCallRpcIds.length > 0) {
+            // Build tool name map for all tools/call RPCs in this session
+            // Note: getRawEvent internally fetches all session events, so subsequent
+            // calls for the same session benefit from SQLite's page cache
+            for (const rpcId of toolsCallRpcIds) {
+                const event = store.getRawEvent(sessionId, rpcId);
+                if (event?.request?.raw_json) {
+                    const toolName = extractToolName(event.request.raw_json);
+                    if (toolName) {
+                        toolNameMap.set(rpcId, toolName);
+                    }
+                }
+            }
+        }
+        for (const rpc of rpcs) {
+            if (rows.length >= options.limit)
+                break;
+            // Determine status
+            let status;
+            if (rpc.success === 1) {
+                status = 'OK';
+            }
+            else if (rpc.success === 0) {
+                status = 'ERR';
+            }
+            else {
+                status = 'pending';
+            }
+            // Filter errors only
+            if (options.errorsOnly && status !== 'ERR') {
+                continue;
+            }
+            // Calculate latency
+            let latency_ms = null;
+            if (rpc.request_ts && rpc.response_ts) {
+                const requestTime = new Date(rpc.request_ts).getTime();
+                const responseTime = new Date(rpc.response_ts).getTime();
+                latency_ms = responseTime - requestTime;
+            }
+            // Get tool_name from pre-built map (avoids N+1 query)
+            const tool_name = toolNameMap.get(rpc.rpc_id);
+            rows.push({
+                rpc_id: rpc.rpc_id,
+                session_id: rpc.session_id,
+                connector_id: connectorId,
+                method: rpc.method,
+                status,
+                latency_ms,
+                request_ts: rpc.request_ts,
+                response_ts: rpc.response_ts ?? null,
+                error_code: rpc.error_code ?? null,
+                tool_name,
+            });
+        }
+    }
+    return {
+        ok: true,
+        result: { kind: 'rows', rows, rowType: 'rpc' },
+        stats: { count: rows.length, sessions: sessionCount },
+    };
+}
+//# sourceMappingURL=find-command.js.map

package/dist/shell/find-command.js.map

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

package/dist/shell/pager/index.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Pager module exports
+ */
+export { LessPager } from './less-pager.js';
+export { MorePager } from './more-pager.js';
+export { renderRowsToLines } from './renderer.js';
+export { commandExists, parsePagerCommand, runPager, FOOTER_RESERVE_LINES } from './utils.js';
+export type { Pager, PagerOptions } from './types.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/shell/pager/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/shell/pager/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC5C,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC5C,OAAO,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAClD,OAAO,EAAE,aAAa,EAAE,iBAAiB,EAAE,QAAQ,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAC9F,YAAY,EAAE,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC"}

package/dist/shell/pager/index.js

@@ -0,0 +1,8 @@
+/**
+ * Pager module exports
+ */
+export { LessPager } from './less-pager.js';
+export { MorePager } from './more-pager.js';
+export { renderRowsToLines } from './renderer.js';
+export { commandExists, parsePagerCommand, runPager, FOOTER_RESERVE_LINES } from './utils.js';
+//# sourceMappingURL=index.js.map

package/dist/shell/pager/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/shell/pager/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC5C,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC5C,OAAO,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAClD,OAAO,EAAE,aAAa,EAAE,iBAAiB,EAAE,QAAQ,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC"}

package/dist/shell/pager/less-pager.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Less Pager for psh Shell
+ *
+ * Delegates to external pager for reliable TTY handling.
+ * Pager selection priority:
+ *   1. $PAGER environment variable (user preference)
+ *   2. 'less' command
+ *   3. Built-in pager (fallback)
+ *
+ * Note: When using external pager, standard pager key bindings apply.
+ * The built-in fallback provides vim-style navigation (j/k/space/b/g/G/q).
+ */
+import type { Pager, PagerOptions } from './types.js';
+import type { PipelineValue } from '../pipeline-types.js';
+export declare class LessPager implements Pager {
+    private options;
+    constructor(options?: PagerOptions);
+    run(input: PipelineValue): Promise<void>;
+    /**
+     * Try external pager in priority order
+     * Returns true if successful, false if all failed
+     */
+    private tryExternalPager;
+    /**
+     * Built-in pager fallback
+     * Provides vim-style navigation when no external pager is available
+     */
+    private runBuiltIn;
+    private runLoop;
+}
+//# sourceMappingURL=less-pager.d.ts.map

package/dist/shell/pager/less-pager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"less-pager.d.ts","sourceRoot":"","sources":["../../../src/shell/pager/less-pager.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EAAE,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AACtD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAI1D,qBAAa,SAAU,YAAW,KAAK;IACrC,OAAO,CAAC,OAAO,CAAe;gBAElB,OAAO,CAAC,EAAE,YAAY;IAI5B,GAAG,CAAC,KAAK,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC;IA2B9C;;;OAGG;YACW,gBAAgB;IAmC9B;;;OAGG;YACW,UAAU;YAmBV,OAAO;CAyGtB"}

package/dist/shell/pager/less-pager.js

@@ -0,0 +1,196 @@
+/**
+ * Less Pager for psh Shell
+ *
+ * Delegates to external pager for reliable TTY handling.
+ * Pager selection priority:
+ *   1. $PAGER environment variable (user preference)
+ *   2. 'less' command
+ *   3. Built-in pager (fallback)
+ *
+ * Note: When using external pager, standard pager key bindings apply.
+ * The built-in fallback provides vim-style navigation (j/k/space/b/g/G/q).
+ */
+import { renderRowsToLines } from './renderer.js';
+import { commandExists, parsePagerCommand, runPager, FOOTER_RESERVE_LINES } from './utils.js';
+export class LessPager {
+    options;
+    constructor(options) {
+        this.options = options ?? {};
+    }
+    async run(input) {
+        // TTY check - non-TTY outputs all lines without paging
+        if (!process.stdin.isTTY || !process.stdout.isTTY) {
+            const lines = renderRowsToLines(input, { useColor: false });
+            lines.forEach(line => console.log(line));
+            return;
+        }
+        const lines = renderRowsToLines(input, { useColor: true });
+        // If content fits in one page, just print and return
+        const terminalHeight = this.options.height ?? (process.stdout.rows || 24);
+        const pageSize = Math.max(1, terminalHeight - FOOTER_RESERVE_LINES);
+        if (lines.length <= pageSize) {
+            lines.forEach(line => console.log(line));
+            return;
+        }
+        // Try external pager (PAGER env -> less -> built-in)
+        const pagerResult = await this.tryExternalPager(lines);
+        if (!pagerResult) {
+            // All external pagers failed, use built-in
+            await this.runBuiltIn(lines, pageSize);
+        }
+    }
+    /**
+     * Try external pager in priority order
+     * Returns true if successful, false if all failed
+     */
+    async tryExternalPager(lines) {
+        const content = lines.join('\n') + '\n';
+        // 1. Try $PAGER environment variable (supports arguments like "less -R")
+        const pagerEnv = process.env.PAGER;
+        if (pagerEnv) {
+            const { cmd, args } = parsePagerCommand(pagerEnv);
+            if (commandExists(cmd)) {
+                try {
+                    await runPager(cmd, args, content);
+                    return true;
+                }
+                catch {
+                    // $PAGER failed, continue to next option
+                }
+            }
+        }
+        // 2. Try 'less' with recommended options
+        // -F: quit if content fits one screen
+        // -R: interpret ANSI color codes
+        // -S: don't wrap long lines (preserves table layout)
+        // -X: don't clear screen on exit
+        if (commandExists('less')) {
+            try {
+                await runPager('less', ['-FRSX'], content);
+                return true;
+            }
+            catch {
+                // less failed, continue
+            }
+        }
+        // All external pagers failed
+        return false;
+    }
+    /**
+     * Built-in pager fallback
+     * Provides vim-style navigation when no external pager is available
+     */
+    async runBuiltIn(lines, pageSize) {
+        // Enable raw mode for key input
+        process.stdin.setRawMode(true);
+        process.stdin.resume();
+        // Hide cursor while in pager mode
+        process.stdout.write('\x1B[?25l');
+        try {
+            await this.runLoop(lines, pageSize);
+        }
+        finally {
+            // Show cursor again
+            process.stdout.write('\x1B[?25h');
+            // Restore raw mode
+            process.stdin.setRawMode(false);
+        }
+    }
+    async runLoop(lines, pageSize) {
+        let offset = 0;
+        return new Promise((resolve) => {
+            const render = () => {
+                // Clear screen and move cursor to top
+                process.stdout.write('\x1B[2J\x1B[H');
+                // Show visible lines
+                const visible = lines.slice(offset, offset + pageSize);
+                visible.forEach(line => console.log(line));
+                // Footer with position info
+                const start = offset + 1;
+                const end = Math.min(offset + pageSize, lines.length);
+                const position = `${start}-${end}/${lines.length}`;
+                process.stdout.write(`\x1b[2m-- psh pager -- ${position} | j/k scroll | space page | q quit\x1b[0m`);
+            };
+            const cleanup = () => {
+                process.stdin.removeListener('data', onKey);
+                // Show cursor and clear screen before returning to shell
+                process.stdout.write('\x1B[?25h\x1B[2J\x1B[H');
+            };
+            const maxOffset = Math.max(0, lines.length - pageSize);
+            const onKey = (key) => {
+                const ch = key.toString();
+                // Handle escape sequences (arrow keys, page up/down)
+                if (ch.startsWith('\x1B[')) {
+                    switch (ch) {
+                        case '\x1B[B': // Down arrow
+                            if (offset < maxOffset) {
+                                offset++;
+                            }
+                            render(); // Always re-render to clear any stray characters
+                            break;
+                        case '\x1B[A': // Up arrow
+                            if (offset > 0) {
+                                offset--;
+                            }
+                            render();
+                            break;
+                        case '\x1B[6~': // Page Down
+                            offset = Math.min(offset + pageSize, maxOffset);
+                            render();
+                            break;
+                        case '\x1B[5~': // Page Up
+                            offset = Math.max(0, offset - pageSize);
+                            render();
+                            break;
+                        default:
+                            // Unknown escape sequence - re-render to clear
+                            render();
+                    }
+                    return;
+                }
+                // Single character commands - always re-render to prevent stray chars
+                switch (ch) {
+                    case 'q':
+                    case '\x03': // Ctrl+C
+                        cleanup();
+                        resolve();
+                        return; // Don't render after cleanup
+                    case 'j': // Down
+                        if (offset < maxOffset) {
+                            offset++;
+                        }
+                        break;
+                    case 'k': // Up
+                        if (offset > 0) {
+                            offset--;
+                        }
+                        break;
+                    case ' ': // Page down
+                    case 'f': // Forward (like less)
+                        offset = Math.min(offset + pageSize, maxOffset);
+                        break;
+                    case 'b': // Page up / backward
+                        offset = Math.max(0, offset - pageSize);
+                        break;
+                    case 'g': // First line
+                        offset = 0;
+                        break;
+                    case 'G': // Last line
+                        offset = maxOffset;
+                        break;
+                    case 'd': // Half page down (like vim)
+                        offset = Math.min(offset + Math.floor(pageSize / 2), maxOffset);
+                        break;
+                    case 'u': // Half page up (like vim)
+                        offset = Math.max(0, offset - Math.floor(pageSize / 2));
+                        break;
+                }
+                // Re-render after any key to clear potential stray characters
+                render();
+            };
+            process.stdin.on('data', onKey);
+            render();
+        });
+    }
+}
+//# sourceMappingURL=less-pager.js.map