opencode-agenthub 0.1.1 → 0.1.3

package/dist/composer/opencode-profile.js

@@ -37,19 +37,28 @@ import {
 import { readPackageVersion } from "./package-version.js";
 import {
   mergeAgentHubSettingsDefaults,
-  hrPrimaryAgentName,
-  hrSubagentNames,
+  hrAgentNames,
+  loadNativeOpenCodePreferences,
+  listAvailableOpencodeModels,
+  probeOpencodeModelAvailability,
+  readHrKnownModelIds,
   recommendedHrBootstrapModel,
-  recommendedHrBootstrapVariant,
   readAgentHubSettings,
+  resolveHrBootstrapAgentModels,
+  validateHrAgentModelConfiguration,
   writeAgentHubSettings
 } from "./settings.js";
+import {
+  validateModelAgainstCatalog,
+  validateModelIdentifier
+} from "./model-utils.js";
 import {
   displayHomeConfigPath,
   interactivePromptResetSequence,
   resolvePythonCommand,
   shouldChmod,
   shouldOfferEnvrc,
+  shouldUseReadlineTerminal,
   spawnOptions,
   stripTerminalControlInput,
   windowsStartupNotice
@@ -146,8 +155,8 @@ FLAGS (hr)
   hr <profile>         Test an HR-home profile in the current workspace
   hr last              Reuse the last HR profile tested in this workspace
   hr set <profile>     Unsupported (use explicit '${cliCommand} hr <profile>' each time)
-  first bootstrap      Interactive terminals can choose recommended / free / custom
-                       defaults to openai/gpt-5.4-mini when left blank
+  first bootstrap      HR first asks about your situation, inspects resources,
+                       reports a recommendation, then lets you accept or override it
 
 FLAGS (new / compose profile)
   --from <profile>      Seed bundles/plugins from an existing profile
@@ -711,6 +720,7 @@ const printRuntimeBanner = (label, root) => {
   process.stdout.write(`[agenthub] Home: ${root}
 `);
 };
+let suppressNextHrRuntimeBanner = false;
 const listPromotablePackageIds = async (hrRoot = defaultHrHome()) => {
   try {
     const entries = await readdir(path.join(hrRoot, "staging"), { withFileTypes: true });
@@ -840,70 +850,285 @@ const ensureHomeReadyOrBootstrap = async (targetRoot = defaultAgentHubHome()) =>
   process.stdout.write(`\u2713 First run \u2014 initialised coding system at ${targetRoot}
 `);
 };
-const promptHrBootstrapModelSelection = async (hrRoot) => {
-  const rl = createPromptInterface();
-  try {
-    process.stdout.write("\nFirst-time HR Office setup\n");
-    process.stdout.write("Choose an HR model preset:\n");
+const formatCountLabel = (count, singular, plural = `${singular}s`) => {
+  if (count === null) return `unknown ${plural}`;
+  return `${count} ${count === 1 ? singular : plural}`;
+};
+const inspectHrBootstrapResources = async (hrRoot) => {
+  const [configuredGithubSources, configuredModelCatalogSources, knownModels, availableModels, freeModels, native] = await Promise.all([
+    countConfiguredHrGithubSources(hrRoot),
+    countConfiguredHrModelCatalogSources(hrRoot),
+    readHrKnownModelIds(hrRoot),
+    listAvailableOpencodeModels(),
+    listOpencodeFreeModels(),
+    loadNativeOpenCodePreferences()
+  ]);
+  const recommendedAvailability = await probeOpencodeModelAvailability(
+    recommendedHrBootstrapModel,
+    { listModels: async () => availableModels }
+  );
+  return {
+    configuredGithubSources,
+    configuredModelCatalogSources,
+    knownModels,
+    availableModels,
+    freeModels,
+    nativeModel: native?.model,
+    recommendedAvailability
+  };
+};
+const recommendHrBootstrapSelection = (resources) => {
+  if (resources.recommendedAvailability.available) {
+    return {
+      strategy: "recommended",
+      summary: `I recommend starting with the recommended HR model (${recommendedHrBootstrapModel}).`,
+      reason: "It is available in this opencode environment and matches the built-in HR default."
+    };
+  }
+  if (resources.freeModels.length > 0) {
+    return {
+      strategy: "free",
+      summary: "I recommend starting with the best available free HR model.",
+      reason: `${resources.recommendedAvailability.message} A free fallback is available right now.`
+    };
+  }
+  const nativeModelSyntax = resources.nativeModel ? validateModelIdentifier(resources.nativeModel) : void 0;
+  if (resources.nativeModel && nativeModelSyntax?.ok) {
+    return {
+      strategy: "native",
+      summary: `I recommend reusing your native default model (${resources.nativeModel}).`,
+      reason: "No verified free fallback is visible, but your native opencode default looks usable."
+    };
+  }
+  return {
+    strategy: "custom",
+    summary: "I recommend entering a custom HR model now.",
+    reason: "The recommended preset is not currently verified and no safer automatic fallback was found."
+  };
+};
+const printHrBootstrapAssessment = (resources, recommendation) => {
+  void resources;
+  process.stdout.write(`
+Recommended setup:
+${recommendation.summary}
+
+`);
+};
+const buildHrModelSelection = async (rl, hrRoot, strategy) => {
+  if (strategy === "recommended") {
     process.stdout.write(
-      `  recommended  Use ${recommendedHrBootstrapModel} (${recommendedHrBootstrapVariant})
+      `[agenthub] Recommended HR preset requires OpenAI model access in your opencode environment.
 `
     );
-    process.stdout.write(
-      "  free         Pick from current opencode free models (quality may drop)\n"
+    return {
+      consoleModel: recommendedHrBootstrapModel,
+      subagentStrategy: "recommended",
+      sharedSubagentModel: recommendedHrBootstrapModel
+    };
+  }
+  if (strategy === "native") {
+    const native = await loadNativeOpenCodePreferences();
+    if (!native?.model) {
+      process.stdout.write("[agenthub] No native default model is configured. Choose another fallback.\n");
+      return buildHrModelSelection(rl, hrRoot, "free");
+    }
+    return {
+      consoleModel: native.model,
+      subagentStrategy: "native",
+      sharedSubagentModel: native.model
+    };
+  }
+  if (strategy === "free") {
+    const freeModels = await listOpencodeFreeModels();
+    const fallbackFreeModel = freeModels.includes("opencode/minimax-m2.5-free") ? "opencode/minimax-m2.5-free" : freeModels[0] || "opencode/minimax-m2.5-free";
+    const choices = freeModels.length > 0 ? freeModels : [fallbackFreeModel];
+    process.stdout.write("Current opencode free models:\n");
+    const selected = choices.length === 1 ? (process.stdout.write(`  1. ${choices[0]}
+`), choices[0]) : await promptIndexedChoice(
+      rl,
+      "Choose a free model for HR",
+      choices,
+      fallbackFreeModel
     );
-    process.stdout.write("  custom       Enter any model id yourself\n\n");
-    const subagentStrategy = await promptChoice(
+    return {
+      consoleModel: selected,
+      subagentStrategy: "free",
+      sharedSubagentModel: selected
+    };
+  }
+  const custom = await promptRequired(rl, "Custom HR model", recommendedHrBootstrapModel);
+  return {
+    consoleModel: custom,
+    subagentStrategy: "custom",
+    sharedSubagentModel: custom
+  };
+};
+const checkHrBootstrapSelection = async (hrRoot, selection) => {
+  const model = selection.sharedSubagentModel || selection.consoleModel;
+  if (!model) {
+    return {
+      ok: false,
+      selection,
+      stage: "syntax",
+      message: "Model id cannot be blank."
+    };
+  }
+  const syntax = validateModelIdentifier(model);
+  if (!syntax.ok) {
+    return { ok: false, selection, stage: "syntax", message: syntax.message };
+  }
+  const knownModels = await readHrKnownModelIds(hrRoot);
+  const catalog = validateModelAgainstCatalog(model, knownModels);
+  if (!catalog.ok) {
+    return { ok: false, selection, stage: "catalog", message: catalog.message };
+  }
+  const availability = await probeOpencodeModelAvailability(model, {
+    listModels: listAvailableOpencodeModels
+  });
+  if (!availability.available) {
+    return {
+      ok: false,
+      selection,
+      stage: availability.reason === "probe_failed" ? "probe_failed" : "availability",
+      message: availability.message
+    };
+  }
+  return { ok: true, selection };
+};
+const promptValidatedHrModelSelection = async (rl, hrRoot, strategy) => {
+  let selection = await buildHrModelSelection(rl, hrRoot, strategy);
+  while (true) {
+    const check = await checkHrBootstrapSelection(hrRoot, selection);
+    if (check.ok) return check.selection;
+    process.stdout.write(`${check.message}
+`);
+    if (check.stage === "syntax" && selection.subagentStrategy === "custom") {
+      selection = await buildHrModelSelection(rl, hrRoot, "custom");
+      continue;
+    }
+    const action = await promptChoice(
       rl,
-      "HR model preset",
-      ["recommended", "free", "custom"],
-      "recommended"
+      check.stage === "probe_failed" ? "Model verification failed \u2014 continue or choose a fallback" : "Choose a fallback",
+      ["continue", "free", "native", "custom", "retry recommended"],
+      check.stage === "probe_failed" ? "continue" : "free"
     );
-    let sharedSubagentModel;
-    let consoleModel;
-    if (subagentStrategy === "recommended") {
-      consoleModel = recommendedHrBootstrapModel;
-      sharedSubagentModel = recommendedHrBootstrapModel;
-    }
-    if (subagentStrategy === "free") {
-      const freeModels = await listOpencodeFreeModels();
-      const fallbackFreeModel = freeModels.includes("opencode/minimax-m2.5-free") ? "opencode/minimax-m2.5-free" : freeModels[0] || "opencode/minimax-m2.5-free";
-      process.stdout.write("Current opencode free models:\n");
-      sharedSubagentModel = await promptIndexedChoice(
-        rl,
-        "Choose a free model for HR",
-        freeModels.length > 0 ? freeModels : [fallbackFreeModel],
-        fallbackFreeModel
-      );
-      consoleModel = sharedSubagentModel;
-    } else if (subagentStrategy === "custom") {
-      sharedSubagentModel = await promptRequired(
+    if (action === "continue") return selection;
+    selection = await buildHrModelSelection(
+      rl,
+      hrRoot,
+      action === "retry recommended" ? "recommended" : action
+    );
+  }
+};
+const promptHrBootstrapModelSelection = async (hrRoot) => {
+  const rl = createPromptInterface();
+  try {
+    process.stdout.write("\nFirst-time HR Office setup\n");
+    const resources = await inspectHrBootstrapResources(hrRoot);
+    const recommendation = recommendHrBootstrapSelection(resources);
+    printHrBootstrapAssessment(resources, recommendation);
+    while (true) {
+      const action = await promptChoice(
         rl,
-        "Custom HR model",
-        recommendedHrBootstrapModel
+        "Apply this recommendation now",
+        ["accept", "recommended", "free", "native", "custom"],
+        "accept"
       );
-      consoleModel = sharedSubagentModel;
+      const strategy = action === "accept" ? recommendation.strategy : action;
+      const validated = await promptValidatedHrModelSelection(rl, hrRoot, strategy);
+      const finalModel = validated.sharedSubagentModel || validated.consoleModel;
+      if (!finalModel) continue;
+      const finalSyntax = validateModelIdentifier(finalModel);
+      if (finalSyntax.ok) {
+        return validated;
+      }
     }
-    process.stdout.write(`
-[agenthub] HR settings will be written to ${path.join(hrRoot, "settings.json")}
+  } finally {
+    rl.close();
+  }
+};
+const shouldUseInteractivePrompts = () => process.env.OPENCODE_AGENTHUB_FORCE_INTERACTIVE_PROMPTS === "1" || Boolean(process.stdin.isTTY && process.stdout.isTTY);
+const applyHrModelSelection = async (targetRoot, selection) => {
+  await installHrOfficeHomeWithOptions({
+    hrRoot: targetRoot,
+    hrModelSelection: selection
+  });
+};
+const repairHrModelConfigurationIfNeeded = async (targetRoot) => {
+  const settings = await readAgentHubSettings(targetRoot);
+  if (!shouldUseInteractivePrompts()) {
+    for (const agentName of hrAgentNames) {
+      const model = settings?.agents?.[agentName]?.model;
+      if (typeof model !== "string" || model.trim().length === 0) continue;
+      const syntax = validateModelIdentifier(model);
+      if (!syntax.ok) {
+        fail(`HR model configuration needs attention. Agent '${agentName}' model '${model}' is invalid: ${syntax.message}`);
+      }
+    }
+    return;
+  }
+  const status = await validateHrAgentModelConfiguration(targetRoot, settings);
+  if (status.valid) return;
+  const rl = createPromptInterface();
+  try {
+    process.stdout.write("[agenthub] HR model configuration needs attention.\n");
+    if (status.message) process.stdout.write(`${status.message}
 `);
-    return {
-      consoleModel,
-      subagentStrategy,
-      sharedSubagentModel
+    const repair = await promptBoolean(
+      rl,
+      "Reconfigure HR models now?",
+      true
+    );
+    if (!repair) {
+      fail("Aborted before repairing invalid HR model configuration.");
+    }
+    const fallback = await promptChoice(
+      rl,
+      "Choose a fallback",
+      ["free", "native", "custom", "retry recommended"],
+      "free"
+    );
+    const validated = await promptValidatedHrModelSelection(
+      rl,
+      targetRoot,
+      fallback === "retry recommended" ? "recommended" : fallback
+    );
+    const resolved = await resolveHrBootstrapAgentModels({
+      targetRoot,
+      selection: validated
+    });
+    const merged = mergeAgentHubSettingsDefaults(settings || {});
+    merged.agents = merged.agents || {};
+    for (const agentName of hrAgentNames) {
+      const resolvedSelection = resolved.agentModels[agentName];
+      merged.agents[agentName] = {
+        ...merged.agents[agentName] || {},
+        model: resolvedSelection.model,
+        ...resolvedSelection.variant ? { variant: resolvedSelection.variant } : {}
+      };
+      if (!resolvedSelection.variant) delete merged.agents[agentName].variant;
+    }
+    merged.meta = {
+      ...merged.meta,
+      onboarding: {
+        ...merged.meta?.onboarding,
+        modelStrategy: resolved.strategy,
+        mode: merged.meta?.onboarding?.mode || "hr-office",
+        importedNativeBasics: merged.meta?.onboarding?.importedNativeBasics ?? true,
+        importedNativeAgents: merged.meta?.onboarding?.importedNativeAgents ?? true,
+        createdAt: merged.meta?.onboarding?.createdAt || (/* @__PURE__ */ new Date()).toISOString()
+      }
     };
+    await writeAgentHubSettings(targetRoot, merged);
+    process.stdout.write("[agenthub] Updated HR model configuration.\n");
   } finally {
     rl.close();
   }
 };
 const printHrModelOverrideHint = (targetRoot) => {
-  process.stdout.write(
-    [
-      `[agenthub] HR model settings: ${path.join(targetRoot, "settings.json")}`,
-      `[agenthub] Change later with: ${cliCommand} doctor --target-root ${targetRoot} --agent ${hrPrimaryAgentName} --model <model>`,
-      `[agenthub] HR subagents: ${hrSubagentNames.join(", ")} (use the same doctor command with --agent <name>)`
-    ].join("\n") + "\n"
-  );
+  void targetRoot;
+  process.stdout.write(`Tip: change HR models later with '${cliCommand} doctor'.
+`);
 };
 const countConfiguredHrGithubSources = async (targetRoot) => {
   try {
@@ -954,8 +1179,12 @@ const syncHrSourceInventoryOnFirstRun = async (targetRoot) => {
     );
   }
   const sourceLabel = sourceParts.length > 0 ? sourceParts.join(" + ") : "configured HR sources";
-  process.stdout.write(`[agenthub] First run \u2014 syncing HR inventory from ${sourceLabel}...
-`);
+  process.stdout.write(
+    `
+Step 3/3 \xB7 Sync inventory
+Sync the HR sourcer inventory from ${sourceLabel} \u2014 this may take a moment, please wait...
+`
+  );
   try {
     const pythonCommand = resolvePythonCommand();
     const scriptPath = path.join(targetRoot, "bin", "sync_sources.py");
@@ -982,12 +1211,10 @@ const syncHrSourceInventoryOnFirstRun = async (targetRoot) => {
     });
     const summary = stdout.trim();
     if (code === 0) {
-      if (summary) process.stdout.write(`${summary}
+      void summary;
+      const repoSummary = configuredSourceCount && configuredSourceCount > 0 ? `${configuredSourceCount} repo${configuredSourceCount === 1 ? "" : "s"}` : "configured sources";
+      process.stdout.write(`\u2713 HR sourcer inventory sync complete (${repoSummary}).
 `);
-      process.stdout.write(
-        `[agenthub] HR source status: ${path.join(targetRoot, "source-status.json")}
-`
-      );
       return;
     }
     process.stderr.write(
@@ -1007,18 +1234,33 @@ const syncHrSourceInventoryOnFirstRun = async (targetRoot) => {
 };
 const ensureHrOfficeReadyOrBootstrap = async (targetRoot = defaultHrHome(), options = {}) => {
   if (await hrHomeInitialized(targetRoot)) return;
-  const shouldPrompt = process.stdin.isTTY && process.stdout.isTTY;
+  const shouldPrompt = shouldUseInteractivePrompts();
+  process.stdout.write("\nHR Office \u2014 first-time setup\n\n");
+  process.stdout.write(
+    "Heads up: a full HR assemble can take about 20\u201330 minutes because AI may need time to choose and evaluate the souls and skills your agents need.\n\n"
+  );
+  process.stdout.write("This will:\n");
+  process.stdout.write("1. Choose an AI model for HR agents\n");
+  process.stdout.write("2. Create the HR Office workspace\n");
+  if (options.syncSourcesOnFirstRun ?? true) {
+    process.stdout.write("3. Sync the HR sourcer inventory (this may take a little longer)\n\n");
+  } else {
+    process.stdout.write("3. Skip inventory sync for now because you are assembling only\n\n");
+  }
   const hrModelSelection = shouldPrompt ? await promptHrBootstrapModelSelection(targetRoot) : void 0;
-  await installHrOfficeHomeWithOptions({
-    hrRoot: targetRoot,
-    hrModelSelection
-  });
-  process.stdout.write(`\u2713 First run \u2014 initialised HR Office at ${targetRoot}
+  await applyHrModelSelection(targetRoot, hrModelSelection || {});
+  process.stdout.write(`
+Step 2/3 \xB7 Create workspace
+\u2713 First run \u2014 initialised HR Office at ${targetRoot}
 `);
   printHrModelOverrideHint(targetRoot);
   if (options.syncSourcesOnFirstRun ?? true) {
     await syncHrSourceInventoryOnFirstRun(targetRoot);
   }
+  process.stdout.write(`
+\u2713 HR Office is ready.
+`);
+  suppressNextHrRuntimeBanner = true;
 };
 const isHrRuntimeSelection = (selection) => selection?.kind === "profile" && selection.profile === "hr";
 const normalizeCsv = (value) => value.split(",").map((item) => item.trim()).filter(Boolean);
@@ -1190,17 +1432,38 @@ const maybeConfigureEnvrc = async (workspace, configRoot) => {
 };
 const createPromptInterface = () => {
   const interactive = Boolean(process.stdin.isTTY && process.stdout.isTTY);
-  if (interactive) {
+  const terminal = interactive && shouldUseReadlineTerminal();
+  if (terminal) {
     const resetSequence = interactivePromptResetSequence();
     if (resetSequence) process.stdout.write(resetSequence);
   }
   return readline.createInterface({
     input: process.stdin,
     output: process.stdout,
-    terminal: interactive
+    terminal
   });
 };
-const askPrompt = async (rl, question) => stripTerminalControlInput(await rl.question(question));
+const scriptedPromptAnswers = (() => {
+  const raw = process.env.OPENCODE_AGENTHUB_SCRIPTED_ANSWERS;
+  if (!raw) return void 0;
+  try {
+    const parsed2 = JSON.parse(raw);
+    return Array.isArray(parsed2) ? parsed2.map((value) => typeof value === "string" ? value : String(value)) : void 0;
+  } catch {
+    return raw.split("\n");
+  }
+})();
+let scriptedPromptIndex = 0;
+const askPrompt = async (rl, question) => {
+  if (scriptedPromptAnswers && scriptedPromptIndex < scriptedPromptAnswers.length) {
+    const answer = scriptedPromptAnswers[scriptedPromptIndex++] || "";
+    const sanitized = stripTerminalControlInput(answer);
+    process.stdout.write(`${question}${sanitized}
+`);
+    return sanitized;
+  }
+  return stripTerminalControlInput(await rl.question(question));
+};
 const promptRequired = async (rl, question, defaultValue) => {
   while (true) {
     const answer = await askPrompt(
@@ -2260,6 +2523,7 @@ if (parsed.command === "hr") {
   await ensureHrOfficeReadyOrBootstrap(resolveSelectedHomeRoot(parsed), {
     syncSourcesOnFirstRun: !parsed.assembleOnly
   });
+  await repairHrModelConfigurationIfNeeded(resolveSelectedHomeRoot(parsed) || defaultHrHome());
   if (parsed.hrIntent?.kind === "office") {
     parsed.workspace = resolveSelectedHomeRoot(parsed) || defaultHrHome();
   } else if (parsed.hrIntent?.kind === "compose") {
@@ -2284,10 +2548,13 @@ if (parsed.command === "run" || parsed.command === "start" || parsed.command ===
 }
 const finalConfigRoot = resolveConfigRoot(parsed);
 const result = await composeSelection(parsed, finalConfigRoot);
-printRuntimeBanner(
-  parsed.command === "hr" ? "HR Office" : "My Team",
-  resolveSelectedHomeRoot(parsed) || defaultAgentHubHome()
-);
+if (!(parsed.command === "hr" && suppressNextHrRuntimeBanner)) {
+  printRuntimeBanner(
+    parsed.command === "hr" ? "HR Office" : "My Team",
+    resolveSelectedHomeRoot(parsed) || defaultAgentHubHome()
+  );
+}
+suppressNextHrRuntimeBanner = false;
 if (shouldChmod()) {
   await chmod(path.join(result.configRoot, "run.sh"), 493);
 }

package/dist/composer/platform.js

@@ -9,7 +9,8 @@ const csiSequencePattern = /\u001b\[[0-?]*[ -/]*[@-~]/g;
 const oscSequencePattern = /\u001b\][^\u0007\u001b]*(?:\u0007|\u001b\\)/g;
 const singleEscapePattern = /\u001b[@-_]/g;
 const controlCharacterPattern = /[\u0000-\u001f\u007f]/g;
-const stripTerminalControlInput = (value) => value.replace(oscSequencePattern, "").replace(csiSequencePattern, "").replace(singleEscapePattern, "").replace(controlCharacterPattern, "");
+const degradedLeadingCsiFragmentPattern = /^(?:(?:\d{1,3};){1,10}\d{1,3}m)+/;
+const stripTerminalControlInput = (value) => value.replace(oscSequencePattern, "").replace(csiSequencePattern, "").replace(singleEscapePattern, "").replace(controlCharacterPattern, "").replace(degradedLeadingCsiFragmentPattern, "");
 const interactivePromptResetSequence = (win = detectWindows()) => isWindows(win) ? [
   "\x1B[?1000l",
   "\x1B[?1001l",
@@ -19,6 +20,7 @@ const interactivePromptResetSequence = (win = detectWindows()) => isWindows(win)
   "\x1B[?1006l",
   "\x1B[?1015l"
 ].join("") : "";
+const shouldUseReadlineTerminal = (win = detectWindows()) => !isWindows(win);
 const generateRunScript = () => `#!/usr/bin/env bash
 set -euo pipefail
 
@@ -57,6 +59,7 @@ export {
   resolvePythonCommand,
   shouldChmod,
   shouldOfferEnvrc,
+  shouldUseReadlineTerminal,
   spawnOptions,
   stripTerminalControlInput,
   symlinkType,