opencode-usage-coach 0.9.1 → 0.10.1

package/README.md

@@ -49,6 +49,18 @@ For local dev without npm: `bun install && bun run build`, then point both confi
 
 Four config surfaces; only the first two (install config + codexbar) are required to run. The **harness config** (`harness.config.json`) maps roles to models so per-model quota is tracked — set `generator` (required) and optionally `grader`, `lighterModel`, and `provider`. Thresholds and tuning live in env vars (`UC_STOP_5H`, `UC_THROTTLE_5H`, …).
 
+### Changing models at runtime
+
+Type `/coach-config` in the TUI to view or update harness models interactively. The AI calls the `coach_config` tool, which reads/writes `harness.config.json` with merge semantics — no manual JSON editing required:
+
+```
+/coach-config                              # view current config
+"change generator to anthropic/claude-sonnet-4-20250514"
+"set grader and lighterModel to opencode/mimo-v2.5-free"
+```
+
+Changes take effect immediately for new `generate` / `grade` calls.
+
 See **[docs/configuration.md](docs/configuration.md)** for the full reference (env var table, harness config fields, agent-mode scoping, local dev setup).
 
 ## Harness Loop

package/dist/index.js

@@ -909,6 +909,25 @@ function readHarnessCfg(dir) {
     ...tryRead(join2(dir, "harness.config.json"))
   };
 }
+function writeHarnessCfg(updates) {
+  const configDir = join2(homedir(), ".config", "opencode-usage-coach");
+  const configPath = join2(configDir, "harness.config.json");
+  try {
+    mkdirSync2(configDir, { recursive: true });
+    const existing = (() => {
+      try {
+        return JSON.parse(readFileSync2(configPath, "utf8"));
+      } catch {
+        return {};
+      }
+    })();
+    const merged = { ...existing, ...updates };
+    writeFileSync2(configPath, JSON.stringify(merged, null, 2) + "\n");
+    return configPath;
+  } catch (e) {
+    throw new Error(`Failed to write harness config: ${String(e)}`, { cause: e });
+  }
+}
 async function runModel(client, model, prompt, directory, track, maxSteps = DEFAULT_MAX_STEPS) {
   const t0 = Date.now();
   const subStart = Date.now();
@@ -1245,6 +1264,7 @@ function isHarnessAgent(agent) {
 }
 var LOADING = { decision: "GO", advice: "quota loading\u2026", weekly: -1, monthly: -1, fiveHour: -1 };
 async function UsageCoachPlugin(input) {
+  pipeLog(`UsageCoachPlugin CALLED | dir=${input.directory} | worktree=${input.worktree}`);
   try {
     setStateDir(input.directory);
     initDomain(STATE_DIR);
@@ -2139,10 +2159,67 @@ If the task is already well-specified with no significant ambiguities, return {"
             const qNum = state.currentIndex + 1;
             return formatQuestionOutput(qNum, total, q);
           }
+        }),
+        coach_config: tool({
+          description: 'View or update harness model configuration (generator, grader, lighterModel, provider). Call with no args to view current config. Pass any combination of generator/grader/lighterModel/provider to update. Example: coach_config({ generator: "anthropic/claude-sonnet-4-20250514", grader: "opencode/mimo-v2.5-free" })',
+          args: {
+            generator: tool.schema.string().optional(),
+            grader: tool.schema.string().optional(),
+            lighterModel: tool.schema.string().optional(),
+            provider: tool.schema.string().optional()
+          },
+          async execute(args, ctx) {
+            const dir = ctx?.directory ?? input.directory;
+            const current2 = readHarnessCfg(dir);
+            const hasUpdates = args.generator !== void 0 || args.grader !== void 0 || args.lighterModel !== void 0 || args.provider !== void 0;
+            if (!hasUpdates) {
+              const envOverrides = [];
+              if (process.env.UC_PROVIDER) envOverrides.push(`UC_PROVIDER=${process.env.UC_PROVIDER}`);
+              if (process.env.UC_LIGHTER_MODEL) envOverrides.push(`UC_LIGHTER_MODEL=${process.env.UC_LIGHTER_MODEL}`);
+              return [
+                `Harness Configuration`,
+                `\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550`,
+                `  generator:     ${current2.generator ?? "(not set \u2014 harness won't work!)"}`,
+                `  grader:        ${current2.grader ?? "(defaults to generator)"}`,
+                `  lighterModel:  ${current2.lighterModel ?? "(not set \u2014 no THROTTLE fallback)"}`,
+                `  provider:      ${current2.provider ?? "(auto-detected from model)"}`,
+                `\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550`,
+                envOverrides.length > 0 ? `
+Environment overrides (take precedence):
+  ${envOverrides.join("\n  ")}` : "",
+                `
+Config file: ~/.config/opencode-usage-coach/harness.config.json`,
+                `
+To update, call: coach_config({ generator: "provider/model-id", ... })`
+              ].filter(Boolean).join("\n");
+            }
+            const updates = {};
+            if (args.generator !== void 0) updates.generator = args.generator.trim();
+            if (args.grader !== void 0) updates.grader = args.grader.trim();
+            if (args.lighterModel !== void 0) updates.lighterModel = args.lighterModel.trim();
+            if (args.provider !== void 0) updates.provider = args.provider.trim();
+            const writtenPath = writeHarnessCfg(updates);
+            const updated = readHarnessCfg(dir);
+            return [
+              `\u2705 Harness config updated successfully!`,
+              `\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550`,
+              `  generator:     ${updated.generator ?? "(not set)"}`,
+              `  grader:        ${updated.grader ?? "(defaults to generator)"}`,
+              `  lighterModel:  ${updated.lighterModel ?? "(not set)"}`,
+              `  provider:      ${updated.provider ?? "(auto-detected)"}`,
+              `\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550`,
+              `
+Saved to: ${writtenPath}`,
+              `
+Note: Changes take effect immediately for new generate/grade calls.`,
+              `       A running harness will pick up the new config on the next tool call.`
+            ].join("\n");
+          }
         })
       }
     };
   } catch (e) {
+    pipeLog(`PLUGIN INIT FAILED (no-op): ${String(e)}`);
     log(`PLUGIN INIT FAILED (no-op): ${String(e)}`);
     return NOOP_HOOKS;
   }
@@ -2168,8 +2245,11 @@ export {
   providerAdvice,
   providerToCodexbar,
   readHarness,
+  readHarnessCfg,
   readRules,
+  UsageCoachPlugin as server,
   setStateDir,
   updateSubSession,
-  writeHarness
+  writeHarness,
+  writeHarnessCfg
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "opencode-usage-coach",
-  "version": "0.9.1",
+  "version": "0.10.1",
   "description": "opencode closed-loop usage coach — quota SENSE -> coaching DECIDE -> loop ACT + TUI integration",
   "type": "module",
   "main": "./dist/index.js",