feat: ClawTap v0.1.0 — initial release
Multi-adapter mobile UI for AI coding assistants. Supports Claude Code, Codex CLI, and Gemini CLI through one interface. Features: - Real-time bidirectional sync via tmux + WebSocket - Cross-AI review (send one AI's output to another for review) - Multi-review tabs with minimize/expand - Push notifications (PWA) with smart session-aware filtering - Three-channel event system (hooks, file watcher, pane monitor) - Voice input, image paste, draft persistence - Terminal-native design (JetBrains Mono, dark theme, pixel art claw) - CLI with --adapter flag on every command - Zero-overhead fire-and-forget hooks
This commit is contained in:
kuannnn
@@ -0,0 +1,217 @@
|
||||
// server/adapters/gemini/pane-monitor.ts
|
||||
//
|
||||
// Polls a tmux pane every 500ms to capture real-time streaming output from
|
||||
// the Gemini CLI.
|
||||
//
|
||||
// Detects:
|
||||
// 1. Streaming response text (new text since last poll)
|
||||
// 2. Thinking indicators (spinner / processing patterns)
|
||||
//
|
||||
// Note: Gemini already provides thinking content in JSON (thoughts[]), so
|
||||
// pane-level thinking detection is supplementary — it provides real-time
|
||||
// feedback before the JSON response is written to disk.
|
||||
//
|
||||
// Modelled after server/adapters/codex/pane-monitor.ts but with
|
||||
// Gemini-specific regex patterns. Patterns are conservative placeholders
|
||||
// that will be refined through empirical testing with the actual Gemini CLI.
|
||||
|
||||
import { EventEmitter } from 'events';
|
||||
|
||||
/** Minimal interface for the tmux manager dependency */
|
||||
interface TmuxCapture {
|
||||
capturePane(windowId: string, lines?: number): Promise<string>;
|
||||
}
|
||||
|
||||
/** Thinking indicator detected from pane content */
|
||||
export interface ThinkingInfo {
|
||||
text: string;
|
||||
detail: string | null;
|
||||
}
|
||||
|
||||
/**
|
||||
* GeminiPaneMonitor — polls a tmux pane to detect streaming text and
|
||||
* thinking indicators from the Gemini CLI.
|
||||
*
|
||||
* Events emitted via the injected EventEmitter:
|
||||
* - 'streaming-text' (sessionId, newText)
|
||||
* - 'thinking' (sessionId, { text, detail })
|
||||
*/
|
||||
export class GeminiPaneMonitor {
|
||||
private sessionId: string;
|
||||
private windowId: string;
|
||||
private tmux: TmuxCapture;
|
||||
private emitter: EventEmitter;
|
||||
private interval: ReturnType<typeof setInterval> | null = null;
|
||||
private _lastContent: string = '';
|
||||
private _lastResponseText: string = '';
|
||||
|
||||
constructor(
|
||||
sessionId: string,
|
||||
windowId: string,
|
||||
tmuxManager: TmuxCapture,
|
||||
emitter: EventEmitter,
|
||||
) {
|
||||
this.sessionId = sessionId;
|
||||
this.windowId = windowId;
|
||||
this.tmux = tmuxManager;
|
||||
this.emitter = emitter;
|
||||
}
|
||||
|
||||
/** Begin polling the tmux pane at 500ms intervals */
|
||||
start(): void {
|
||||
if (this.interval) return;
|
||||
this.interval = setInterval(() => this._poll(), 500);
|
||||
}
|
||||
|
||||
/** Stop polling and clear the interval */
|
||||
stop(): void {
|
||||
if (this.interval) {
|
||||
clearInterval(this.interval);
|
||||
this.interval = null;
|
||||
}
|
||||
}
|
||||
|
||||
/** Force an immediate poll (useful on hook receipt) */
|
||||
async pollNow(): Promise<void> {
|
||||
await this._poll();
|
||||
}
|
||||
|
||||
// ---------------------------------------------------------------------------
|
||||
// Internal
|
||||
// ---------------------------------------------------------------------------
|
||||
|
||||
private async _poll(): Promise<void> {
|
||||
try {
|
||||
const content = await this.tmux.capturePane(this.windowId);
|
||||
if (content === this._lastContent) return;
|
||||
this._lastContent = content;
|
||||
|
||||
// 1. Check for thinking indicator
|
||||
const thinking = detectThinking(content);
|
||||
if (thinking) {
|
||||
this.emitter.emit('thinking', this.sessionId, thinking);
|
||||
return;
|
||||
}
|
||||
|
||||
// 2. Extract streaming response text
|
||||
const text = extractResponseText(content);
|
||||
if (text && text !== this._lastResponseText) {
|
||||
this._lastResponseText = text;
|
||||
this.emitter.emit('streaming-text', this.sessionId, text);
|
||||
}
|
||||
} catch {
|
||||
// Silently ignore — tmux window may have been killed
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
// =============================================================================
|
||||
// Detection functions (exported for unit testing)
|
||||
// =============================================================================
|
||||
|
||||
/**
|
||||
* Detect Gemini thinking/processing indicators.
|
||||
*
|
||||
* Gemini CLI shows various spinner/processing patterns while reasoning.
|
||||
* In non-alt-screen mode these appear as inline text in the pane.
|
||||
*
|
||||
* Placeholder patterns — will be refined through empirical testing:
|
||||
* - "Thinking..." text (Gemini's native thinking label)
|
||||
* - Spinner characters (⠋⠙⠹⠸⠼⠴⠦⠧⠇⠏ braille spinner set)
|
||||
* - "Generating..." or processing indicators
|
||||
*/
|
||||
export function detectThinking(content: string): ThinkingInfo | null {
|
||||
const lines = content.split('\n');
|
||||
// Only check the tail of the pane (last 15 lines)
|
||||
const tail = lines.slice(-15);
|
||||
|
||||
for (const line of tail) {
|
||||
// Skip completion/summary lines
|
||||
if (/completed|finished|done|exited/i.test(line)) continue;
|
||||
|
||||
// Pattern 1: Braille spinner followed by descriptive text
|
||||
// e.g. "⠙ Thinking..." or "⠹ Generating..."
|
||||
const brailleMatch = line.match(/^\s*([⠋⠙⠹⠸⠼⠴⠦⠧⠇⠏])\s+(.+?)\s*$/);
|
||||
if (brailleMatch) {
|
||||
return { text: brailleMatch[2]!, detail: null };
|
||||
}
|
||||
|
||||
// Pattern 2: Explicit "Thinking..." or "Generating..." text
|
||||
// Gemini CLI commonly shows "Thinking..." during reasoning
|
||||
const thinkingMatch = line.match(
|
||||
/^\s*(Thinking|Generating|Processing|Working)(\.\.\.)?\s*(?:\((.+?)\))?\s*$/i,
|
||||
);
|
||||
if (thinkingMatch) {
|
||||
return {
|
||||
text: `${thinkingMatch[1]}...`,
|
||||
detail: thinkingMatch[3] || null,
|
||||
};
|
||||
}
|
||||
|
||||
// Pattern 3: Braille spinner on its own (Gemini may render bare spinner)
|
||||
const bareSpinner = line.match(/^\s*[⠋⠙⠹⠸⠼⠴⠦⠧⠇⠏]\s*$/);
|
||||
if (bareSpinner) {
|
||||
return { text: 'Thinking...', detail: null };
|
||||
}
|
||||
}
|
||||
|
||||
return null;
|
||||
}
|
||||
|
||||
/**
|
||||
* Extract the current streaming response text from pane content.
|
||||
*
|
||||
* Gemini CLI writes responses inline. We look for text after the last
|
||||
* user input marker and collect lines until we hit a boundary indicator.
|
||||
*
|
||||
* Placeholder patterns — will be refined through empirical testing:
|
||||
* - User input prompt: ">" or "❯" followed by user text
|
||||
* - Response boundary: horizontal rules, new prompts, spinner indicators
|
||||
*/
|
||||
export function extractResponseText(content: string): string {
|
||||
const lines = content.split('\n');
|
||||
|
||||
// Find the LAST user prompt line — responses appear after it
|
||||
let lastUserPrompt = -1;
|
||||
for (let i = lines.length - 1; i >= 0; i--) {
|
||||
const line = lines[i]!;
|
||||
// Gemini user prompt patterns (conservative):
|
||||
// - ">" or "❯" at start of line followed by user text
|
||||
// - "user:" prefix
|
||||
if (/^\s*[>❯]\s+\S/.test(line) || /^\s*user:\s/i.test(line)) {
|
||||
lastUserPrompt = i;
|
||||
break;
|
||||
}
|
||||
}
|
||||
|
||||
if (lastUserPrompt === -1) return '';
|
||||
|
||||
// Collect response lines after the user prompt
|
||||
// Skip the prompt line itself and any blank lines immediately after
|
||||
let responseStart = lastUserPrompt + 1;
|
||||
while (responseStart < lines.length && lines[responseStart]!.trim() === '') {
|
||||
responseStart++;
|
||||
}
|
||||
|
||||
if (responseStart >= lines.length) return '';
|
||||
|
||||
const responseLines: string[] = [];
|
||||
for (let i = responseStart; i < lines.length; i++) {
|
||||
const line = lines[i]!;
|
||||
|
||||
// Stop at boundary markers
|
||||
if (
|
||||
// Horizontal rules
|
||||
/^[─━═\-]{5,}/.test(line.trim()) ||
|
||||
// New user prompt
|
||||
/^\s*[>❯]\s+\S/.test(line) ||
|
||||
// Spinner/thinking indicators (braille set)
|
||||
/^\s*[⠋⠙⠹⠸⠼⠴⠦⠧⠇⠏]\s*/.test(line)
|
||||
) {
|
||||
break;
|
||||
}
|
||||
responseLines.push(line);
|
||||
}
|
||||
|
||||
return responseLines.join('\n').trim();
|
||||
}
|
||||
Reference in New Issue
Block a user