opencode-agenthub 0.1.0 → 0.1.1

package/README.md

@@ -1,8 +1,11 @@
 # opencode-agenthub
 
-> **Alpha.** Requires Node >= 18.0.0. macOS and Linux are primary targets. Windows users should use WSL 2 for the best experience; native Windows remains best-effort in alpha.
+[![npm version](https://img.shields.io/npm/v/opencode-agenthub.svg)](https://www.npmjs.com/package/opencode-agenthub)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)
 
-`opencode-agenthub` is a lightweight framework and CLI for organizing your AI agents, skills, prompts, and workspace runtime setup into one consistent structure.
+> Requires Node >= 18.0.0. Supports macOS and Linux directly. Windows users should use WSL 2 for the best experience; native Windows support remains best-effort alpha.
+
+`opencode-agenthub` is a control plane and CLI for organizing, composing, and activating OpenCode agents, skills, profiles, bundles, and workspace runtime setup.
 
 The npm package name is `opencode-agenthub`. The CLI command is `agenthub`. `opencode-agenthub` also works as a compatibility alias.
 

package/dist/composer/library/bundles/auto.json

@@ -9,7 +9,7 @@
     "name": "auto",
     "mode": "primary",
     "hidden": false,
-    "model": "github-copilot/claude-sonnet-4.5",
+    "model": "",
     "description": "Default coding agent with OMO-style intent detection and native build/edit/test workflow",
     "permission": {
       "*": "allow"

package/dist/composer/opencode-profile.js

@@ -46,10 +46,12 @@ import {
 } from "./settings.js";
 import {
   displayHomeConfigPath,
+  interactivePromptResetSequence,
   resolvePythonCommand,
   shouldChmod,
   shouldOfferEnvrc,
   spawnOptions,
+  stripTerminalControlInput,
   windowsStartupNotice
 } from "./platform.js";
 const cliCommand = "agenthub";
@@ -1186,10 +1188,23 @@ const maybeConfigureEnvrc = async (workspace, configRoot) => {
     rl.close();
   }
 };
-const createPromptInterface = () => readline.createInterface({ input: process.stdin, output: process.stdout });
+const createPromptInterface = () => {
+  const interactive = Boolean(process.stdin.isTTY && process.stdout.isTTY);
+  if (interactive) {
+    const resetSequence = interactivePromptResetSequence();
+    if (resetSequence) process.stdout.write(resetSequence);
+  }
+  return readline.createInterface({
+    input: process.stdin,
+    output: process.stdout,
+    terminal: interactive
+  });
+};
+const askPrompt = async (rl, question) => stripTerminalControlInput(await rl.question(question));
 const promptRequired = async (rl, question, defaultValue) => {
   while (true) {
-    const answer = await rl.question(
+    const answer = await askPrompt(
+      rl,
       defaultValue ? `${question} [${defaultValue}]: ` : `${question}: `
     );
     const value = normalizeOptional(answer) || defaultValue;
@@ -1198,14 +1213,16 @@ const promptRequired = async (rl, question, defaultValue) => {
   }
 };
 const promptOptional = async (rl, question, defaultValue) => {
-  const answer = await rl.question(
+  const answer = await askPrompt(
+    rl,
     defaultValue ? `${question} [${defaultValue}]: ` : `${question}: `
   );
   return normalizeOptional(answer) || defaultValue;
 };
 const promptCsv = async (rl, question, defaultValues = []) => {
   const defaultValue = defaultValues.join(", ");
-  const answer = await rl.question(
+  const answer = await askPrompt(
+    rl,
     defaultValue ? `${question} [${defaultValue}]: ` : `${question}: `
   );
   return normalizeCsv(answer || defaultValue);
@@ -1213,7 +1230,7 @@ const promptCsv = async (rl, question, defaultValues = []) => {
 const promptBoolean = async (rl, question, defaultValue) => {
   const suffix = defaultValue ? "[Y/n]" : "[y/N]";
   while (true) {
-    const answer = (await rl.question(`${question} ${suffix}: `)).trim().toLowerCase();
+    const answer = (await askPrompt(rl, `${question} ${suffix}: `)).trim().toLowerCase();
     if (!answer) return defaultValue;
     if (answer === "y" || answer === "yes") return true;
     if (answer === "n" || answer === "no") return false;
@@ -1223,7 +1240,7 @@ const promptBoolean = async (rl, question, defaultValue) => {
 const promptChoice = async (rl, question, choices, defaultValue) => {
   const label = `${question} [${choices.join("/")}] (${defaultValue})`;
   while (true) {
-    const answer = (await rl.question(`${label}: `)).trim().toLowerCase();
+    const answer = (await askPrompt(rl, `${label}: `)).trim().toLowerCase();
     if (!answer) return defaultValue;
     const match = choices.find((choice) => choice === answer);
     if (match) return match;
@@ -1238,7 +1255,10 @@ const promptIndexedChoice = async (rl, question, choices, defaultValue) => {
   });
   const defaultIndex = Math.max(choices.indexOf(defaultValue), 0) + 1;
   while (true) {
-    const answer = (await rl.question(`${question} [1-${choices.length}] (${defaultIndex}): `)).trim().toLowerCase();
+    const answer = (await askPrompt(
+      rl,
+      `${question} [1-${choices.length}] (${defaultIndex}): `
+    )).trim().toLowerCase();
     if (!answer) return defaultValue;
     const numeric = Number(answer);
     if (Number.isInteger(numeric) && numeric >= 1 && numeric <= choices.length) {
@@ -1522,7 +1542,8 @@ const createSkillDefinition = async (root, name, reservedOk = false) => {
 };
 const readProfileDefinition = async (root, name) => readJsonIfExists(path.join(root, "profiles", `${name}.json`));
 const promptRecord = async (rl, question) => {
-  const answer = await rl.question(
+  const answer = await askPrompt(
+    rl,
     `${question} (comma-separated key=value, blank to skip): `
   );
   const entries = normalizeCsv(answer);

package/dist/composer/platform.js

@@ -5,6 +5,20 @@ const shouldChmod = (win) => !isWindows(win);
 const shouldOfferEnvrc = (win) => !isWindows(win);
 const resolvePythonCommand = (win) => isWindows(win) ? "python" : "python3";
 const spawnOptions = (win) => isWindows(win) ? { shell: true } : {};
+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 interactivePromptResetSequence = (win = detectWindows()) => isWindows(win) ? [
+  "\x1B[?1000l",
+  "\x1B[?1001l",
+  "\x1B[?1002l",
+  "\x1B[?1003l",
+  "\x1B[?1005l",
+  "\x1B[?1006l",
+  "\x1B[?1015l"
+].join("") : "";
 const generateRunScript = () => `#!/usr/bin/env bash
 set -euo pipefail
 
@@ -37,12 +51,14 @@ export {
   displayHomeConfigPath,
   generateRunCmd,
   generateRunScript,
+  interactivePromptResetSequence,
   isWindows,
   resolveHomeConfigRoot,
   resolvePythonCommand,
   shouldChmod,
   shouldOfferEnvrc,
   spawnOptions,
+  stripTerminalControlInput,
   symlinkType,
   windowsStartupNotice
 };

package/dist/skills/agenthub-doctor/fix.js

@@ -132,7 +132,7 @@ async function createBundleForSoul(targetRoot, soulName, options = {}) {
       agent: {
         name: options.agentName ?? soulName,
         mode: options.mode ?? "primary",
-        model: options.model || "github-copilot/claude-sonnet-4.5",
+        model: options.model ?? "",
         description: "Auto-generated bundle for imported soul"
       }
     };

package/dist/skills/agenthub-doctor/interactive.js

@@ -149,9 +149,9 @@ async function createBundleFlow(rl, targetRoot) {
   const modeInput = await rl.question("Mode [primary/subagent, default: primary]: ");
   const mode = modeInput.trim() === "subagent" ? "subagent" : "primary";
   const modelInput = await rl.question(
-    "Model [default: github-copilot/claude-sonnet-4.5]: "
+    "Model [default: none]: "
   );
-  const model = modelInput.trim() || "github-copilot/claude-sonnet-4.5";
+  const model = modelInput.trim();
   const result = await createBundleForSoul(targetRoot, soulName.trim(), {
     agentName: finalAgentName,
     mode,

package/dist/skills/hr-support/bin/validate_staged_package.py

@@ -9,12 +9,22 @@ import tempfile
 from pathlib import Path
 
 
-def resolve_agenthub_bin() -> str:
+def wrap_executable(command: str) -> list[str]:
+    path = Path(command)
+    suffix = path.suffix.lower()
+    if suffix == ".js":
+        return ["node", command]
+    if os.name == "nt" and suffix in {".cmd", ".bat"}:
+        return ["cmd", "/c", command]
+    return [command]
+
+
+def resolve_agenthub_command() -> list[str]:
     if os.getenv("OPENCODE_AGENTHUB_BIN"):
-        return os.environ["OPENCODE_AGENTHUB_BIN"]
+        return wrap_executable(os.environ["OPENCODE_AGENTHUB_BIN"])
     found = shutil.which("opencode-agenthub")
     if found:
-        return found
+        return wrap_executable(found)
     # Portable repo-local fallback: when running from src/skills/hr-support/bin/
     # inside the source tree, try <repo-root>/bin/opencode-agenthub
     this_file = Path(__file__).resolve()
@@ -28,13 +38,19 @@ def resolve_agenthub_bin() -> str:
         and parts[-4] == "skills"
         and parts[-5] == "src"
     ):
+        repo_bin_cmd = this_file.parents[4] / "bin" / "opencode-agenthub.cmd"
+        if os.name == "nt" and repo_bin_cmd.exists():
+            return ["cmd", "/c", str(repo_bin_cmd)]
         repo_bin = this_file.parents[4] / "bin" / "opencode-agenthub"
-        if repo_bin.exists():
-            return str(repo_bin)
+        if os.name != "nt" and repo_bin.exists():
+            return [str(repo_bin)]
+        repo_dist = this_file.parents[4] / "dist" / "composer" / "opencode-profile.js"
+        if repo_dist.exists():
+            return ["node", str(repo_dist)]
     raise SystemExit(
         "Could not locate opencode-agenthub.\n"
         "  Set OPENCODE_AGENTHUB_BIN to the full path, or add opencode-agenthub to PATH.\n"
-        "  When running from source, ensure bin/opencode-agenthub exists in the repo root."
+        "  When running from source, ensure bin/opencode-agenthub (or .cmd on Windows) exists, or build dist/composer/opencode-profile.js in the repo root."
     )
 
 
@@ -223,7 +239,6 @@ def main() -> int:
             "Usage: validate_staged_package.py <stage-package-root|agenthub-home-root>"
         )
 
-    agenthub_bin = resolve_agenthub_bin()
     import_root = resolve_import_root(sys.argv[1])
     workspace_root = Path.cwd()
     validate_bundle_metadata(import_root)
@@ -235,6 +250,9 @@ def main() -> int:
     if not profiles:
         raise SystemExit("No profiles found in staged import root.")
 
+    # Integration smoke phase below requires a runnable agenthub binary.
+    agenthub_cmd = resolve_agenthub_command()
+
     with tempfile.TemporaryDirectory(prefix="agenthub-stage-validate-") as temp_dir:
         temp_root = Path(temp_dir)
         temp_home = temp_root / "home"
@@ -243,7 +261,7 @@ def main() -> int:
 
         run(
             [
-                agenthub_bin,
+                *agenthub_cmd,
                 "setup",
                 "minimal",
                 "--target-root",
@@ -252,7 +270,7 @@ def main() -> int:
         )
         run(
             [
-                agenthub_bin,
+                *agenthub_cmd,
                 "hub-import",
                 "--source",
                 str(import_root),
@@ -268,7 +286,7 @@ def main() -> int:
         for profile in profiles:
             run(
                 [
-                    agenthub_bin,
+                    *agenthub_cmd,
                     "run",
                     profile,
                     "--workspace",

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "opencode-agenthub",
-  "version": "0.1.0",
-  "description": "Systematic control plane for opencode agents, skills, profiles, and shared runtime assets.",
+  "version": "0.1.1",
+  "description": "A control plane for organizing, composing, and activating OpenCode agents, skills, profiles, and bundles.",
   "type": "module",
   "main": "./dist/plugins/opencode-agenthub.js",
   "exports": {
@@ -15,7 +15,7 @@
   "scripts": {
     "build": "node scripts/build.mjs",
     "test:smoke": "bun test test/smoke-*.test.ts",
-    "prepublishOnly": "npm run build"
+    "prepack": "npm run build"
   },
   "files": [
     "LICENSE",