feat(tools): execute_bash uses PTY for shell integrations

- Create a PTY and spawn the command inside that
- Reads from user input for text and key events, allowing some use for interactive commands
- Uses current program env vars, and users custom shell integrations (dot files e.g. .zshrc)
- Works for both `execute_bash` tool and context hooks
- Moved PTY creation code from `figterm` to `fig_util` instead.

NOTES:
- terminal is set to dumb mode as explained in the code. we should find a way around this.
- we provde all command output which is expensive for some interactive commands that re-draw. Our next steps should involve writing more than a max output to a local file, then prompting Q to read from this file if it wants more context about what the tool did.
- Not tested on windows (testable?) or other shells besides zsh (yet)

Author: hayemaxi

Cargo.lock

@@ -14,15 +14,24 @@ workspace = true
 default = []
 
 [dependencies]
+anyhow.workspace = true
+shlex.workspace = true
+async-trait.workspace = true
 camino.workspace = true
 cfg-if.workspace = true
 clap.workspace = true
+crossterm.workspace = true
 dirs.workspace = true
 fig_os_shim.workspace = true
 hex.workspace = true
 indoc.workspace = true
 libc.workspace = true
 paste = "1.0.11"
+portable-pty.workspace = true
+termios = "0.3"
+nix = "0.26"
+filedescriptor = "0.8.3"
+console = "0.15.11"
 rand.workspace = true
 regex.workspace = true
 serde.workspace = true

crates/fig_util/Cargo.toml

@@ -1,15 +1,15 @@
+pub mod consts;
 pub mod directories;
+#[cfg(target_os = "macos")]
+pub mod launchd_plist;
 pub mod manifest;
 mod open;
 pub mod process_info;
-mod shell;
+pub mod pty;
+pub mod shell;
 pub mod system_info;
 pub mod terminal;
 
-pub mod consts;
-#[cfg(target_os = "macos")]
-pub mod launchd_plist;
-
 use std::cmp::Ordering;
 use std::path::{
     Path,

crates/fig_util/src/lib.rs

@@ -2,12 +2,17 @@ use std::borrow::Cow;
 use std::fmt;
 use std::sync::OnceLock;
 
+use crossterm::event::{
+    KeyCode,
+    KeyEvent,
+    KeyModifiers,
+};
 use fig_os_shim::Context;
+use portable_pty::PtySize;
 use serde::{
     Deserialize,
     Serialize,
 };
-
 /// Terminals that macOS supports
 pub const MACOS_TERMINALS: &[Terminal] = &[
     Terminal::Alacritty,
@@ -793,6 +798,58 @@ impl IntelliJVariant {
     }
 }
 
+pub fn get_terminal_size() -> PtySize {
+    match crossterm::terminal::size() {
+        Ok((cols, rows)) => PtySize {
+            rows,
+            cols,
+            pixel_width: 0,
+            pixel_height: 0,
+        },
+        Err(_) => {
+            // Fall back to default size
+            PtySize {
+                rows: 24,
+                cols: 80,
+                pixel_width: 0,
+                pixel_height: 0,
+            }
+        },
+    }
+}
+
+pub fn key_event_to_bytes(key: KeyEvent) -> Vec<u8> {
+    match key.code {
+        KeyCode::Char(c) => {
+            // Handle Ctrl+key combinations
+            if key.modifiers.contains(KeyModifiers::CONTROL) {
+                // Convert to control character (ASCII control chars are 1-26)
+                if c.is_ascii_lowercase() {
+                    return vec![(c as u8) - b'a' + 1];
+                } else if c.is_ascii_uppercase() {
+                    return vec![(c as u8) - b'A' + 1];
+                }
+            }
+            // Regular character
+            c.to_string().into_bytes()
+        },
+        KeyCode::Enter => vec![b'\r'],
+        KeyCode::Backspace => vec![b'\x7f'],
+        KeyCode::Esc => vec![b'\x1b'],
+        KeyCode::Tab => vec![b'\t'],
+        KeyCode::Up => vec![b'\x1b', b'[', b'A'],
+        KeyCode::Down => vec![b'\x1b', b'[', b'B'],
+        KeyCode::Right => vec![b'\x1b', b'[', b'C'],
+        KeyCode::Left => vec![b'\x1b', b'[', b'D'],
+        KeyCode::Home => vec![b'\x1b', b'[', b'H'],
+        KeyCode::End => vec![b'\x1b', b'[', b'F'],
+        KeyCode::Delete => vec![b'\x1b', b'[', b'3', b'~'],
+        KeyCode::PageUp => vec![b'\x1b', b'[', b'5', b'~'],
+        KeyCode::PageDown => vec![b'\x1b', b'[', b'6', b'~'],
+        _ => vec![], // Ignore other keys for now
+    }
+}
+
 #[cfg(test)]
 mod tests {
     use std::sync::Arc;