opencode-herdr-orchestration 0.1.4 → 0.1.6

package/README.md

@@ -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`. The sheep worker reasoning effort accepts the provider's variant names, such as `low`, `medium`, or `high`; leaving it unset uses the model's default reasoning behavior. Shepherd agents always inherit the active model and its reasoning behavior, and reviewer reasoning stays fixed at `low` and `medium`.
+
 ## Manual Installation
 
 Add the published package to the global OpenCode configuration at `~/.config/opencode/opencode.json` or `~/.config/opencode/opencode.jsonc`:
@@ -148,7 +152,9 @@ Plugin tuple options can override model defaults:
     [
       "opencode-herdr-orchestration",
       {
+        "shepherdModel": "anthropic/claude-sonnet-4-6",
         "workerModel": "litellm/glm-5.3-flash",
+        "workerVariant": "medium",
         "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,13 @@ 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", "model"],
+  ["workerModel", "Sheep worker agents", "litellm/glm-5.3-flash", "model"],
+  ["workerVariant", "Sheep worker reasoning effort", "model default", "variant"],
+  ["reviewerModel", "Shearer review agents", "litellm-responses/gpt-5.6-terra", "model"],
+];
+
 function git(args, options = {}) {
   return execFileSync("git", args, { encoding: "utf8", windowsHide: true, ...options }).trim();
 }
@@ -59,11 +69,43 @@ 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, kind] of MODEL_ROLES) {
+      const shown = existing[key] || packageDefault;
+      const answer = (await prompt.question(`${label} [${shown}]: `)).trim();
+      const value = answer === "-" ? "" : (answer || existing[key] || "");
+      if (value && kind === "model" && !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 +119,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 +162,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.4",
+  "version": "0.1.6",
   "description": "Capability-separated Herdr orchestration agents for OpenCode",
   "author": "CodingJinxx",
   "repository": {

package/src/agents.js

@@ -81,7 +81,9 @@ export function mergeAgent(defaults, override) {
 }
 
 export function createAgents(options = {}) {
+  const shepherdModel = options.shepherdModel;
   const workerModel = options.workerModel ?? "litellm/glm-5.3-flash";
+  const workerVariant = options.workerVariant;
   const reviewerModel = options.reviewerModel ?? "litellm-responses/gpt-5.6-terra";
   const shepherdBuildPermissions = options.shepherdBuildPermissions ?? {};
   const shepherdBuildPrompt = appendPrompt(SHEPHERD_BUILD_PROMPT, options.shepherdBuildPromptAppend);
@@ -89,6 +91,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 +138,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: {
@@ -188,6 +192,7 @@ export function createAgents(options = {}) {
     "sheep-plan": {
       mode: "primary",
       model: workerModel,
+      ...(workerVariant ? { variant: workerVariant } : {}),
       description: "Performs read-only repository research for a shepherd.",
       prompt: SHEEP_PLAN_PROMPT,
       permission: {
@@ -207,6 +212,7 @@ export function createAgents(options = {}) {
     "sheep-build": {
       mode: "primary",
       model: workerModel,
+      ...(workerVariant ? { variant: workerVariant } : {}),
       description: "Implements a bounded task, verifies it, and hands a local commit to shepherd-build.",
       prompt: SHEEP_BUILD_PROMPT,
       permission: {

package/src/installer.js

@@ -65,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);
@@ -132,12 +164,14 @@ export function uninstallPackage(configDir) {
   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");