heyio 0.1.17 → 0.1.19

package/README.md

@@ -4,7 +4,7 @@ A personal AI assistant daemon built on the GitHub Copilot SDK. IO runs 24/7 on
 
 [![CI](https://github.com/michaeljolley/io/actions/workflows/ci.yml/badge.svg)](https://github.com/michaeljolley/io/actions/workflows/ci.yml)
 ![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)
-![Node.js](https://img.shields.io/badge/node-%3E%3D18-brightgreen)
+![Node.js](https://img.shields.io/badge/node-%3E%3D22-brightgreen)
 
 ## ✨ Features
 
@@ -15,13 +15,15 @@ A personal AI assistant daemon built on the GitHub Copilot SDK. IO runs 24/7 on
 - **Skills** — modular skill system; install from git repos or the [skills.sh](https://skills.sh) registry
 - **Adaptive Sessions** — infinite sessions with automatic context compaction
 - **Worker Agents** — delegated task execution through specialized agent sessions
+- **GitHub Integration** — create, list, view, and comment on issues and PRs via the `github` tool
+- **Smart Model Routing** — automatically selects the best model for each task based on complexity
 - **Self-Updating** — checks for updates and can apply them automatically
 
 ## 📋 Prerequisites
 
-- **Node.js** >= 18
+- **Node.js** >= 22
 - **GitHub Copilot subscription** — IO uses the Copilot SDK, which requires an active Copilot license
-- **GitHub CLI** (`gh`) — authenticated via `gh auth login`
+- **GitHub CLI** (`gh`) — required for the `github` tool (issue/PR management). Install from [cli.github.com](https://cli.github.com/) and authenticate with `gh auth login`
 
 ## 🚀 Quick Start
 
@@ -54,6 +56,33 @@ io --daemon
 io --self-edit
 ```
 
+### Headless Server (systemd)
+
+To run IO as a background service on a headless server:
+
+1. Authenticate the Copilot SDK: `copilot login`
+2. Authenticate the GitHub CLI: `gh auth login`
+3. Create a systemd service file at `/etc/systemd/system/io.service`:
+
+```ini
+[Unit]
+Description=IO Personal Assistant
+After=network-online.target
+Wants=network-online.target
+
+[Service]
+Type=simple
+ExecStart=/usr/bin/env io --daemon
+Restart=always
+RestartSec=10
+Environment=NODE_ENV=production
+
+[Install]
+WantedBy=multi-user.target
+```
+
+4. Enable and start: `systemctl enable --now io`
+
 ## 💬 CLI Usage
 
 | Command | Description |
@@ -80,7 +109,17 @@ IO stores its configuration at `~/.io/config.json`. The setup wizard (`io setup`
   "telegramUserId": 123456789,
 
   // Enable self-edit mode by default
-  "selfEdit": false
+  "selfEdit": false,
+
+  // Default model for the orchestrator
+  "defaultModel": "claude-sonnet-4.6",
+
+  // Model tiers for squad agents (ranked preference lists)
+  "modelTiers": {
+    "high": ["claude-opus-4.7", "claude-opus-4.6"],
+    "medium": ["claude-sonnet-4.6", "gpt-5.5", "claude-opus-4.5"],
+    "low": ["claude-haiku-4.5", "gpt-5.4-mini"]
+  }
 }
 ```
 
@@ -160,6 +199,7 @@ src/
 │   ├── orchestrator.ts   # Main session management
 │   ├── agents.ts         # Worker agent sessions
 │   ├── tools.ts          # Tool definitions
+│   ├── model-router.ts   # Complexity-based model selection
 │   ├── skills.ts         # Skills loader
 │   └── system-message.ts # System prompt builder
 ├── store/

package/dist/copilot/agents.js

@@ -2,6 +2,7 @@ import { randomUUID } from "crypto";
 import { execSync } from "child_process";
 import { readFileSync, writeFileSync, readdirSync, statSync, existsSync, mkdirSync, } from "fs";
 import { join, dirname, resolve } from "path";
+import { homedir } from "os";
 import { defineTool, approveAll } from "@github/copilot-sdk";
 import { z } from "zod";
 import { getClient } from "./client.js";
@@ -154,6 +155,7 @@ function buildAgentTools(squadSlug) {
                     timeout: (timeout_secs ?? 60) * 1000,
                     maxBuffer: 1024 * 1024,
                     cwd: working_dir,
+                    env: { ...process.env, HOME: process.env.HOME || homedir() },
                 });
                 const output = result.trim();
                 if (output.length > 8000) {

package/dist/copilot/system-message.js

@@ -86,6 +86,7 @@ The model is selected automatically. Tell the user which model tier was chosen w
 ### System
 - \`shell\`: Run a shell command. You have full system access — you can create directories, install packages, clone repos, etc. **Always use this instead of the built-in \`bash\` tool.**
 - \`file_ops\`: Read, write, or list files anywhere on the filesystem. Can create directories automatically.
+- \`github\`: Manage GitHub issues and PRs — create, list, view, comment, close issues; create, list, view, comment on PRs.
 - \`web_fetch\`: (built-in) Fetch a URL and return content.
 
 ## Guidelines

package/dist/copilot/tools.js

@@ -3,6 +3,14 @@ import { z } from "zod";
 import { execSync } from "child_process";
 import { readFileSync, writeFileSync, readdirSync, statSync, existsSync, mkdirSync } from "fs";
 import { join, dirname, resolve } from "path";
+import { homedir } from "os";
+// Ensure child processes have HOME set (systemd services often don't)
+function shellEnv() {
+    const env = { ...process.env };
+    if (!env.HOME)
+        env.HOME = homedir();
+    return env;
+}
 export function createTools(deps) {
     const wikiRead = defineTool("wiki_read", {
         description: "Read a page from IO's knowledge base wiki. Path is relative to the wiki root (e.g., 'pages/preferences/editor.md').",
@@ -129,6 +137,7 @@ export function createTools(deps) {
                     timeout: (timeout_secs ?? 60) * 1000,
                     maxBuffer: 1024 * 1024,
                     cwd: working_dir,
+                    env: shellEnv(),
                 });
                 const output = result.trim();
                 if (output.length > 8000) {
@@ -219,6 +228,7 @@ export function createTools(deps) {
                     encoding: "utf-8",
                     timeout: 60_000,
                     maxBuffer: 1024 * 1024,
+                    env: shellEnv(),
                 });
                 const output = result.trim();
                 if (output.length > 8000) {
@@ -331,6 +341,7 @@ export function createTools(deps) {
                     encoding: "utf-8",
                     timeout: 30_000,
                     maxBuffer: 1024 * 1024,
+                    env: shellEnv(),
                 });
                 const output = result.trim();
                 if (output.length > 8000) {
@@ -409,7 +420,133 @@ export function createTools(deps) {
             }
         },
     });
-    return [wikiRead, wikiWrite, wikiSearch, squadCreate, squadRecall, squadStatus, squadLogDecision, shell, fileOps, bash, readFile, viewTool, grepTool, strReplaceEditor];
+    // GitHub issue/PR management via gh CLI
+    const github = defineTool("github", {
+        description: "Manage GitHub issues and pull requests using the gh CLI. Supports creating, listing, viewing, and commenting on issues and PRs.",
+        skipPermission: true,
+        parameters: z.object({
+            action: z
+                .enum([
+                "create_issue",
+                "list_issues",
+                "view_issue",
+                "comment_issue",
+                "close_issue",
+                "create_pr",
+                "list_prs",
+                "view_pr",
+                "comment_pr",
+            ])
+                .describe("The GitHub action to perform"),
+            repo: z.string().describe("Repository in owner/repo format"),
+            title: z.string().optional().describe("Title (for create_issue, create_pr)"),
+            body: z.string().optional().describe("Body text (for create_issue, create_pr, comment_*)"),
+            labels: z.array(z.string()).optional().describe("Labels (for create_issue)"),
+            assignees: z.array(z.string()).optional().describe("Assignees (for create_issue)"),
+            number: z.number().optional().describe("Issue or PR number (for view, comment, close)"),
+            base: z.string().optional().describe("Base branch (for create_pr)"),
+            head: z.string().optional().describe("Head branch (for create_pr)"),
+            state: z.enum(["open", "closed", "all"]).optional().describe("Filter by state (for list_*)"),
+            limit: z.number().optional().describe("Max results (for list_*, default 10)"),
+        }),
+        handler: async ({ action, repo, title, body, labels, assignees, number, base, head, state, limit }) => {
+            console.error(`[io] github tool called: ${action} on ${repo}`);
+            try {
+                let cmd;
+                const r = `--repo ${repo}`;
+                switch (action) {
+                    case "create_issue": {
+                        if (!title)
+                            return "Error: title is required for create_issue";
+                        cmd = `gh issue create ${r} --title "${title.replace(/"/g, '\\"')}"`;
+                        if (body)
+                            cmd += ` --body "${body.replace(/"/g, '\\"')}"`;
+                        if (labels?.length)
+                            cmd += ` --label "${labels.join(",")}"`;
+                        if (assignees?.length)
+                            cmd += ` --assignee "${assignees.join(",")}"`;
+                        break;
+                    }
+                    case "list_issues": {
+                        cmd = `gh issue list ${r} --limit ${limit ?? 10}`;
+                        if (state)
+                            cmd += ` --state ${state}`;
+                        break;
+                    }
+                    case "view_issue": {
+                        if (!number)
+                            return "Error: number is required for view_issue";
+                        cmd = `gh issue view ${number} ${r}`;
+                        break;
+                    }
+                    case "comment_issue": {
+                        if (!number)
+                            return "Error: number is required for comment_issue";
+                        if (!body)
+                            return "Error: body is required for comment_issue";
+                        cmd = `gh issue comment ${number} ${r} --body "${body.replace(/"/g, '\\"')}"`;
+                        break;
+                    }
+                    case "close_issue": {
+                        if (!number)
+                            return "Error: number is required for close_issue";
+                        cmd = `gh issue close ${number} ${r}`;
+                        break;
+                    }
+                    case "create_pr": {
+                        if (!title)
+                            return "Error: title is required for create_pr";
+                        cmd = `gh pr create ${r} --title "${title.replace(/"/g, '\\"')}"`;
+                        if (body)
+                            cmd += ` --body "${body.replace(/"/g, '\\"')}"`;
+                        if (base)
+                            cmd += ` --base ${base}`;
+                        if (head)
+                            cmd += ` --head ${head}`;
+                        break;
+                    }
+                    case "list_prs": {
+                        cmd = `gh pr list ${r} --limit ${limit ?? 10}`;
+                        if (state)
+                            cmd += ` --state ${state}`;
+                        break;
+                    }
+                    case "view_pr": {
+                        if (!number)
+                            return "Error: number is required for view_pr";
+                        cmd = `gh pr view ${number} ${r}`;
+                        break;
+                    }
+                    case "comment_pr": {
+                        if (!number)
+                            return "Error: number is required for comment_pr";
+                        if (!body)
+                            return "Error: body is required for comment_pr";
+                        cmd = `gh pr comment ${number} ${r} --body "${body.replace(/"/g, '\\"')}"`;
+                        break;
+                    }
+                    default:
+                        return `Unknown action: ${action}`;
+                }
+                const result = execSync(cmd, {
+                    encoding: "utf-8",
+                    timeout: 30_000,
+                    maxBuffer: 1024 * 1024,
+                    env: shellEnv(),
+                }).trim();
+                if (result.length > 8000) {
+                    return result.slice(0, 8000) + "\n\n[…truncated]";
+                }
+                return result || "(success, no output)";
+            }
+            catch (err) {
+                const execErr = err;
+                const msg = execErr.stderr?.trim() || execErr.stdout?.trim() || execErr.message || "Command failed";
+                return `Error: ${msg.length > 4000 ? msg.slice(0, 4000) + "\n[…truncated]" : msg}`;
+            }
+        },
+    });
+    return [wikiRead, wikiWrite, wikiSearch, squadCreate, squadRecall, squadStatus, squadLogDecision, shell, fileOps, bash, readFile, viewTool, grepTool, strReplaceEditor, github];
 }
 function walkDirectory(dir, maxDepth = 3, depth = 0) {
     if (depth >= maxDepth)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "heyio",
-  "version": "0.1.17",
+  "version": "0.1.19",
   "description": "IO — a personal AI assistant built on the GitHub Copilot SDK",
   "bin": {
     "io": "dist/index.js"