gsd-pi 2.76.0 → 2.77.0-dev.538325aea

package/packages/gsd-agent-modes/src/modes/rpc/rpc-types.ts

@@ -0,0 +1,335 @@
+/**
+ * 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, ThinkingLevel } from "@gsd/pi-agent-core";
+import type { Api, ImageContent, Model } from "@gsd/pi-ai";
+import type { SessionStats, BashResult, CompactionResult } from "@gsd/agent-types";
+
+// ============================================================================
+// RPC Protocol Versioning
+// ============================================================================
+
+/** Supported protocol versions. v1 is the implicit default; v2 requires an init handshake. */
+export type RpcProtocolVersion = 1 | 2;
+
+// ============================================================================
+// 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: "new_session"; parentSession?: string }
+
+	// State
+	| { id?: string; type: "get_state" }
+
+	// 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" }
+
+	// 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: "fork"; entryId: string }
+	| { id?: string; type: "get_fork_messages" }
+	| { id?: string; type: "get_last_assistant_text" }
+	| { id?: string; type: "set_session_name"; name: string }
+
+	// Messages
+	| { id?: string; type: "get_messages" }
+
+	// Commands (available for invocation via prompt)
+	| { id?: string; type: "get_commands" }
+
+	// Bridge-hosted native terminal
+	| { id?: string; type: "terminal_input"; data: string }
+	| { id?: string; type: "terminal_resize"; cols: number; rows: number }
+	| { id?: string; type: "terminal_redraw" }
+
+	// v2 Protocol
+	| { id?: string; type: "init"; protocolVersion: 2; clientId?: string }
+	| { id?: string; type: "shutdown"; graceful?: boolean }
+	| { id?: string; type: "subscribe"; events: string[] };
+
+// ============================================================================
+// RPC Slash Command (for get_commands response)
+// ============================================================================
+
+/** A command available for invocation via prompt */
+export interface RpcSlashCommand {
+	/** Command name (without leading slash) */
+	name: string;
+	/** Human-readable description */
+	description?: string;
+	/** What kind of command this is */
+	source: "extension" | "prompt" | "skill";
+	/** Where the command was loaded from (undefined for extensions) */
+	location?: "user" | "project" | "path";
+	/** File path to the command source */
+	path?: string;
+}
+
+// ============================================================================
+// RPC State
+// ============================================================================
+
+export interface RpcSessionState {
+	model?: Model<Api>;
+	thinkingLevel: ThinkingLevel;
+	isStreaming: boolean;
+	isCompacting: boolean;
+	steeringMode: "all" | "one-at-a-time";
+	followUpMode: "all" | "one-at-a-time";
+	sessionFile?: string;
+	sessionId: string;
+	sessionName?: string;
+	autoCompactionEnabled: boolean;
+	autoRetryEnabled: boolean;
+	retryInProgress: boolean;
+	retryAttempt: number;
+	messageCount: number;
+	pendingMessageCount: number;
+	/** Whether extension loading has completed. Commands from `get_commands` may be incomplete until true. */
+	extensionsReady: boolean;
+}
+
+// ============================================================================
+// RPC Responses (stdout)
+// ============================================================================
+
+// Success responses with data
+export type RpcResponse =
+	// Prompting (async - events follow)
+	| { id?: string; type: "response"; command: "prompt"; success: true; runId?: string }
+	| { id?: string; type: "response"; command: "steer"; success: true; runId?: string }
+	| { id?: string; type: "response"; command: "follow_up"; success: true; runId?: string }
+	| { id?: string; type: "response"; command: "abort"; 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 }
+
+	// Model
+	| {
+			id?: string;
+			type: "response";
+			command: "set_model";
+			success: true;
+			data: Model<Api>;
+	  }
+	| {
+			id?: string;
+			type: "response";
+			command: "cycle_model";
+			success: true;
+			data: { model: Model<Api>; thinkingLevel: ThinkingLevel; isScoped: boolean } | null;
+	  }
+	| {
+			id?: string;
+			type: "response";
+			command: "get_available_models";
+			success: true;
+			data: { models: Model<Api>[] };
+	  }
+
+	// Thinking
+	| { id?: string; type: "response"; command: "set_thinking_level"; success: true }
+	| {
+			id?: string;
+			type: "response";
+			command: "cycle_thinking_level";
+			success: true;
+			data: { level: ThinkingLevel } | null;
+	  }
+
+	// Queue modes
+	| { id?: string; type: "response"; command: "set_steering_mode"; success: true }
+	| { id?: string; type: "response"; command: "set_follow_up_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: "fork"; success: true; data: { text: string; cancelled: boolean } }
+	| {
+			id?: string;
+			type: "response";
+			command: "get_fork_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[] } }
+
+	// Commands
+	| {
+			id?: string;
+			type: "response";
+			command: "get_commands";
+			success: true;
+			data: { commands: RpcSlashCommand[] };
+	  }
+
+	// Bridge-hosted native terminal
+	| { id?: string; type: "response"; command: "terminal_input"; success: true }
+	| { id?: string; type: "response"; command: "terminal_resize"; success: true }
+	| { id?: string; type: "response"; command: "terminal_redraw"; success: true }
+
+	// v2 Protocol
+	| { id?: string; type: "response"; command: "init"; success: true; data: RpcInitResult }
+	| { id?: string; type: "response"; command: "shutdown"; success: true }
+	| { id?: string; type: "response"; command: "subscribe"; success: true }
+
+	// Error response (any command can fail)
+	| { id?: string; type: "response"; command: string; success: false; error: string };
+
+// ============================================================================
+// v2 Protocol Types
+// ============================================================================
+
+/** Result of the init handshake (v2 only) */
+export interface RpcInitResult {
+	protocolVersion: 2;
+	sessionId: string;
+	capabilities: {
+		events: string[];
+		commands: string[];
+	};
+}
+
+/** v2 execution_complete event — emitted when a prompt/steer/follow_up finishes */
+export interface RpcExecutionCompleteEvent {
+	type: "execution_complete";
+	runId: string;
+	status: "completed" | "error" | "cancelled";
+	reason?: string;
+	stats: SessionStats;
+}
+
+/** v2 cost_update event — emitted per-turn with running cost data */
+export interface RpcCostUpdateEvent {
+	type: "cost_update";
+	runId: string;
+	turnCost: number;
+	cumulativeCost: number;
+	tokens: {
+		input: number;
+		output: number;
+		cacheRead: number;
+		cacheWrite: number;
+	};
+}
+
+/** Discriminated union of all v2-only event types */
+export type RpcV2Event = RpcExecutionCompleteEvent | RpcCostUpdateEvent;
+
+// ============================================================================
+// 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; allowMultiple?: boolean }
+	| { 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;
+			secure?: boolean;
+	  }
+	| { type: "extension_ui_request"; id: string; method: "editor"; title: string; prefill?: 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 };
+
+// ============================================================================
+// 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; values: string[] }
+	| { type: "extension_ui_response"; id: string; confirmed: boolean }
+	| { type: "extension_ui_response"; id: string; cancelled: true };
+
+// ============================================================================
+// Helper type for extracting command types
+// ============================================================================
+
+export type RpcCommandType = RpcCommand["type"];

package/packages/gsd-agent-modes/src/modes/shared/command-context-actions.ts

@@ -0,0 +1,53 @@
+/**
+ * Default (headless) implementations of ExtensionCommandContextActions.
+ *
+ * These delegate directly to AgentSession without any UI side-effects.
+ * Interactive mode layers TUI-specific behavior on top of these.
+ * RPC and print modes use them as-is.
+ */
+
+import type { AgentSession } from "@gsd/agent-core";
+import type { ExtensionCommandContextActions } from "@gsd/agent-types";
+
+/**
+ * Create the default set of command context actions that simply delegate
+ * to the corresponding AgentSession methods.
+ *
+ * Callers can spread the result and override individual actions to add
+ * mode-specific behavior (e.g., interactive mode clears TUI state after
+ * forking).
+ */
+export function createDefaultCommandContextActions(session: AgentSession): ExtensionCommandContextActions {
+	return {
+		waitForIdle: () => session.agent.waitForIdle(),
+
+		newSession: async (options) => {
+			const success = await session.newSession(options);
+			return { cancelled: !success };
+		},
+
+		fork: async (entryId) => {
+			const result = await session.fork(entryId);
+			return { cancelled: result.cancelled };
+		},
+
+		navigateTree: async (targetId, options) => {
+			const result = await session.navigateTree(targetId, {
+				summarize: options?.summarize,
+				customInstructions: options?.customInstructions,
+				replaceInstructions: options?.replaceInstructions,
+				label: options?.label,
+			});
+			return { cancelled: result.cancelled };
+		},
+
+		switchSession: async (sessionPath) => {
+			const success = await session.switchSession(sessionPath);
+			return { cancelled: !success };
+		},
+
+		reload: async () => {
+			await session.reload();
+		},
+	};
+}

package/packages/gsd-agent-modes/src/pi-coding-agent-compat.ts

@@ -0,0 +1,42 @@
+export {
+	APP_NAME,
+	CONFIG_DIR_NAME,
+	ENV_AGENT_DIR,
+	getAuthPath,
+	getChangelogPath,
+	getDebugLogPath,
+	getModelsPath,
+	getShareViewerUrl,
+	getUpdateInstruction,
+} from "../../pi-coding-agent/dist/config.js";
+
+export { allTools } from "../../pi-coding-agent/dist/core/tools/index.js";
+export { resolveReadPath } from "../../pi-coding-agent/dist/core/tools/path-utils.js";
+export { computeEditDiff } from "../../pi-coding-agent/dist/core/tools/edit-diff.js";
+export { exportFromFile } from "../../pi-coding-agent/dist/core/export-html/index.js";
+export { printTimings, time } from "../../pi-coding-agent/dist/core/timings.js";
+export { resolveCliModel, resolveModelScope } from "../../pi-coding-agent/dist/core/model-resolver.js";
+export type { ScopedModel } from "../../pi-coding-agent/dist/core/model-resolver.js";
+export { runMigrations, showDeprecationWarnings } from "../../pi-coding-agent/dist/migrations.js";
+export {
+	getAvailableThemes,
+	getAvailableThemesWithPaths,
+	getEditorTheme,
+	getThemeByName,
+	onThemeChange,
+	setRegisteredThemes,
+	setTheme,
+	setThemeInstance,
+	stopThemeWatcher,
+} from "../../pi-coding-agent/dist/modes/interactive/theme/theme.js";
+export { FooterDataProvider } from "../../pi-coding-agent/dist/core/footer-data-provider.js";
+export { createCompactionSummaryMessage } from "../../pi-coding-agent/dist/core/messages.js";
+export { BUILTIN_SLASH_COMMANDS } from "../../pi-coding-agent/dist/core/slash-commands.js";
+export { getNewEntries, parseChangelog } from "../../pi-coding-agent/dist/utils/changelog.js";
+export { extensionForImageMimeType, readClipboardImage } from "../../pi-coding-agent/dist/utils/clipboard-image.js";
+export { ensureTool } from "../../pi-coding-agent/dist/utils/tools-manager.js";
+export { detectSupportedImageMimeTypeFromFile } from "../../pi-coding-agent/dist/utils/mime.js";
+export { formatDimensionNote, resizeImage } from "../../pi-coding-agent/dist/utils/image-resize.js";
+export { convertToPng } from "../../pi-coding-agent/dist/utils/image-convert.js";
+export { sanitizeBinaryOutput } from "../../pi-coding-agent/dist/utils/shell.js";
+export { ContextualTips } from "../../pi-coding-agent/dist/core/contextual-tips.js";

package/packages/gsd-agent-modes/src/pi-tui-compat.ts

@@ -0,0 +1,4 @@
+import { getEditorKeybindings, type EditorAction } from "@gsd/pi-tui";
+
+export type Keybinding = EditorAction;
+export const getKeybindings = getEditorKeybindings;

package/packages/gsd-agent-modes/src/theme.ts

@@ -0,0 +1,25 @@
+/**
+ * GSD theme proxy — re-exports the live theme singleton from pi-coding-agent.
+ *
+ * The `theme` proxy reads from the same globalThis key that pi-coding-agent's
+ * initTheme() sets, so it always reflects the currently active theme without
+ * requiring a direct import of the (removed) `theme` value export.
+ */
+
+import type { Theme } from "@gsd/agent-types";
+
+// Use the same Symbol key that pi-coding-agent uses for the global theme singleton.
+const THEME_KEY = Symbol.for("@gsd/pi-coding-agent:theme");
+
+/**
+ * Live proxy to the currently active theme instance.
+ * Equivalent to the removed `theme` proxy export from @gsd/pi-coding-agent 0.67.2.
+ * Throws if initTheme() has not been called yet.
+ */
+export const theme: Theme = new Proxy({} as Theme, {
+	get(_target, prop) {
+		const t = (globalThis as Record<symbol, Theme>)[THEME_KEY];
+		if (!t) throw new Error("Theme not initialized. Call initTheme() first.");
+		return (t as unknown as Record<string | symbol, unknown>)[prop];
+	},
+});

package/packages/gsd-agent-modes/src/utils/theme.ts

@@ -0,0 +1,24 @@
+/**
+ * Global theme proxy for gsd-agent-modes.
+ *
+ * Both @gsd/pi-coding-agent module paths (core/theme/theme.ts and
+ * modes/interactive/theme/theme.ts) write the active theme to the same
+ * globalThis key, but they export two structurally-incompatible Theme classes
+ * (different private fields). Importing `theme` from either path triggers TS2345.
+ *
+ * This module creates its own Proxy using the same Symbol key, bypassing the
+ * dual-module-path mismatch. It is typed with the `Theme` class from the
+ * barrel index (which exports Theme from modes/interactive/theme/theme.ts).
+ */
+import type { Theme } from "@gsd/pi-coding-agent";
+
+const THEME_KEY = Symbol.for("@gsd/pi-coding-agent:theme");
+
+/** Global theme proxy — reflects the active theme set by initTheme(). */
+export const theme: Theme = new Proxy({} as Theme, {
+	get(_target, prop) {
+		const t = (globalThis as Record<symbol, Theme>)[THEME_KEY];
+		if (!t) throw new Error("Theme not initialized. Call initTheme() first.");
+		return (t as unknown as Record<string | symbol, unknown>)[prop];
+	},
+});

package/packages/gsd-agent-modes/tsconfig.json

@@ -0,0 +1,28 @@
+{
+  "compilerOptions": {
+    "target": "ES2024",
+    "module": "Node16",
+    "lib": ["ES2024"],
+    "strict": true,
+    "esModuleInterop": true,
+    "skipLibCheck": true,
+    "incremental": true,
+    "forceConsistentCasingInFileNames": true,
+    "declaration": true,
+    "declarationMap": true,
+    "sourceMap": true,
+    "inlineSources": true,
+    "inlineSourceMap": false,
+    "moduleResolution": "Node16",
+    "resolveJsonModule": true,
+    "allowImportingTsExtensions": false,
+    "experimentalDecorators": true,
+    "emitDecoratorMetadata": true,
+    "useDefineForClassFields": false,
+    "types": ["node"],
+    "outDir": "./dist",
+    "rootDir": "./src"
+  },
+  "include": ["src/**/*.ts"],
+  "exclude": ["node_modules", "dist", "**/*.d.ts", "src/**/*.d.ts", "src/**/*.test.ts"]
+}