@osovv/vv-opencode 0.10.0 → 0.11.0

package/dist/lib/managed-agents.js

@@ -1,8 +1,8 @@
 // FILE: src/lib/managed-agents.ts
-// VERSION: 0.2.1
+// VERSION: 0.3.0
 // START_MODULE_CONTRACT
 //   PURPOSE: Describe vvoc-managed OpenCode agent prompts and load them from bundled templates or scoped vvoc config roots.
-//   SCOPE: Built-in subagent metadata, managed prompt names, prompt file path resolution, bundled template loading, and project/global prompt lookup.
+//   SCOPE: Built-in primary/subagent metadata, managed prompt names, prompt file path resolution, bundled template loading, and project/global prompt lookup.
 //   DEPENDS: [node:fs/promises, node:path, src/lib/vvoc-paths.ts]
 //   LINKS: [M-CLI-CONFIG, M-PLUGIN-GUARDIAN, M-PLUGIN-MEMORY]
 //   ROLE: RUNTIME
@@ -11,20 +11,29 @@
 //
 // START_MODULE_MAP
 //   ManagedSubagentName - Canonical vvoc-managed subagent names.
+//   ManagedPrimaryAgentName - Canonical vvoc-managed primary agent names.
+//   ManagedOpenCodeAgentName - Canonical vvoc-managed OpenCode agent registration names.
 //   ManagedAgentPromptName - Canonical vvoc-managed agent prompt names including Guardian and memory-reviewer.
 //   ManagedSubagentDefinition - Metadata used to register a managed subagent in OpenCode config.
+//   ManagedPrimaryAgentDefinition - Metadata used to register a managed primary agent in OpenCode config.
 //   MANAGED_SUBAGENT_NAMES - Ordered managed subagent names.
+//   MANAGED_PRIMARY_AGENT_NAMES - Ordered managed primary agent names.
+//   MANAGED_OPENCODE_AGENT_NAMES - Ordered managed OpenCode agent registration names.
 //   MANAGED_AGENT_PROMPT_NAMES - Ordered managed agent prompt names.
 //   MANAGED_SUBAGENTS - Built-in managed subagent definitions.
+//   MANAGED_PRIMARY_AGENTS - Built-in managed primary agent definitions.
+//   MANAGED_OPENCODE_AGENTS - Built-in managed OpenCode agent definitions.
 //   isManagedSubagentName - Checks whether a string is one of the managed subagent names.
+//   isManagedOpenCodeAgentName - Checks whether a string is one of the managed OpenCode agent names.
 //   getManagedSubagentDefinition - Returns metadata for a managed subagent.
+//   getManagedOpenCodeAgentDefinition - Returns metadata for a managed OpenCode agent.
 //   getManagedAgentPromptPath - Resolves the prompt file path inside a vvoc agents directory.
 //   loadManagedAgentPromptTemplate - Loads the bundled prompt template for a managed agent prompt.
 //   loadManagedAgentPromptText - Loads a managed prompt from project or global vvoc config and errors if neither exists.
 // END_MODULE_MAP
 //
 // START_CHANGE_SUMMARY
-//   LAST_CHANGE: [v0.2.1 - Removed explicit steps from vvoc-managed subagents so only guardian keeps a hard step limit.]
+//   LAST_CHANGE: [v0.3.0 - Added the managed enhancer primary agent alongside the existing vvoc subagent definitions.]
 // END_CHANGE_SUMMARY
 import { readFile } from "node:fs/promises";
 import { join } from "node:path";
@@ -35,21 +44,28 @@ export const MANAGED_SUBAGENT_NAMES = [
     "code-reviewer",
     "investitagor",
 ];
+export const MANAGED_PRIMARY_AGENT_NAMES = ["enhancer"];
+export const MANAGED_OPENCODE_AGENT_NAMES = [
+    ...MANAGED_PRIMARY_AGENT_NAMES,
+    ...MANAGED_SUBAGENT_NAMES,
+];
 export const MANAGED_AGENT_PROMPT_NAMES = [
     "guardian",
     "memory-reviewer",
-    ...MANAGED_SUBAGENT_NAMES,
+    ...MANAGED_OPENCODE_AGENT_NAMES,
 ];
 export const MANAGED_SUBAGENTS = [
     {
         name: "implementer",
         description: "Implements approved changes with focused verification and a minimal diff.",
         promptFileName: "implementer.md",
+        mode: "subagent",
     },
     {
         name: "spec-reviewer",
         description: "Checks an implementation against the requested spec and flags missing or extra behavior.",
         promptFileName: "spec-reviewer.md",
+        mode: "subagent",
         permission: {
             edit: "deny",
         },
@@ -58,6 +74,7 @@ export const MANAGED_SUBAGENTS = [
         name: "code-reviewer",
         description: "Reviews changes for bugs, regressions, maintainability risks, and missing tests.",
         promptFileName: "code-reviewer.md",
+        mode: "subagent",
         permission: {
             edit: "deny",
         },
@@ -66,15 +83,33 @@ export const MANAGED_SUBAGENTS = [
         name: "investitagor",
         description: "Investigates bugs and unclear behavior before implementation work begins.",
         promptFileName: "investitagor.md",
+        mode: "subagent",
+        permission: {
+            edit: "deny",
+        },
+    },
+];
+export const MANAGED_PRIMARY_AGENTS = [
+    {
+        name: "enhancer",
+        description: "Turns raw user intent into a structured XML prompt for a follow-up agent.",
+        promptFileName: "enhancer.md",
+        mode: "primary",
         permission: {
             edit: "deny",
+            bash: "deny",
+            task: "deny",
+            todowrite: "deny",
         },
     },
 ];
+export const MANAGED_OPENCODE_AGENTS = [...MANAGED_PRIMARY_AGENTS, ...MANAGED_SUBAGENTS];
 const MANAGED_SUBAGENT_MAP = new Map(MANAGED_SUBAGENTS.map((definition) => [definition.name, definition]));
+const MANAGED_OPENCODE_AGENT_MAP = new Map(MANAGED_OPENCODE_AGENTS.map((definition) => [definition.name, definition]));
 const MANAGED_AGENT_PROMPT_FILE_NAMES = new Map([
     ["guardian", "guardian.md"],
     ["memory-reviewer", "memory-reviewer.md"],
+    ["enhancer", "enhancer.md"],
     ["implementer", "implementer.md"],
     ["spec-reviewer", "spec-reviewer.md"],
     ["code-reviewer", "code-reviewer.md"],
@@ -83,6 +118,9 @@ const MANAGED_AGENT_PROMPT_FILE_NAMES = new Map([
 export function isManagedSubagentName(value) {
     return MANAGED_SUBAGENT_MAP.has(value);
 }
+export function isManagedOpenCodeAgentName(value) {
+    return MANAGED_OPENCODE_AGENT_MAP.has(value);
+}
 export function getManagedSubagentDefinition(name) {
     const definition = MANAGED_SUBAGENT_MAP.get(name);
     if (!definition) {
@@ -90,6 +128,13 @@ export function getManagedSubagentDefinition(name) {
     }
     return definition;
 }
+export function getManagedOpenCodeAgentDefinition(name) {
+    const definition = MANAGED_OPENCODE_AGENT_MAP.get(name);
+    if (!definition) {
+        throw new Error(`unknown managed OpenCode agent: ${name}`);
+    }
+    return definition;
+}
 export function getManagedAgentPromptPath(agentsDirPath, name) {
     return join(agentsDirPath, getManagedAgentPromptFileName(name));
 }

package/dist/lib/managed-agents.js.map

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

package/dist/lib/opencode.d.ts

@@ -1,4 +1,4 @@
-import { type ManagedSubagentName } from "./managed-agents.js";
+import { type ManagedOpenCodeAgentName } from "./managed-agents.js";
 import { type MemoryConfigOverrides } from "../plugins/memory-store.js";
 import { PACKAGE_NAME } from "./package.js";
 export declare const CLI_NAME = "vvoc";
@@ -33,7 +33,7 @@ export type WriteResult = {
     path: string;
     reason?: string;
 };
-export type ManagedSubagentModelMap = Record<ManagedSubagentName, string | undefined>;
+export type ManagedAgentModelMap = Record<ManagedOpenCodeAgentName, string | undefined>;
 export type InstallationInspection = {
     scope: Scope;
     opencode: {
@@ -76,13 +76,8 @@ export declare function resolvePaths(options: {
     configDir?: string;
 }): Promise<ResolvedPaths>;
 export declare function ensurePackageConfigText(text: string | undefined, packageSpecifier?: string): string;
-export declare function ensureManagedCommandsConfigText(text: string | undefined): string;
-export declare function syncManagedCommandRegistrations(paths: ResolvedPaths): Promise<{
-    path: string;
-    changed: boolean;
-}>;
-export declare function ensureManagedSubagentsConfigText(text: string | undefined, paths: Pick<ResolvedPaths, "managedAgentsDirPath" | "opencodeConfigPath">): string;
-export declare function syncManagedSubagentRegistrations(paths: ResolvedPaths): Promise<{
+export declare function ensureManagedAgentRegistrationsConfigText(text: string | undefined, paths: Pick<ResolvedPaths, "managedAgentsDirPath" | "opencodeConfigPath">): string;
+export declare function syncManagedAgentRegistrations(paths: ResolvedPaths): Promise<{
     path: string;
     changed: boolean;
 }>;
@@ -92,13 +87,13 @@ export declare function installManagedAgentPrompts(paths: ResolvedPaths, options
 export declare function syncManagedAgentPrompts(paths: ResolvedPaths, options: {
     force: boolean;
 }): Promise<WriteResult[]>;
-export declare function readManagedSubagentModels(paths: Pick<ResolvedPaths, "opencodeConfigPath">): Promise<ManagedSubagentModelMap>;
+export declare function readManagedAgentModels(paths: Pick<ResolvedPaths, "opencodeConfigPath">): Promise<ManagedAgentModelMap>;
 export declare function readOpenCodeAgentModel(paths: Pick<ResolvedPaths, "opencodeConfigPath">, agentName: string): Promise<string | undefined>;
 export declare function writeOpenCodeAgentModel(paths: Pick<ResolvedPaths, "opencodeConfigPath">, agentName: string, options: {
     model?: string;
     ensureEntry: boolean;
 }): Promise<WriteResult>;
-export declare function writeManagedSubagentModel(paths: Pick<ResolvedPaths, "managedAgentsDirPath" | "opencodeConfigPath">, agentName: ManagedSubagentName, options: {
+export declare function writeManagedAgentModel(paths: Pick<ResolvedPaths, "managedAgentsDirPath" | "opencodeConfigPath">, agentName: ManagedOpenCodeAgentName, options: {
     model?: string;
     ensureEntry: boolean;
 }): Promise<WriteResult>;

package/dist/lib/opencode.js

@@ -1,8 +1,8 @@
 // FILE: src/lib/opencode.ts
-// VERSION: 0.3.0
+// VERSION: 0.5.0
 // START_MODULE_CONTRACT
 //   PURPOSE: Manage OpenCode config mutation, provider patching, and vvoc-owned config files.
-//   SCOPE: Scope-aware path resolution, pinned plugin writes, provider baseURL patching, managed OpenCode command registration, OpenCode agent model overrides, managed subagent registration, managed agent prompt sync, Guardian/Memory config rendering and sync, and installation inspection.
+//   SCOPE: Scope-aware path resolution, pinned plugin writes, provider baseURL patching, managed OpenCode agent registration/model overrides, managed agent prompt sync, Guardian/Memory config rendering and sync, and installation inspection.
 //   DEPENDS: [jsonc-parser, node:fs/promises, node:path, src/lib/managed-agents.ts, src/lib/package.ts, src/lib/vvoc-paths.ts, src/plugins/memory-store.ts]
 //   LINKS: [M-CLI-CONFIG]
 //   ROLE: RUNTIME
@@ -21,20 +21,18 @@
 //   resolvePaths - Resolves OpenCode and vvoc config paths for global/project scopes.
 //   ensurePackageConfigText - Ensures OpenCode config contains the pinned vvoc plugin specifier.
 //   ensureProviderBaseUrlConfigText - Ensures OpenCode config contains the requested provider options.baseURL override.
-//   ensureManagedCommandsConfigText - Ensures OpenCode config contains the vvoc-managed slash command registrations.
-//   ensureManagedSubagentsConfigText - Ensures OpenCode config contains the vvoc-managed subagent registrations.
+//   ensureManagedAgentRegistrationsConfigText - Ensures OpenCode config contains the vvoc-managed OpenCode agent registrations.
 //   parseGuardianConfigText - Parses Guardian config JSONC into typed overrides.
 //   renderGuardianConfig - Renders managed Guardian config JSONC.
 //   ensurePackageInstalled - Writes the pinned vvoc plugin specifier into OpenCode config.
 //   writeProviderBaseUrl - Writes a provider options.baseURL override into OpenCode config.
-//   syncManagedCommandRegistrations - Syncs the canonical vvoc-managed slash command registrations into OpenCode config.
-//   syncManagedSubagentRegistrations - Syncs the canonical vvoc-managed subagent registrations into OpenCode config.
-//   installManagedAgentPrompts - Creates managed vvoc prompt files for the bundled Guardian/subagent agents when missing.
-//   syncManagedAgentPrompts - Rewrites managed vvoc prompt files for the bundled Guardian/subagent agents.
+//   syncManagedAgentRegistrations - Syncs the canonical vvoc-managed OpenCode agent registrations into OpenCode config.
+//   installManagedAgentPrompts - Creates managed vvoc prompt files for the bundled Guardian and managed OpenCode agents when missing.
+//   syncManagedAgentPrompts - Rewrites managed vvoc prompt files for the bundled Guardian and managed OpenCode agents.
 //   readOpenCodeAgentModel - Reads a model override for any OpenCode agent from config.
 //   writeOpenCodeAgentModel - Writes or removes a model override for any OpenCode agent in config.
-//   readManagedSubagentModels - Reads model overrides for the bundled vvoc subagents from OpenCode config.
-//   writeManagedSubagentModel - Writes or removes a bundled vvoc subagent model override in OpenCode config.
+//   readManagedAgentModels - Reads model overrides for the bundled vvoc-managed OpenCode agents from OpenCode config.
+//   writeManagedAgentModel - Writes or removes a bundled vvoc-managed OpenCode agent model override in OpenCode config.
 //   installGuardianConfig - Creates or preserves managed Guardian config.
 //   syncGuardianConfig - Rewrites managed Guardian config while preserving current values.
 //   writeGuardianConfig - Writes explicit Guardian overrides to managed config.
@@ -45,12 +43,12 @@
 // END_MODULE_MAP
 //
 // START_CHANGE_SUMMARY
-//   LAST_CHANGE: [v0.3.0 - Added conservative registration for the managed /enhance OpenCode slash command with a structured XML execution prompt.]
+//   LAST_CHANGE: [v0.5.0 - Removed the legacy enhance command path and kept enhancer as a managed primary agent only.]
 // END_CHANGE_SUMMARY
 import { applyEdits, format, modify, parse } from "jsonc-parser";
 import { mkdir, readFile, writeFile } from "node:fs/promises";
 import { dirname, join, relative } from "node:path";
-import { MANAGED_AGENT_PROMPT_NAMES, MANAGED_SUBAGENTS, getManagedAgentPromptPath, getManagedSubagentDefinition, loadManagedAgentPromptTemplate, } from "./managed-agents.js";
+import { MANAGED_AGENT_PROMPT_NAMES, MANAGED_OPENCODE_AGENTS, getManagedAgentPromptPath, getManagedOpenCodeAgentDefinition, loadManagedAgentPromptTemplate, } from "./managed-agents.js";
 import { parseMemoryConfigText, renderMemoryConfig, } from "../plugins/memory-store.js";
 import { getPinnedPackageSpecifier, PACKAGE_NAME } from "./package.js";
 import { getConfigHome, getGlobalOpencodeDir, getGlobalVvocDir, getProjectVvocDir, getVvocAgentsDir, } from "./vvoc-paths.js";
@@ -72,35 +70,6 @@ const JSON_FORMAT = {
     tabSize: 2,
     eol: "\n",
 };
-const ENHANCE_COMMAND_TEMPLATE = [
-    '<vvoc_enhance version="1.0">',
-    "  <source_request><![CDATA[$ARGUMENTS]]></source_request>",
-    "  <execution_goal>Interpret the source request and carry the work through to completion.</execution_goal>",
-    "  <rules>",
-    "    <preserve_user_intent>true</preserve_user_intent>",
-    "    <preserve_explicit_constraints>true</preserve_explicit_constraints>",
-    "    <do_not_invent_requirements>true</do_not_invent_requirements>",
-    "    <inspect_relevant_context_first>true</inspect_relevant_context_first>",
-    "    <prefer_minimal_correct_change>true</prefer_minimal_correct_change>",
-    "    <ask_only_when_blocked>true</ask_only_when_blocked>",
-    "    <run_relevant_verification>true</run_relevant_verification>",
-    "  </rules>",
-    "  <missing_request_behavior>",
-    "    If the source request is empty, ask the user to provide the raw request to enhance instead of guessing.",
-    "  </missing_request_behavior>",
-    "  <deliverables>",
-    "    <item>Complete the requested work or explain the concrete blocker.</item>",
-    "    <item>Summarize the result and the verification you ran.</item>",
-    "  </deliverables>",
-    "</vvoc_enhance>",
-].join("\n");
-const MANAGED_COMMANDS = [
-    {
-        name: "enhance",
-        description: "Wrap a raw request in vvoc's structured XML execution prompt.",
-        template: ENHANCE_COMMAND_TEMPLATE,
-    },
-];
 // START_BLOCK_RESOLVE_CONFIG_PATHS
 export async function resolvePaths(options) {
     const configHome = getConfigHome(options.configDir);
@@ -157,59 +126,14 @@ export function ensurePackageConfigText(text, packageSpecifier = PACKAGE_NAME) {
     return ensureTrailingNewline(applyEdits(nextText, format(nextText, undefined, JSON_FORMAT)));
 }
 // END_BLOCK_ENSURE_OPENCODE_PLUGIN_CONFIG
-// START_BLOCK_ENSURE_MANAGED_COMMAND_CONFIG
-export function ensureManagedCommandsConfigText(text) {
+// START_BLOCK_ENSURE_MANAGED_AGENT_CONFIG
+export function ensureManagedAgentRegistrationsConfigText(text, paths) {
     if (!text?.trim()) {
         return renderJson({
             $schema: OPENCODE_SCHEMA_URL,
-            command: Object.fromEntries(MANAGED_COMMANDS.map((definition) => [
+            agent: Object.fromEntries(MANAGED_OPENCODE_AGENTS.map((definition) => [
                 definition.name,
-                getManagedCommandRegistration(definition.name),
-            ])),
-        });
-    }
-    const document = parseObjectDocument(text, "OpenCode config");
-    const currentCommands = readCommandMap(document, "OpenCode config");
-    let nextText = text;
-    if (!Object.hasOwn(document, "$schema")) {
-        nextText = applyEdits(nextText, modify(nextText, ["$schema"], OPENCODE_SCHEMA_URL, {
-            formattingOptions: JSON_FORMAT,
-            getInsertionIndex: () => 0,
-        }));
-    }
-    for (const definition of MANAGED_COMMANDS) {
-        const currentEntry = currentCommands[definition.name];
-        const nextEntry = {
-            ...getManagedCommandRegistration(definition.name),
-            ...currentEntry,
-        };
-        if (JSON.stringify(currentEntry) === JSON.stringify(nextEntry)) {
-            continue;
-        }
-        nextText = applyEdits(nextText, modify(nextText, ["command", definition.name], nextEntry, {
-            formattingOptions: JSON_FORMAT,
-        }));
-    }
-    return ensureTrailingNewline(applyEdits(nextText, format(nextText, undefined, JSON_FORMAT)));
-}
-export async function syncManagedCommandRegistrations(paths) {
-    const currentText = await readOptionalText(paths.opencodeConfigPath);
-    const nextText = ensureManagedCommandsConfigText(currentText);
-    if (currentText === nextText) {
-        return { path: paths.opencodeConfigPath, changed: false };
-    }
-    await writeText(paths.opencodeConfigPath, nextText);
-    return { path: paths.opencodeConfigPath, changed: true };
-}
-// END_BLOCK_ENSURE_MANAGED_COMMAND_CONFIG
-// START_BLOCK_ENSURE_MANAGED_SUBAGENT_CONFIG
-export function ensureManagedSubagentsConfigText(text, paths) {
-    if (!text?.trim()) {
-        return renderJson({
-            $schema: OPENCODE_SCHEMA_URL,
-            agent: Object.fromEntries(MANAGED_SUBAGENTS.map((definition) => [
-                definition.name,
-                getManagedSubagentRegistration(paths, definition.name),
+                getManagedOpenCodeAgentRegistration(paths, definition.name),
             ])),
         });
     }
@@ -222,10 +146,10 @@ export function ensureManagedSubagentsConfigText(text, paths) {
             getInsertionIndex: () => 0,
         }));
     }
-    for (const definition of MANAGED_SUBAGENTS) {
+    for (const definition of MANAGED_OPENCODE_AGENTS) {
         const currentEntry = currentAgents[definition.name];
         const nextEntry = {
-            ...getManagedSubagentRegistration(paths, definition.name),
+            ...getManagedOpenCodeAgentRegistration(paths, definition.name),
             ...currentEntry,
         };
         if (JSON.stringify(currentEntry) === JSON.stringify(nextEntry)) {
@@ -237,15 +161,16 @@ export function ensureManagedSubagentsConfigText(text, paths) {
     }
     return ensureTrailingNewline(applyEdits(nextText, format(nextText, undefined, JSON_FORMAT)));
 }
-export async function syncManagedSubagentRegistrations(paths) {
+export async function syncManagedAgentRegistrations(paths) {
     const currentText = await readOptionalText(paths.opencodeConfigPath);
-    const nextText = ensureManagedSubagentsConfigText(currentText, paths);
+    const nextText = ensureManagedAgentRegistrationsConfigText(currentText, paths);
     if (currentText === nextText) {
         return { path: paths.opencodeConfigPath, changed: false };
     }
     await writeText(paths.opencodeConfigPath, nextText);
     return { path: paths.opencodeConfigPath, changed: true };
 }
+// END_BLOCK_ENSURE_MANAGED_AGENT_CONFIG
 export async function installManagedAgentPrompts(paths, options) {
     const results = [];
     for (const agentName of MANAGED_AGENT_PROMPT_NAMES) {
@@ -280,15 +205,15 @@ export async function syncManagedAgentPrompts(paths, options) {
     }
     return results;
 }
-export async function readManagedSubagentModels(paths) {
-    const models = Object.fromEntries(MANAGED_SUBAGENTS.map((definition) => [definition.name, undefined]));
+export async function readManagedAgentModels(paths) {
+    const models = Object.fromEntries(MANAGED_OPENCODE_AGENTS.map((definition) => [definition.name, undefined]));
     const currentText = await readOptionalText(paths.opencodeConfigPath);
     if (!currentText) {
         return models;
     }
     const document = parseObjectDocument(currentText, paths.opencodeConfigPath);
     const agentMap = readAgentMap(document, paths.opencodeConfigPath);
-    for (const definition of MANAGED_SUBAGENTS) {
+    for (const definition of MANAGED_OPENCODE_AGENTS) {
         const currentEntry = agentMap[definition.name];
         if (currentEntry?.model !== undefined) {
             models[definition.name] = readNonEmptyString(currentEntry.model, `${definition.name}: model`);
@@ -341,13 +266,13 @@ export async function writeOpenCodeAgentModel(paths, agentName, options) {
         path: paths.opencodeConfigPath,
     };
 }
-export async function writeManagedSubagentModel(paths, agentName, options) {
+export async function writeManagedAgentModel(paths, agentName, options) {
     const currentText = await readOptionalText(paths.opencodeConfigPath);
     if (!currentText && !options.ensureEntry) {
         return { action: "kept", path: paths.opencodeConfigPath };
     }
     const baseText = options.ensureEntry
-        ? ensureManagedSubagentsConfigText(currentText, paths)
+        ? ensureManagedAgentRegistrationsConfigText(currentText, paths)
         : currentText;
     if (!baseText) {
         return { action: "kept", path: paths.opencodeConfigPath };
@@ -359,7 +284,7 @@ export async function writeManagedSubagentModel(paths, agentName, options) {
         return { action: "kept", path: paths.opencodeConfigPath };
     }
     const nextEntry = {
-        ...getManagedSubagentRegistration(paths, agentName),
+        ...getManagedOpenCodeAgentRegistration(paths, agentName),
         ...currentEntry,
     };
     if (options.model) {
@@ -798,23 +723,6 @@ function readPluginList(document, label) {
     }
     return raw.slice();
 }
-function readCommandMap(document, label) {
-    const raw = document.command;
-    if (raw === undefined) {
-        return {};
-    }
-    if (!raw || typeof raw !== "object" || Array.isArray(raw)) {
-        throw new Error(`${label}: expected "command" to be an object`);
-    }
-    const entries = {};
-    for (const [name, value] of Object.entries(raw)) {
-        if (!value || typeof value !== "object" || Array.isArray(value)) {
-            throw new Error(`${label}: expected "command.${name}" to be an object`);
-        }
-        entries[name] = value;
-    }
-    return entries;
-}
 function normalizePluginList(currentPlugins, packageSpecifier) {
     const nextPlugins = [];
     const seen = new Set();
@@ -843,31 +751,7 @@ function normalizePluginList(currentPlugins, packageSpecifier) {
 function isPackagePluginSpecifier(value) {
     return value === PACKAGE_NAME || value.startsWith(`${PACKAGE_NAME}@`);
 }
-function getManagedCommandDefinition(commandName) {
-    const definition = MANAGED_COMMANDS.find((entry) => entry.name === commandName);
-    if (!definition) {
-        throw new Error(`unknown managed command: ${commandName}`);
-    }
-    return definition;
-}
-function getManagedCommandRegistration(commandName) {
-    const definition = getManagedCommandDefinition(commandName);
-    const registration = {
-        description: definition.description,
-        template: definition.template,
-    };
-    if (definition.agent) {
-        registration.agent = definition.agent;
-    }
-    if (definition.model) {
-        registration.model = definition.model;
-    }
-    if (definition.subtask !== undefined) {
-        registration.subtask = definition.subtask;
-    }
-    return registration;
-}
-// START_BLOCK_MANAGED_SUBAGENT_HELPERS
+// START_BLOCK_MANAGED_AGENT_HELPERS
 function readAgentMap(document, label) {
     const raw = document.agent;
     if (raw === undefined) {
@@ -928,17 +812,17 @@ function ensureAgentConfigText(text) {
     }
     return ensureTrailingNewline(applyEdits(nextText, format(nextText, undefined, JSON_FORMAT)));
 }
-function getManagedSubagentPromptReference(paths, agentName) {
+function getManagedOpenCodeAgentPromptReference(paths, agentName) {
     const promptPath = getManagedPromptPath(paths, agentName);
     const promptRef = relative(dirname(paths.opencodeConfigPath), promptPath).replaceAll("\\", "/");
     return `{file:${promptRef.startsWith(".") ? promptRef : `./${promptRef}`}}`;
 }
-function getManagedSubagentRegistration(paths, agentName) {
-    const definition = getManagedSubagentDefinition(agentName);
+function getManagedOpenCodeAgentRegistration(paths, agentName) {
+    const definition = getManagedOpenCodeAgentDefinition(agentName);
     const registration = {
         description: definition.description,
-        mode: "subagent",
-        prompt: getManagedSubagentPromptReference(paths, agentName),
+        mode: definition.mode,
+        prompt: getManagedOpenCodeAgentPromptReference(paths, agentName),
     };
     if (definition.permission) {
         registration.permission = definition.permission;
@@ -983,7 +867,7 @@ function updateAgentEntryText(text, agentName, entry) {
     }));
     return ensureTrailingNewline(applyEdits(nextText, format(nextText, undefined, JSON_FORMAT)));
 }
-// END_BLOCK_MANAGED_SUBAGENT_HELPERS
+// END_BLOCK_MANAGED_AGENT_HELPERS
 function normalizeGuardianOverrides(raw, label) {
     if (!raw || typeof raw !== "object" || Array.isArray(raw)) {
         throw new Error(`${label}: expected a top-level object`);