opencode-multiagent 0.2.1 → 0.4.0

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 };

package/src/opencode-multiagent/constants.ts

@@ -1,178 +0,0 @@
-import { homedir } from "node:os";
-import { dirname, join, resolve } from "node:path";
-import { fileURLToPath } from "node:url";
-
-export const pluginName = "opencode-multiagent";
-export const pluginMode = "stable";
-
-export const opencodeDir = join(homedir(), ".config", "opencode");
-export const pluginDir = join(opencodeDir, "plugins");
-export const globalAgentsDir = join(opencodeDir, "agents");
-export const globalCommandsDir = join(opencodeDir, "commands");
-export const logDirPath = join(opencodeDir, "logs");
-export const logFilePath = join(logDirPath, `${pluginName}.jsonl`);
-export const flagsPath = join(pluginDir, `${pluginName}.flags.json`);
-export const agentSettingsPath = join(pluginDir, `${pluginName}.agent-settings.json`);
-export const profilesPath = join(pluginDir, `${pluginName}.profiles.json`);
-
-export const packageRoot = resolve(dirname(fileURLToPath(import.meta.url)), "../..");
-export const bundledAgentSettingsPath = join(packageRoot, "defaults", "agent-settings.json");
-export const bundledAgentsDir = join(packageRoot, "agents");
-export const bundledCommandsDir = join(packageRoot, "commands");
-export const bundledSkillsDir = join(packageRoot, "skills");
-
-export const trackedEventTypes = new Set([
-  "permission.updated",
-  "permission.replied",
-  "session.created",
-  "session.status",
-  "session.diff",
-  "file.edited",
-  "session.deleted",
-  "session.idle",
-  "message.updated",
-  "message.part.updated",
-  "message.part.delta",
-  "command.executed",
-]);
-
-export const supervisionEventTypes = new Set([
-  "session.created",
-  "message.updated",
-  "message.part.updated",
-  "message.part.delta",
-  "session.idle",
-  "session.deleted",
-]);
-
-export const qualityEventTypes = new Set(["file.edited", "session.idle", "session.deleted"]);
-export const telemetryEventTypes = new Set(["session.created", "message.updated", "session.deleted"]);
-export const suspiciousTerms = ["blocked", "failed", "error", "permission", "refused"];
-export const qualitySignalRegex =
-  /\b(test|tests|lint|typecheck|tsc|build|pytest|vitest|jest|cargo test|go test|ruff|mypy|eslint|biome|prettier)\b/i;
-
-export const mcpToolPrefixes = ["exa_", "context7_", "gh_grep_", "github_", "code_index_", "repo_git_"];
-
-export const defaultProfiles = {
-  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,
-    skill_sources: [bundledSkillsDir, join(homedir(), ".agents", "skills"), join(homedir(), "skills")],
-    skill_injection: false,
-    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,
-    },
-  },
-};
-
-export const defaultFlags = {
-  profile: "standard",
-  enforcement: true,
-  observation: true,
-  prompt_controls: true,
-  agent_compilation: true,
-  command_compilation: true,
-  mcp_compilation: true,
-  telemetry: true,
-  supervision: true,
-  quality_gate: true,
-  skill_sources: [bundledSkillsDir, join(homedir(), ".agents", "skills"), join(homedir(), "skills")],
-  skill_injection: false,
-  compiler: {
-    permission_compilation: true,
-  },
-  experimental: {
-    chat_system_transform: false,
-    chat_messages_transform: false,
-    session_compacting: false,
-    text_complete: false,
-  },
-  supervision_config: {
-    idle_timeout_ms: 180000,
-    cooldown_ms: 300000,
-  },
-  quality_config: {
-    reminder_idle_ms: 120000,
-    reminder_cooldown_ms: 300000,
-  },
-};
-
-export const disabledNativeAgents = ["build", "plan", "general", "explore"];
-
-export const blockedPathPrefixRegex = /^(\/etc|\/root|\/boot|\/proc|\/sys|\/dev)(?:\/|$)/;
-export const blockedPathFragments = ["/.ssh/", "/credentials", "/secrets", "/.aws/", "/.gcloud/", "/.kube/"];
-export const blockedPathSuffixes = ["/.ssh", "/credentials"];
-export const destructiveBashFragments = [
-  "git reset --" + "hard",
-  "git che" + "ckout --",
-  "r" + "m -rf /",
-  "r" + "m -rf ~",
-  "su" + "do ",
-  "shut" + "down",
-  "re" + "boot",
-  "mk" + "fs",
-  "dd i" + "f=",
-  "cu" + "rl | ba" + "sh",
-  "cu" + "rl | sh",
-  "wg" + "et | ba" + "sh",
-  "wg" + "et | sh",
-  "ev" + "al $(",
-  "> /de" + "v/",
-  ":" + "(){",
-  "ch" + "mod 777",
-  "ki" + "ll -9 -1",
-  "no" + "hup ",
-];
-export const sensitiveMentions = ["/etc", "/root", "/boot", "/proc", "/sys", "/dev", "/.ssh", "~/.ssh"];
-
-export const noteText =
-  "[opencode-multiagent note] Sensitive system paths and destructive shell fragments are blocked by local runtime policy.";
-export const experimentalText =
-  "[opencode-multiagent experimental] Experimental control-plane transforms are active for this session.";
-
-export type DefaultFlags = typeof defaultFlags;
-export type DefaultProfiles = typeof defaultProfiles;

package/src/opencode-multiagent/file-lock.ts

@@ -1,90 +0,0 @@
-const cleanupIntervalMs = 5 * 60 * 1000;
-const staleLockTtlMs = 30 * 60 * 1000;
-
-type LockInfo = {
-  sessionID: string;
-  lastTouchedAt: number;
-};
-
-type AcquireResult =
-  | { ok: true; filePath: string | undefined }
-  | { ok: false; filePath: string; ownerSessionID: string };
-
-const normalizeFilePath = (filePath: unknown): string | undefined =>
-  typeof filePath === "string" ? filePath.replace(/\\/g, "/") : undefined;
-
-export const createFileLockController = () => {
-  const locks = new Map<string, LockInfo>();
-  const sessionFiles = new Map<string, Set<string>>();
-
-  const trackSessionFile = (sessionID: string, filePath: string): void => {
-    if (!sessionFiles.has(sessionID)) sessionFiles.set(sessionID, new Set());
-    sessionFiles.get(sessionID)?.add(filePath);
-  };
-
-  const untrackSessionFile = (sessionID: string, filePath: string): void => {
-    const files = sessionFiles.get(sessionID);
-    if (!files) return;
-    files.delete(filePath);
-    if (files.size === 0) sessionFiles.delete(sessionID);
-  };
-
-  const release = (sessionID: string, filePath: unknown): boolean => {
-    const normalized = normalizeFilePath(filePath);
-    if (!normalized) return false;
-    const existing = locks.get(normalized);
-    if (!existing || existing.sessionID !== sessionID) return false;
-    locks.delete(normalized);
-    untrackSessionFile(sessionID, normalized);
-    return true;
-  };
-
-  const releaseAll = (sessionID: string): number => {
-    const files = sessionFiles.get(sessionID);
-    if (!files) return 0;
-    let count = 0;
-    for (const filePath of files) {
-      const existing = locks.get(filePath);
-      if (existing?.sessionID === sessionID) {
-        locks.delete(filePath);
-        count += 1;
-      }
-    }
-    sessionFiles.delete(sessionID);
-    return count;
-  };
-
-  const cleanupStaleLocks = (now = Date.now()): void => {
-    for (const [filePath, info] of locks.entries()) {
-      if (now - info.lastTouchedAt <= staleLockTtlMs) continue;
-      locks.delete(filePath);
-      untrackSessionFile(info.sessionID, filePath);
-    }
-  };
-
-  const interval = setInterval(() => cleanupStaleLocks(), cleanupIntervalMs);
-  interval.unref?.();
-
-  return {
-    acquire(sessionID: string, filePath: unknown): AcquireResult {
-      const normalized = normalizeFilePath(filePath);
-      if (!sessionID || !normalized) return { ok: true, filePath: normalized };
-      const existing = locks.get(normalized);
-      if (existing && existing.sessionID !== sessionID) {
-        return { ok: false, filePath: normalized, ownerSessionID: existing.sessionID };
-      }
-      locks.set(normalized, { sessionID, lastTouchedAt: Date.now() });
-      trackSessionFile(sessionID, normalized);
-      return { ok: true, filePath: normalized };
-    },
-    release,
-    releaseAll,
-    inspect(filePath: unknown): LockInfo | undefined {
-      return locks.get(normalizeFilePath(filePath) ?? "");
-    },
-    cleanup(now = Date.now()): void {
-      cleanupStaleLocks(now);
-      clearInterval(interval);
-    },
-  };
-};