zenox 0.1.0

package/dist/mcp/exa.d.ts

@@ -0,0 +1,12 @@
+import type { LocalMcpServerConfig } from "./types";
+/**
+ * Exa MCP Server - Web search and code context
+ *
+ * Provides tools:
+ * - exa_web_search_exa: Web search via Exa AI
+ * - exa_get_code_context_exa: Code context for APIs/libraries
+ * - exa_crawling_exa: URL content extraction
+ *
+ * HTTP Streamable via mcp-remote - No API key required!
+ */
+export declare const exa: LocalMcpServerConfig;

package/dist/mcp/grep-app.d.ts

@@ -0,0 +1,10 @@
+import type { RemoteMcpServerConfig } from "./types";
+/**
+ * grep.app MCP Server - GitHub code search
+ *
+ * Provides tools:
+ * - grep_app_searchGitHub: Search real-world code examples from GitHub
+ *
+ * Remote MCP - No API key required!
+ */
+export declare const grep_app: RemoteMcpServerConfig;

package/dist/mcp/index.d.ts

@@ -0,0 +1,10 @@
+import type { McpName } from "./types";
+export { McpNameSchema, type McpName } from "./types";
+export type { McpServerConfig, LocalMcpServerConfig, RemoteMcpServerConfig } from "./types";
+/**
+ * Creates the MCP server configurations, excluding any disabled MCPs
+ *
+ * @param disabledMcps - Array of MCP names to disable
+ * @returns Record of enabled MCP server configurations
+ */
+export declare function createBuiltinMcps(disabledMcps?: McpName[]): Record<string, import("./types").LocalMcpServerConfig | import("./types").RemoteMcpServerConfig>;

package/dist/mcp/sequential-thinking.d.ts

@@ -0,0 +1,13 @@
+import type { LocalMcpServerConfig } from "./types";
+/**
+ * Sequential Thinking MCP Server - Structured reasoning
+ *
+ * Provides tools:
+ * - sequential-thinking_sequentialthinking: Dynamic problem-solving through thoughts
+ *
+ * Useful for:
+ * - Breaking down complex problems
+ * - Multi-step planning with revision capability
+ * - Architecture decisions and analysis
+ */
+export declare const sequentialThinking: LocalMcpServerConfig;

package/dist/mcp/types.d.ts

@@ -0,0 +1,26 @@
+import { z } from "zod";
+/**
+ * MCP Server names that can be configured/disabled
+ */
+export declare const McpNameSchema: z.ZodEnum<["exa", "grep_app", "sequential-thinking"]>;
+export type McpName = z.infer<typeof McpNameSchema>;
+/**
+ * Local MCP server configuration (spawns a process)
+ */
+export interface LocalMcpServerConfig {
+    type: "local";
+    command: string[];
+    enabled: boolean;
+}
+/**
+ * Remote MCP server configuration (connects to URL)
+ */
+export interface RemoteMcpServerConfig {
+    type: "remote";
+    url: string;
+    enabled: boolean;
+}
+/**
+ * Union type for all MCP server configurations
+ */
+export type McpServerConfig = LocalMcpServerConfig | RemoteMcpServerConfig;

package/dist/orchestration/prompt.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Orchestration prompt to inject into Build and Plan agents.
+ * This teaches the primary agents how to delegate to specialized subagents using the Task tool.
+ */
+export declare const ORCHESTRATION_PROMPT = "\n\n---\n\n## Sub-Agent Delegation\n\nYou have specialized subagents. Use the **Task tool** to delegate work proactively.\n\n### Available Agents\n\n| Agent | Use For | subagent_type |\n|-------|---------|---------------|\n| **Explorer** | Codebase search, \"Where is X?\", file discovery, pattern matching | `explorer` |\n| **Librarian** | External docs, library research, OSS examples, GitHub permalinks | `librarian` |\n| **Oracle** | Architecture decisions, debugging strategy, trade-offs, code review | `oracle` |\n| **UI Planner** | Visual design, CSS, animations, UI/UX, beautiful interfaces | `ui-planner` |\n\n### When to Delegate (Fire Immediately)\n\n| Trigger | subagent_type | Why |\n|---------|---------------|-----|\n| \"Where is X?\", \"Find Y\", locate code | `explorer` | Fast codebase search |\n| External library, \"how does X library work?\" | `librarian` | Searches docs, GitHub, OSS |\n| 2+ modules involved, cross-cutting concerns | `explorer` | Multi-file pattern discovery |\n| Architecture decision, \"should I use X or Y?\" | `oracle` | Deep reasoning advisor |\n| Visual/styling, CSS, animations, UI/UX | `ui-planner` | Designer-developer hybrid |\n| After 2+ failed fix attempts | `oracle` | Debugging escalation |\n\n### How to Delegate\n\nUse the Task tool with these parameters:\n\n```\nTask(\n  subagent_type: \"explorer\" | \"librarian\" | \"oracle\" | \"ui-planner\",\n  description: \"Short 3-5 word task description\",\n  prompt: \"Detailed instructions for the agent\"\n)\n```\n\n**Example delegations:**\n\n```\n// Find code in codebase\nTask(\n  subagent_type: \"explorer\",\n  description: \"Find auth middleware\",\n  prompt: \"Find all authentication middleware implementations in this codebase. Return file paths and explain the auth flow.\"\n)\n\n// Research external library\nTask(\n  subagent_type: \"librarian\",\n  description: \"React Query caching docs\",\n  prompt: \"How does React Query handle caching? Find official documentation and real-world examples with GitHub permalinks.\"\n)\n\n// Architecture decision\nTask(\n  subagent_type: \"oracle\",\n  description: \"Redux vs Zustand analysis\",\n  prompt: \"Analyze trade-offs between Redux and Zustand for this project. Consider bundle size, learning curve, and our existing patterns.\"\n)\n\n// UI/Visual work\nTask(\n  subagent_type: \"ui-planner\",\n  description: \"Redesign dashboard cards\",\n  prompt: \"Redesign the dashboard stat cards to be more visually appealing. Use modern aesthetics, subtle animations, and ensure responsive design.\"\n)\n```\n\n### Parallel Execution\n\nTo run multiple agents in parallel, call multiple Task tools in the **same response message**:\n\n```\n// CORRECT: Multiple Task calls in ONE message = parallel execution\nTask(subagent_type: \"explorer\", description: \"Find auth code\", prompt: \"...\")\nTask(subagent_type: \"librarian\", description: \"JWT best practices\", prompt: \"...\")\n// Both run simultaneously\n\n// WRONG: One Task per message = sequential (slow)\nMessage 1: Task(...) \u2192 wait for result\nMessage 2: Task(...) \u2192 wait for result\n```\n\n### Delegation Priority\n\n1. **Explorer FIRST** \u2014 Always locate code before modifying unfamiliar areas\n2. **Librarian** \u2014 When dealing with external libraries/APIs you don't fully understand\n3. **Oracle** \u2014 For complex decisions or after 2+ failed fix attempts\n4. **UI Planner** \u2014 For ANY visual/styling work (never edit CSS/UI yourself)\n\n### Critical Rules\n\n1. **Never touch frontend visual/styling code yourself** \u2014 Always delegate to `ui-planner`\n2. **Fire librarian proactively** when unfamiliar libraries are involved\n3. **Consult oracle BEFORE major architectural decisions**, not after\n4. **Verify delegated work** before marking task complete\n\n### When to Handle Directly (Don't Delegate)\n\n- Single file edits with known location\n- Questions answerable from code already in context\n- Trivial changes requiring no specialist knowledge\n- Tasks you can complete faster than explaining to an agent\n\n---\n\n## Background Tasks (Parallel Research)\n\nFor **independent research tasks** that benefit from parallelism, use background tasks instead of sequential Task calls.\n\n### When to Use Background Tasks\n\n| Scenario | Use Background Tasks |\n|----------|---------------------|\n| User wants \"comprehensive\" / \"thorough\" / \"deep\" exploration | YES - fire 3-4 agents in parallel |\n| Need BOTH codebase search AND external docs | YES - explore + librarian in parallel |\n| Exploring multiple modules/features simultaneously | YES - separate explore for each |\n| Result of Task A needed before Task B | NO - use sequential Task |\n| Single focused lookup | NO - just use Task directly |\n\n### How Background Tasks Work\n\n1. **Fire**: Launch multiple agents with `background_task` - they run in parallel\n2. **Continue**: Keep working while background agents search\n3. **Notify**: You'll be notified when ALL background tasks complete\n4. **Retrieve**: Use `background_output` to get each result\n\n### Usage\n\n```\n// Launch parallel research (all run simultaneously)\nbackground_task(agent=\"explorer\", description=\"Find auth code\", prompt=\"Search for authentication...\")\nbackground_task(agent=\"explorer\", description=\"Find db layer\", prompt=\"Search for database/ORM...\")\nbackground_task(agent=\"librarian\", description=\"Best practices\", prompt=\"Find framework best practices...\")\n\n// Continue working on other things while they run...\n\n// [NOTIFICATION: All background tasks complete!]\n\n// Retrieve results\nbackground_output(task_id=\"bg_abc123\")\nbackground_output(task_id=\"bg_def456\")\nbackground_output(task_id=\"bg_ghi789\")\n```\n\n### Background Tasks vs Task Tool\n\n| Aspect | Task Tool | Background Tasks |\n|--------|-----------|------------------|\n| Execution | Sequential (waits for result) | Parallel (fire-and-forget) |\n| Best for | Dependent tasks, immediate needs | Independent research, breadth |\n| Result | Inline, immediate | Retrieved later via background_output |\n\n### Key Insight\n\n- **Task** = Use when you need the result immediately before proceeding\n- **Background** = Use when researching multiple angles independently\n\n**Both tools coexist - choose based on whether tasks are dependent or independent.**\n";

package/package.json

@@ -0,0 +1,56 @@
+{
+  "name": "zenox",
+  "version": "0.1.0",
+  "description": "OpenCode plugin with specialized agents (explorer, librarian, oracle, ui-planner), background tasks for parallel execution, and smart orchestration",
+  "author": "Ayush",
+  "license": "MIT",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "bun build src/index.ts --outdir dist --target bun --format esm && tsc --emitDeclarationOnly",
+    "clean": "rm -rf dist",
+    "prepublishOnly": "bun run clean && bun run build",
+    "typecheck": "tsc --noEmit"
+  },
+  "keywords": [
+    "zenox",
+    "opencode",
+    "plugin",
+    "agents",
+    "explorer",
+    "librarian",
+    "oracle",
+    "ui-planner",
+    "background-tasks",
+    "parallel",
+    "orchestration",
+    "ai",
+    "llm"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/CYBERBOYAYUSH/zenox.git"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "@opencode-ai/plugin": "^1.1.12",
+    "@opencode-ai/sdk": "^1.1.12",
+    "zod": "^3.24.1"
+  },
+  "devDependencies": {
+    "bun-types": "latest",
+    "typescript": "^5.7.3"
+  }
+}