pi-interactive-shell 0.6.1 → 0.6.2

package/CHANGELOG.md

@@ -4,6 +4,15 @@ All notable changes to the `pi-interactive-shell` extension will be documented i
 
 ## [Unreleased]
 
+## [0.6.2] - 2026-01-28
+
+### Fixed
+- **Ctrl+T transfer now works in hands-free mode** - When using Ctrl+T to transfer output in non-blocking hands-free mode, the captured output is now properly sent back to the main agent using `pi.sendMessage()` with `triggerTurn: true`. Previously, the transfer data was captured but never delivered to the agent because the tool had already returned. The fix uses the event bus pattern to wake the agent with the transferred content.
+- **Race condition when Ctrl+T during polling** - Added guard in `getOutputSinceLastCheck()` to return empty output if the session is finished. This prevents errors when a query races with Ctrl+T transfer (PTY disposed before query completes).
+
+### Added
+- **New event: `interactive-shell:transfer`** - Emitted via `pi.events` when Ctrl+T transfer occurs, allowing other extensions to hook into transfer events.
+
 ## [0.6.1] - 2026-01-27
 
 ### Added

package/README.md

@@ -25,11 +25,9 @@ Works with any CLI: `vim`, `htop`, `psql`, `ssh`, `docker logs -f`, `npm run dev
 ## Install
 
 ```bash
-npx pi-interactive-shell
+pi install npm:pi-interactive-shell
 ```
 
-Installs to `~/.pi/agent/extensions/interactive-shell/`.
-
 The `interactive-shell` skill is automatically symlinked to `~/.pi/agent/skills/interactive-shell/`.
 
 **Requires:** Node.js, build tools for `node-pty` (Xcode CLI tools on macOS).

package/index.ts

@@ -437,10 +437,37 @@ export default function interactiveShellExtension(pi: ExtensionAPI) {
 				// Handle overlay completion in background (cleanup when user closes)
 				overlayPromise.then((result) => {
 					overlayOpen = false;
-					// Session already handles cleanup via finishWith* methods
-					// This just ensures the promise doesn't cause unhandled rejection
-					if (result.userTookOver) {
-						// User took over - session continues interactively
+					
+					// Handle Ctrl+T transfer: send output back to main agent
+					if (result.transferred) {
+						const truncatedNote = result.transferred.truncated
+							? ` (truncated from ${result.transferred.totalLines} total lines)`
+							: "";
+						const content = `Session ${generatedSessionId} output transferred (${result.transferred.lines.length} lines${truncatedNote}):\n\n${result.transferred.lines.join("\n")}`;
+						
+						// Send message with triggerTurn to wake the agent
+						pi.sendMessage({
+							customType: "interactive-shell-transfer",
+							content,
+							display: true,
+							details: {
+								sessionId: generatedSessionId,
+								transferred: result.transferred,
+								exitCode: result.exitCode,
+								signal: result.signal,
+							},
+						}, { triggerTurn: true });
+						
+						// Emit event for extensions that want to handle transfers
+						pi.events.emit("interactive-shell:transfer", {
+							sessionId: generatedSessionId,
+							transferred: result.transferred,
+							exitCode: result.exitCode,
+							signal: result.signal,
+						});
+						
+						// Unregister session - PTY is disposed, agent has the output via sendMessage
+						sessionManager.unregisterActive(generatedSessionId, true);
 					}
 				}).catch(() => {
 					overlayOpen = false;

package/overlay-component.ts

@@ -190,6 +190,16 @@ export class InteractiveShellOverlay implements Component, Focusable {
 
 	/** Get rendered terminal output (last N lines, truncated if too large) */
 	getOutputSinceLastCheck(options: { skipRateLimit?: boolean; lines?: number; maxChars?: number; offset?: number; drain?: boolean; incremental?: boolean } | boolean = false): { output: string; truncated: boolean; totalBytes: number; totalLines?: number; hasMore?: boolean; rateLimited?: boolean; waitSeconds?: number } {
+		// Guard: if session is finished (PTY disposed), return empty output
+		// This handles race conditions where query arrives after Ctrl+T transfer
+		if (this.finished) {
+			return {
+				output: "",
+				truncated: false,
+				totalBytes: 0,
+			};
+		}
+
 		// Handle legacy boolean parameter
 		const opts = typeof options === "boolean" ? { skipRateLimit: options } : options;
 		const skipRateLimit = opts.skipRateLimit ?? false;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pi-interactive-shell",
-  "version": "0.6.1",
+  "version": "0.6.2",
   "description": "Run AI coding agents as foreground subagents in pi TUI overlays with hands-free monitoring",
   "type": "module",
   "bin": {