@nforma.ai/nforma 0.2.1

package/bin/providers.json

@@ -0,0 +1,392 @@
+{
+  "providers": [
+    {
+      "name": "codex-1",
+      "provider": "openai",
+      "type": "subprocess",
+      "has_file_access": true,
+      "description": "Execute Codex CLI agent non-interactively (slot 1)",
+      "mainTool": "codex",
+      "model": "gpt-5.3-codex",
+      "model_detect": {
+        "file": "~/.codex/config.toml",
+        "pattern": "^model = \"([^\"]+)\""
+      },
+      "health_check_args": [
+        "--version"
+      ],
+      "display_provider": "OpenAI",
+      "cli": "/opt/homebrew/bin/codex",
+      "args_template": [
+        "exec",
+        "{prompt}"
+      ],
+      "helpArgs": [
+        "--help"
+      ],
+      "extraTools": [
+        {
+          "name": "review",
+          "description": "Run a code review against the current repository using Codex CLI",
+          "args_template": [
+            "review",
+            "{prompt}"
+          ]
+        }
+      ],
+      "timeout_ms": 300000,
+      "quorum_timeout_ms": 30000,
+      "env": {},
+      "display_type": "codex-cli"
+    },
+    {
+      "name": "codex-2",
+      "provider": "openai",
+      "type": "subprocess",
+      "has_file_access": true,
+      "description": "Execute Codex CLI agent non-interactively (slot 2)",
+      "mainTool": "codex",
+      "model": "gpt-5.3-codex",
+      "model_detect": {
+        "file": "~/.codex/config.toml",
+        "pattern": "^model = \"([^\"]+)\""
+      },
+      "health_check_args": [
+        "--version"
+      ],
+      "display_provider": "OpenAI",
+      "cli": "/opt/homebrew/bin/codex",
+      "args_template": [
+        "exec",
+        "{prompt}"
+      ],
+      "helpArgs": [
+        "--help"
+      ],
+      "extraTools": [
+        {
+          "name": "review",
+          "description": "Run a code review against the current repository using Codex CLI",
+          "args_template": [
+            "review",
+            "{prompt}"
+          ]
+        }
+      ],
+      "timeout_ms": 300000,
+      "quorum_timeout_ms": 30000,
+      "env": {}
+    },
+    {
+      "name": "gemini-1",
+      "provider": "google",
+      "type": "subprocess",
+      "has_file_access": true,
+      "description": "Query Gemini CLI agent non-interactively (slot 1)",
+      "mainTool": "gemini",
+      "model": "gemini-3-pro-preview",
+      "health_check_args": [
+        "--version"
+      ],
+      "display_provider": "Google",
+      "cli": "/opt/homebrew/bin/gemini",
+      "args_template": [
+        "-m",
+        "gemini-3-pro-preview",
+        "-p",
+        "{prompt}"
+      ],
+      "helpArgs": [
+        "--help"
+      ],
+      "extraTools": [],
+      "timeout_ms": 300000,
+      "quorum_timeout_ms": 30000,
+      "env": {},
+      "display_type": "gemini-cli"
+    },
+    {
+      "name": "gemini-2",
+      "provider": "google",
+      "type": "subprocess",
+      "has_file_access": true,
+      "description": "Query Gemini CLI agent non-interactively (slot 2)",
+      "mainTool": "gemini",
+      "model": "gemini-3-pro-preview",
+      "health_check_args": [
+        "--version"
+      ],
+      "display_provider": "Google",
+      "cli": "/opt/homebrew/bin/gemini",
+      "args_template": [
+        "-m",
+        "gemini-3-pro-preview",
+        "-p",
+        "{prompt}"
+      ],
+      "helpArgs": [
+        "--help"
+      ],
+      "extraTools": [],
+      "timeout_ms": 300000,
+      "quorum_timeout_ms": 30000,
+      "env": {}
+    },
+    {
+      "name": "opencode-1",
+      "provider": "xai",
+      "type": "subprocess",
+      "has_file_access": true,
+      "description": "Run OpenCode agent non-interactively with a message",
+      "mainTool": "opencode",
+      "model": "grok-code-fast-1",
+      "model_detect": {
+        "file": "~/.local/state/opencode/model.json",
+        "pattern": "\"recent\":\\[{\"providerID\":\"[^\"]*\",\"modelID\":\"([^\"]+)\""
+      },
+      "health_check_args": [
+        "--version"
+      ],
+      "display_provider": "OpenCode",
+      "cli": "/opt/homebrew/bin/opencode",
+      "args_template": [
+        "run",
+        "{prompt}"
+      ],
+      "helpArgs": [
+        "--help"
+      ],
+      "extraTools": [
+        {
+          "name": "opencode_check_update",
+          "description": "Check whether a newer version of OpenCode is available on npm. Returns current version, latest version, and whether an update is available.",
+          "checkUpdate": true
+        }
+      ],
+      "timeout_ms": 300000,
+      "quorum_timeout_ms": 30000,
+      "env": {},
+      "display_type": "opencode-cli"
+    },
+    {
+      "name": "copilot-1",
+      "provider": "github",
+      "type": "subprocess",
+      "has_file_access": true,
+      "description": "Execute GitHub Copilot CLI non-interactively",
+      "mainTool": "ask",
+      "model": "gpt-4.1",
+      "health_check_args": [
+        "--version"
+      ],
+      "display_provider": "GitHub",
+      "cli": "/opt/homebrew/bin/copilot",
+      "args_template": [
+        "-p",
+        "{prompt}",
+        "--allow-all-tools",
+        "--no-color",
+        "-s"
+      ],
+      "helpArgs": [
+        "--help"
+      ],
+      "extraTools": [
+        {
+          "name": "suggest",
+          "description": "Ask GitHub Copilot to suggest a shell, git, or gh CLI command for a given task.",
+          "args_template": [
+            "-p",
+            "Suggest a shell command for the following task: {prompt}",
+            "--allow-all-tools",
+            "--no-color",
+            "-s"
+          ]
+        },
+        {
+          "name": "explain",
+          "description": "Ask GitHub Copilot to explain what a shell command does in plain language.",
+          "args_template": [
+            "-p",
+            "Explain what the following shell command does: {prompt}",
+            "--allow-all-tools",
+            "--no-color",
+            "-s"
+          ]
+        }
+      ],
+      "timeout_ms": 300000,
+      "quorum_timeout_ms": 30000,
+      "env": {},
+      "display_type": "copilot-cli"
+    },
+    {
+      "name": "claude-1",
+      "provider": "akashml",
+      "type": "subprocess",
+      "has_file_access": true,
+      "description": "DeepSeek-V3.2 via AkashML — real Claude Code CLI via ccr",
+      "mainTool": "claude",
+      "model": "deepseek-ai/DeepSeek-V3.2",
+      "display_provider": "AkashML",
+      "cli": "/opt/homebrew/bin/ccr",
+      "args_template": [
+        "claude-1",
+        "-p",
+        "{prompt}",
+        "--dangerously-skip-permissions"
+      ],
+      "health_check_args": [
+        "-v"
+      ],
+      "helpArgs": [
+        "--help"
+      ],
+      "extraTools": [],
+      "timeout_ms": 300000,
+      "quorum_timeout_ms": 20000,
+      "env": {},
+      "display_type": "claude-code-router"
+    },
+    {
+      "name": "claude-2",
+      "provider": "akashml",
+      "type": "subprocess",
+      "has_file_access": true,
+      "description": "MiniMax-M2.5 via AkashML — real Claude Code CLI via ccr",
+      "mainTool": "claude",
+      "model": "MiniMaxAI/MiniMax-M2.5",
+      "display_provider": "AkashML",
+      "cli": "/opt/homebrew/bin/ccr",
+      "args_template": [
+        "claude-2",
+        "-p",
+        "{prompt}",
+        "--dangerously-skip-permissions"
+      ],
+      "health_check_args": [
+        "-v"
+      ],
+      "helpArgs": [
+        "--help"
+      ],
+      "extraTools": [],
+      "timeout_ms": 300000,
+      "quorum_timeout_ms": 20000,
+      "env": {},
+      "display_type": "claude-code-router"
+    },
+    {
+      "name": "claude-3",
+      "provider": "together-xyz",
+      "type": "subprocess",
+      "has_file_access": true,
+      "description": "Qwen3-Coder-480B via Together.xyz — real Claude Code CLI via ccr",
+      "mainTool": "claude",
+      "model": "Qwen/Qwen3-Coder-480B-A35B-Instruct-FP8",
+      "display_provider": "Together.xyz",
+      "cli": "/opt/homebrew/bin/ccr",
+      "args_template": [
+        "claude-3",
+        "-p",
+        "{prompt}",
+        "--dangerously-skip-permissions"
+      ],
+      "health_check_args": [
+        "-v"
+      ],
+      "helpArgs": [
+        "--help"
+      ],
+      "extraTools": [],
+      "timeout_ms": 300000,
+      "quorum_timeout_ms": 30000,
+      "env": {},
+      "display_type": "claude-code-router"
+    },
+    {
+      "name": "claude-4",
+      "provider": "fireworks",
+      "type": "subprocess",
+      "has_file_access": true,
+      "description": "Kimi-K2 via Fireworks — real Claude Code CLI via ccr",
+      "mainTool": "claude",
+      "model": "accounts/fireworks/models/kimi-k2p5",
+      "display_provider": "Fireworks",
+      "cli": "/opt/homebrew/bin/ccr",
+      "args_template": [
+        "claude-4",
+        "-p",
+        "{prompt}",
+        "--dangerously-skip-permissions"
+      ],
+      "health_check_args": [
+        "-v"
+      ],
+      "helpArgs": [
+        "--help"
+      ],
+      "extraTools": [],
+      "timeout_ms": 300000,
+      "quorum_timeout_ms": 30000,
+      "env": {},
+      "display_type": "claude-code-router"
+    },
+    {
+      "name": "claude-5",
+      "provider": "together-xyz",
+      "type": "subprocess",
+      "has_file_access": true,
+      "description": "Llama-4-Maverick-17B via Together.xyz — real Claude Code CLI via ccr",
+      "mainTool": "claude",
+      "model": "meta-llama/Llama-4-Maverick-17B-128E-Instruct-FP8",
+      "display_provider": "Together.xyz",
+      "cli": "/opt/homebrew/bin/ccr",
+      "args_template": [
+        "claude-5",
+        "-p",
+        "{prompt}",
+        "--dangerously-skip-permissions"
+      ],
+      "health_check_args": [
+        "-v"
+      ],
+      "helpArgs": [
+        "--help"
+      ],
+      "extraTools": [],
+      "timeout_ms": 300000,
+      "quorum_timeout_ms": 10000,
+      "env": {},
+      "display_type": "claude-code-router"
+    },
+    {
+      "name": "claude-6",
+      "provider": "fireworks",
+      "type": "subprocess",
+      "has_file_access": true,
+      "description": "GLM-5 via Fireworks — real Claude Code CLI via ccr",
+      "mainTool": "claude",
+      "model": "accounts/fireworks/models/glm-5",
+      "display_provider": "Fireworks",
+      "cli": "/opt/homebrew/bin/ccr",
+      "args_template": [
+        "claude-6",
+        "-p",
+        "{prompt}",
+        "--dangerously-skip-permissions"
+      ],
+      "health_check_args": [
+        "-v"
+      ],
+      "helpArgs": [
+        "--help"
+      ],
+      "extraTools": [],
+      "timeout_ms": 300000,
+      "quorum_timeout_ms": 8000,
+      "env": {},
+      "display_type": "claude-code-router"
+    }
+  ]
+}

package/bin/pty-proxy.py

@@ -0,0 +1,129 @@
+#!/usr/bin/env python3
+"""
+pty-proxy.py — zero-dependency PTY allocator for nForma's embedded terminal.
+
+Spawns a command inside a real pseudo-terminal so interactive CLIs (like claude)
+see isTTY=true on stdin/stdout/stderr. Proxies data between the parent's piped
+stdio and the PTY master fd.
+
+Usage: python3 pty-proxy.py <cols> <rows> <command> [args...]
+
+Works on macOS and Linux without any native Node.js addons.
+"""
+
+import pty, os, sys, select, signal, struct, fcntl, termios, errno
+
+def set_winsize(fd, rows, cols):
+    """Set the terminal window size on a PTY fd."""
+    try:
+        winsize = struct.pack('HHHH', rows, cols, 0, 0)
+        fcntl.ioctl(fd, termios.TIOCSWINSZ, winsize)
+    except Exception:
+        pass
+
+def main():
+    if len(sys.argv) < 4:
+        sys.stderr.write('Usage: pty-proxy.py <cols> <rows> <command> [args...]\n')
+        sys.exit(1)
+
+    cols = int(sys.argv[1])
+    rows = int(sys.argv[2])
+    cmd = sys.argv[3]
+    args = sys.argv[3:]  # argv[0] for the child = cmd
+
+    # Create PTY pair
+    master_fd, slave_fd = pty.openpty()
+    set_winsize(master_fd, rows, cols)
+
+    pid = os.fork()
+    if pid == 0:
+        # ── Child process ──
+        os.close(master_fd)
+        os.setsid()
+
+        # Set slave as controlling terminal
+        fcntl.ioctl(slave_fd, termios.TIOCSCTTY, 0)
+
+        # Redirect stdio to slave PTY
+        os.dup2(slave_fd, 0)
+        os.dup2(slave_fd, 1)
+        os.dup2(slave_fd, 2)
+        if slave_fd > 2:
+            os.close(slave_fd)
+
+        os.execvp(cmd, args)
+        # If exec fails
+        os._exit(127)
+    else:
+        # ── Parent process ──
+        os.close(slave_fd)
+
+        # Forward SIGWINCH to child (nForma sends this on resize)
+        def on_winch(signum, frame):
+            try:
+                os.kill(pid, signal.SIGWINCH)
+            except Exception:
+                pass
+        signal.signal(signal.SIGWINCH, on_winch)
+
+        # Make stdin non-blocking
+        stdin_fd = sys.stdin.fileno()
+        stdout_fd = sys.stdout.fileno()
+
+        # Set stdin to non-blocking
+        old_flags = fcntl.fcntl(stdin_fd, fcntl.F_GETFL)
+        fcntl.fcntl(stdin_fd, fcntl.F_SETFL, old_flags | os.O_NONBLOCK)
+
+        # Proxy loop: stdin → master, master → stdout
+        try:
+            while True:
+                try:
+                    rfds, _, _ = select.select([stdin_fd, master_fd], [], [], 0.1)
+                except select.error:
+                    break
+
+                if stdin_fd in rfds:
+                    try:
+                        data = os.read(stdin_fd, 4096)
+                        if not data:
+                            # stdin closed — send EOF to child
+                            os.close(master_fd)
+                            break
+                        os.write(master_fd, data)
+                    except OSError as e:
+                        if e.errno not in (errno.EAGAIN, errno.EWOULDBLOCK):
+                            break
+
+                if master_fd in rfds:
+                    try:
+                        data = os.read(master_fd, 4096)
+                        if not data:
+                            break
+                        os.write(stdout_fd, data)
+                        sys.stdout.flush()
+                    except OSError as e:
+                        if e.errno == errno.EIO:
+                            # Child exited — PTY closed
+                            break
+                        if e.errno not in (errno.EAGAIN, errno.EWOULDBLOCK):
+                            break
+        except KeyboardInterrupt:
+            pass
+        finally:
+            # Restore stdin flags
+            try:
+                fcntl.fcntl(stdin_fd, fcntl.F_SETFL, old_flags)
+            except Exception:
+                pass
+
+        # Wait for child and exit with its status
+        try:
+            _, status = os.waitpid(pid, 0)
+            if os.WIFEXITED(status):
+                sys.exit(os.WEXITSTATUS(status))
+            sys.exit(1)
+        except ChildProcessError:
+            sys.exit(0)
+
+if __name__ == '__main__':
+    main()