cortex-agents 4.1.2 → 5.0.1

package/dist/tools/engine.js

@@ -0,0 +1,56 @@
+// ---------------------------------------------------------------------------
+// Engine-backed MCP tools: cortex_get_skill, cortex_list_agents
+// ---------------------------------------------------------------------------
+import { tool } from "@opencode-ai/plugin";
+import { CortexEngine } from "../engine/index.js";
+let _engine = null;
+function getEngine() {
+    if (!_engine) {
+        _engine = new CortexEngine();
+        _engine.initialize();
+    }
+    return _engine;
+}
+export const getSkill = tool({
+    description: "Retrieve the full content of a domain skill by ID. Returns the skill markdown including guidelines, patterns, and best practices.",
+    args: {
+        skillId: tool.schema
+            .string()
+            .describe('The skill identifier, e.g. "security-hardening", "api-design"'),
+    },
+    async execute(args) {
+        const engine = getEngine();
+        const content = engine.getSkillContent(args.skillId);
+        if (!content) {
+            const skills = engine.listSkills();
+            const available = skills.map((s) => s.id).join(", ");
+            return `✗ Skill not found: ${args.skillId}\n\nAvailable skills: ${available}`;
+        }
+        return content;
+    },
+});
+export const listAgents = tool({
+    description: "List all registered agents with their mode (primary/subagent), description, and available tools.",
+    args: {
+        mode: tool.schema
+            .enum(["primary", "subagent"])
+            .optional()
+            .describe("Filter by agent mode"),
+    },
+    async execute(args) {
+        const engine = getEngine();
+        const filter = args.mode ? { mode: args.mode } : undefined;
+        const agents = engine.listAgents(filter);
+        if (agents.length === 0) {
+            return "✗ No agents found in the database. Run 'npx cortex-agents install' first.";
+        }
+        const lines = agents.map((a) => {
+            const tools = engine.getAgentTools(a.id);
+            const enabledTools = tools
+                .filter((t) => t.allowed)
+                .map((t) => t.tool_name);
+            return `- **${a.id}** (${a.mode}) — ${a.description}\n  Tools: ${enabledTools.join(", ") || "none"}`;
+        });
+        return `✓ ${agents.length} agents:\n\n${lines.join("\n\n")}`;
+    },
+});

package/dist/tools/plan.d.ts

@@ -8,9 +8,9 @@ export declare const save: {
             refactor: "refactor";
             feature: "feature";
             bugfix: "bugfix";
+            architecture: "architecture";
             spike: "spike";
             docs: "docs";
-            architecture: "architecture";
         }>;
         content: import("zod").ZodString;
         tasks: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodString>>;
@@ -18,7 +18,7 @@ export declare const save: {
     };
     execute(args: {
         title: string;
-        type: "refactor" | "feature" | "bugfix" | "spike" | "docs" | "architecture";
+        type: "refactor" | "feature" | "bugfix" | "architecture" | "spike" | "docs";
         content: string;
         tasks?: string[] | undefined;
         branch?: string | undefined;
@@ -31,14 +31,14 @@ export declare const list: {
             refactor: "refactor";
             feature: "feature";
             bugfix: "bugfix";
+            architecture: "architecture";
             spike: "spike";
             docs: "docs";
-            architecture: "architecture";
             all: "all";
         }>>;
     };
     execute(args: {
-        type?: "refactor" | "feature" | "bugfix" | "spike" | "docs" | "architecture" | "all" | undefined;
+        type?: "refactor" | "feature" | "bugfix" | "architecture" | "spike" | "docs" | "all" | undefined;
     }, context: import("@opencode-ai/plugin").ToolContext): Promise<string>;
 };
 export declare const load: {

package/dist/tools/worktree.d.ts

@@ -12,16 +12,16 @@ export declare function createCreate(client: Client): {
             refactor: "refactor";
             feature: "feature";
             bugfix: "bugfix";
-            hotfix: "hotfix";
             spike: "spike";
             docs: "docs";
+            hotfix: "hotfix";
             test: "test";
         }>;
         fromBranch: import("zod").ZodOptional<import("zod").ZodString>;
     };
     execute(args: {
         name: string;
-        type: "refactor" | "feature" | "bugfix" | "hotfix" | "spike" | "docs" | "test";
+        type: "refactor" | "feature" | "bugfix" | "spike" | "docs" | "hotfix" | "test";
         fromBranch?: string | undefined;
     }, context: import("@opencode-ai/plugin").ToolContext): Promise<string>;
 };

package/dist/utils/cortex-code-bridge.d.ts

@@ -0,0 +1,21 @@
+export declare class CortexCodeBridge {
+    private readonly eventUrl;
+    private readonly taskId;
+    private readonly active;
+    private tokensIn;
+    private tokensOut;
+    private costUsd;
+    private sessionStartTime;
+    private started;
+    constructor();
+    get isActive(): boolean;
+    taskStarted(): void;
+    taskFinished(): void;
+    usage(tokensIn: number, tokensOut: number, costUsd: number, model?: string): void;
+    interactionNeeded(reason: string, prompt?: string): void;
+    text(content: string): void;
+    toolCall(id: string, name: string, input?: unknown): void;
+    error(message: string, code?: string, recoverable?: boolean): void;
+    private send;
+}
+//# sourceMappingURL=cortex-code-bridge.d.ts.map

package/dist/utils/cortex-code-bridge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cortex-code-bridge.d.ts","sourceRoot":"","sources":["../../src/utils/cortex-code-bridge.ts"],"names":[],"mappings":"AAgBA,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAqB;IAC9C,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAqB;IAC5C,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAU;IAGjC,OAAO,CAAC,QAAQ,CAAK;IACrB,OAAO,CAAC,SAAS,CAAK;IACtB,OAAO,CAAC,OAAO,CAAK;IAEpB,OAAO,CAAC,gBAAgB,CAAc;IACtC,OAAO,CAAC,OAAO,CAAS;;IAUxB,IAAI,QAAQ,IAAI,OAAO,CAEtB;IAID,WAAW,IAAI,IAAI;IAOnB,YAAY,IAAI,IAAI;IAUpB,KAAK,CAAC,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI;IAYjF,iBAAiB,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI;IAOxD,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAI3B,QAAQ,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,OAAO,GAAG,IAAI;IAQzD,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,OAAO,GAAG,IAAI;IAUlE,OAAO,CAAC,IAAI;CAkBb"}

package/dist/utils/cortex-code-bridge.js

@@ -0,0 +1,104 @@
+// ─── Cortex Code Event Bridge ─────────────────────────────────────────────────
+//
+// When running inside Cortex Code's embedded terminal, the environment provides:
+//   CORTEX_EVENT_URL  — HTTP endpoint for structured events
+//   CORTEX_TASK_ID    — ID of the parent task in Cortex Code
+//   CORTEX_CODE       — "1" when running inside Cortex Code
+//
+// This bridge POSTs structured events so Cortex Code can precisely track agent
+// state (working, waiting, finished) instead of relying on ANSI heuristics.
+//
+// Payload format (Cortex Event Protocol):
+//   { cortex: "event", taskId, type, timestamp, ...fields }
+//
+// All HTTP calls are fire-and-forget with a 5s timeout — they never block the
+// agent or throw errors.
+export class CortexCodeBridge {
+    eventUrl;
+    taskId;
+    active;
+    // Accumulated usage for task_finished summary
+    tokensIn = 0;
+    tokensOut = 0;
+    costUsd = 0;
+    sessionStartTime = Date.now();
+    started = false;
+    constructor() {
+        this.eventUrl = process.env.CORTEX_EVENT_URL;
+        this.taskId = process.env.CORTEX_TASK_ID;
+        const cortexCode = process.env.CORTEX_CODE;
+        this.active = !!(this.eventUrl && this.taskId && cortexCode);
+    }
+    get isActive() {
+        return this.active;
+    }
+    // ── Event Senders ─────────────────────────────────────────────────────────
+    taskStarted() {
+        if (this.started)
+            return;
+        this.started = true;
+        this.sessionStartTime = Date.now();
+        this.send("task_started", {});
+    }
+    taskFinished() {
+        const duration = Date.now() - this.sessionStartTime;
+        this.send("task_finished", {
+            tokensIn: this.tokensIn,
+            tokensOut: this.tokensOut,
+            costUsd: this.costUsd,
+            duration,
+        });
+    }
+    usage(tokensIn, tokensOut, costUsd, model) {
+        this.tokensIn += tokensIn;
+        this.tokensOut += tokensOut;
+        this.costUsd += costUsd;
+        this.send("usage", {
+            tokensIn,
+            tokensOut,
+            costUsd,
+            ...(model ? { model } : {}),
+        });
+    }
+    interactionNeeded(reason, prompt) {
+        this.send("interaction_needed", {
+            reason,
+            ...(prompt ? { prompt } : {}),
+        });
+    }
+    text(content) {
+        this.send("text", { content });
+    }
+    toolCall(id, name, input) {
+        this.send("tool_call", {
+            id,
+            name,
+            ...(input !== undefined ? { input } : {}),
+        });
+    }
+    error(message, code, recoverable) {
+        this.send("error", {
+            message,
+            ...(code ? { code } : {}),
+            ...(recoverable !== undefined ? { recoverable } : {}),
+        });
+    }
+    // ── Internal ──────────────────────────────────────────────────────────────
+    send(type, fields) {
+        if (!this.active)
+            return;
+        const payload = {
+            cortex: "event",
+            taskId: this.taskId,
+            type,
+            timestamp: Date.now(),
+            ...fields,
+        };
+        fetch(this.eventUrl, {
+            method: "POST",
+            headers: { "Content-Type": "application/json" },
+            body: JSON.stringify(payload),
+            signal: AbortSignal.timeout(5000),
+        }).catch(() => { });
+    }
+}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "cortex-agents",
-  "version": "4.1.2",
-  "description": "Supercharge OpenCode with structured workflows, intelligent agents, and automated development practices",
+  "version": "5.0.1",
+  "description": "Structured AI development workflows for OpenCode and Claude Code — plan, build, ship with discipline",
   "type": "module",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -55,12 +55,15 @@
   },
   "devDependencies": {
     "@opencode-ai/plugin": "^1.0.0",
+    "@types/better-sqlite3": "^7.6.13",
     "@types/node": "^20.0.0",
     "@types/prompts": "^2.4.9",
     "typescript": "^5.0.0",
     "vitest": "^3.0.0"
   },
   "dependencies": {
-    "prompts": "^2.4.2"
+    "better-sqlite3": "^12.6.2",
+    "prompts": "^2.4.2",
+    "@modelcontextprotocol/sdk": "^1.0.0"
   }
 }