calvyn-code 0.14.0 → 0.14.1

package/bin/calvyn.js

@@ -49,14 +49,37 @@ function runPostinstallIfNeeded() {
   return calvynBinary
 }
 
+function shouldShowBanner(args) {
+  if (!args.length) return true
+  const first = String(args[0] || "").trim().toLowerCase()
+  return !["-h", "--help", "-v", "--version", "version"].includes(first)
+}
+
+function printNpmLaunchHeader() {
+  console.log("")
+  console.log("")
+  console.log("")
+  console.log("   ╔════════════════════════════════════════════════════════════════════════════╗")
+  console.log("   ║ ✦ CALVYN CODE                                                            ║")
+  console.log("   ║ Запуск через npm                                                         ║")
+  console.log("   ╚════════════════════════════════════════════════════════════════════════════╝")
+  console.log("")
+}
+
+const args = process.argv.slice(2)
+if (shouldShowBanner(args)) {
+  printNpmLaunchHeader()
+}
+
 const calvynBinary = runPostinstallIfNeeded()
-const result = spawnSync(calvynBinary, process.argv.slice(2), {
+const result = spawnSync(calvynBinary, args, {
   stdio: "inherit",
   shell: false,
   env: {
     ...process.env,
     CALVYN_LAUNCHED_FROM_NPM: "1",
     CALVYN_REPO_ROOT: packageRoot,
+    CALVYN_HOME: process.env.CALVYN_HOME || path.join(require("os").homedir(), ".calvyn"),
   },
 })
 

package/calvyn_constants.py

@@ -1,4 +1,4 @@
-"""Shared constants for Hermes Agent.
+"""Shared constants for Calvyn Code.
 
 Import-safe module with no dependencies — can be imported from anywhere
 without risk of circular imports.
@@ -8,14 +8,24 @@ import os
 from pathlib import Path
 
 
-_profile_fallback_warned: bool = False
+_profile_fallback_warned: bool = False
+_CALVYN_HOME_ENV = "CALVYN_HOME"
+_LEGACY_HOME_ENV = "HERMES_HOME"
+_DEFAULT_HOME_DIRNAME = ".calvyn"
+_LEGACY_HOME_DIRNAME = ".hermes"
 
 
-def get_hermes_home() -> Path:
-    """Return the Hermes home directory (default: ~/.hermes).
-
-    Reads HERMES_HOME env var, falls back to ~/.hermes.
-    This is the single source of truth — all other copies should import this.
+def get_hermes_home() -> Path:
+    """Return the Calvyn home directory.
+
+    Preference order:
+    1. ``CALVYN_HOME``
+    2. ``HERMES_HOME`` for legacy compatibility
+    3. ``~/.calvyn``
+    4. ``~/.hermes`` only when it already exists and ``~/.calvyn`` does not
+
+    This keeps Calvyn isolated from Hermes by default while still allowing
+    explicit legacy overrides.
 
     When ``HERMES_HOME`` is unset but an ``active_profile`` file indicates
     a non-default profile is active, logs a loud one-shot warning to
@@ -27,22 +37,26 @@ def get_hermes_home() -> Path:
     template in ``hermes_cli/gateway.py`` and the kanban dispatcher in
     ``hermes_cli/kanban_db.py``).  See https://github.com/NousResearch/hermes-agent/issues/18594.
     """
-    val = os.environ.get("HERMES_HOME", "").strip()
-    if val:
-        return Path(val)
+    val = os.environ.get(_CALVYN_HOME_ENV, "").strip()
+    if val:
+        return Path(val)
+
+    val = os.environ.get(_LEGACY_HOME_ENV, "").strip()
+    if val:
+        return Path(val)
 
     # Guard: if a non-default profile is sticky-active, warn once that
     # the fallback to the default profile is almost certainly wrong.
     global _profile_fallback_warned
     if not _profile_fallback_warned:
         try:
-            # Inline the default-root resolution from get_default_hermes_root()
-            # to stay import-safe (this function is called from module scope
-            # in 30+ files; we cannot afford to trigger logging setup here).
-            active_path = (Path.home() / ".hermes" / "active_profile")
-            active = active_path.read_text().strip() if active_path.exists() else ""
-        except (UnicodeDecodeError, OSError):
-            active = ""
+            # Inline the default-root resolution from get_default_hermes_root()
+            # to stay import-safe (this function is called from module scope
+            # in 30+ files; we cannot afford to trigger logging setup here).
+            active_path = (Path.home() / _DEFAULT_HOME_DIRNAME / "active_profile")
+            active = active_path.read_text().strip() if active_path.exists() else ""
+        except (UnicodeDecodeError, OSError):
+            active = ""
         if active and active != "default":
             _profile_fallback_warned = True
             # Write directly to stderr.  We intentionally do NOT route this
@@ -52,24 +66,28 @@ def get_hermes_home() -> Path:
             # on consoles where a StreamHandler is already attached.
             import sys
             msg = (
-                f"[HERMES_HOME fallback] HERMES_HOME is unset but active "
-                f"profile is {active!r}. Falling back to ~/.hermes, which "
-                f"is the DEFAULT profile — not {active!r}. Any data this "
-                f"process writes will land in the wrong profile. The "
-                f"subprocess spawner should pass HERMES_HOME explicitly "
-                f"(see issue #18594)."
-            )
+                f"[CALVYN_HOME fallback] CALVYN_HOME is unset but active "
+                f"profile is {active!r}. Falling back to ~/{_DEFAULT_HOME_DIRNAME}, which "
+                f"is the DEFAULT profile — not {active!r}. Any data this "
+                f"process writes will land in the wrong profile. The "
+                f"subprocess spawner should pass CALVYN_HOME explicitly "
+                f"(see issue #18594)."
+            )
             try:
                 sys.stderr.write(msg + "\n")
                 sys.stderr.flush()
             except Exception:
                 pass
 
-    return Path.home() / ".hermes"
+    calvyn_home = Path.home() / _DEFAULT_HOME_DIRNAME
+    legacy_home = Path.home() / _LEGACY_HOME_DIRNAME
+    if calvyn_home.exists() or not legacy_home.exists():
+        return calvyn_home
+    return legacy_home
 
 
-def get_default_hermes_root() -> Path:
-    """Return the root Hermes directory for profile-level operations.
+def get_default_hermes_root() -> Path:
+    """Return the root Calvyn directory for profile-level operations.
 
     In standard deployments this is ``~/.hermes``.
 
@@ -84,8 +102,8 @@ def get_default_hermes_root() -> Path:
 
     Import-safe — no dependencies beyond stdlib.
     """
-    native_home = Path.home() / ".hermes"
-    env_home = os.environ.get("HERMES_HOME", "")
+    native_home = Path.home() / _DEFAULT_HOME_DIRNAME
+    env_home = os.environ.get(_CALVYN_HOME_ENV, "") or os.environ.get(_LEGACY_HOME_ENV, "")
     if not env_home:
         return native_home
     env_path = Path(env_home)
@@ -110,10 +128,11 @@ def get_default_hermes_root() -> Path:
 def get_optional_skills_dir(default: Path | None = None) -> Path:
     """Return the optional-skills directory, honoring package-manager wrappers.
 
-    Packaged installs may ship ``optional-skills`` outside the Python package
-    tree and expose it via ``HERMES_OPTIONAL_SKILLS``.
-    """
-    override = os.getenv("HERMES_OPTIONAL_SKILLS", "").strip()
+    Packaged installs may ship ``optional-skills`` outside the Python package
+    tree and expose it via ``CALVYN_OPTIONAL_SKILLS`` or the legacy
+    ``HERMES_OPTIONAL_SKILLS``.
+    """
+    override = os.getenv("CALVYN_OPTIONAL_SKILLS", "").strip() or os.getenv("HERMES_OPTIONAL_SKILLS", "").strip()
     if override:
         return Path(override)
     if default is not None:
@@ -122,7 +141,7 @@ def get_optional_skills_dir(default: Path | None = None) -> Path:
 
 
 def get_hermes_dir(new_subpath: str, old_name: str) -> Path:
-    """Resolve a Hermes subdirectory with backward compatibility.
+    """Resolve a Calvyn subdirectory with backward compatibility.
 
     New installs get the consolidated layout (e.g. ``cache/images``).
     Existing installs that already have the old path (e.g. ``image_cache``)
@@ -143,17 +162,17 @@ def get_hermes_dir(new_subpath: str, old_name: str) -> Path:
 
 
 def display_hermes_home() -> str:
-    """Return a user-friendly display string for the current HERMES_HOME.
+    """Return a user-friendly display string for the current Calvyn home.
 
     Uses ``~/`` shorthand for readability::
 
-        default:  ``~/.hermes``
-        profile:  ``~/.hermes/profiles/coder``
-        custom:   ``/opt/hermes-custom``
+        default:  ``~/.calvyn``
+        profile:  ``~/.calvyn/profiles/coder``
+        custom:   ``/opt/hermes-custom``
 
-    Use this in **user-facing** print/log messages instead of hardcoding
-    ``~/.hermes``.  For code that needs a real ``Path``, use
-    :func:`get_hermes_home` instead.
+    Use this in **user-facing** print/log messages instead of hardcoding
+    ``~/.calvyn``.  For code that needs a real ``Path``, use
+    :func:`get_hermes_home` instead.
     """
     home = get_hermes_home()
     try:
@@ -165,7 +184,7 @@ def display_hermes_home() -> str:
 def get_subprocess_home() -> str | None:
     """Return a per-profile HOME directory for subprocesses, or None.
 
-    When ``{HERMES_HOME}/home/`` exists on disk, subprocesses should use it
+    When ``{CALVYN_HOME}/home/`` exists on disk, subprocesses should use it
     as ``HOME`` so system tools (git, ssh, gh, npm …) write their configs
     inside the Hermes data directory instead of the OS-level ``/root`` or
     ``~/``.  This provides:
@@ -179,7 +198,7 @@ def get_subprocess_home() -> str | None:
     Activation is directory-based: if the ``home/`` subdirectory doesn't
     exist, returns ``None`` and behavior is unchanged.
     """
-    hermes_home = os.getenv("HERMES_HOME")
+    hermes_home = os.getenv(_CALVYN_HOME_ENV) or os.getenv(_LEGACY_HOME_ENV)
     if not hermes_home:
         return None
     profile_home = os.path.join(hermes_home, "home")

package/cli-config.yaml

@@ -0,0 +1,21 @@
+model:
+  provider: "freemodel"
+  default: "gpt-5.5"
+  base_url: "https://api.freemodel.dev"
+  api_mode: "codex_responses"
+
+agent:
+  reasoning_effort: "xhigh"
+
+providers:
+  freemodel:
+    name: "freemodel"
+    base_url: "https://api.freemodel.dev"
+    key_env: "FREEMODEL_API_KEY"
+    api_mode: "codex_responses"
+    model: "gpt-5.5"
+
+model_provider: "freemodel"
+model_reasoning_effort: "xhigh"
+disable_response_storage: true
+preferred_auth_method: "apikey"

package/cli.py

@@ -11542,12 +11542,18 @@ class HermesCLI:
         # responses, and prompt all appear pinned to the bottom — empty
         # space stays above, not below.  This prints enough blank lines to
         # scroll the cursor to the last row before any content is rendered.
-        try:
-            _term_lines = shutil.get_terminal_size().lines
-            if _term_lines > 2:
-                print("\n" * (_term_lines - 1), end="", flush=True)
-        except Exception:
-            pass
+        try:
+            if os.getenv("CALVYN_LAUNCHED_FROM_NPM", "").strip().lower() not in {
+                "1",
+                "true",
+                "yes",
+                "on",
+            }:
+                _term_lines = shutil.get_terminal_size().lines
+                if _term_lines > 2:
+                    print("\n" * (_term_lines - 1), end="", flush=True)
+        except Exception:
+            pass
 
         self.show_banner()
         # Surface any active supply-chain security advisories right after the

package/hermes_bootstrap.py

@@ -0,0 +1 @@
+from calvyn_bootstrap import *  # noqa: F401,F403

package/hermes_cli/__init__.py

@@ -14,7 +14,7 @@ Provides subcommands for:
 import os
 import sys
 
-__version__ = "0.14.0"
+__version__ = "0.14.1"
 __release_date__ = "2026.5.16"
 
 

package/hermes_cli/auth.py

@@ -1387,8 +1387,9 @@ def resolve_provider(
         "kimi": "kimi-coding", "kimi-for-coding": "kimi-coding", "moonshot": "kimi-coding",
         "kimi-cn": "kimi-coding-cn", "moonshot-cn": "kimi-coding-cn",
         "step": "stepfun", "stepfun-coding-plan": "stepfun",
-        "arcee-ai": "arcee", "arceeai": "arcee",
-        "gmi-cloud": "gmi", "gmicloud": "gmi",
+        "arcee-ai": "arcee", "arceeai": "arcee",
+        "gmi-cloud": "gmi", "gmicloud": "gmi",
+        "freemodel": "freemodel", "free-model": "freemodel", "free_model": "freemodel",
         "minimax-china": "minimax-cn", "minimax_cn": "minimax-cn",
         "minimax-portal": "minimax-oauth", "minimax-global": "minimax-oauth", "minimax_oauth": "minimax-oauth",
         "alibaba_coding": "alibaba-coding-plan", "alibaba-coding": "alibaba-coding-plan",

package/hermes_cli/models.py

@@ -949,7 +949,8 @@ CANONICAL_PROVIDERS: list[ProviderEntry] = [
     ProviderEntry("minimax-cn",     "MiniMax (China)",          "MiniMax China (domestic direct API)"),
     ProviderEntry("ollama-cloud",   "Ollama Cloud",             "Ollama Cloud (cloud-hosted open models — ollama.com)"),
     ProviderEntry("arcee",          "Arcee AI",                 "Arcee AI (Trinity models — direct API)"),
-    ProviderEntry("gmi",            "GMI Cloud",                "GMI Cloud (multi-model direct API)"),
+    ProviderEntry("gmi",            "GMI Cloud",                "GMI Cloud (multi-model direct API)"),
+    ProviderEntry("freemodel",      "FreeModel",                "FreeModel (OpenAI-compatible direct API)"),
     ProviderEntry("kilocode",       "Kilo Code",                "Kilo Code (Kilo Gateway API)"),
     ProviderEntry("opencode-zen",   "OpenCode Zen",             "OpenCode Zen (35+ curated models, pay-as-you-go)"),
     ProviderEntry("opencode-go",    "OpenCode Go",              "OpenCode Go (open models, $10/month subscription)"),
@@ -1005,8 +1006,11 @@ _PROVIDER_ALIASES = {
     "stepfun-coding-plan": "stepfun",
     "arcee-ai": "arcee",
     "arceeai": "arcee",
-    "gmi-cloud": "gmi",
-    "gmicloud": "gmi",
+    "gmi-cloud": "gmi",
+    "gmicloud": "gmi",
+    "freemodel": "freemodel",
+    "free-model": "freemodel",
+    "free_model": "freemodel",
     "minimax-china": "minimax-cn",
     "minimax_cn": "minimax-cn",
     "minimax-portal": "minimax-oauth",

package/hermes_cli/providers.py

@@ -190,12 +190,18 @@ HERMES_OVERLAYS: Dict[str, HermesOverlay] = {
         base_url_override="https://api.arcee.ai/api/v1",
         base_url_env_var="ARCEE_BASE_URL",
     ),
-    "gmi": HermesOverlay(
-        transport="openai_chat",
-        extra_env_vars=("GMI_API_KEY",),
-        base_url_override="https://api.gmi-serving.com/v1",
-        base_url_env_var="GMI_BASE_URL",
-    ),
+    "gmi": HermesOverlay(
+        transport="openai_chat",
+        extra_env_vars=("GMI_API_KEY",),
+        base_url_override="https://api.gmi-serving.com/v1",
+        base_url_env_var="GMI_BASE_URL",
+    ),
+    "freemodel": HermesOverlay(
+        transport="openai_chat",
+        extra_env_vars=("FREEMODEL_API_KEY",),
+        base_url_override="https://api.freemodel.xyz/v1",
+        base_url_env_var="FREEMODEL_BASE_URL",
+    ),
     "ollama-cloud": HermesOverlay(
         transport="openai_chat",
         base_url_env_var="OLLAMA_BASE_URL",
@@ -349,8 +355,11 @@ ALIASES: Dict[str, str] = {
     "arceeai": "arcee",
 
     # gmi
-    "gmi-cloud": "gmi",
-    "gmicloud": "gmi",
+    "gmi-cloud": "gmi",
+    "gmicloud": "gmi",
+    "freemodel": "freemodel",
+    "free-model": "freemodel",
+    "free_model": "freemodel",
 
     # Local server aliases → virtual "local" concept (resolved via user config)
     "lmstudio": "lmstudio",
@@ -374,7 +383,8 @@ _LABEL_OVERRIDES: Dict[str, str] = {
     "copilot-acp": "GitHub Copilot ACP",
     "stepfun": "StepFun Step Plan",
     "xiaomi": "Xiaomi MiMo",
-    "gmi": "GMI Cloud",
+    "gmi": "GMI Cloud",
+    "freemodel": "FreeModel",
     "tencent-tokenhub": "Tencent TokenHub",
     "lmstudio": "LM Studio",
     "local": "Local endpoint",

package/hermes_constants.py

@@ -0,0 +1 @@
+from calvyn_constants import *  # noqa: F401,F403

package/hermes_logging.py

@@ -0,0 +1 @@
+from calvyn_logging import *  # noqa: F401,F403

package/hermes_state.py

@@ -0,0 +1 @@
+from calvyn_state import *  # noqa: F401,F403

package/hermes_time.py

@@ -0,0 +1 @@
+from calvyn_time import *  # noqa: F401,F403

package/package.json

@@ -1,9 +1,10 @@
 {
   "name": "calvyn-code",
-  "version": "0.14.0",
+  "version": "0.14.1",
   "description": "Calvyn Code — AI агент с инструментами, мессенджерами и локальным CLI",
   "bin": {
-    "calvyn": "./bin/calvyn.js"
+    "calvyn": "./bin/calvyn.js",
+    "calvyn-code": "./bin/calvyn.js"
   },
   "main": "./bin/calvyn.js",
   "keywords": [
@@ -40,6 +41,9 @@
   "engines": {
     "node": ">=20.0.0"
   },
+  "publishConfig": {
+    "access": "public"
+  },
   "files": [
     "bin",
     "scripts",
@@ -68,9 +72,15 @@
     "calvyn_state.py",
     "calvyn_time.py",
     "calvyn_logging.py",
+    "hermes_bootstrap.py",
+    "hermes_constants.py",
+    "hermes_state.py",
+    "hermes_time.py",
+    "hermes_logging.py",
     "mcp_serve.py",
     "utils.py",
     "pyproject.toml",
+    "cli-config.yaml",
     "README.md",
     "LICENSE"
   ]

package/plugins/model-providers/freemodel/__init__.py

@@ -0,0 +1,16 @@
+"""FreeModel provider profile."""
+
+from providers import register_provider
+from providers.base import ProviderProfile
+
+freemodel = ProviderProfile(
+    name="freemodel",
+    aliases=("free-model", "free_model"),
+    display_name="FreeModel",
+    description="FreeModel — OpenAI-compatible direct API",
+    signup_url="https://freemodel.xyz/",
+    env_vars=("FREEMODEL_API_KEY", "FREEMODEL_BASE_URL"),
+    base_url="https://api.freemodel.xyz/v1",
+)
+
+register_provider(freemodel)

package/plugins/model-providers/freemodel/plugin.yaml

@@ -0,0 +1,5 @@
+name: freemodel-profile
+kind: model-provider
+version: 1.0.0
+description: FreeModel direct API provider profile
+author: Calvyn Code Contributors

package/pyproject.toml

@@ -3,8 +3,8 @@ requires = ["setuptools>=61.0"]
 build-backend = "setuptools.build_meta"
 
 [project]
-name = "hermes-agent"
-version = "0.14.0"
+name = "calvyn-code"
+version = "0.14.1"
 description = "The self-improving AI agent — creates skills from experience, improves them during use, and runs anywhere"
 readme = "README.md"
 requires-python = ">=3.11"
@@ -128,23 +128,23 @@ bedrock = ["boto3==1.42.89"]
 termux = [
   # Baseline Android / Termux path for reliable fresh installs.
   "python-telegram-bot[webhooks]==22.6",
-  "hermes-agent[cron]",
-  "hermes-agent[cli]",
-  "hermes-agent[pty]",
-  "hermes-agent[mcp]",
-  "hermes-agent[honcho]",
-  "hermes-agent[acp]",
+  "calvyn-code[cron]",
+  "calvyn-code[cli]",
+  "calvyn-code[pty]",
+  "calvyn-code[mcp]",
+  "calvyn-code[honcho]",
+  "calvyn-code[acp]",
 ]
 termux-all = [
   # Best-effort "install all" profile for Termux. Same policy as [all]:
   # only includes extras that aren't covered by `tools/lazy_deps.py`.
   # Backends like telegram/slack/dingtalk/feishu/honcho lazy-install at
   # first use, so they're no longer eager-installed here.
-  "hermes-agent[termux]",
-  "hermes-agent[google]",
-  "hermes-agent[homeassistant]",
-  "hermes-agent[sms]",
-  "hermes-agent[web]",
+  "calvyn-code[termux]",
+  "calvyn-code[google]",
+  "calvyn-code[homeassistant]",
+  "calvyn-code[sms]",
+  "calvyn-code[web]",
 ]
 dingtalk = ["dingtalk-stream==0.24.3", "alibabacloud-dingtalk==2.2.42", "qrcode==7.4.2"]
 feishu = ["lark-oapi==1.5.3", "qrcode==7.4.2"]
@@ -188,25 +188,23 @@ all = [
   # [all], `uv sync --locked` on Windows tried to build it from sdist
   # and failed on `make`. Lazy-install routes that build to first use,
   # where the user is expected to have a toolchain available.
-  "hermes-agent[cron]",
-  "hermes-agent[cli]",
-  "hermes-agent[dev]",
-  "hermes-agent[pty]",
-  "hermes-agent[mcp]",
-  "hermes-agent[homeassistant]",
-  "hermes-agent[sms]",
-  "hermes-agent[acp]",
-  "hermes-agent[google]",
-  "hermes-agent[web]",
-  "hermes-agent[youtube]",
+  "calvyn-code[cron]",
+  "calvyn-code[cli]",
+  "calvyn-code[dev]",
+  "calvyn-code[pty]",
+  "calvyn-code[mcp]",
+  "calvyn-code[homeassistant]",
+  "calvyn-code[sms]",
+  "calvyn-code[acp]",
+  "calvyn-code[google]",
+  "calvyn-code[web]",
+  "calvyn-code[youtube]",
 ]
 
 [project.scripts]
 calvyn = "hermes_cli.main:main"
 calvyn-agent = "run_agent:main"
 calvyn-acp = "acp_adapter.entry:main"
-hermes-agent = "run_agent:main"
-hermes-acp = "acp_adapter.entry:main"
 
 [tool.setuptools]
 py-modules = ["run_agent", "model_tools", "toolsets", "batch_runner", "trajectory_compressor", "toolset_distributions", "cli", "calvyn_bootstrap", "calvyn_constants", "calvyn_state", "calvyn_time", "calvyn_logging", "utils"]

package/scripts/postinstall.js

@@ -95,6 +95,25 @@ function getVenvPaths() {
   }
 }
 
+function ensureDefaultConfig() {
+  const homeDir = process.env.CALVYN_HOME
+    ? path.resolve(process.env.CALVYN_HOME)
+    : path.join(require("os").homedir(), ".calvyn")
+  const configDir = homeDir
+  const configPath = path.join(configDir, "config.yaml")
+  const bundledConfig = path.join(packageRoot, "cli-config.yaml")
+
+  if (!fs.existsSync(bundledConfig)) {
+    return
+  }
+
+  fs.mkdirSync(configDir, { recursive: true })
+  if (!fs.existsSync(configPath)) {
+    fs.copyFileSync(bundledConfig, configPath)
+    log(`Положил стартовый конфиг в ${configPath}`)
+  }
+}
+
 function ensureVenv(python) {
   const venv = getVenvPaths()
   if (!fs.existsSync(venv.dir)) {
@@ -137,6 +156,7 @@ function main() {
   }
 
   ensureInstalled(venv.python)
+  ensureDefaultConfig()
 
   if (!fs.existsSync(venv.calvyn)) {
     fail("Установка прошла не до конца: команда calvyn внутри .venv не найдена")