heyio 0.1.19 → 0.1.21

package/README.md

@@ -100,21 +100,33 @@ WantedBy=multi-user.target
 
 IO stores its configuration at `~/.io/config.json`. The setup wizard (`io setup`) handles initial configuration, but you can also edit the file directly.
 
-```jsonc
-{
-  // Telegram bot token from @BotFather
-  "telegramBotToken": "123456:ABC-DEF...",
+### Parameters
 
-  // Your Telegram user ID (for authentication)
-  "telegramUserId": 123456789,
+| Parameter | Type | Default | Description |
+| --- | --- | --- | --- |
+| `telegramBotToken` | `string` | — | Telegram bot token from [@BotFather](https://t.me/BotFather) |
+| `authorizedUserId` | `number` | — | Your Telegram user ID (only this user can interact with the bot) |
+| `telegramEnabled` | `boolean` | `false` | Enable the Telegram bot interface |
+| `selfEditEnabled` | `boolean` | `false` | Allow IO to modify its own source code |
+| `defaultModel` | `string` | `"gpt-4.1"` | LLM model for the main orchestrator session |
+| `modelTiers` | `object` | *(see below)* | Per-complexity model preferences for squad agents |
+| `modelTiers.high` | `string[]` | `["claude-opus-4.7", "claude-opus-4.6"]` | Models for complex tasks (architecture, debugging, design) |
+| `modelTiers.medium` | `string[]` | `["claude-sonnet-4.6", "gpt-5.5", "claude-opus-4.5"]` | Models for standard tasks (features, tests, reviews) |
+| `modelTiers.low` | `string[]` | `["claude-haiku-4.5", "gpt-5.4-mini"]` | Models for simple tasks (reads, formatting, lookups) |
+| `apiPort` | `number` | `3170` | Port for the HTTP API server |
 
-  // Enable self-edit mode by default
-  "selfEdit": false,
+Each `modelTiers` list is a ranked preference — IO picks the first available model at startup.
 
-  // Default model for the orchestrator
-  "defaultModel": "claude-sonnet-4.6",
+### Example
 
-  // Model tiers for squad agents (ranked preference lists)
+```jsonc
+{
+  "telegramBotToken": "123456:ABC-DEF...",
+  "authorizedUserId": 123456789,
+  "telegramEnabled": true,
+  "selfEditEnabled": false,
+  "defaultModel": "claude-sonnet-4.6",
+  "apiPort": 3170,
   "modelTiers": {
     "high": ["claude-opus-4.7", "claude-opus-4.6"],
     "medium": ["claude-sonnet-4.6", "gpt-5.5", "claude-opus-4.5"],

package/dist/copilot/orchestrator.js

@@ -2,15 +2,18 @@ import { approveAll, } from "@github/copilot-sdk";
 import { config } from "../config.js";
 import { SESSIONS_DIR } from "../paths.js";
 import { getState, setState, deleteState, logConversation } from "../store/db.js";
-import { clearStaleTasks } from "../store/tasks.js";
-import { getSquad, listSquads, createSquad, logDecision, getDecisionsSummary, updateSquadStatus, } from "../store/squads.js";
-import { readPage, writePage, assertPagePath } from "../wiki/fs.js";
+import { clearStaleTasks, getTask } from "../store/tasks.js";
+import { getSquad, listSquads, createSquad, deleteSquad, logDecision, getDecisionsSummary, updateSquadStatus, } from "../store/squads.js";
+import { readPage, writePage, assertPagePath, deletePage, listPages } from "../wiki/fs.js";
 import { resolveModelTiers } from "./model-router.js";
 import { searchWiki, getWikiSummary } from "../wiki/search.js";
 import { getOrchestratorSystemMessage } from "./system-message.js";
 import { createTools } from "./tools.js";
-import { getSkillDirectories } from "./skills.js";
+import { getSkillDirectories, listSkills, installSkill, removeSkill, searchSkillsRegistry } from "./skills.js";
 import { resetClient } from "./client.js";
+import { delegateToAgent, getActiveAgentTasks } from "./agents.js";
+import { saveConfig } from "../config.js";
+import { checkForUpdate } from "../update.js";
 // ---------------------------------------------------------------------------
 // Constants
 // ---------------------------------------------------------------------------
@@ -40,15 +43,32 @@ function getToolDeps() {
         wikiWrite: writePage,
         wikiSearch: searchWiki,
         wikiAssertPagePath: assertPagePath,
+        wikiDelete: deletePage,
+        wikiList: listPages,
         getSquad: (slug) => {
             const s = getSquad(slug);
             return s ? mapSquad(s) : undefined;
         },
         listSquads: () => listSquads().map(mapSquad),
         createSquad,
+        deleteSquad,
         logDecision,
         getDecisionsSummary,
         updateSquadStatus,
+        delegateToAgent,
+        getTask,
+        getActiveAgentTasks: () => getActiveAgentTasks().map((t) => ({
+            taskId: t.taskId,
+            agentSlug: t.agentSlug,
+            description: t.description,
+            status: t.status,
+        })),
+        listSkills,
+        installSkill,
+        removeSkill,
+        searchSkillsRegistry,
+        saveConfig,
+        checkForUpdate,
     };
 }
 function getSessionConfig() {

package/dist/copilot/system-message.js

@@ -62,6 +62,16 @@ Squads are persistent project teams. When a user works on a codebase:
 3. Recall squad context with \`squad_recall\` before doing project work.
 4. Check squad status with \`squad_status\`.
 
+### Delegating Work
+After planning tasks with the user, **use \`squad_delegate\` to send each task to the squad agent for implementation**. The workflow is:
+1. Plan the work with the user (break into concrete tasks).
+2. Call \`squad_delegate\` for each task — provide detailed instructions including file paths, expected behavior, and acceptance criteria.
+3. The agent works autonomously in the background. You get a task ID immediately.
+4. Use \`squad_task_status\` to check progress and retrieve results.
+5. Report results back to the user.
+
+You can delegate multiple tasks in parallel — each gets its own task ID.
+
 ### Model Selection
 Squad agents are automatically assigned a model based on task complexity:
 - **High complexity** (architecture, refactoring, debugging, design) → most capable model
@@ -76,12 +86,27 @@ The model is selected automatically. Tell the user which model tier was chosen w
 - \`wiki_read\`: Read a page from your knowledge base.
 - \`wiki_write\`: Write or update a page. Use for preferences, project notes, facts.
 - \`wiki_search\`: Search your knowledge base.
+- \`wiki_delete\`: Delete a page from your knowledge base.
+- \`wiki_list\`: List all pages in your knowledge base.
 
 ### Squad Management
 - \`squad_create\`: Create a project squad.
 - \`squad_recall\`: Get a squad's context and decisions.
 - \`squad_status\`: Check squad status.
 - \`squad_log_decision\`: Log a decision for a squad.
+- \`squad_delegate\`: **Delegate a task to a squad agent.** The agent works autonomously in the background. Returns a task ID.
+- \`squad_task_status\`: Check the status/result of a delegated task, or list all active tasks.
+- \`squad_delete\`: Delete a squad and all its decisions permanently.
+
+### Skills
+- \`skill_list\`: List all installed skills.
+- \`skill_install\`: Install a skill from a git repository URL.
+- \`skill_remove\`: Remove an installed skill by slug.
+- \`skill_search\`: Search the skills.sh registry for available skills.
+
+### Configuration
+- \`config_update\`: Update IO's configuration (defaultModel, telegramEnabled, selfEditEnabled, apiPort).
+- \`check_update\`: Check if a newer version of IO is available.
 
 ### 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.**

package/dist/copilot/tools.js

@@ -121,6 +121,212 @@ export function createTools(deps) {
             }
         },
     });
+    const squadDelegate = defineTool("squad_delegate", {
+        description: "Delegate a task to a squad agent for autonomous execution. The agent runs in the background and you get a task ID immediately. Use squad_task_status to check progress. Use this after planning work with the user to send each task to the squad for implementation.",
+        skipPermission: true,
+        parameters: z.object({
+            slug: z.string().describe("Squad slug to delegate to"),
+            task: z
+                .string()
+                .describe("Detailed task description. Be specific — include file paths, expected behavior, acceptance criteria. The agent works autonomously with this as its only instruction."),
+        }),
+        handler: async ({ slug, task }) => {
+            console.error(`[io] squad_delegate called: ${slug} — ${task.slice(0, 100)}…`);
+            try {
+                const taskId = await deps.delegateToAgent(slug, task, (id, result) => {
+                    console.error(`[io] Agent task ${id} completed for squad ${slug}`);
+                });
+                return `Task delegated to squad "${slug}". Task ID: ${taskId}\n\nThe agent is working on this in the background. Use squad_task_status to check progress.`;
+            }
+            catch (err) {
+                return `Error delegating task: ${err instanceof Error ? err.message : String(err)}`;
+            }
+        },
+    });
+    const squadTaskStatus = defineTool("squad_task_status", {
+        description: "Check the status of a delegated squad task, or list all active tasks. Returns status (running/done/failed) and result when complete.",
+        skipPermission: true,
+        parameters: z.object({
+            task_id: z
+                .string()
+                .optional()
+                .describe("Specific task ID to check. If omitted, lists all active tasks."),
+        }),
+        handler: async ({ task_id }) => {
+            if (task_id) {
+                const task = deps.getTask(task_id);
+                if (!task)
+                    return `Task not found: ${task_id}`;
+                let response = `**Task ${task.task_id}**\nSquad: ${task.agent_slug}\nStatus: ${task.status}\nDescription: ${task.description}`;
+                if (task.result) {
+                    const result = task.result.length > 4000 ? task.result.slice(0, 4000) + "\n[…truncated]" : task.result;
+                    response += `\n\nResult:\n${result}`;
+                }
+                return response;
+            }
+            const tasks = deps.getActiveAgentTasks();
+            if (tasks.length === 0)
+                return "No active tasks.";
+            return tasks
+                .map((t) => `- **${t.taskId}** (${t.agentSlug}) — ${t.status} — ${t.description}`)
+                .join("\n");
+        },
+    });
+    // --- Squad delete ---
+    const squadDelete = defineTool("squad_delete", {
+        description: "Delete a squad and all its decisions. This is permanent.",
+        skipPermission: true,
+        parameters: z.object({
+            slug: z.string().describe("Squad slug to delete"),
+        }),
+        handler: async ({ slug }) => {
+            console.error(`[io] squad_delete called: ${slug}`);
+            try {
+                const squad = deps.getSquad(slug);
+                if (!squad)
+                    return `Squad not found: ${slug}`;
+                deps.deleteSquad(slug);
+                return `Squad "${squad.name}" (${slug}) has been deleted.`;
+            }
+            catch (err) {
+                return `Error: ${err instanceof Error ? err.message : String(err)}`;
+            }
+        },
+    });
+    // --- Skill management ---
+    const skillList = defineTool("skill_list", {
+        description: "List all installed skills with their names, slugs, and descriptions.",
+        skipPermission: true,
+        parameters: z.object({}),
+        handler: async () => {
+            const skills = deps.listSkills();
+            if (skills.length === 0)
+                return "No skills installed.";
+            return skills
+                .map((s) => `- **${s.name}** (\`${s.slug}\`): ${s.description || "(no description)"}`)
+                .join("\n");
+        },
+    });
+    const skillInstall = defineTool("skill_install", {
+        description: "Install a skill from a git repository URL. The repo must contain a SKILL.md file.",
+        skipPermission: true,
+        parameters: z.object({
+            repo_url: z.string().describe("Git repository URL (e.g., https://github.com/user/my-skill.git)"),
+        }),
+        handler: async ({ repo_url }) => {
+            console.error(`[io] skill_install called: ${repo_url}`);
+            try {
+                const skill = await deps.installSkill(repo_url);
+                return `Skill "${skill.name}" installed successfully.\nSlug: ${skill.slug}\nDescription: ${skill.description || "(none)"}`;
+            }
+            catch (err) {
+                return `Error installing skill: ${err instanceof Error ? err.message : String(err)}`;
+            }
+        },
+    });
+    const skillRemove = defineTool("skill_remove", {
+        description: "Remove an installed skill by its slug.",
+        skipPermission: true,
+        parameters: z.object({
+            slug: z.string().describe("Skill slug to remove"),
+        }),
+        handler: async ({ slug }) => {
+            console.error(`[io] skill_remove called: ${slug}`);
+            const removed = deps.removeSkill(slug);
+            return removed ? `Skill "${slug}" removed.` : `Skill not found: ${slug}`;
+        },
+    });
+    const skillSearch = defineTool("skill_search", {
+        description: "Search the skills.sh registry for skills matching a query.",
+        skipPermission: true,
+        parameters: z.object({
+            query: z.string().describe("Search query"),
+        }),
+        handler: async ({ query }) => {
+            console.error(`[io] skill_search called: ${query}`);
+            try {
+                const results = await deps.searchSkillsRegistry(query);
+                if (results.length === 0)
+                    return `No skills found for "${query}".`;
+                return results
+                    .map((r) => `- **${r.name}**: ${r.description}\n  ${r.repoUrl}`)
+                    .join("\n");
+            }
+            catch (err) {
+                return `Error searching registry: ${err instanceof Error ? err.message : String(err)}`;
+            }
+        },
+    });
+    // --- Wiki extras ---
+    const wikiDelete = defineTool("wiki_delete", {
+        description: "Delete a page from IO's knowledge base wiki.",
+        skipPermission: true,
+        parameters: z.object({
+            path: z.string().describe("Relative path to the wiki page (e.g., 'pages/preferences/editor.md')"),
+        }),
+        handler: async ({ path: pagePath }) => {
+            console.error(`[io] wiki_delete called: ${pagePath}`);
+            try {
+                const deleted = deps.wikiDelete(pagePath);
+                return deleted ? `Deleted: ${pagePath}` : `Page not found: ${pagePath}`;
+            }
+            catch (err) {
+                return `Error: ${err instanceof Error ? err.message : String(err)}`;
+            }
+        },
+    });
+    const wikiList = defineTool("wiki_list", {
+        description: "List all pages in IO's knowledge base wiki.",
+        skipPermission: true,
+        parameters: z.object({}),
+        handler: async () => {
+            const pages = deps.wikiList();
+            if (pages.length === 0)
+                return "Wiki is empty — no pages yet.";
+            return pages.map((p) => `- ${p}`).join("\n");
+        },
+    });
+    // --- Config update ---
+    const configUpdate = defineTool("config_update", {
+        description: "Update IO's configuration. Changes are saved to ~/.io/config.json and take effect on restart.",
+        skipPermission: true,
+        parameters: z.object({
+            key: z
+                .enum(["defaultModel", "telegramEnabled", "selfEditEnabled", "apiPort"])
+                .describe("Config key to update"),
+            value: z
+                .union([z.string(), z.number(), z.boolean()])
+                .describe("New value for the config key"),
+        }),
+        handler: async ({ key, value }) => {
+            console.error(`[io] config_update called: ${key} = ${JSON.stringify(value)}`);
+            try {
+                deps.saveConfig({ [key]: value });
+                return `Config updated: ${key} = ${JSON.stringify(value)}\nNote: Some changes require a restart to take effect.`;
+            }
+            catch (err) {
+                return `Error: ${err instanceof Error ? err.message : String(err)}`;
+            }
+        },
+    });
+    // --- Update checker ---
+    const checkUpdate = defineTool("check_update", {
+        description: "Check if a newer version of IO is available.",
+        skipPermission: true,
+        parameters: z.object({}),
+        handler: async () => {
+            try {
+                const info = await deps.checkForUpdate();
+                if (info.updateAvailable) {
+                    return `Update available! Current: v${info.current} → Latest: v${info.latest}\nRun: npm update -g heyio`;
+                }
+                return `IO is up to date (v${info.current}).`;
+            }
+            catch (err) {
+                return `Error checking for updates: ${err instanceof Error ? err.message : String(err)}`;
+            }
+        },
+    });
     const shell = defineTool("shell", {
         description: "Run a shell command on the host machine. You have FULL ROOT ACCESS. Use for git, apt, npm, build tools, system administration, or anything else. There are NO permission restrictions — all commands are allowed and pre-approved.",
         skipPermission: true,
@@ -546,7 +752,7 @@ export function createTools(deps) {
             }
         },
     });
-    return [wikiRead, wikiWrite, wikiSearch, squadCreate, squadRecall, squadStatus, squadLogDecision, shell, fileOps, bash, readFile, viewTool, grepTool, strReplaceEditor, github];
+    return [wikiRead, wikiWrite, wikiSearch, wikiDelete, wikiList, squadCreate, squadRecall, squadStatus, squadLogDecision, squadDelegate, squadTaskStatus, squadDelete, skillList, skillInstall, skillRemove, skillSearch, configUpdate, checkUpdate, 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.19",
+  "version": "0.1.21",
   "description": "IO — a personal AI assistant built on the GitHub Copilot SDK",
   "bin": {
     "io": "dist/index.js"