feat(embodied_plan): in-intent narrative-replan composer + daemoncraft-base profile rules aligned with Autonomía Corporal

.env.example

@@ -67,12 +67,12 @@
 # =============================================================================
 # MiniMax provides access to MiniMax models (global endpoint)
 # Get your key at: https://www.minimax.io
-# MINIMAX_API_KEY=
-# MINIMAX_BASE_URL=https://api.minimax.io/v1  # Override default base URL
+# MINIMAX_API_KEY=***
+# MINIMAX_BASE_URL=https://api.minimax.io/anthropic  # Anthropic-compatible endpoint (required for prompt caching)
 
 # MiniMax China endpoint (for users in mainland China)
-# MINIMAX_CN_API_KEY=
-# MINIMAX_CN_BASE_URL=https://api.minimaxi.com/v1  # Override default base URL
+# MINIMAX_CN_API_KEY=***
+# MINIMAX_CN_BASE_URL=https://api.minimaxi.com/anthropic  # Anthropic-compatible endpoint (required for prompt caching)
 
 # =============================================================================
 # LLM PROVIDER (OpenCode Zen)

.gitignore

@@ -70,3 +70,7 @@ mini-swe-agent/
 result
 website/static/api/skills-index.json
 models-dev-upstream/
+
+# Local project memory and session artifacts (never commit)
+.codex
+hermes_conversation_*.json

AGENTS_SETUP.md

@@ -0,0 +1,102 @@
+# Agent Setup Guide
+
+How to set up and run the multi-agent Kanban coding roster on your machine.
+
+## Prerequisites
+
+- Hermes Agent installed and working (`hermes chat -q "hello"`)
+- API keys for your preferred providers in `~/.hermes/.env`
+- Git access to this repo
+
+## Quick Start
+
+```bash
+# 1. Pull latest
+cd ~/Projects/hermes-agent
+git pull origin main
+
+# 2. Sync deploy target (if using gateway)
+cd ~/.hermes/hermes-agent
+git pull local-project main
+
+# 3. Create profiles (one-time)
+hermes profile create riqui
+hermes profile create miki
+hermes profile create maxi
+
+# 4. Copy configs from repo
+cp ~/Projects/hermes-agent/profiles/riqui/config.yaml ~/.hermes/profiles/riqui/
+cp ~/Projects/hermes-agent/profiles/miki/config.yaml ~/.hermes/profiles/miki/
+cp ~/Projects/hermes-agent/profiles/maxi/config.yaml ~/.hermes/profiles/maxi/
+
+# 5. ADAPT PROVIDERS TO YOUR STACK (IMPORTANT)
+# Edit each profile's config.yaml:
+#   - model.provider: your provider (openrouter, anthropic, nous, etc.)
+#   - model.default: your model name
+#   - model.base_url: your provider's endpoint (if needed)
+#   - model.api_key or symlink .env
+$EDITOR ~/.hermes/profiles/riqui/config.yaml
+$EDITOR ~/.hermes/profiles/miki/config.yaml
+$EDITOR ~/.hermes/profiles/maxi/config.yaml
+
+# 6. Copy SOUL.md files
+cp ~/Projects/hermes-agent/profiles/riqui/SOUL.md ~/.hermes/profiles/riqui/
+cp ~/Projects/hermes-agent/profiles/miki/SOUL.md ~/.hermes/profiles/miki/
+cp ~/Projects/hermes-agent/profiles/maxi/SOUL.md ~/.hermes/profiles/maxi/
+
+# 7. Symlink .env and agent-memory
+ln -sf ~/.hermes/.env ~/.hermes/profiles/riqui/.env
+ln -sf ~/.hermes/.env ~/.hermes/profiles/miki/.env
+ln -sf ~/.hermes/.env ~/.hermes/profiles/maxi/.env
+ln -sf ~/.hermes/agent-memory ~/.hermes/profiles/riqui/agent-memory
+ln -sf ~/.hermes/agent-memory ~/.hermes/profiles/miki/agent-memory
+ln -sf ~/.hermes/agent-memory ~/.hermes/profiles/maxi/agent-memory
+
+# 8. Test each profile
+hermes -p riqui chat -q "hello" --quiet
+hermes -p miki chat -q "hello" --quiet
+hermes -p maxi chat -q "hello" --quiet   # ⚠ known issue: maxi needs api_mode fix
+```
+
+## Profile Reference
+
+| Profile | Purpose | Key config | Status |
+|---------|---------|-----------|--------|
+| riqui | Fast surgical coding | max_turns=30, reasoning=minimal | ✓ Working |
+| miki | Deep-thinking coding (Kimi) | max_turns=30, reasoning=high | ✓ Working |
+| maxi | Deep-thinking coding (MiniMax) | max_turns=30, reasoning=high, Anthropic endpoint | ⚠ API mode bug |
+
+## Provider Adaptation
+
+The profiles assume our stack (DeepSeek, Kimi OAuth, MiniMax API key). To use different providers:
+
+### Using OpenRouter
+```yaml
+model:
+  default: openai/gpt-5.4  # or anthropic/claude-sonnet-4-6, etc.
+  provider: openrouter
+```
+
+### Using Anthropic Direct
+```yaml
+model:
+  default: claude-sonnet-4-6-20250514
+  provider: anthropic
+```
+
+### Using Nous Portal
+```yaml
+model:
+  default: anthropic/claude-sonnet-4-6
+  provider: nous
+```
+
+The `agent.max_turns` and `agent.reasoning_effort` settings are provider-agnostic.
+
+## Kanban Worker Rules (CRITICAL)
+
+- All coding profiles MUST have `max_turns >= 25` and `reasoning_effort >= minimal`
+- Lower values cause protocol violations (exhausted iterations before kanban_complete)
+- Kanban dispatcher spawns `hermes -p <profile> --skills kanban-worker chat -q "work kanban task <id>"`
+- Workers MUST end with `kanban_complete()` or `kanban_block()` — text-only exit is a violation
+- Dispatcher auto-blocks after 1 protocol violation (effective_limit=1)

CHANGELOG.md

@@ -0,0 +1,53 @@
+# CHANGELOG — nicoechaniz/hermes-agent fork
+
+Team-facing summary of changes to our fork. For upstream changes between syncs,
+see `~/wiki/projects/hermes-agent/notes/upstream-changes-review.md`.
+
+---
+
+## 2026-05-11
+
+### Upstream sync (138 commits behind → caught up)
+
+- `nousmain` reset to upstream/main (`8e2eb4b51`)
+- `main` merged with upstream (2 conflicts resolved: Kimi OAuth headers + ProviderProfile fallback)
+- `feat/daemoncraft` merged into `main` (5 commits: embodied heartbeat, @name! interrupt, compressor fix, embodied_plan, kanban-review)
+- Deployed to `~/.hermes/hermes-agent`, gateway restarted
+
+### Kimi K2.6 context window bug — fixed
+
+**Problem:** Hermes rejected `kimi-k2.6` with "context window of 32,768 tokens, below minimum 64,000". Real context is 262,144 (256K).
+
+**Root cause:** Two issues in the context-length resolution chain (`agent/model_metadata.py`, `agent/models_dev.py`):
+1. `PROVIDER_TO_MODELS_DEV` was missing `"kimi"` and `"moonshot"` entries (only had `kimi-coding`/`kimi-coding-cn`)
+2. OpenRouter metadata (community-maintained, incorrect for kimi-k2.6) was consulted BEFORE the project's own curated `DEFAULT_CONTEXT_LENGTHS`
+
+**Fix (3 changes in 2 files):**
+1. Added `"kimi"` → `"kimi-for-coding"` and `"moonshot"` → `"kimi-for-coding"` to `PROVIDER_TO_MODELS_DEV`
+2. Gated OpenRouter fallback behind `not effective_provider` — known providers skip third-party metadata and go straight to curated defaults
+3. Added explicit `DEFAULT_CONTEXT_LENGTHS` entries for `kimi-k2.6`, `kimi-k2.5`, `kimi-k2`, `k2p6`, `k2p5` (all 262,144)
+
+**Result:** `provider: kimi` with `kimi-k2.6` now resolves to 262,144. No config workaround needed.
+
+**PR upstream:** https://github.com/NousResearch/hermes-agent/pull/23950
+**Cherry-picked to:** `feat/kimi-oauth-clean`
+
+### Kanban cleanup
+
+- hermes-agent board had ~2,778 synthetic test tasks from kanban development
+- DB backed up to `kanban.db.backup-20260511-145448`, then deleted
+- Fresh empty board auto-created on next CLI access
+
+### Branches
+
+| Branch | Status | Notes |
+|--------|--------|-------|
+| `nousmain` | Clean | Tracks upstream/main exactly |
+| `main` | Integration | upstream + all our features |
+| `feat/daemoncraft` | Active | Consolidated DC work (needs rebase onto new nousmain) |
+| `feat/kimi-oauth-clean` | Active | Kimi OAuth + context-length fix |
+| `fix/kimi-context-length-resolution` | Merged to main | Kimi context window fix |
+
+### Pending
+
+- `feat/daemoncraft` is on the old base — needs rebase onto new `nousmain` on next sync cycle

agent/auxiliary_client.py

@@ -1311,7 +1311,8 @@ def _resolve_api_key_provider() -> Tuple[Optional[OpenAI], Optional[str]]:
                     return GeminiNativeClient(api_key=api_key, base_url=base_url), model
             extra = {}
             if base_url_host_matches(base_url, "api.kimi.com"):
-                extra["default_headers"] = {"User-Agent": "claude-code/0.1.0"}
+                from hermes_cli.auth import kimi_coding_default_headers
+                extra["default_headers"] = kimi_coding_default_headers()
             elif base_url_host_matches(base_url, "api.githubcopilot.com"):
                 from hermes_cli.models import copilot_default_headers
 
@@ -1346,7 +1347,8 @@ def _resolve_api_key_provider() -> Tuple[Optional[OpenAI], Optional[str]]:
                 return GeminiNativeClient(api_key=api_key, base_url=base_url), model
         extra = {}
         if base_url_host_matches(base_url, "api.kimi.com"):
-            extra["default_headers"] = {"User-Agent": "claude-code/0.1.0"}
+            from hermes_cli.auth import kimi_coding_default_headers
+            extra["default_headers"] = kimi_coding_default_headers()
         elif base_url_host_matches(base_url, "api.githubcopilot.com"):
             from hermes_cli.models import copilot_default_headers
 
@@ -2372,6 +2374,17 @@ def _refresh_provider_credentials(provider: str) -> bool:
                 return False
             _evict_cached_clients(normalized)
             return True
+        if normalized in ("kimi-coding", "kimi-coding-cn"):
+            from hermes_cli.auth import resolve_kimi_coding_runtime_credentials
+
+            creds = resolve_kimi_coding_runtime_credentials(
+                force_refresh=True,
+                allow_api_key_fallback=True,
+            )
+            if not str(creds.get("api_key", "") or "").strip():
+                return False
+            _evict_cached_clients(normalized)
+            return True
     except Exception as exc:
         logger.debug("Auxiliary provider credential refresh failed for %s: %s", normalized, exc)
         return False
@@ -2586,7 +2599,8 @@ def _to_async_client(sync_client, model: str, is_vision: bool = False):
             is_agent_turn=True, is_vision=is_vision
         )
     elif base_url_host_matches(sync_base_url, "api.kimi.com"):
-        async_kwargs["default_headers"] = {"User-Agent": "claude-code/0.1.0"}
+        from hermes_cli.auth import kimi_coding_default_headers
+        async_kwargs["default_headers"] = kimi_coding_default_headers()
     else:
         # Fall back to profile.default_headers for providers that declare
         # client-level headers on their ProviderProfile (e.g. attribution
@@ -2822,7 +2836,8 @@ def _wrap_if_needed(client_obj, final_model_str: str, base_url_str: str = "",
             if _dq:
                 extra["default_query"] = _dq
             if base_url_host_matches(custom_base, "api.kimi.com"):
-                extra["default_headers"] = {"User-Agent": "claude-code/0.1.0"}
+                from hermes_cli.auth import kimi_coding_default_headers
+                extra["default_headers"] = kimi_coding_default_headers()
             elif base_url_host_matches(custom_base, "api.githubcopilot.com"):
                 from hermes_cli.copilot_auth import copilot_request_headers
                 extra["default_headers"] = copilot_request_headers(
@@ -3019,7 +3034,8 @@ def _wrap_if_needed(client_obj, final_model_str: str, base_url_str: str = "",
         # Provider-specific headers
         headers = {}
         if base_url_host_matches(base_url, "api.kimi.com"):
-            headers["User-Agent"] = "claude-code/0.1.0"
+            from hermes_cli.auth import kimi_coding_default_headers
+            headers.update(kimi_coding_default_headers())
         elif base_url_host_matches(base_url, "api.githubcopilot.com"):
             from hermes_cli.copilot_auth import copilot_request_headers