mcp-subagents-opencode 1.0.0

package/build/utils/sanitize.js

@@ -0,0 +1,89 @@
+import { z } from 'zod';
+import { ALL_ACCEPTED_MODELS } from '../models.js';
+import { TASK_TYPE_IDS } from '../templates/index.js';
+import { TASK_TIMEOUT_DEFAULT_MS, TASK_TIMEOUT_MAX_MS, TASK_TIMEOUT_MIN_MS, } from '../config/timeouts.js';
+// --- Shared field schemas ---
+const sharedTimeoutSchema = z.number().int().min(TASK_TIMEOUT_MIN_MS).max(TASK_TIMEOUT_MAX_MS).default(TASK_TIMEOUT_DEFAULT_MS).optional();
+const sharedModelSchema = z.enum(ALL_ACCEPTED_MODELS).optional();
+const sharedDependsOnSchema = z.array(z.string().min(1)).optional();
+const sharedLabelsSchema = z.array(z.string().min(1).max(50)).max(10).optional();
+const contextFileSchema = z.object({
+    path: z.string().min(1),
+    description: z.string().max(2000).optional(),
+});
+// --- Legacy spawn_task schema (backward compat) ---
+export const SpawnTaskSchema = z.object({
+    prompt: z.string().min(1).max(50000),
+    timeout: sharedTimeoutSchema,
+    cwd: z.string().optional(),
+    model: sharedModelSchema,
+    task_type: z.enum(TASK_TYPE_IDS).optional(),
+    autonomous: z.boolean().default(true).optional(),
+    depends_on: sharedDependsOnSchema,
+    labels: sharedLabelsSchema,
+    context_files: z.array(contextFileSchema).max(20).optional(),
+});
+// --- Coder languages ---
+export const CODER_LANGUAGES = [
+    'typescript', 'python', 'rust', 'go', 'java', 'ruby', 'swift', 'csharp', 'kotlin',
+    'react', 'nextjs', 'vue', 'supabase', 'tauri', 'triggerdev', 'supastarter',
+    'general',
+];
+// --- Planner types ---
+export const PLANNING_TYPES = [
+    'feature', 'bugfix', 'migration', 'refactor', 'architecture',
+];
+// --- Testing types ---
+export const TESTING_TYPES = [
+    'playwright', 'rest', 'graphql', 'suite', 'accessibility', 'performance', 'security', 'general',
+];
+// --- Research types ---
+export const RESEARCH_TYPES = [
+    'security', 'library', 'performance', 'architecture', 'general',
+];
+// --- Per-tool schemas ---
+export const SpawnCoderSchema = z.object({
+    prompt: z.string().min(1).max(100000),
+    context_files: z.array(contextFileSchema).min(1).max(20),
+    language: z.enum(CODER_LANGUAGES).optional(),
+    model: sharedModelSchema,
+    cwd: z.string().optional(),
+    timeout: sharedTimeoutSchema,
+    autonomous: z.boolean().default(true).optional(),
+    depends_on: sharedDependsOnSchema,
+    labels: sharedLabelsSchema,
+});
+export const SpawnPlannerSchema = z.object({
+    prompt: z.string().min(1).max(100000),
+    context_files: z.array(contextFileSchema).max(20).optional(),
+    planning_type: z.enum(PLANNING_TYPES).optional(),
+    model: sharedModelSchema,
+    cwd: z.string().optional(),
+    timeout: sharedTimeoutSchema,
+    autonomous: z.boolean().default(true).optional(),
+    depends_on: sharedDependsOnSchema,
+    labels: sharedLabelsSchema,
+});
+export const SpawnTesterSchema = z.object({
+    prompt: z.string().min(1).max(100000),
+    context_files: z.array(contextFileSchema).min(1).max(20),
+    testing_type: z.enum(TESTING_TYPES).optional(),
+    model: sharedModelSchema,
+    cwd: z.string().optional(),
+    timeout: sharedTimeoutSchema,
+    autonomous: z.boolean().default(true).optional(),
+    depends_on: sharedDependsOnSchema,
+    labels: sharedLabelsSchema,
+});
+export const SpawnResearcherSchema = z.object({
+    prompt: z.string().min(1).max(100000),
+    context_files: z.array(contextFileSchema).max(20).optional(),
+    research_type: z.enum(RESEARCH_TYPES).optional(),
+    model: sharedModelSchema,
+    cwd: z.string().optional(),
+    timeout: sharedTimeoutSchema,
+    autonomous: z.boolean().default(true).optional(),
+    depends_on: sharedDependsOnSchema,
+    labels: sharedLabelsSchema,
+});
+//# sourceMappingURL=sanitize.js.map

package/build/utils/sanitize.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sanitize.js","sourceRoot":"","sources":["../../src/utils/sanitize.ts"],"names":[],"mappings":"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"}

package/build/utils/task-id-generator.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Generates human-readable task IDs like "brave-tiger-42" or "cosmic-falcon-17"
+ * Much easier to remember and communicate than UUIDs or random strings
+ */
+export declare function generateTaskId(): string;
+/**
+ * Normalizes task ID for case-insensitive lookups
+ */
+export declare function normalizeTaskId(taskId: string): string;
+//# sourceMappingURL=task-id-generator.d.ts.map

package/build/utils/task-id-generator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"task-id-generator.d.ts","sourceRoot":"","sources":["../../src/utils/task-id-generator.ts"],"names":[],"mappings":"AAEA;;;GAGG;AACH,wBAAgB,cAAc,IAAI,MAAM,CAWvC;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAEtD"}

package/build/utils/task-id-generator.js

@@ -0,0 +1,22 @@
+import { uniqueNamesGenerator, adjectives, animals } from 'unique-names-generator';
+/**
+ * Generates human-readable task IDs like "brave-tiger-42" or "cosmic-falcon-17"
+ * Much easier to remember and communicate than UUIDs or random strings
+ */
+export function generateTaskId() {
+    const randomNumber = Math.floor(Math.random() * 100);
+    const name = uniqueNamesGenerator({
+        dictionaries: [adjectives, animals],
+        separator: '-',
+        length: 2,
+        style: 'lowerCase',
+    });
+    return `${name}-${randomNumber}`;
+}
+/**
+ * Normalizes task ID for case-insensitive lookups
+ */
+export function normalizeTaskId(taskId) {
+    return taskId.toLowerCase().trim();
+}
+//# sourceMappingURL=task-id-generator.js.map

package/build/utils/task-id-generator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"task-id-generator.js","sourceRoot":"","sources":["../../src/utils/task-id-generator.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,UAAU,EAAE,OAAO,EAAE,MAAM,wBAAwB,CAAC;AAEnF;;;GAGG;AACH,MAAM,UAAU,cAAc;IAC5B,MAAM,YAAY,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,GAAG,CAAC,CAAC;IAErD,MAAM,IAAI,GAAG,oBAAoB,CAAC;QAChC,YAAY,EAAE,CAAC,UAAU,EAAE,OAAO,CAAC;QACnC,SAAS,EAAE,GAAG;QACd,MAAM,EAAE,CAAC;QACT,KAAK,EAAE,WAAW;KACnB,CAAC,CAAC;IAEH,OAAO,GAAG,IAAI,IAAI,YAAY,EAAE,CAAC;AACnC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,eAAe,CAAC,MAAc;IAC5C,OAAO,MAAM,CAAC,WAAW,EAAE,CAAC,IAAI,EAAE,CAAC;AACrC,CAAC"}

package/package.json

@@ -0,0 +1,62 @@
+{
+  "name": "mcp-subagents-opencode",
+  "version": "1.0.0",
+  "description": "MCP server for spawning and managing OpenCode AI sub-agents — parallel task execution with planner, coder, researcher & tester specialists",
+  "type": "module",
+  "main": "build/index.js",
+  "bin": {
+    "mcp-subagents-opencode": "build/index.js"
+  },
+  "files": [
+    "build",
+    "README.md",
+    "LICENSE"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/yigitkonur/mcp-subagents-opencode.git"
+  },
+  "homepage": "https://github.com/yigitkonur/mcp-subagents-opencode#readme",
+  "bugs": {
+    "url": "https://github.com/yigitkonur/mcp-subagents-opencode/issues"
+  },
+  "author": "Yigit Konur <yigit35@gmail.com>",
+  "scripts": {
+    "build": "tsc --noEmitOnError false; cp src/templates/*.mdx build/templates/; mkdir -p build/templates/overlays && cp src/templates/overlays/*.mdx build/templates/overlays/",
+    "prepublishOnly": "npm run build",
+    "dev": "tsx watch src/index.ts",
+    "start": "node build/index.js",
+    "clean": "rm -rf build"
+  },
+  "keywords": [
+    "mcp",
+    "opencode",
+    "agent",
+    "ai",
+    "sub-agents",
+    "model-context-protocol",
+    "claude",
+    "anthropic",
+    "parallel",
+    "autonomous",
+    "coding-agent",
+    "ai-agents"
+  ],
+  "license": "MIT",
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.25.0",
+    "unique-names-generator": "^4.7.1",
+    "zod": "^3.23.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.10.5",
+    "tsx": "^4.19.2",
+    "typescript": "^5.7.2"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}