opencode-multiagent 0.2.1 → 0.3.0-next.1

package/defaults/flags.schema.json

@@ -1,119 +0,0 @@
-{
-  "$schema": "https://json-schema.org/draft/2020-12/schema",
-  "title": "opencode-multiagent flags",
-  "description": "Partial runtime overrides for the OpenCode multi-agent control plane plugin.",
-  "type": "object",
-  "additionalProperties": false,
-  "properties": {
-    "profile": {
-      "type": "string",
-      "enum": ["minimal", "standard", "strict"],
-      "description": "Named runtime profile to use as the base flag set."
-    },
-    "enforcement": {
-      "type": "boolean",
-      "description": "Enable local path and shell safety enforcement hooks."
-    },
-    "observation": {
-      "type": "boolean",
-      "description": "Enable JSONL observation logging for events and tool executions."
-    },
-    "prompt_controls": {
-      "type": "boolean",
-      "description": "Enable prompt metadata headers and risky-input logging."
-    },
-    "agent_compilation": {
-      "type": "boolean",
-      "description": "Compile bundled, global, and project agent markdown into config."
-    },
-    "command_compilation": {
-      "type": "boolean",
-      "description": "Compile bundled, global, and project command markdown into config."
-    },
-    "mcp_compilation": {
-      "type": "boolean",
-      "description": "Inject plugin-managed MCP server defaults when missing from config."
-    },
-    "telemetry": {
-      "type": "boolean",
-      "description": "Enable detailed agent and tool telemetry in the plugin JSONL log."
-    },
-    "supervision": {
-      "type": "boolean",
-      "description": "Enable parent-child idle supervision reminders."
-    },
-    "quality_gate": {
-      "type": "boolean",
-      "description": "Enable quality reminder tracking for edited sessions."
-    },
-    "skill_injection": {
-      "type": "boolean",
-      "description": "Enable dynamic skill registry lookup and prompt injection."
-    },
-    "skill_sources": {
-      "type": "array",
-      "description": "Skill registry search paths. Variables such as ${plugin_root} and ${home} are resolved at runtime.",
-      "items": {
-        "type": "string",
-        "minLength": 1
-      },
-      "minItems": 1
-    },
-    "compiler": {
-      "type": "object",
-      "additionalProperties": false,
-      "properties": {
-        "permission_compilation": {
-          "type": "boolean",
-          "description": "Fill missing top-level OpenCode permission defaults conservatively."
-        }
-      }
-    },
-    "experimental": {
-      "type": "object",
-      "additionalProperties": false,
-      "properties": {
-        "chat_system_transform": {
-          "type": "boolean"
-        },
-        "chat_messages_transform": {
-          "type": "boolean"
-        },
-        "session_compacting": {
-          "type": "boolean"
-        },
-        "text_complete": {
-          "type": "boolean"
-        }
-      }
-    },
-    "supervision_config": {
-      "type": "object",
-      "additionalProperties": false,
-      "properties": {
-        "idle_timeout_ms": {
-          "type": "number",
-          "minimum": 0
-        },
-        "cooldown_ms": {
-          "type": "number",
-          "minimum": 0
-        }
-      }
-    },
-    "quality_config": {
-      "type": "object",
-      "additionalProperties": false,
-      "properties": {
-        "reminder_idle_ms": {
-          "type": "number",
-          "minimum": 0
-        },
-        "reminder_cooldown_ms": {
-          "type": "number",
-          "minimum": 0
-        }
-      }
-    }
-  }
-}

package/defaults/mcp-defaults.json

@@ -1,47 +0,0 @@
-{
-  "code_index": {
-    "type": "local",
-    "command": [
-      "python3",
-      "-m",
-      "code_index_mcp.server"
-    ],
-    "enabled": true
-  },
-  "repo": {
-    "type": "local",
-    "command": [
-      "python3",
-      "-m",
-      "mcp_server_git"
-    ],
-    "enabled": true
-  },
-  "context7": {
-    "type": "remote",
-    "url": "https://mcp.context7.com/mcp",
-    "enabled": false
-  },
-  "exa": {
-    "type": "remote",
-    "url": "https://mcp.exa.ai/mcp",
-    "enabled": false
-  },
-  "gh_grep": {
-    "type": "remote",
-    "url": "https://mcp.grep.app",
-    "enabled": false
-  },
-  "github": {
-    "type": "local",
-    "command": [
-      "npx",
-      "-y",
-      "@modelcontextprotocol/server-github"
-    ],
-    "environment": {
-      "GITHUB_PERSONAL_ACCESS_TOKEN": "{env:GITHUB_PAT_TOKEN}"
-    },
-    "enabled": false
-  }
-}

package/defaults/mcp-defaults.schema.json

@@ -1,38 +0,0 @@
-{
-  "$schema": "https://json-schema.org/draft/2020-12/schema",
-  "title": "opencode-multiagent MCP defaults",
-  "description": "Plugin-managed MCP server definitions that are conservatively injected when missing from the active OpenCode config.",
-  "type": "object",
-  "additionalProperties": {
-    "type": "object",
-    "additionalProperties": false,
-    "properties": {
-      "type": {
-        "type": "string",
-        "enum": ["local", "remote"]
-      },
-      "url": {
-        "type": "string",
-        "minLength": 1
-      },
-      "command": {
-        "type": "array",
-        "items": {
-          "type": "string",
-          "minLength": 1
-        },
-        "minItems": 1
-      },
-      "environment": {
-        "type": "object",
-        "additionalProperties": {
-          "type": "string"
-        }
-      },
-      "enabled": {
-        "type": "boolean"
-      }
-    },
-    "required": ["type", "enabled"]
-  }
-}

package/defaults/profiles.json

@@ -1,53 +0,0 @@
-{
-  "minimal": {
-    "enforcement": true,
-    "observation": false,
-    "prompt_controls": false,
-    "agent_compilation": true,
-    "command_compilation": true,
-    "mcp_compilation": true,
-    "telemetry": false,
-    "supervision": false,
-    "quality_gate": false,
-    "experimental": {
-      "chat_system_transform": false,
-      "chat_messages_transform": false,
-      "session_compacting": false,
-      "text_complete": false
-    }
-  },
-  "standard": {
-    "enforcement": true,
-    "observation": true,
-    "prompt_controls": true,
-    "agent_compilation": true,
-    "command_compilation": true,
-    "mcp_compilation": true,
-    "telemetry": true,
-    "supervision": true,
-    "quality_gate": true,
-    "experimental": {
-      "chat_system_transform": false,
-      "chat_messages_transform": false,
-      "session_compacting": false,
-      "text_complete": false
-    }
-  },
-  "strict": {
-    "enforcement": true,
-    "observation": true,
-    "prompt_controls": true,
-    "agent_compilation": true,
-    "command_compilation": true,
-    "mcp_compilation": true,
-    "telemetry": true,
-    "supervision": true,
-    "quality_gate": true,
-    "experimental": {
-      "chat_system_transform": true,
-      "chat_messages_transform": true,
-      "session_compacting": true,
-      "text_complete": true
-    }
-  }
-}

package/defaults/profiles.schema.json

@@ -1,60 +0,0 @@
-{
-  "$schema": "https://json-schema.org/draft/2020-12/schema",
-  "title": "opencode-multiagent profiles",
-  "description": "Named flag bundles for switching plugin behavior by profile.",
-  "type": "object",
-  "additionalProperties": {
-    "type": "object",
-    "additionalProperties": false,
-    "properties": {
-      "enforcement": { "type": "boolean" },
-      "observation": { "type": "boolean" },
-      "prompt_controls": { "type": "boolean" },
-      "agent_compilation": { "type": "boolean" },
-      "command_compilation": { "type": "boolean" },
-      "mcp_compilation": { "type": "boolean" },
-      "telemetry": { "type": "boolean" },
-      "supervision": { "type": "boolean" },
-      "quality_gate": { "type": "boolean" },
-      "skill_injection": { "type": "boolean" },
-      "skill_sources": {
-        "type": "array",
-        "items": { "type": "string", "minLength": 1 },
-        "minItems": 1
-      },
-      "compiler": {
-        "type": "object",
-        "additionalProperties": false,
-        "properties": {
-          "permission_compilation": { "type": "boolean" }
-        }
-      },
-      "experimental": {
-        "type": "object",
-        "additionalProperties": false,
-        "properties": {
-          "chat_system_transform": { "type": "boolean" },
-          "chat_messages_transform": { "type": "boolean" },
-          "session_compacting": { "type": "boolean" },
-          "text_complete": { "type": "boolean" }
-        }
-      },
-      "supervision_config": {
-        "type": "object",
-        "additionalProperties": false,
-        "properties": {
-          "idle_timeout_ms": { "type": "number", "minimum": 0 },
-          "cooldown_ms": { "type": "number", "minimum": 0 }
-        }
-      },
-      "quality_config": {
-        "type": "object",
-        "additionalProperties": false,
-        "properties": {
-          "reminder_idle_ms": { "type": "number", "minimum": 0 },
-          "reminder_cooldown_ms": { "type": "number", "minimum": 0 }
-        }
-      }
-    }
-  }
-}

package/defaults/team-profiles.json

@@ -1,83 +0,0 @@
-{
-  "standard": {
-    "description": "Full development team: backend, frontend, and QA. Members are spawned on demand by the lead.",
-    "members": [
-      {
-        "name": "backend-dev",
-        "agent": "backend-dev",
-        "role": "Backend developer — API, business logic, database",
-        "auto_spawn": false
-      },
-      {
-        "name": "frontend-dev",
-        "agent": "frontend-dev",
-        "role": "Frontend developer — UI, state management, UX",
-        "auto_spawn": false
-      },
-      {
-        "name": "tester",
-        "agent": "tester",
-        "role": "QA engineer — unit, integration, and E2E tests",
-        "auto_spawn": false
-      }
-    ]
-  },
-  "quick": {
-    "description": "Single general-purpose developer spawned immediately. Good for fast, focused tasks.",
-    "members": [
-      {
-        "name": "dev",
-        "agent": "general-purpose",
-        "role": "Developer — awaits task assignment from the lead",
-        "auto_spawn": true,
-        "initial_prompt": "You are a general-purpose developer on this team. Wait for the lead to assign a task via the team_read_messages tool, then execute it and report back."
-      }
-    ]
-  },
-  "review": {
-    "description": "Code review and security audit team.",
-    "members": [
-      {
-        "name": "reviewer",
-        "agent": "code-reviewer",
-        "role": "Code reviewer — PR review, code smells, standards",
-        "auto_spawn": false
-      },
-      {
-        "name": "security",
-        "agent": "security-advisor",
-        "role": "Security advisor — OWASP, vulnerability scanning",
-        "auto_spawn": false
-      }
-    ]
-  },
-  "fullstack": {
-    "description": "Full-stack team including a planner for task breakdown.",
-    "members": [
-      {
-        "name": "planner",
-        "agent": "planner",
-        "role": "Task planner — breaks work into steps and assigns to developers",
-        "auto_spawn": false
-      },
-      {
-        "name": "backend-dev",
-        "agent": "backend-dev",
-        "role": "Backend developer",
-        "auto_spawn": false
-      },
-      {
-        "name": "frontend-dev",
-        "agent": "frontend-dev",
-        "role": "Frontend developer",
-        "auto_spawn": false
-      },
-      {
-        "name": "tester",
-        "agent": "tester",
-        "role": "QA engineer",
-        "auto_spawn": false
-      }
-    ]
-  }
-}

package/src/control-plane.ts

@@ -1,21 +0,0 @@
-import type { PluginInput } from "@opencode-ai/plugin";
-
-import { createPluginHooks } from "./opencode-multiagent/hooks.ts";
-import { loadRuntimeSettings } from "./opencode-multiagent/runtime.ts";
-
-export const OpenCodeMultiAgentPlugin = async (context: PluginInput) => {
-  const client = context.client;
-  const projectRoot = context.worktree || context.directory;
-  const { flags, modelTiers, agentSettings } = await loadRuntimeSettings();
-
-  return createPluginHooks({
-    client,
-    flags,
-    modelTiers,
-    agentSettings,
-    projectRoot,
-  });
-};
-
-export const ControlPlanePlugin = OpenCodeMultiAgentPlugin;
-export default OpenCodeMultiAgentPlugin;

package/src/index.ts

@@ -1,8 +0,0 @@
-import type { Plugin } from "@opencode-ai/plugin";
-
-import OpenCodeMultiAgentPlugin from "./control-plane.ts";
-
-const plugin: Plugin = OpenCodeMultiAgentPlugin;
-
-export default plugin;
-export { plugin as OpenCodeMultiAgentPlugin };

package/src/opencode-multiagent/compiler.ts

@@ -1,168 +0,0 @@
-import { disabledNativeAgents } from "./constants.ts";
-import { note } from "./log.ts";
-import { loadMarkdownDefs } from "./markdown.ts";
-import { resolveTier } from "./runtime.ts";
-import { clone, compact, merge, own } from "./utils.ts";
-
-type GenericRecord = Record<string, unknown>;
-type MergedConfig = GenericRecord & {
-  agent?: Record<string, GenericRecord>;
-  command?: Record<string, GenericRecord>;
-  default_agent?: string;
-  permission?: Record<string, unknown>;
-  _mcpPermissionRegistry?: Map<string, MpcPermissionRegistry>;
-};
-
-type MpcPermissionRegistry = {
-  allowed: string[];
-  denied: string[];
-  fallback: "allow" | "deny";
-};
-
-export const normalizeDefinitionData = (data: GenericRecord, modelTiers: Record<string, string>): GenericRecord => {
-  const result = clone(data) ?? {};
-  delete result.variant;
-  if (typeof result.model === "string") result.model = resolveTier(result.model, modelTiers);
-  return result;
-};
-
-const mcpPrefixes = ["exa_", "context7_", "gh_grep_", "github_", "code_index_", "repo_git_"];
-
-export const isMcpPermissionKey = (key: string): boolean =>
-  mcpPrefixes.some((prefix) => key === prefix || key.startsWith(prefix));
-
-export const buildMcpPermissionRegistry = (permission: GenericRecord = {}): MpcPermissionRegistry => {
-  const allowed: string[] = [];
-  const denied: string[] = [];
-  for (const [key, value] of Object.entries(permission)) {
-    if (!isMcpPermissionKey(key)) continue;
-    if (value === "allow") allowed.push(key);
-    if (value === "deny") denied.push(key);
-  }
-  return { allowed, denied, fallback: permission["*"] === "allow" ? "allow" : "deny" };
-};
-
-export async function compileAgents(
-  cfg: MergedConfig,
-  dirs: Array<string | undefined>,
-  modelTiers: Record<string, string>,
-  agentSettings: GenericRecord = {},
-): Promise<Map<string, MpcPermissionRegistry>> {
-  const defs = await loadMarkdownDefs(dirs);
-  if (!cfg.agent || typeof cfg.agent !== "object") cfg.agent = {};
-  const mcpRegistry = new Map<string, MpcPermissionRegistry>();
-
-  for (const [name, raw] of defs.entries()) {
-    const data = normalizeDefinitionData(raw.data, modelTiers);
-    if (!own(cfg.agent, name)) {
-      cfg.agent[name] = {};
-    } else if (!cfg.agent[name] || typeof cfg.agent[name] !== "object") {
-      continue;
-    }
-
-    const target = cfg.agent[name] as GenericRecord;
-    const explicitFields = new Set(Object.keys(target));
-    for (const [field, value] of Object.entries(data)) {
-      if (own(target, field)) continue;
-      target[field] = clone(value);
-    }
-
-    const overrides = agentSettings?.[name];
-    if (overrides && typeof overrides === "object") {
-      for (const [field, value] of Object.entries(overrides as GenericRecord)) {
-        if (["model", "temperature", "steps"].includes(field) && !explicitFields.has(field)) {
-          target[field] = clone(value);
-        }
-      }
-    }
-
-    if (!own(target, "prompt") && typeof raw.body === "string") {
-      target.prompt = raw.body.trim();
-    }
-
-    mcpRegistry.set(name, buildMcpPermissionRegistry((target.permission as GenericRecord | undefined) ?? {}));
-  }
-
-  cfg._mcpPermissionRegistry = mcpRegistry;
-  return mcpRegistry;
-}
-
-export async function compileCommands(
-  cfg: MergedConfig,
-  dirs: Array<string | undefined>,
-  modelTiers: Record<string, string>,
-): Promise<void> {
-  const defs = await loadMarkdownDefs(dirs);
-  if (!cfg.command || typeof cfg.command !== "object") cfg.command = {};
-
-  for (const [name, raw] of defs.entries()) {
-    const data = normalizeDefinitionData(raw.data, modelTiers);
-    if (!own(cfg.command, name)) {
-      cfg.command[name] = {};
-    } else if (!cfg.command[name] || typeof cfg.command[name] !== "object") {
-      continue;
-    }
-
-    const target = cfg.command[name] as GenericRecord;
-    for (const [field, value] of Object.entries(data)) {
-      if (own(target, field)) continue;
-      target[field] = clone(value);
-    }
-
-    if (!own(target, "template") && typeof raw.body === "string") {
-      target.template = raw.body.trim();
-    }
-  }
-}
-
-export const applyBuiltInAgentPolicy = async (cfg: MergedConfig): Promise<void> => {
-  if (!cfg.agent || typeof cfg.agent !== "object") cfg.agent = {};
-  for (const name of disabledNativeAgents) {
-    cfg.agent[name] = merge(cfg.agent[name], { disable: true });
-  }
-
-  const current = typeof cfg.default_agent === "string" ? cfg.default_agent : undefined;
-  const currentAgent = current ? cfg.agent?.[current] : undefined;
-  const preferred = cfg.agent.lead && cfg.agent.lead.disable !== true ? "lead" : cfg.agent.critic && cfg.agent.critic.disable !== true ? "critic" : undefined;
-  const invalidCurrent =
-    !current ||
-    disabledNativeAgents.includes(current) ||
-    !currentAgent ||
-    currentAgent.disable === true ||
-    currentAgent.hidden === true ||
-    currentAgent.mode === "subagent" ||
-    currentAgent.mode === "sub" ||
-    (preferred === "lead" && current !== "lead");
-
-  if (invalidCurrent && preferred) {
-    const previous = current;
-    cfg.default_agent = preferred;
-    await note(
-      "config_warning",
-      compact({
-        observation: true,
-        warning: "default_agent_reset",
-        previous,
-        next: preferred,
-      }),
-    );
-  }
-};
-
-export const applyPermissionDefaults = (cfg: MergedConfig): void => {
-  if (!cfg.permission || typeof cfg.permission !== "object") cfg.permission = {};
-  for (const [key, value] of Object.entries({
-    bash: "allow",
-    read: "allow",
-    edit: "allow",
-    glob: "allow",
-    grep: "allow",
-    list: "allow",
-  })) {
-    if (!own(cfg.permission, key)) {
-      (cfg.permission as GenericRecord)[key] = value;
-    }
-  }
-};
-
-export type { MergedConfig, MpcPermissionRegistry };