opencode-herdr-orchestration 0.1.3 → 0.1.5

package/README.md

@@ -4,7 +4,7 @@ Capability-separated OpenCode agents for planning, implementation, independent r
 
 This package registers the agents, provides complete structured worker-response retrieval, injects session-specific orchestration mode into shell environments, and ships a reproducible Git `pre-push` policy for new and existing repositories.
 
-Requires Node.js 22.22.2 or newer when running the package CLI or tests.
+Requires Node.js 20 or newer when running the package CLI or tests.
 
 ## Installation
 
@@ -19,6 +19,7 @@ The installer:
 
 - locates the global OpenCode config directory;
 - installs an exact package version there;
+- interactively asks which models the shepherd, sheep worker, and shearer reviewer roles should use when run in a terminal;
 - preserves existing JSONC comments, trailing commas, plugins, and tuple options;
 - adds the stable file URL required by current OpenCode npm plugin loading;
 - creates timestamped backups of changed config and npm manifest files;
@@ -35,12 +36,15 @@ Inspect or remove the installation:
 
 ```bash
 npx -y opencode-herdr-orchestration@latest status
+npx -y opencode-herdr-orchestration@latest configure-agents
 npx -y opencode-herdr-orchestration@latest uninstall
 npx -y opencode-herdr-orchestration@latest uninstall --with-hooks
 ```
 
 After installation or update, quit and restart OpenCode intentionally when ready. Existing processes keep their already-loaded configuration.
 
+`configure-agents` updates the same model choices after installation. Press Enter to keep the displayed value, or enter `-` to restore that role's package default. Model names must include their provider prefix, such as `anthropic/claude-sonnet-4-6`.
+
 ## Manual Installation
 
 Add the published package to the global OpenCode configuration at `~/.config/opencode/opencode.json` or `~/.config/opencode/opencode.jsonc`:
@@ -148,6 +152,7 @@ Plugin tuple options can override model defaults:
     [
       "opencode-herdr-orchestration",
       {
+        "shepherdModel": "anthropic/claude-sonnet-4-6",
         "workerModel": "litellm/glm-5.3-flash",
         "reviewerModel": "litellm-responses/gpt-5.6-terra"
       }

package/bin/orchestration.js

@@ -1,16 +1,19 @@
 #!/usr/bin/env node
 
-import { chmodSync, copyFileSync, existsSync, mkdirSync, rmSync } from "node:fs";
+import { chmodSync, copyFileSync, existsSync, mkdirSync, readFileSync, rmSync } from "node:fs";
 import { homedir } from "node:os";
 import { dirname, join } from "node:path";
 import { fileURLToPath } from "node:url";
 import { execFileSync } from "node:child_process";
+import { createInterface } from "node:readline/promises";
 import {
   configDirectory,
+  findConfigFile,
   installPackage,
   latestVersion,
   PACKAGE_NAME,
   packageVersion,
+  orchestrationOptions,
   restoreBackup,
   status as installationStatus,
   uninstallPackage,
@@ -24,6 +27,12 @@ const sourceHook = join(packageRoot, "hooks", "pre-push");
 const installedHook = join(hooksPath, "pre-push");
 const [command, ...flags] = process.argv.slice(2);
 
+const MODEL_ROLES = [
+  ["shepherdModel", "Shepherd agents", "OpenCode active model"],
+  ["workerModel", "Sheep worker agents", "litellm/glm-5.3-flash"],
+  ["reviewerModel", "Shearer review agents", "litellm-responses/gpt-5.6-terra"],
+];
+
 function git(args, options = {}) {
   return execFileSync("git", args, { encoding: "utf8", windowsHide: true, ...options }).trim();
 }
@@ -59,11 +68,41 @@ function uninstallHooks() {
   }
 }
 
-function installOrUpdate(useLatest) {
+function currentOptions(configDir) {
+  const file = findConfigFile(configDir);
+  return existsSync(file) ? orchestrationOptions(readFileSync(file, "utf8")) : {};
+}
+
+async function promptForModels(configDir) {
+  if (!process.stdin.isTTY || !process.stdout.isTTY) {
+    throw new Error("Agent model configuration requires an interactive terminal.");
+  }
+  const existing = currentOptions(configDir);
+  const answers = {};
+  const prompt = createInterface({ input: process.stdin, output: process.stdout });
+  process.stdout.write("Configure agent models. Press Enter to keep the shown value; enter - to restore the package default.\n");
+  try {
+    for (const [key, label, packageDefault] of MODEL_ROLES) {
+      const shown = existing[key] || packageDefault;
+      const answer = (await prompt.question(`${label} [${shown}]: `)).trim();
+      const value = answer === "-" ? "" : (answer || existing[key] || "");
+      if (value && !value.includes("/")) throw new Error(`${label} model must include a provider prefix, for example provider/model.`);
+      answers[key] = value;
+    }
+  } finally {
+    prompt.close();
+  }
+  return answers;
+}
+
+async function installOrUpdate(useLatest) {
   const configDir = configDirectory();
+  const models = command === "install" && process.stdin.isTTY && process.stdout.isTTY
+    ? await promptForModels(configDir)
+    : undefined;
   const version = useLatest ? latestVersion() : packageVersion(packageRoot);
   const packageBackups = installPackage(configDir, version);
-  const result = writePluginConfig(configDir);
+  const result = writePluginConfig(configDir, false, models);
   try {
     validateOpenCode(configDir);
   } catch (error) {
@@ -77,6 +116,24 @@ function installOrUpdate(useLatest) {
   process.stdout.write("Restart OpenCode intentionally to load the new configuration.\n");
 }
 
+async function configureAgents() {
+  const configDir = configDirectory();
+  if (!existsSync(join(configDir, "node_modules", PACKAGE_NAME, "package.json"))) {
+    throw new Error(`${PACKAGE_NAME} is not installed. Run the install command first.`);
+  }
+  const models = await promptForModels(configDir);
+  const result = writePluginConfig(configDir, false, models);
+  try {
+    validateOpenCode(configDir);
+  } catch (error) {
+    restoreBackup(result.file, result.backup, result.existed);
+    throw new Error(`OpenCode validation failed; restored the previous config. ${error.message}`);
+  }
+  process.stdout.write(`Configured agent models in ${result.file}\n`);
+  if (result.backup) process.stdout.write(`Backup: ${result.backup}\n`);
+  process.stdout.write("Restart OpenCode intentionally to load the new configuration.\n");
+}
+
 function uninstallOrchestration() {
   const configDir = configDirectory();
   const result = writePluginConfig(configDir, true);
@@ -102,14 +159,15 @@ function captureHookStatus() {
 }
 
 try {
-  if (command === "install") installOrUpdate(false);
-  else if (command === "update") installOrUpdate(true);
+  if (command === "install") await installOrUpdate(false);
+  else if (command === "update") await installOrUpdate(true);
+  else if (command === "configure-agents") await configureAgents();
   else if (command === "uninstall") uninstallOrchestration();
   else if (command === "install-hooks") installHooks();
   else if (command === "uninstall-hooks") uninstallHooks();
   else if (command === "status") fullStatus();
   else {
-    process.stderr.write("Usage: opencode-herdr-orchestration <install|update|status|uninstall|install-hooks|uninstall-hooks> [--with-hooks] [--force]\n");
+    process.stderr.write("Usage: opencode-herdr-orchestration <install|update|configure-agents|status|uninstall|install-hooks|uninstall-hooks> [--with-hooks] [--force]\n");
     process.exitCode = 2;
   }
 } catch (error) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "opencode-herdr-orchestration",
-  "version": "0.1.3",
+  "version": "0.1.5",
   "description": "Capability-separated Herdr orchestration agents for OpenCode",
   "author": "CodingJinxx",
   "repository": {
@@ -31,13 +31,7 @@
     "check": "node --check src/plugin.js && node --check src/index.js && node --check src/agents.js && node --check src/prompts.js && node --check src/response.js && node --check bin/orchestration.js"
   },
   "engines": {
-    "node": ">=22.22.2"
-  },
-  "peerDependencies": {
-    "@opencode-ai/plugin": ">=1.3.0 <2"
-  },
-  "devDependencies": {
-    "@opencode-ai/plugin": "1.3.14"
+    "node": ">=20"
   },
   "keywords": [
     "opencode",
@@ -47,6 +41,8 @@
   ],
   "license": "MIT",
   "dependencies": {
+    "@opencode-ai/plugin": "1.3.14",
+    "cross-spawn": "7.0.6",
     "jsonc-parser": "3.3.1"
   }
 }

package/src/agents.js

@@ -81,6 +81,7 @@ export function mergeAgent(defaults, override) {
 }
 
 export function createAgents(options = {}) {
+  const shepherdModel = options.shepherdModel;
   const workerModel = options.workerModel ?? "litellm/glm-5.3-flash";
   const reviewerModel = options.reviewerModel ?? "litellm-responses/gpt-5.6-terra";
   const shepherdBuildPermissions = options.shepherdBuildPermissions ?? {};
@@ -89,6 +90,7 @@ export function createAgents(options = {}) {
   return {
     "shepherd-plan": {
       mode: "primary",
+      ...(shepherdModel ? { model: shepherdModel } : {}),
       description: "Researches and presents implementation-ready plans through sheep-plan workers without implementing them.",
       prompt: SHEPHERD_PLAN_PROMPT,
       permission: {
@@ -135,6 +137,7 @@ export function createAgents(options = {}) {
 
     "shepherd-build": {
       mode: "primary",
+      ...(shepherdModel ? { model: shepherdModel } : {}),
       description: "Executes approved plans through planning, implementation, and independent review workers.",
       prompt: shepherdBuildPrompt,
       permission: {

package/src/installer.js

@@ -1,14 +1,13 @@
-import { execFileSync } from "node:child_process";
 import { copyFileSync, existsSync, mkdirSync, readFileSync, rmSync, writeFileSync } from "node:fs";
 import { homedir } from "node:os";
-import { dirname, join, resolve } from "node:path";
+import { join, resolve } from "node:path";
 import { pathToFileURL } from "node:url";
+import spawn from "cross-spawn";
 import { applyEdits, modify, parse, printParseErrorCode } from "jsonc-parser";
 
 export const PACKAGE_NAME = "opencode-herdr-orchestration";
-const NPM_COMMAND = process.platform === "win32" ? process.execPath : "npm";
-const NPM_PREFIX = process.platform === "win32" ? [resolveNpmCli()] : [];
-const OPENCODE_COMMAND = process.platform === "win32" ? "opencode.exe" : "opencode";
+const NPM_COMMAND = "npm";
+const OPENCODE_COMMAND = "opencode";
 export const AGENT_NAMES = [
   "shepherd-plan",
   "shepherd-build",
@@ -18,22 +17,6 @@ export const AGENT_NAMES = [
   "shearer-review-medium",
 ];
 
-function resolveWindowsCommand(name) {
-  try {
-    return execFileSync("where.exe", [name], { encoding: "utf8", windowsHide: true })
-      .split(/\r?\n/)
-      .find(Boolean)
-      .trim();
-  } catch {
-    return name;
-  }
-}
-
-function resolveNpmCli() {
-  const npmShim = resolveWindowsCommand("npm.cmd");
-  return join(dirname(npmShim), "node_modules", "npm", "bin", "npm-cli.js");
-}
-
 export function configDirectory(env = process.env) {
   if (env.OPENCODE_CONFIG_DIR) return resolve(env.OPENCODE_CONFIG_DIR);
   const home = env.HOME || env.USERPROFILE || homedir();
@@ -82,6 +65,38 @@ export function updatePluginConfig(text, entry, remove = false) {
   return source;
 }
 
+export function orchestrationOptions(text) {
+  const config = parse(text || "{}", [], { allowTrailingComma: true, disallowComments: false });
+  const entry = Array.isArray(config?.plugin)
+    ? config.plugin.find((candidate) => isOrchestrationPlugin(candidate))
+    : undefined;
+  return Array.isArray(entry) && entry[1] && typeof entry[1] === "object" ? entry[1] : {};
+}
+
+export function updateAgentModels(text, entry, models) {
+  const original = parse(text || "{}", [], { allowTrailingComma: true, disallowComments: false });
+  const matches = Array.isArray(original?.plugin)
+    ? original.plugin.map((candidate, index) => isOrchestrationPlugin(candidate) ? index : -1).filter((index) => index >= 0)
+    : [];
+  let updated = text || "{}";
+  const formattingOptions = { insertSpaces: true, tabSize: 2, eol: updated.includes("\r\n") ? "\r\n" : "\n" };
+  if (matches.length === 1 && Array.isArray(original.plugin[matches[0]])) {
+    updated = applyEdits(updated, modify(updated, ["plugin", matches[0], 0], entry, { formattingOptions }));
+  } else {
+    updated = updatePluginConfig(updated, entry);
+  }
+  const config = parse(updated, [], { allowTrailingComma: true, disallowComments: false });
+  const index = config.plugin.findIndex((candidate) => isOrchestrationPlugin(candidate));
+  if (!Array.isArray(config.plugin[index])) {
+    const options = Object.fromEntries(Object.entries(models).filter(([, value]) => value));
+    return applyEdits(updated, modify(updated, ["plugin", index], [entry, options], { formattingOptions }));
+  }
+  for (const [key, value] of Object.entries(models)) {
+    updated = applyEdits(updated, modify(updated, ["plugin", index, 1, key], value || undefined, { formattingOptions }));
+  }
+  return updated;
+}
+
 export function findConfigFile(configDir) {
   for (const name of ["opencode.jsonc", "opencode.json"]) {
     const candidate = join(configDir, name);
@@ -99,12 +114,21 @@ export function backupFile(file, now = new Date()) {
 }
 
 function run(command, args, options = {}) {
-  return execFileSync(command, args, {
+  const result = spawn.sync(command, args, {
     encoding: "utf8",
     windowsHide: true,
     stdio: ["ignore", "pipe", "pipe"],
     ...options,
-  }).trim();
+  });
+  if (result.error) throw result.error;
+  if (result.status !== 0) {
+    const error = new Error(`${command} exited with status ${result.status}.`);
+    error.status = result.status;
+    error.stdout = result.stdout;
+    error.stderr = result.stderr;
+    throw error;
+  }
+  return result.stdout.trim();
 }
 
 export function installedVersion(configDir) {
@@ -118,7 +142,7 @@ export function packageVersion(packageRoot) {
 }
 
 export function latestVersion() {
-  return JSON.parse(run(NPM_COMMAND, [...NPM_PREFIX, "view", PACKAGE_NAME, "version", "--json", "--prefer-online"]));
+  return JSON.parse(run(NPM_COMMAND, ["view", PACKAGE_NAME, "version", "--json", "--prefer-online"]));
 }
 
 export function installPackage(configDir, version) {
@@ -126,7 +150,7 @@ export function installPackage(configDir, version) {
   const backups = ["package.json", "package-lock.json"]
     .map((name) => backupFile(join(configDir, name)))
     .filter(Boolean);
-  run(NPM_COMMAND, [...NPM_PREFIX, "install", "--save-exact", `${PACKAGE_NAME}@${version}`], { cwd: configDir });
+  run(NPM_COMMAND, ["install", "--save-exact", `${PACKAGE_NAME}@${version}`], { cwd: configDir });
   return backups;
 }
 
@@ -135,17 +159,19 @@ export function uninstallPackage(configDir) {
     .map((name) => backupFile(join(configDir, name)))
     .filter(Boolean);
   try {
-    run(NPM_COMMAND, [...NPM_PREFIX, "uninstall", PACKAGE_NAME], { cwd: configDir });
+    run(NPM_COMMAND, ["uninstall", PACKAGE_NAME], { cwd: configDir });
   } catch {}
   return backups;
 }
 
-export function writePluginConfig(configDir, remove = false) {
+export function writePluginConfig(configDir, remove = false, models) {
   mkdirSync(configDir, { recursive: true });
   const file = findConfigFile(configDir);
   const existed = existsSync(file);
   const previous = existed ? readFileSync(file, "utf8") : '{\n  "$schema": "https://opencode.ai/config.json"\n}\n';
-  const next = updatePluginConfig(previous, packageEntry(configDir), remove);
+  const next = models && !remove
+    ? updateAgentModels(previous, packageEntry(configDir), models)
+    : updatePluginConfig(previous, packageEntry(configDir), remove);
   if (next === previous) return { file, backup: null, changed: false, existed };
   const backup = backupFile(file);
   writeFileSync(file, next, "utf8");