@f5xc-salesdemos/xcsh 2.2.0 → 14.0.2

package/src/modes/rpc/rpc-types.ts

@@ -0,0 +1,297 @@
+/**
+ * RPC protocol types for headless operation.
+ *
+ * Commands are sent as JSON lines on stdin.
+ * Responses and events are emitted as JSON lines on stdout.
+ */
+import type { AgentMessage, AgentToolResult, ThinkingLevel } from "@f5xc-salesdemos/pi-agent-core";
+import type { Effort, ImageContent, Model } from "@f5xc-salesdemos/pi-ai";
+import type { BashResult } from "../../exec/bash-executor";
+import type { SessionStats } from "../../session/agent-session";
+import type { CompactionResult } from "../../session/compaction";
+import type { TodoPhase } from "../../tools/todo-write";
+
+// ============================================================================
+// RPC Commands (stdin)
+// ============================================================================
+
+export type RpcCommand =
+	// Prompting
+	| { id?: string; type: "prompt"; message: string; images?: ImageContent[]; streamingBehavior?: "steer" | "followUp" }
+	| { id?: string; type: "steer"; message: string; images?: ImageContent[] }
+	| { id?: string; type: "follow_up"; message: string; images?: ImageContent[] }
+	| { id?: string; type: "abort" }
+	| { id?: string; type: "abort_and_prompt"; message: string; images?: ImageContent[] }
+	| { id?: string; type: "new_session"; parentSession?: string }
+
+	// State
+	| { id?: string; type: "get_state" }
+	| { id?: string; type: "set_todos"; phases: TodoPhase[] }
+	| { id?: string; type: "set_host_tools"; tools: RpcHostToolDefinition[] }
+
+	// Model
+	| { id?: string; type: "set_model"; provider: string; modelId: string }
+	| { id?: string; type: "cycle_model" }
+	| { id?: string; type: "get_available_models" }
+
+	// Thinking
+	| { id?: string; type: "set_thinking_level"; level: ThinkingLevel }
+	| { id?: string; type: "cycle_thinking_level" }
+
+	// Queue modes
+	| { id?: string; type: "set_steering_mode"; mode: "all" | "one-at-a-time" }
+	| { id?: string; type: "set_follow_up_mode"; mode: "all" | "one-at-a-time" }
+	| { id?: string; type: "set_interrupt_mode"; mode: "immediate" | "wait" }
+
+	// Compaction
+	| { id?: string; type: "compact"; customInstructions?: string }
+	| { id?: string; type: "set_auto_compaction"; enabled: boolean }
+
+	// Retry
+	| { id?: string; type: "set_auto_retry"; enabled: boolean }
+	| { id?: string; type: "abort_retry" }
+
+	// Bash
+	| { id?: string; type: "bash"; command: string }
+	| { id?: string; type: "abort_bash" }
+
+	// Session
+	| { id?: string; type: "get_session_stats" }
+	| { id?: string; type: "export_html"; outputPath?: string }
+	| { id?: string; type: "switch_session"; sessionPath: string }
+	| { id?: string; type: "branch"; entryId: string }
+	| { id?: string; type: "get_branch_messages" }
+	| { id?: string; type: "get_last_assistant_text" }
+	| { id?: string; type: "set_session_name"; name: string }
+
+	// Messages
+	| { id?: string; type: "get_messages" };
+
+// ============================================================================
+// RPC State
+// ============================================================================
+
+export interface RpcSessionState {
+	model?: Model;
+	thinkingLevel: ThinkingLevel | undefined;
+	isStreaming: boolean;
+	isCompacting: boolean;
+	steeringMode: "all" | "one-at-a-time";
+	followUpMode: "all" | "one-at-a-time";
+	interruptMode: "immediate" | "wait";
+	sessionFile?: string;
+	sessionId: string;
+	sessionName?: string;
+	autoCompactionEnabled: boolean;
+	messageCount: number;
+	queuedMessageCount: number;
+	todoPhases: TodoPhase[];
+	/** For session dump / export (plain-text parity with /dump). */
+	systemPrompt?: string;
+	dumpTools?: Array<{ name: string; description: string; parameters: unknown }>;
+}
+
+// ============================================================================
+// RPC Responses (stdout)
+// ============================================================================
+
+// Success responses with data
+export type RpcResponse =
+	// Prompting (async - events follow)
+	| { id?: string; type: "response"; command: "prompt"; success: true }
+	| { id?: string; type: "response"; command: "steer"; success: true }
+	| { id?: string; type: "response"; command: "follow_up"; success: true }
+	| { id?: string; type: "response"; command: "abort"; success: true }
+	| { id?: string; type: "response"; command: "abort_and_prompt"; success: true }
+	| { id?: string; type: "response"; command: "new_session"; success: true; data: { cancelled: boolean } }
+
+	// State
+	| { id?: string; type: "response"; command: "get_state"; success: true; data: RpcSessionState }
+	| { id?: string; type: "response"; command: "set_todos"; success: true; data: { todoPhases: TodoPhase[] } }
+	| { id?: string; type: "response"; command: "set_host_tools"; success: true; data: { toolNames: string[] } }
+
+	// Model
+	| {
+			id?: string;
+			type: "response";
+			command: "set_model";
+			success: true;
+			data: Model;
+	  }
+	| {
+			id?: string;
+			type: "response";
+			command: "cycle_model";
+			success: true;
+			data: { model: Model; thinkingLevel: ThinkingLevel | undefined; isScoped: boolean } | null;
+	  }
+	| {
+			id?: string;
+			type: "response";
+			command: "get_available_models";
+			success: true;
+			data: { models: Model[] };
+	  }
+
+	// Thinking
+	| { id?: string; type: "response"; command: "set_thinking_level"; success: true }
+	| {
+			id?: string;
+			type: "response";
+			command: "cycle_thinking_level";
+			success: true;
+			data: { level: Effort } | null;
+	  }
+
+	// Queue modes
+	| { id?: string; type: "response"; command: "set_steering_mode"; success: true }
+	| { id?: string; type: "response"; command: "set_follow_up_mode"; success: true }
+	| { id?: string; type: "response"; command: "set_interrupt_mode"; success: true }
+
+	// Compaction
+	| { id?: string; type: "response"; command: "compact"; success: true; data: CompactionResult }
+	| { id?: string; type: "response"; command: "set_auto_compaction"; success: true }
+
+	// Retry
+	| { id?: string; type: "response"; command: "set_auto_retry"; success: true }
+	| { id?: string; type: "response"; command: "abort_retry"; success: true }
+
+	// Bash
+	| { id?: string; type: "response"; command: "bash"; success: true; data: BashResult }
+	| { id?: string; type: "response"; command: "abort_bash"; success: true }
+
+	// Session
+	| { id?: string; type: "response"; command: "get_session_stats"; success: true; data: SessionStats }
+	| { id?: string; type: "response"; command: "export_html"; success: true; data: { path: string } }
+	| { id?: string; type: "response"; command: "switch_session"; success: true; data: { cancelled: boolean } }
+	| { id?: string; type: "response"; command: "branch"; success: true; data: { text: string; cancelled: boolean } }
+	| {
+			id?: string;
+			type: "response";
+			command: "get_branch_messages";
+			success: true;
+			data: { messages: Array<{ entryId: string; text: string }> };
+	  }
+	| {
+			id?: string;
+			type: "response";
+			command: "get_last_assistant_text";
+			success: true;
+			data: { text: string | null };
+	  }
+	| { id?: string; type: "response"; command: "set_session_name"; success: true }
+
+	// Messages
+	| { id?: string; type: "response"; command: "get_messages"; success: true; data: { messages: AgentMessage[] } }
+
+	// Error response (any command can fail)
+	| { id?: string; type: "response"; command: string; success: false; error: string };
+
+// ============================================================================
+// Extension UI Events (stdout)
+// ============================================================================
+
+/** Emitted when an extension needs user input */
+export type RpcExtensionUIRequest =
+	| { type: "extension_ui_request"; id: string; method: "select"; title: string; options: string[]; timeout?: number }
+	| { type: "extension_ui_request"; id: string; method: "confirm"; title: string; message: string; timeout?: number }
+	| {
+			type: "extension_ui_request";
+			id: string;
+			method: "input";
+			title: string;
+			placeholder?: string;
+			timeout?: number;
+	  }
+	| {
+			type: "extension_ui_request";
+			id: string;
+			method: "editor";
+			title: string;
+			prefill?: string;
+			promptStyle?: boolean;
+	  }
+	| { type: "extension_ui_request"; id: string; method: "cancel"; targetId: string }
+	| {
+			type: "extension_ui_request";
+			id: string;
+			method: "notify";
+			message: string;
+			notifyType?: "info" | "warning" | "error";
+	  }
+	| {
+			type: "extension_ui_request";
+			id: string;
+			method: "setStatus";
+			statusKey: string;
+			statusText: string | undefined;
+	  }
+	| {
+			type: "extension_ui_request";
+			id: string;
+			method: "setWidget";
+			widgetKey: string;
+			widgetLines: string[] | undefined;
+			widgetPlacement?: "aboveEditor" | "belowEditor";
+	  }
+	| { type: "extension_ui_request"; id: string; method: "setTitle"; title: string }
+	| { type: "extension_ui_request"; id: string; method: "set_editor_text"; text: string };
+
+// ============================================================================
+// Host Tool Frames (bidirectional)
+// ============================================================================
+
+export interface RpcHostToolDefinition {
+	name: string;
+	label?: string;
+	description: string;
+	parameters: Record<string, unknown>;
+	hidden?: boolean;
+}
+
+/** Emitted by the RPC server when it needs the host to execute a registered tool. */
+export interface RpcHostToolCallRequest {
+	type: "host_tool_call";
+	id: string;
+	toolCallId: string;
+	toolName: string;
+	arguments: Record<string, unknown>;
+}
+
+/** Emitted by the RPC server when a pending host tool call should be aborted. */
+export interface RpcHostToolCancelRequest {
+	type: "host_tool_cancel";
+	id: string;
+	targetId: string;
+}
+
+/** Sent by the host to stream partial tool updates back to the RPC server. */
+export interface RpcHostToolUpdate {
+	type: "host_tool_update";
+	id: string;
+	partialResult: AgentToolResult<unknown>;
+}
+
+/** Sent by the host to complete a pending tool call. */
+export interface RpcHostToolResult {
+	type: "host_tool_result";
+	id: string;
+	result: AgentToolResult<unknown>;
+	isError?: boolean;
+}
+
+// ============================================================================
+// Extension UI Commands (stdin)
+// ============================================================================
+
+/** Response to an extension UI request */
+export type RpcExtensionUIResponse =
+	| { type: "extension_ui_response"; id: string; value: string }
+	| { type: "extension_ui_response"; id: string; confirmed: boolean }
+	| { type: "extension_ui_response"; id: string; cancelled: true; timedOut?: boolean };
+
+// ============================================================================
+// Helper type for extracting command types
+// ============================================================================
+
+export type RpcCommandType = RpcCommand["type"];

package/src/modes/session-observer-registry.ts

@@ -0,0 +1,146 @@
+import type { AgentProgress, SubagentLifecyclePayload, SubagentProgressPayload } from "../task";
+import { TASK_SUBAGENT_LIFECYCLE_CHANNEL, TASK_SUBAGENT_PROGRESS_CHANNEL } from "../task";
+import type { EventBus } from "../utils/event-bus";
+
+export interface ObservableSession {
+	id: string;
+	kind: "main" | "subagent";
+	label: string;
+	agent?: string;
+	description?: string;
+	status: "active" | "completed" | "failed" | "aborted";
+	sessionFile?: string;
+	lastUpdate: number;
+	/** Latest progress snapshot from the subagent executor */
+	progress?: AgentProgress;
+}
+
+const STATUS_MAP: Record<string, ObservableSession["status"]> = {
+	started: "active",
+	completed: "completed",
+	failed: "failed",
+	aborted: "aborted",
+};
+
+export class SessionObserverRegistry {
+	#sessions = new Map<string, ObservableSession>();
+	#listeners = new Set<() => void>();
+	#eventBusUnsubscribers: Array<() => void> = [];
+
+	/** Add a change listener. Returns unsubscribe function. */
+	onChange(cb: () => void): () => void {
+		this.#listeners.add(cb);
+		return () => this.#listeners.delete(cb);
+	}
+
+	#notifyListeners(): void {
+		for (const cb of this.#listeners) cb();
+	}
+
+	setMainSession(sessionFile?: string): void {
+		const existing = this.#sessions.get("main");
+		this.#sessions.set("main", {
+			id: "main",
+			kind: "main",
+			label: "Main Session",
+			status: "active",
+			sessionFile: sessionFile ?? existing?.sessionFile,
+			lastUpdate: Date.now(),
+		});
+		this.#notifyListeners();
+	}
+
+	getSessions(): ObservableSession[] {
+		const sessions = [...this.#sessions.values()];
+		sessions.sort((a, b) => {
+			if (a.kind === "main") return -1;
+			if (b.kind === "main") return 1;
+			return a.lastUpdate - b.lastUpdate;
+		});
+		return sessions;
+	}
+
+	getActiveSubagentCount(): number {
+		let count = 0;
+		for (const s of this.#sessions.values()) {
+			if (s.kind === "subagent" && s.status === "active") count++;
+		}
+		return count;
+	}
+
+	/** Clear all tracked sessions (e.g. on session switch). Keeps EventBus subscriptions and listeners. */
+	resetSessions(): void {
+		this.#sessions.clear();
+		this.#notifyListeners();
+	}
+
+	dispose(): void {
+		for (const unsub of this.#eventBusUnsubscribers) unsub();
+		this.#eventBusUnsubscribers = [];
+		this.#sessions.clear();
+		this.#listeners.clear();
+	}
+
+	subscribeToEventBus(eventBus: EventBus): void {
+		// Dispose previous EventBus subscriptions if called again
+		for (const unsub of this.#eventBusUnsubscribers) unsub();
+		this.#eventBusUnsubscribers = [];
+
+		this.#eventBusUnsubscribers.push(
+			eventBus.on(TASK_SUBAGENT_LIFECYCLE_CHANNEL, data => {
+				const payload = data as SubagentLifecyclePayload;
+				const status = STATUS_MAP[payload.status];
+				if (!status) return;
+
+				const existing = this.#sessions.get(payload.id);
+				if (existing) {
+					existing.status = status;
+					existing.lastUpdate = Date.now();
+					if (payload.description) existing.description = payload.description;
+					if (payload.sessionFile) existing.sessionFile = payload.sessionFile;
+				} else {
+					this.#sessions.set(payload.id, {
+						id: payload.id,
+						kind: "subagent",
+						label: payload.description ?? `Subagent #${payload.index}`,
+						agent: payload.agent,
+						description: payload.description,
+						status,
+						sessionFile: payload.sessionFile,
+						lastUpdate: Date.now(),
+					});
+				}
+				this.#notifyListeners();
+			}),
+		);
+
+		this.#eventBusUnsubscribers.push(
+			eventBus.on(TASK_SUBAGENT_PROGRESS_CHANNEL, data => {
+				const payload = data as SubagentProgressPayload;
+				const progress = payload.progress;
+				const id = progress.id;
+				const existing = this.#sessions.get(id);
+
+				if (existing) {
+					existing.lastUpdate = Date.now();
+					existing.progress = progress;
+					if (progress.description) existing.description = progress.description;
+					if (payload.sessionFile) existing.sessionFile = payload.sessionFile;
+				} else {
+					this.#sessions.set(id, {
+						id,
+						kind: "subagent",
+						label: progress.description ?? `Subagent #${payload.index}`,
+						agent: payload.agent,
+						description: progress.description,
+						status: "active",
+						sessionFile: payload.sessionFile,
+						lastUpdate: Date.now(),
+						progress,
+					});
+				}
+				this.#notifyListeners();
+			}),
+		);
+	}
+}

package/src/modes/shared.ts

@@ -0,0 +1,30 @@
+import type { TabBarTheme } from "@f5xc-salesdemos/pi-tui";
+import { theme } from "./theme/theme";
+
+// ═══════════════════════════════════════════════════════════════════════════
+// Text Sanitization
+// ═══════════════════════════════════════════════════════════════════════════
+
+/** Sanitize text for display in a single-line status. Replaces newlines/tabs with space, collapses runs, trims. */
+export function sanitizeStatusText(text: string): string {
+	return text
+		.replace(/[\r\n\t]/g, " ")
+		.replace(/ +/g, " ")
+		.trim();
+}
+
+// ═══════════════════════════════════════════════════════════════════════════
+// Tab Bar Theme
+// ═══════════════════════════════════════════════════════════════════════════
+
+/** Shared tab bar theme used by model-selector and settings-selector. */
+export function getTabBarTheme(): TabBarTheme {
+	return {
+		label: (text: string) => theme.bold(theme.fg("accent", text)),
+		activeTab: (text: string) => theme.bold(theme.bg("selectedBg", theme.fg("text", text))),
+		inactiveTab: (text: string) => theme.fg("muted", text),
+		hint: (text: string) => theme.fg("dim", text),
+	};
+}
+
+export { parseCommandArgs } from "../utils/command-args";

package/src/modes/theme/dark.json

@@ -0,0 +1,95 @@
+{
+	"$schema": "https://raw.githubusercontent.com/f5xc-salesdemos/xcsh/main/packages/coding-agent/theme-schema.json",
+	"name": "dark",
+	"vars": {
+		"cyan": "#0088fa",
+		"blue": "#178fb9",
+		"green": "#89d281",
+		"red": "#fc3a4b",
+		"yellow": "#e4c00f",
+		"gray": "#777d88",
+		"dimGray": "#5f6673",
+		"darkGray": "#3d424a",
+		"accent": "#febc38",
+		"selectedBg": "#31363f",
+		"userMsgBg": "#221d1a",
+		"toolPendingBg": "#1d2129",
+		"toolSuccessBg": "#161a1f",
+		"toolErrorBg": "#291d1d",
+		"customMsgBg": "#2a2530"
+	},
+	"colors": {
+		"accent": "accent",
+		"border": "blue",
+		"borderAccent": "cyan",
+		"borderMuted": "darkGray",
+		"success": "green",
+		"error": "red",
+		"warning": "yellow",
+		"muted": "gray",
+		"dim": "dimGray",
+		"text": "",
+		"thinkingText": "gray",
+		"selectedBg": "selectedBg",
+		"userMessageBg": "userMsgBg",
+		"userMessageText": "",
+		"customMessageBg": "customMsgBg",
+		"customMessageText": "",
+		"customMessageLabel": "#b281d6",
+		"toolPendingBg": "toolPendingBg",
+		"toolSuccessBg": "toolSuccessBg",
+		"toolErrorBg": "toolErrorBg",
+		"toolTitle": "",
+		"toolOutput": "gray",
+		"mdHeading": "#febc38",
+		"mdLink": "#0088fa",
+		"mdLinkUrl": "dimGray",
+		"mdCode": "#e5c1ff",
+		"mdCodeBlock": "#9CDCFE",
+		"mdCodeBlockBorder": "darkGray",
+		"mdQuote": "gray",
+		"mdQuoteBorder": "darkGray",
+		"mdHr": "darkGray",
+		"mdListBullet": "accent",
+		"toolDiffAdded": "green",
+		"toolDiffRemoved": "red",
+		"toolDiffContext": "gray",
+		"link": "#0088fa",
+		"syntaxComment": "#6A9955",
+		"syntaxKeyword": "#569CD6",
+		"syntaxFunction": "#DCDCAA",
+		"syntaxVariable": "#9CDCFE",
+		"syntaxString": "#CE9178",
+		"syntaxNumber": "#B5CEA8",
+		"syntaxType": "#4EC9B0",
+		"syntaxOperator": "#D4D4D4",
+		"syntaxPunctuation": "#D4D4D4",
+		"thinkingOff": "darkGray",
+		"thinkingMinimal": "dimGray",
+		"thinkingLow": "#178fb9",
+		"thinkingMedium": "#0088fa",
+		"thinkingHigh": "#b281d6",
+		"thinkingXhigh": "#e5c1ff",
+		"bashMode": "cyan",
+		"statusLineBg": "#121212",
+		"statusLineSep": 244,
+		"statusLineModel": "#d787af",
+		"statusLinePath": "#00afaf",
+		"statusLineGitClean": "#5faf5f",
+		"statusLineGitDirty": "#d7af5f",
+		"statusLineContext": "#8787af",
+		"statusLineSpend": "#5fafaf",
+		"statusLineStaged": 70,
+		"statusLineDirty": 178,
+		"statusLineUntracked": 39,
+		"statusLineOutput": 205,
+		"statusLineCost": 205,
+		"statusLineSubagents": "accent",
+		"pythonMode": "yellow"
+	},
+	"export": {
+		"pageBg": "#18181e",
+		"cardBg": "#1e1e24",
+		"infoBg": "#3c3728"
+	}
+}

package/src/modes/theme/defaults/alabaster.json

@@ -0,0 +1,93 @@
+{
+	"$schema": "https://raw.githubusercontent.com/f5xc-salesdemos/xcsh/main/packages/coding-agent/theme-schema.json",
+	"name": "alabaster",
+	"vars": {
+		"alabaster": "#fdfcfb",
+		"chiseledBlack": "#1a1c20",
+		"shadowGray": "#505860",
+		"carvedDepth": "#6a7080",
+		"subtleShadow": "#e8e8ec",
+		"lightShadow": "#f0f0f4",
+		"accent": "#404850",
+		"warmShadow": "#8a7060",
+		"selectedBg": "#f0eff0",
+		"userMsgBg": "#f5f4f5",
+		"toolPendingBg": "#f3f3f8",
+		"toolSuccessBg": "#f4f5f4",
+		"toolErrorBg": "#f8f3f3",
+		"customMsgBg": "#f6f4f7"
+	},
+	"colors": {
+		"accent": "shadowGray",
+		"border": "subtleShadow",
+		"borderAccent": "shadowGray",
+		"borderMuted": "lightShadow",
+		"success": "#405840",
+		"error": "#704040",
+		"warning": "#806850",
+		"muted": "carvedDepth",
+		"dim": "#909098",
+		"text": "",
+		"thinkingText": "carvedDepth",
+		"selectedBg": "selectedBg",
+		"userMessageBg": "userMsgBg",
+		"userMessageText": "",
+		"customMessageBg": "customMsgBg",
+		"customMessageText": "",
+		"customMessageLabel": "shadowGray",
+		"toolPendingBg": "toolPendingBg",
+		"toolSuccessBg": "toolSuccessBg",
+		"toolErrorBg": "toolErrorBg",
+		"toolTitle": "",
+		"toolOutput": "carvedDepth",
+		"mdHeading": "chiseledBlack",
+		"mdLink": "shadowGray",
+		"mdLinkUrl": "carvedDepth",
+		"mdCode": "accent",
+		"mdCodeBlock": "shadowGray",
+		"mdCodeBlockBorder": "subtleShadow",
+		"mdQuote": "carvedDepth",
+		"mdQuoteBorder": "subtleShadow",
+		"mdHr": "subtleShadow",
+		"mdListBullet": "shadowGray",
+		"toolDiffAdded": "#405840",
+		"toolDiffRemoved": "#704040",
+		"toolDiffContext": "carvedDepth",
+		"syntaxComment": "#707880",
+		"syntaxKeyword": "#303840",
+		"syntaxFunction": "chiseledBlack",
+		"syntaxVariable": "chiseledBlack",
+		"syntaxString": "warmShadow",
+		"syntaxNumber": "shadowGray",
+		"syntaxType": "#303840",
+		"syntaxOperator": "#404850",
+		"syntaxPunctuation": "#505860",
+		"thinkingOff": "#c0c0c8",
+		"thinkingMinimal": "#a0a0a8",
+		"thinkingLow": "#808090",
+		"thinkingMedium": "#606870",
+		"thinkingHigh": "#505860",
+		"thinkingXhigh": "#303840",
+		"bashMode": "#405840",
+		"statusLineBg": "#ececf0",
+		"statusLineSep": "#a0a0a8",
+		"statusLineModel": "#505860",
+		"statusLinePath": "#404850",
+		"statusLineGitClean": "#305030",
+		"statusLineGitDirty": "#806030",
+		"statusLineContext": "#404860",
+		"statusLineSpend": "#405050",
+		"statusLineStaged": 28,
+		"statusLineDirty": 136,
+		"statusLineUntracked": 31,
+		"statusLineOutput": 133,
+		"statusLineCost": 133,
+		"statusLineSubagents": "shadowGray",
+		"pythonMode": "#f0c040"
+	},
+	"export": {
+		"pageBg": "#fdfcfb",
+		"cardBg": "#ffffff",
+		"infoBg": "#faf9f8"
+	}
+}