cortex-agents 2.3.0 → 3.4.0

package/dist/cli.js

@@ -3,8 +3,8 @@ import * as fs from "fs";
 import * as path from "path";
 import { fileURLToPath } from "url";
 import prompts from "prompts";
-import { PRIMARY_AGENTS, SUBAGENTS, ALL_AGENTS, getPrimaryChoices, getSubagentChoices, } from "./registry.js";
-const VERSION = "2.3.0";
+import { PRIMARY_AGENTS, SUBAGENTS, ALL_AGENTS, DISABLED_BUILTIN_AGENTS, STALE_AGENT_FILES, getPrimaryChoices, getSubagentChoices, } from "./registry.js";
+const VERSION = "3.4.0";
 const PLUGIN_NAME = "cortex-agents";
 const __filename = fileURLToPath(import.meta.url);
 const __dirname = path.dirname(__filename);
@@ -138,6 +138,23 @@ function installAgentsAndSkills(targetDir) {
         console.log(`  Installed ${count} skills -> ${skillsDest}`);
     }
 }
+function cleanupStaleAgents(globalDir) {
+    const agentsDir = path.join(globalDir, "agents");
+    if (!fs.existsSync(agentsDir))
+        return;
+    for (const file of STALE_AGENT_FILES) {
+        const filePath = path.join(agentsDir, file);
+        try {
+            if (fs.existsSync(filePath)) {
+                fs.unlinkSync(filePath);
+                console.log(`  Cleaned up stale agent: ${file}`);
+            }
+        }
+        catch (err) {
+            console.warn(`  Warning: Could not remove stale agent ${file}: ${err.message}`);
+        }
+    }
+}
 function removeAgentsAndSkills(targetDir) {
     const agentsSrc = path.join(PACKAGE_OPENCODE_DIR, "agents");
     const skillsSrc = path.join(PACKAGE_OPENCODE_DIR, "skills");
@@ -173,9 +190,15 @@ function install() {
             fs.mkdirSync(globalDir, { recursive: true });
         }
         const globalPath = path.join(globalDir, "opencode.json");
+        const disabledAgents = {};
+        for (const name of DISABLED_BUILTIN_AGENTS) {
+            disabledAgents[name] = { disable: true };
+        }
         const newConfig = {
             $schema: "https://opencode.ai/config.json",
             plugin: [PLUGIN_NAME],
+            default_agent: "architect",
+            agent: disabledAgents,
         };
         writeConfig(globalPath, newConfig);
         console.log(`Created config: ${globalPath}`);
@@ -187,16 +210,26 @@ function install() {
             config.plugin = [];
         if (!config.plugin.includes(PLUGIN_NAME)) {
             config.plugin.push(PLUGIN_NAME);
-            writeConfig(configInfo.path, config);
-            console.log(`Added plugin to config: ${configInfo.path}\n`);
         }
-        else {
-            console.log(`Plugin already in config: ${configInfo.path}\n`);
+        // Disable built-in agents that cortex-agents replaces
+        if (!config.agent)
+            config.agent = {};
+        for (const name of DISABLED_BUILTIN_AGENTS) {
+            if (!config.agent[name])
+                config.agent[name] = {};
+            config.agent[name].disable = true;
         }
+        // Set default_agent, clean legacy camelCase key
+        config.default_agent = "architect";
+        delete config.defaultAgent;
+        writeConfig(configInfo.path, config);
+        console.log(`Updated config: ${configInfo.path}\n`);
     }
     // Copy agents and skills into the global opencode config dir
     console.log("Installing agents and skills...");
     installAgentsAndSkills(globalDir);
+    // Clean up stale agent files from previous cortex-agents versions
+    cleanupStaleAgents(globalDir);
     // Sync per-project models if .opencode/models.json exists
     if (hasProjectModelsConfig()) {
         console.log("\nPer-project model config found (.opencode/models.json)");
@@ -233,11 +266,23 @@ function uninstall() {
                 }
             }
         }
+        // Re-enable built-in agents
+        for (const name of DISABLED_BUILTIN_AGENTS) {
+            if (config.agent[name]) {
+                delete config.agent[name].disable;
+                if (Object.keys(config.agent[name]).length === 0) {
+                    delete config.agent[name];
+                }
+            }
+        }
         // Clean up empty agent object
         if (Object.keys(config.agent).length === 0) {
             delete config.agent;
         }
     }
+    // Remove default_agent + clean legacy key
+    delete config.default_agent;
+    delete config.defaultAgent;
     writeConfig(configInfo.path, config);
     // Remove agents and skills
     const globalDir = getGlobalDir();
@@ -276,6 +321,12 @@ async function configure() {
             config.plugin = [];
         config.plugin.push(PLUGIN_NAME);
     }
+    // Set default agent to architect (planning-first workflow)
+    if (!config.default_agent) {
+        config.default_agent = "architect";
+    }
+    // Clean legacy camelCase key
+    delete config.defaultAgent;
     // ── Primary model selection ────────────────────────────────
     const { primary, subagent } = await promptModelSelection();
     // ── Write config ───────────────────────────────────────────
@@ -283,6 +334,14 @@ async function configure() {
         // Per-project: write .opencode/models.json + sync to local opencode.json
         writeProjectModels(primary, subagent);
         syncProjectModelsToConfig();
+        // Ensure default agent is set in local opencode.json
+        const localConfig = readConfig(path.join(process.cwd(), "opencode.json"));
+        if (!localConfig.default_agent) {
+            localConfig.default_agent = "architect";
+        }
+        // Clean legacy camelCase key
+        delete localConfig.defaultAgent;
+        writeConfig(path.join(process.cwd(), "opencode.json"), localConfig);
         const modelsPath = getProjectModelsPath();
         const localConfigPath = path.join(process.cwd(), "opencode.json");
         console.log("━".repeat(50));
@@ -304,6 +363,12 @@ async function configure() {
                 config.agent[name] = {};
             config.agent[name].model = subagent;
         }
+        // Re-assert disable entries for built-in agents
+        for (const name of DISABLED_BUILTIN_AGENTS) {
+            if (!config.agent[name])
+                config.agent[name] = {};
+            config.agent[name].disable = true;
+        }
         const targetPath = configInfo?.path || path.join(getGlobalDir(), "opencode.json");
         writeConfig(targetPath, config);
         console.log("━".repeat(50));
@@ -330,7 +395,7 @@ async function promptModelSelection() {
         description: "provider/model format",
         value: "__custom__",
     });
-    console.log("Primary agents (build, plan, debug) handle complex tasks.\nUse your best available model.\n");
+    console.log("Primary agents (implement, architect, fix, audit) handle complex tasks.\nUse your best available model.\n");
     const { primaryModel } = await prompts({
         type: "select",
         name: "primaryModel",
@@ -364,7 +429,7 @@ async function promptModelSelection() {
         description: "provider/model format",
         value: "__custom__",
     });
-    console.log("Subagents (fullstack, testing, security, devops) handle focused tasks.\nA faster/cheaper model works great here.\n");
+    console.log("Subagents (crosslayer, qa, guard, ship) handle focused tasks.\nA faster/cheaper model works great here.\n");
     const { subagentModel } = await prompts({
         type: "select",
         name: "subagentModel",
@@ -566,18 +631,20 @@ EXAMPLES:
   npx ${PLUGIN_NAME} status                     # Check status
 
 AGENTS:
-  Primary (build, plan, debug):
+  Primary (implement, architect, fix, audit):
     Handle complex tasks — select your best model.
 
-  Subagents (fullstack, testing, security, devops):
+  Subagents (crosslayer, qa, guard, ship):
     Handle focused tasks — a fast/cheap model works great.
 
-TOOLS (23):
+TOOLS (32):
   cortex_init, cortex_status      .cortex directory management
   cortex_configure                Per-project model configuration
   worktree_create, worktree_list  Git worktree management
   worktree_remove, worktree_open
   worktree_launch                 Launch worktree (terminal/PTY/background)
+  detect_environment              Detect IDE/terminal for launch options
+  get_environment_info            Quick environment info for agents
   branch_create, branch_status    Git branch operations
   branch_switch
   plan_save, plan_list            Plan persistence
@@ -587,13 +654,17 @@ TOOLS (23):
   docs_init, docs_save            Mermaid documentation
   docs_list, docs_index
   task_finalize                   Commit, push, and create PR
+  github_status, github_issues    GitHub issue and project browsing
+  github_projects
+  repl_init, repl_status          Iterative task-by-task implementation loop
+  repl_report, repl_summary
 
 SKILLS (14):
-  web-development, frontend-development, backend-development,
-  mobile-development, desktop-development, database-design,
-  api-design, architecture-patterns, design-patterns,
-  testing-strategies, security-hardening, deployment-automation,
-  performance-optimization, code-quality, git-workflow
+  frontend-development, backend-development, mobile-development,
+  desktop-development, database-design, api-design,
+  architecture-patterns, design-patterns, testing-strategies,
+  security-hardening, deployment-automation, performance-optimization,
+  code-quality, git-workflow
 `);
 }
 // ─── CLI Entry Point ─────────────────────────────────────────────────────────

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAsBlD,eAAO,MAAM,YAAY,EAAE,MAmE1B,CAAC;AAGF,eAAe,YAAY,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAiLlD,eAAO,MAAM,YAAY,EAAE,MAsK1B,CAAC;AAGF,eAAe,YAAY,CAAC"}

package/dist/index.js

@@ -6,16 +6,133 @@ import * as plan from "./tools/plan";
 import * as session from "./tools/session";
 import * as docs from "./tools/docs";
 import * as task from "./tools/task";
-// Agent descriptions for handover toast notifications
+import * as environment from "./tools/environment";
+import * as github from "./tools/github";
+import * as repl from "./tools/repl";
+// ─── Agent Descriptions (for handover toasts) ───────────────────────────────
 const AGENT_DESCRIPTIONS = {
-    build: "Development mode — ready to implement",
-    plan: "Planning mode — read-only analysis",
-    debug: "Debug mode — troubleshooting and fixes",
-    fullstack: "Fullstack subagent — end-to-end implementation",
-    testing: "Testing subagent — writing tests",
-    security: "Security subagent — vulnerability audit",
-    devops: "DevOps subagent — CI/CD and deployment",
+    implement: "Development mode — ready to implement",
+    architect: "Planning mode — read-only analysis",
+    fix: "Debug mode — troubleshooting and fixes",
+    audit: "Review mode — code quality assessment",
+    crosslayer: "Crosslayer subagent — end-to-end implementation",
+    qa: "QA subagent — writing tests",
+    guard: "Security subagent — vulnerability audit",
+    ship: "DevOps subagent — CI/CD and deployment",
 };
+const TOOL_NOTIFICATIONS = {
+    task_finalize: {
+        successTitle: "Task Finalized",
+        successMsg: (args) => `Committed & pushed: ${(args.commitMessage ?? "").substring(0, 50)}`,
+        errorTitle: "Finalization Failed",
+        errorMsg: (_, out) => out
+            .replace(/^✗\s*/, "")
+            .split("\n")[0]
+            .substring(0, 100),
+        successDuration: 5000,
+        errorDuration: 10000,
+    },
+    plan_save: {
+        successTitle: "Plan Saved",
+        successMsg: (args) => args.title ?? "Plan saved",
+        errorTitle: "Plan Save Failed",
+        errorMsg: (_, out) => out.substring(0, 100),
+    },
+    plan_delete: {
+        successTitle: "Plan Deleted",
+        successMsg: (args) => args.filename ?? "Plan deleted",
+        errorTitle: "Plan Delete Failed",
+        errorMsg: (_, out) => out.substring(0, 100),
+    },
+    session_save: {
+        successTitle: "Session Saved",
+        successMsg: () => "Session summary recorded",
+        errorTitle: "Session Save Failed",
+        errorMsg: (_, out) => out.substring(0, 100),
+    },
+    docs_save: {
+        successTitle: "Documentation Saved",
+        successMsg: (args) => `${args.type ?? "doc"}: ${args.title ?? "Untitled"}`,
+        errorTitle: "Doc Save Failed",
+        errorMsg: (_, out) => out.substring(0, 100),
+    },
+    docs_init: {
+        successTitle: "Docs Initialized",
+        successMsg: () => "Documentation directory created",
+        errorTitle: "Docs Init Failed",
+        errorMsg: (_, out) => out.substring(0, 100),
+    },
+    cortex_init: {
+        successTitle: "Project Initialized",
+        successMsg: () => ".cortex directory created",
+        errorTitle: "Init Failed",
+        errorMsg: (_, out) => out.substring(0, 100),
+    },
+    cortex_configure: {
+        successTitle: "Models Configured",
+        successMsg: (args) => `Primary: ${args.primaryModel?.split("/").pop() || "set"}`,
+        errorTitle: "Configure Failed",
+        errorMsg: (_, out) => out.substring(0, 100),
+    },
+    branch_switch: {
+        successTitle: "Branch Switched",
+        successMsg: (args) => `Now on ${args.branch ?? "branch"}`,
+        errorTitle: "Branch Switch Failed",
+        errorMsg: (_, out) => out
+            .replace(/^✗\s*/, "")
+            .split("\n")[0]
+            .substring(0, 100),
+    },
+    github_status: {
+        successTitle: "GitHub Connected",
+        successMsg: (_args, output) => {
+            const repoMatch = output.match(/Repository:\s+(.+)/);
+            return repoMatch ? `Connected to ${repoMatch[1].substring(0, 100)}` : "GitHub CLI available";
+        },
+        errorTitle: "GitHub Not Available",
+        errorMsg: (_, out) => out
+            .replace(/^✗\s*/, "")
+            .split("\n")[0]
+            .substring(0, 100),
+    },
+    repl_init: {
+        successTitle: "REPL Loop Started",
+        successMsg: (args) => `${(args.planFilename ?? "Plan").split("/").pop()?.substring(0, 40)} — tasks loaded`,
+        errorTitle: "REPL Init Failed",
+        errorMsg: (_, out) => out.substring(0, 100),
+    },
+    repl_report: {
+        successTitle: "Task Update",
+        successMsg: (args) => `Result: ${args.result ?? "reported"}`,
+        errorTitle: "Report Failed",
+        errorMsg: (_, out) => out.substring(0, 100),
+    },
+};
+// ─── Error Message Extraction ────────────────────────────────────────────────
+//
+// Extracts a human-readable message from the session error union type
+// (ProviderAuthError | UnknownError | MessageOutputLengthError |
+//  MessageAbortedError | ApiError).
+function extractErrorMessage(error) {
+    if (!error)
+        return "An unknown error occurred";
+    const msg = typeof error.data?.message === "string" ? error.data.message : "";
+    switch (error.name) {
+        case "ProviderAuthError":
+            return `Auth error: ${msg || "Provider authentication failed"}`;
+        case "UnknownError":
+            return msg || "An unknown error occurred";
+        case "MessageOutputLengthError":
+            return "Output length exceeded — try compacting the session";
+        case "MessageAbortedError":
+            return `Aborted: ${msg || "Message was aborted"}`;
+        case "APIError":
+            return `API error: ${msg || "Request failed"}`;
+        default:
+            return `Error: ${error.name}`;
+    }
+}
+// ─── Plugin Entry ────────────────────────────────────────────────────────────
 export const CortexPlugin = async (ctx) => {
     return {
         tool: {
@@ -49,10 +166,62 @@ export const CortexPlugin = async (ctx) => {
             docs_index: docs.index,
             // Task tools - finalize workflow (commit, push, PR)
             task_finalize: task.finalize,
+            // Environment tools - IDE/terminal detection for contextual options
+            detect_environment: environment.detectEnvironment,
+            get_environment_info: environment.getEnvironmentInfo,
+            // GitHub integration tools - work item listing, issue selection, project boards
+            github_status: github.status,
+            github_issues: github.issues,
+            github_projects: github.projects,
+            // REPL loop tools - iterative task-by-task implementation
+            repl_init: repl.init,
+            repl_status: repl.status,
+            repl_report: repl.report,
+            repl_summary: repl.summary,
         },
-        // Agent handover toast notifications
+        // ── Post-execution toast notifications ────────────────────────────────
+        //
+        // Fires after every tool execution. Uses the TOOL_NOTIFICATIONS map
+        // to determine which tools get toasts and what content to display.
+        // Tools with existing factory-based toasts are excluded from the map.
+        "tool.execute.after": async (input, output) => {
+            const config = TOOL_NOTIFICATIONS[input.tool];
+            if (!config)
+                return; // No notification configured for this tool
+            try {
+                const result = output.output;
+                const isSuccess = result.startsWith("✓");
+                const isError = result.startsWith("✗");
+                if (isSuccess) {
+                    await ctx.client.tui.showToast({
+                        body: {
+                            title: config.successTitle,
+                            message: config.successMsg(input.args, result),
+                            variant: "success",
+                            duration: config.successDuration ?? 4000,
+                        },
+                    });
+                }
+                else if (isError) {
+                    await ctx.client.tui.showToast({
+                        body: {
+                            title: config.errorTitle,
+                            message: config.errorMsg(input.args, result),
+                            variant: "error",
+                            duration: config.errorDuration ?? 8000,
+                        },
+                    });
+                }
+                // Informational or warning outputs (⚠) — no toast to avoid noise
+            }
+            catch {
+                // Toast failure is non-fatal
+            }
+        },
+        // ── Event-driven notifications ───────────────────────────────────────
         async event({ event }) {
             try {
+                // Agent handover notifications
                 if (event.type === "message.part.updated" &&
                     "part" in event.properties &&
                     event.properties.part.type === "agent") {
@@ -67,6 +236,43 @@ export const CortexPlugin = async (ctx) => {
                         },
                     });
                 }
+                // Session error notifications
+                if (event.type === "session.error") {
+                    const rawError = event.properties.error;
+                    // Runtime validation before cast — ensure error has expected shape
+                    const error = rawError &&
+                        typeof rawError === "object" &&
+                        "name" in rawError &&
+                        typeof rawError.name === "string"
+                        ? rawError
+                        : undefined;
+                    const message = extractErrorMessage(error);
+                    await ctx.client.tui.showToast({
+                        body: {
+                            title: "Session Error",
+                            message,
+                            variant: "error",
+                            duration: 10000,
+                        },
+                    });
+                }
+                // PTY exited notifications (relevant for worktree terminal sessions)
+                if (event.type === "pty.exited") {
+                    const rawExitCode = event.properties.exitCode;
+                    const exitCode = typeof rawExitCode === "number" && Number.isInteger(rawExitCode)
+                        ? rawExitCode
+                        : -1;
+                    await ctx.client.tui.showToast({
+                        body: {
+                            title: "Terminal Exited",
+                            message: exitCode === 0
+                                ? "Terminal session completed successfully"
+                                : `Terminal exited with code ${exitCode}`,
+                            variant: exitCode === 0 ? "success" : "warning",
+                            duration: exitCode === 0 ? 4000 : 8000,
+                        },
+                    });
+                }
             }
             catch {
                 // Toast failure is non-fatal — silently ignore

package/dist/registry.d.ts

@@ -19,11 +19,16 @@ export interface ModelEntry {
 }
 export declare const MODEL_REGISTRY: ModelEntry[];
 /** Primary agents receive the best available model */
-export declare const PRIMARY_AGENTS: readonly ["build", "plan", "debug"];
+export declare const PRIMARY_AGENTS: readonly ["implement", "architect", "fix", "audit"];
 /** Subagents receive a fast/cost-effective model */
-export declare const SUBAGENTS: readonly ["fullstack", "testing", "security", "devops"];
+export declare const SUBAGENTS: readonly ["crosslayer", "qa", "guard", "ship"];
 /** All agent names combined */
-export declare const ALL_AGENTS: readonly ["build", "plan", "debug", "fullstack", "testing", "security", "devops"];
+export declare const ALL_AGENTS: readonly ["implement", "architect", "fix", "audit", "crosslayer", "qa", "guard", "ship"];
+/** OpenCode built-in agents disabled when cortex-agents is installed.
+ *  Replaced by cortex equivalents: build → implement, plan → architect */
+export declare const DISABLED_BUILTIN_AGENTS: readonly ["build", "plan"];
+/** Old agent files to clean up from previous cortex-agents versions */
+export declare const STALE_AGENT_FILES: readonly ["build.md", "plan.md", "debug.md", "review.md", "fullstack.md", "testing.md", "security.md", "devops.md"];
 /**
  * Build the interactive choices list for primary model selection.
  * Shows premium and standard tier models (excluding fast).

package/dist/registry.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../src/registry.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,MAAM,WAAW,UAAU;IACzB,uDAAuD;IACvD,EAAE,EAAE,MAAM,CAAC;IACX,kCAAkC;IAClC,IAAI,EAAE,MAAM,CAAC;IACb,4BAA4B;IAC5B,QAAQ,EAAE,MAAM,CAAC;IACjB,2CAA2C;IAC3C,IAAI,EAAE,SAAS,GAAG,UAAU,GAAG,MAAM,CAAC;IACtC,oDAAoD;IACpD,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,eAAO,MAAM,cAAc,EAAE,UAAU,EAuGtC,CAAC;AAEF,sDAAsD;AACtD,eAAO,MAAM,cAAc,qCAAsC,CAAC;AAElE,oDAAoD;AACpD,eAAO,MAAM,SAAS,yDAA0D,CAAC;AAEjF,+BAA+B;AAC/B,eAAO,MAAM,UAAU,mFAA6C,CAAC;AAErE;;;GAGG;AACH,wBAAgB,iBAAiB;;;;IAMhC;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,cAAc,EAAE,MAAM;;;;IAcxD"}
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../src/registry.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,MAAM,WAAW,UAAU;IACzB,uDAAuD;IACvD,EAAE,EAAE,MAAM,CAAC;IACX,kCAAkC;IAClC,IAAI,EAAE,MAAM,CAAC;IACb,4BAA4B;IAC5B,QAAQ,EAAE,MAAM,CAAC;IACjB,2CAA2C;IAC3C,IAAI,EAAE,SAAS,GAAG,UAAU,GAAG,MAAM,CAAC;IACtC,oDAAoD;IACpD,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,eAAO,MAAM,cAAc,EAAE,UAAU,EAuGtC,CAAC;AAEF,sDAAsD;AACtD,eAAO,MAAM,cAAc,qDAAsD,CAAC;AAElF,oDAAoD;AACpD,eAAO,MAAM,SAAS,gDAAiD,CAAC;AAExE,+BAA+B;AAC/B,eAAO,MAAM,UAAU,0FAA6C,CAAC;AAErE;0EAC0E;AAC1E,eAAO,MAAM,uBAAuB,4BAA6B,CAAC;AAElE,uEAAuE;AACvE,eAAO,MAAM,iBAAiB,qHASpB,CAAC;AAEX;;;GAGG;AACH,wBAAgB,iBAAiB;;;;IAMhC;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,cAAc,EAAE,MAAM;;;;IAcxD"}

package/dist/registry.js

@@ -105,11 +105,25 @@ export const MODEL_REGISTRY = [
     },
 ];
 /** Primary agents receive the best available model */
-export const PRIMARY_AGENTS = ["build", "plan", "debug"];
+export const PRIMARY_AGENTS = ["implement", "architect", "fix", "audit"];
 /** Subagents receive a fast/cost-effective model */
-export const SUBAGENTS = ["fullstack", "testing", "security", "devops"];
+export const SUBAGENTS = ["crosslayer", "qa", "guard", "ship"];
 /** All agent names combined */
 export const ALL_AGENTS = [...PRIMARY_AGENTS, ...SUBAGENTS];
+/** OpenCode built-in agents disabled when cortex-agents is installed.
+ *  Replaced by cortex equivalents: build → implement, plan → architect */
+export const DISABLED_BUILTIN_AGENTS = ["build", "plan"];
+/** Old agent files to clean up from previous cortex-agents versions */
+export const STALE_AGENT_FILES = [
+    "build.md",
+    "plan.md",
+    "debug.md",
+    "review.md",
+    "fullstack.md",
+    "testing.md",
+    "security.md",
+    "devops.md",
+];
 /**
  * Build the interactive choices list for primary model selection.
  * Shows premium and standard tier models (excluding fast).

package/dist/tools/cortex.d.ts

@@ -12,8 +12,8 @@ export declare const status: {
 /**
  * cortex_configure — Write per-project model configuration to ./opencode.json.
  *
- * Accepts a primary model (for build/plan/debug) and a subagent model
- * (for fullstack/testing/security/devops). Merges into any existing
+ * Accepts a primary model (for implement/architect/fix/audit) and a subagent model
+ * (for crosslayer/qa/guard/ship). Merges into any existing
  * opencode.json at the project root, preserving other settings.
  */
 export declare const configure: {

package/dist/tools/cortex.js

@@ -151,13 +151,13 @@ Plans: ${planCount}`;
 /**
  * cortex_configure — Write per-project model configuration to ./opencode.json.
  *
- * Accepts a primary model (for build/plan/debug) and a subagent model
- * (for fullstack/testing/security/devops). Merges into any existing
+ * Accepts a primary model (for implement/architect/fix/audit) and a subagent model
+ * (for crosslayer/qa/guard/ship). Merges into any existing
  * opencode.json at the project root, preserving other settings.
  */
 export const configure = tool({
     description: "Save per-project model configuration to ./opencode.json. " +
-        "Sets the model for primary agents (build, plan, debug) and subagents (fullstack, testing, security, devops). " +
+        "Sets the model for primary agents (implement, architect, fix, audit) and subagents (crosslayer, qa, guard, ship). " +
         "Available models — Premium: " +
         MODEL_REGISTRY.filter((m) => m.tier === "premium")
             .map((m) => `${m.name} (${m.id})`)
@@ -174,10 +174,10 @@ export const configure = tool({
     args: {
         primaryModel: z
             .string()
-            .describe("Model ID for primary agents (build, plan, debug). Format: provider/model-name"),
+            .describe("Model ID for primary agents (implement, architect, fix, audit). Format: provider/model-name"),
         subagentModel: z
             .string()
-            .describe("Model ID for subagents (fullstack, testing, security, devops). Format: provider/model-name"),
+            .describe("Model ID for subagents (crosslayer, qa, guard, ship). Format: provider/model-name"),
     },
     async execute(args, context) {
         const configPath = path.join(context.worktree, "opencode.json");
@@ -246,10 +246,10 @@ export const configure = tool({
         return `✓ Model configuration saved to:
   ${savedTo}
 
-Primary agents (build, plan, debug):
+Primary agents (implement, architect, fix, audit):
   → ${primaryDisplay} (${args.primaryModel})
 
-Subagents (fullstack, testing, security, devops):
+Subagents (crosslayer, qa, guard, ship):
   → ${subagentDisplay} (${args.subagentModel})
 
 Restart OpenCode to apply changes.`;

package/dist/tools/environment.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Environment Detection Tool
+ *
+ * Provides agents with information about the current development environment
+ * (IDE, terminal, editor) to offer contextually appropriate worktree launch options.
+ *
+ * Uses two detection systems:
+ *   - IDE detection (ide.ts) — for "Open in IDE" options
+ *   - Terminal detection (terminal.ts) — for "Open in terminal tab" options
+ *
+ * The terminal detection uses a multi-strategy chain:
+ *   1. Environment variables (fast, synchronous)
+ *   2. Process-tree walk (finds terminal in parent processes)
+ *   3. Frontmost app detection (macOS only)
+ *   4. User preference (.cortex/config.json)
+ */
+export declare const detectEnvironment: {
+    description: string;
+    args: {};
+    execute(args: Record<string, never>, context: import("@opencode-ai/plugin").ToolContext): Promise<string>;
+};
+/**
+ * Quick environment check tool for agents.
+ * Returns a simplified response for quick decision-making.
+ */
+export declare const getEnvironmentInfo: {
+    description: string;
+    args: {};
+    execute(args: Record<string, never>, context: import("@opencode-ai/plugin").ToolContext): Promise<string>;
+};
+//# sourceMappingURL=environment.d.ts.map

package/dist/tools/environment.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"environment.d.ts","sourceRoot":"","sources":["../../src/tools/environment.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAMH,eAAO,MAAM,iBAAiB;;;;CAgD5B,CAAC;AAEH;;;GAGG;AACH,eAAO,MAAM,kBAAkB;;;;CA4B7B,CAAC"}