cortex-agents 2.3.0 → 2.3.1

package/dist/index.js

@@ -6,7 +6,7 @@ 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
+// ─── Agent Descriptions (for handover toasts) ───────────────────────────────
 const AGENT_DESCRIPTIONS = {
     build: "Development mode — ready to implement",
     plan: "Planning mode — read-only analysis",
@@ -16,6 +16,95 @@ const AGENT_DESCRIPTIONS = {
     security: "Security subagent — vulnerability audit",
     devops: "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),
+    },
+};
+// ─── 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: {
@@ -50,9 +139,49 @@ export const CortexPlugin = async (ctx) => {
             // Task tools - finalize workflow (commit, push, PR)
             task_finalize: task.finalize,
         },
-        // 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 +196,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,11 @@ 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 ["build", "plan", "debug", "review"];
 /** Subagents receive a fast/cost-effective model */
 export declare const SUBAGENTS: readonly ["fullstack", "testing", "security", "devops"];
 /** All agent names combined */
-export declare const ALL_AGENTS: readonly ["build", "plan", "debug", "fullstack", "testing", "security", "devops"];
+export declare const ALL_AGENTS: readonly ["build", "plan", "debug", "review", "fullstack", "testing", "security", "devops"];
 /**
  * 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,+CAAgD,CAAC;AAE5E,oDAAoD;AACpD,eAAO,MAAM,SAAS,yDAA0D,CAAC;AAEjF,+BAA+B;AAC/B,eAAO,MAAM,UAAU,6FAA6C,CAAC;AAErE;;;GAGG;AACH,wBAAgB,iBAAiB;;;;IAMhC;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,cAAc,EAAE,MAAM;;;;IAcxD"}

package/dist/registry.js

@@ -105,7 +105,7 @@ export const MODEL_REGISTRY = [
     },
 ];
 /** Primary agents receive the best available model */
-export const PRIMARY_AGENTS = ["build", "plan", "debug"];
+export const PRIMARY_AGENTS = ["build", "plan", "debug", "review"];
 /** Subagents receive a fast/cost-effective model */
 export const SUBAGENTS = ["fullstack", "testing", "security", "devops"];
 /** All agent names combined */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "cortex-agents",
-  "version": "2.3.0",
+  "version": "2.3.1",
   "description": "Supercharge OpenCode with structured workflows, intelligent agents, and automated development practices",
   "type": "module",
   "main": "dist/index.js",