hermes-task-framework 1.4.0__tar.gz → 1.5.0__tar.gz

{hermes_task_framework-1.4.0 → hermes_task_framework-1.5.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: hermes-task-framework
-Version: 1.4.0
+Version: 1.5.0
 Summary: Structured task management skills for Hermes Agent — task creation, decomposition, stage gates
 Project-URL: Source, https://github.com/nuffin/hermes-task-framework-pip
 Requires-Python: >=3.11

{hermes_task_framework-1.4.0 → hermes_task_framework-1.5.0}/hermes_task_framework/skills/task-cross-machine-sync/SKILL.md

@@ -16,7 +16,7 @@ metadata:
       properties: {reason: validates context after transport, strength: strong}
 name: task-cross-machine-sync
 platforms: [linux, macos]
-version: 2.0.0
+version: 2.1.0
 ---
 
 # Task Cross-Machine Sync
@@ -30,6 +30,57 @@ Synchronizes the configured `$HERMES_TASKS_ROOT` as a Git repository. It contain
 - optional machine role and conflict policy supplied outside this skill;
 - optional Git LFS policy for large artifacts.
 
+## Remote execution model contract
+
+Every task that may be explicitly dispatched to another machine has one
+immutable-at-dispatch provider/model pair. Store it in canonical task metadata:
+
+```json
+{
+  "extensions": {
+    "remote_execution": {
+      "provider": "openai-codex",
+      "model": "gpt-5.6-terra-900k",
+      "provider_source": "explicit",
+      "model_source": "explicit"
+    }
+  }
+}
+```
+
+### Creation-time capture
+
+The task creation API resolves both fields once, independently but with the same
+source order:
+
+1. explicit `manage_task.py create --model <model> --provider <provider>`;
+2. Hermes launch-scoped `HERMES_MODEL` / `HERMES_INFERENCE_MODEL` and
+   `HERMES_TUI_PROVIDER` / `HERMES_INFERENCE_PROVIDER`;
+3. current profile configuration, then global configuration, `model.default`
+   and `model.provider`.
+
+The creating conversation must pass both `--model` and `--provider` when it has
+a temporary per-conversation override that is not exported into the process
+environment. Do not defer this decision until remote dispatch: the controller
+may later use a different provider/model pair.
+
+### Dispatch-time resolution
+
+An explicit dispatch provider/model pair may override the stored creation pair
+only when the controller records both values in the dispatch request. Otherwise
+dispatch uses `extensions.remote_execution.provider` and `.model`. The receipt,
+`LaunchSpec`, and result manifest must all record the same resolved pair. A
+missing provider or model is a blocked dispatch; never silently fall back to the
+executor's local provider or model defaults.
+
+The task-specific runtime overlay starts Hermes with its receipt-derived pair:
+
+```text
+hermes -p <executor-profile> -m <resolved-model> --provider <resolved-provider>
+```
+
+Generic SSH/tmux runtime remains model-agnostic and never reads task metadata.
+
 ## Preconditions
 
 1. Confirm the exact task root and Git repository status.

{hermes_task_framework-1.4.0 → hermes_task_framework-1.5.0}/hermes_task_framework/skills/task-framework/scripts/manage_task.py

@@ -44,6 +44,58 @@ def _read_config_yaml(config_path):
         return {}
 
 
+MODEL_IDENTIFIER_PATTERN = re.compile(r"^[^\s\x00]{1,256}$")
+
+
+def _model_from_config(config):
+    value = config.get("model") if isinstance(config, dict) else None
+    if isinstance(value, dict):
+        value = value.get("default")
+    return value.strip() if isinstance(value, str) and value.strip() else None
+
+
+def _provider_from_config(config):
+    value = config.get("model") if isinstance(config, dict) else None
+    if isinstance(value, dict):
+        value = value.get("provider")
+    return value.strip() if isinstance(value, str) and value.strip() else None
+
+
+def _resolve_value(candidates, field_name):
+    for value, source in candidates:
+        if value is None:
+            continue
+        value = str(value).strip()
+        if not value:
+            continue
+        if not MODEL_IDENTIFIER_PATTERN.fullmatch(value):
+            raise ValueError(f"{field_name} must be non-empty text without whitespace or NUL bytes")
+        return value, source
+    return None, None
+
+
+def _resolve_creation_model(explicit_model=None, explicit_provider=None):
+    """Capture the provider/model pair at creation; never infer it at dispatch."""
+    hermes_home = os.environ.get("HERMES_HOME", "").strip()
+    profile_config = _read_config_yaml(Path(hermes_home) / "config.yaml") if hermes_home else {}
+    global_config = _read_config_yaml(Path.home() / ".hermes" / "config.yaml")
+    model, model_source = _resolve_value([
+        (explicit_model, "explicit"),
+        (os.environ.get("HERMES_MODEL"), "launch_env"),
+        (os.environ.get("HERMES_INFERENCE_MODEL"), "launch_env"),
+        (_model_from_config(profile_config), "profile_config"),
+        (_model_from_config(global_config), "global_config"),
+    ], "model")
+    provider, provider_source = _resolve_value([
+        (explicit_provider, "explicit"),
+        (os.environ.get("HERMES_TUI_PROVIDER"), "launch_env"),
+        (os.environ.get("HERMES_INFERENCE_PROVIDER"), "launch_env"),
+        (_provider_from_config(profile_config), "profile_config"),
+        (_provider_from_config(global_config), "global_config"),
+    ], "provider")
+    return model, model_source, provider, provider_source
+
+
 def _resolve_tasks_root() -> str:
     """Resolve the task root with ROOT as canonical and DIR as legacy fallback."""
     # 1. Canonical env var, then the legacy pip-package compatibility alias.
@@ -705,7 +757,7 @@ def _exact_name_matches(slug):
     return matches
 
 
-def cmd_create(name, from_inbox=None, description=None, allow_duplicate=False, parent=None):
+def cmd_create(name, from_inbox=None, description=None, allow_duplicate=False, parent=None, model=None, provider=None):
     """Create a new task: directory + hash + meta + templates + (optional inbox file/dir move)."""
     slug = re.sub(r'[^a-z0-9-]', '', name.lower().replace(' ', '-')).strip('-')
     if not slug:
@@ -747,6 +799,16 @@ def cmd_create(name, from_inbox=None, description=None, allow_duplicate=False, p
         "required_by": [],
         "priority": 2,
     }
+    creation_model, model_source, creation_provider, provider_source = _resolve_creation_model(model, provider)
+    if creation_model or creation_provider:
+        meta["extensions"] = {
+            "remote_execution": {
+                "model": creation_model,
+                "model_source": model_source,
+                "provider": creation_provider,
+                "provider_source": provider_source,
+            }
+        }
     if parent_dir:
         parent_meta_path = os.path.join(parent_dir, ".hermes-task.json")
         parent_meta = json.loads(open(parent_meta_path, encoding="utf-8").read()) if os.path.exists(parent_meta_path) else {}
@@ -955,7 +1017,7 @@ def main():
         formatter_class=argparse.RawDescriptionHelpFormatter,
         epilog="""\
 new commands:
-  create <name> [--from-inbox <file-or-dir>] [--desc <text>]   Create a new task
+  create <name> [--from-inbox <file-or-dir>] [--desc <text>] [--model <model>] [--provider <provider>]
   accept <inbox_item> [--name <task-name>]                     Accept inbox item into a new task
   decline <inbox_item> [--reason <text>]                       Move inbox item to declined/
   status <hash_or_dir> <status> [--reason <text>]             Update task status
@@ -976,6 +1038,10 @@ new commands:
                         help='(create) bypass exact-name duplicate prevention')
     parser.add_argument('--parent', dest='parent', default=None,
                         help='(create) create as a contained subtask of an existing task')
+    parser.add_argument('--model', dest='model', default=None,
+                        help='(create) persist the task creation model for remote dispatch')
+    parser.add_argument('--provider', dest='provider', default=None,
+                        help='(create) persist the task creation provider for remote dispatch')
     parser.add_argument('--name', dest='task_name', default=None,
                         help='(accept) override auto-derived task name')
     parser.add_argument('--reason', dest='reason', default='',
@@ -993,7 +1059,7 @@ new commands:
         'list':       lambda: cmd_list(args.args[0] if args.args else None),
 
         'ensure-all': cmd_ensure_all,
-        'create':     lambda: cmd_create(args.args[0], from_inbox=args.from_inbox, description=args.description, allow_duplicate=args.allow_duplicate, parent=args.parent) if args.args else False,
+        'create':     lambda: cmd_create(args.args[0], from_inbox=args.from_inbox, description=args.description, allow_duplicate=args.allow_duplicate, parent=args.parent, model=args.model, provider=args.provider) if args.args else False,
         'accept':     lambda: cmd_accept(args.args[0], name=args.task_name) if args.args else False,
         'decline':    lambda: cmd_decline(args.args[0], reason=args.reason) if args.args else False,
         'status':     lambda: cmd_status(args.args[0], args.args[1], reason=args.reason) if len(args.args) >= 2 else False,

hermes_task_framework-1.5.0/hermes_task_framework/tests/test_task_model_contract.py

@@ -0,0 +1,71 @@
+import json
+import os
+import subprocess
+import sys
+import tempfile
+import unittest
+from pathlib import Path
+
+
+ROOT = Path(__file__).resolve().parents[1]
+MANAGE = ROOT / "skills" / "task-framework" / "scripts" / "manage_task.py"
+
+
+class TaskModelContractTests(unittest.TestCase):
+    def create_task(self, env, *extra):
+        subprocess.run(
+            [sys.executable, str(MANAGE), "create", "model-contract", *extra],
+            env=env, check=True, capture_output=True, text=True,
+        )
+        task_dir = next(Path(env["HERMES_TASKS_ROOT"]).glob("*.model-contract-*"))
+        return json.loads((task_dir / ".hermes-task.json").read_text(encoding="utf-8"))
+
+    def test_explicit_model_is_persisted_and_wins_over_launch_environment(self):
+        with tempfile.TemporaryDirectory() as temporary:
+            env = os.environ.copy()
+            env["HERMES_TASKS_ROOT"] = temporary
+            env["HERMES_INFERENCE_MODEL"] = "openai/env-model"
+            metadata = self.create_task(env, "--model", "openai/explicit-model", "--provider", "openai-codex")
+            execution = metadata["extensions"]["remote_execution"]
+            self.assertEqual(execution, {
+                "model": "openai/explicit-model", "model_source": "explicit",
+                "provider": "openai-codex", "provider_source": "explicit",
+            })
+
+    def test_launch_model_is_captured_when_no_explicit_model_is_given(self):
+        with tempfile.TemporaryDirectory() as temporary:
+            env = os.environ.copy()
+            env["HERMES_TASKS_ROOT"] = temporary
+            env["HERMES_INFERENCE_MODEL"] = "openai/launch-model"
+            env["HERMES_INFERENCE_PROVIDER"] = "openai-codex"
+            metadata = self.create_task(env)
+            execution = metadata["extensions"]["remote_execution"]
+            self.assertEqual(execution, {
+                "model": "openai/launch-model", "model_source": "launch_env",
+                "provider": "openai-codex", "provider_source": "launch_env",
+            })
+
+    def test_profile_config_default_is_captured_when_no_launch_model_exists(self):
+        with tempfile.TemporaryDirectory() as temporary:
+            profile = Path(temporary) / "profile"
+            profile.mkdir()
+            (profile / "config.yaml").write_text(
+                "model:\n  default: openai/config-model\n  provider: openai-codex\n", encoding="utf-8"
+            )
+            env = os.environ.copy()
+            env["HERMES_TASKS_ROOT"] = str(Path(temporary) / "tasks")
+            env["HERMES_HOME"] = str(profile)
+            env.pop("HERMES_MODEL", None)
+            env.pop("HERMES_INFERENCE_MODEL", None)
+            env.pop("HERMES_TUI_PROVIDER", None)
+            env.pop("HERMES_INFERENCE_PROVIDER", None)
+            metadata = self.create_task(env)
+            execution = metadata["extensions"]["remote_execution"]
+            self.assertEqual(execution, {
+                "model": "openai/config-model", "model_source": "profile_config",
+                "provider": "openai-codex", "provider_source": "profile_config",
+            })
+
+
+if __name__ == "__main__":
+    unittest.main()

{hermes_task_framework-1.4.0 → hermes_task_framework-1.5.0}/hermes_task_framework.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: hermes-task-framework
-Version: 1.4.0
+Version: 1.5.0
 Summary: Structured task management skills for Hermes Agent — task creation, decomposition, stage gates
 Project-URL: Source, https://github.com/nuffin/hermes-task-framework-pip
 Requires-Python: >=3.11

{hermes_task_framework-1.4.0 → hermes_task_framework-1.5.0}/hermes_task_framework.egg-info/SOURCES.txt

@@ -76,6 +76,7 @@ hermes_task_framework/tests/test_task_api.py
 hermes_task_framework/tests/test_task_checkpoint_sync.py
 hermes_task_framework/tests/test_task_git_sync.py
 hermes_task_framework/tests/test_task_integrity.py
+hermes_task_framework/tests/test_task_model_contract.py
 hermes_task_framework/tests/test_task_root_resolution.py
 hermes_task_framework/tests/test_task_symlink_policy.py
 hermes_task_framework/tests/test_todo_lifecycle.py

{hermes_task_framework-1.4.0 → hermes_task_framework-1.5.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "hermes-task-framework"
-version = "1.4.0"
+version = "1.5.0"
 description = "Structured task management skills for Hermes Agent — task creation, decomposition, stage gates"
 requires-python = ">=3.11"
 dependencies = []