@dotdotgod/hermes 0.6.5 → 0.6.7

package/mcp/tools.json

@@ -60,10 +60,6 @@
                   "project"
                 ]
               },
-              "ttlMs": {
-                "type": "integer",
-                "minimum": 0
-              },
               "env": {
                 "type": "object",
                 "additionalProperties": {
@@ -104,6 +100,10 @@
         "timeoutMs": {
           "type": "integer",
           "exclusiveMinimum": 0
+        },
+        "contextSessionId": {
+          "type": "string",
+          "description": "Host session identity; adapters supply this for shared MCP connections."
         }
       },
       "required": [
@@ -191,10 +191,6 @@
             "project"
           ]
         },
-        "ttlMs": {
-          "type": "integer",
-          "minimum": 0
-        },
         "env": {
           "type": "object",
           "additionalProperties": {
@@ -217,6 +213,10 @@
             "type": "string"
           },
           "maxItems": 100
+        },
+        "contextSessionId": {
+          "type": "string",
+          "description": "Host session identity; adapters supply this for shared MCP connections."
         }
       },
       "required": [
@@ -257,10 +257,6 @@
             "project"
           ]
         },
-        "ttlMs": {
-          "type": "integer",
-          "minimum": 0
-        },
         "maxBytes": {
           "type": "integer",
           "exclusiveMinimum": 0
@@ -297,6 +293,10 @@
         "maxAggregateBytes": {
           "type": "integer",
           "minimum": 0
+        },
+        "contextSessionId": {
+          "type": "string",
+          "description": "Host session identity; adapters supply this for shared MCP connections."
         }
       },
       "required": [
@@ -340,6 +340,10 @@
         },
         "sessionOnly": {
           "type": "boolean"
+        },
+        "contextSessionId": {
+          "type": "string",
+          "description": "Host session identity; adapters supply this for shared MCP connections."
         }
       },
       "required": [
@@ -376,10 +380,6 @@
             "project"
           ]
         },
-        "ttlMs": {
-          "type": "integer",
-          "minimum": 0
-        },
         "timeoutMs": {
           "type": "integer",
           "exclusiveMinimum": 0
@@ -390,6 +390,10 @@
         },
         "browser": {
           "type": "boolean"
+        },
+        "contextSessionId": {
+          "type": "string",
+          "description": "Host session identity; adapters supply this for shared MCP connections."
         }
       },
       "required": [
@@ -408,7 +412,7 @@
   },
   {
     "name": "session_resume",
-    "description": "Use an explicit opaque session ID for subsequent context operations; historical sessions are not listed.",
+    "description": "Use an explicit opaque session ID for subsequent context operations on a dedicated connection; historical sessions are not listed. Shared connections should supply contextSessionId per call instead.",
     "inputSchema": {
       "type": "object",
       "properties": {
@@ -417,6 +421,10 @@
           "minLength": 1,
           "maxLength": 128,
           "pattern": "^[A-Za-z0-9][A-Za-z0-9._~-]{0,127}$"
+        },
+        "contextSessionId": {
+          "type": "string",
+          "description": "Host session identity; adapters supply this for shared MCP connections."
         }
       },
       "required": [
@@ -445,6 +453,10 @@
         "input": {
           "type": "object",
           "additionalProperties": {}
+        },
+        "contextSessionId": {
+          "type": "string",
+          "description": "Host session identity; adapters supply this for shared MCP connections."
         }
       },
       "required": [
@@ -467,6 +479,10 @@
         "id": {
           "type": "string",
           "format": "uuid"
+        },
+        "contextSessionId": {
+          "type": "string",
+          "description": "Host session identity; adapters supply this for shared MCP connections."
         }
       },
       "required": [
@@ -491,6 +507,10 @@
         "id": {
           "type": "string",
           "format": "uuid"
+        },
+        "contextSessionId": {
+          "type": "string",
+          "description": "Host session identity; adapters supply this for shared MCP connections."
         }
       },
       "required": [
@@ -515,6 +535,10 @@
         "confirm": {
           "type": "boolean",
           "const": true
+        },
+        "contextSessionId": {
+          "type": "string",
+          "description": "Host session identity; adapters supply this for shared MCP connections."
         }
       },
       "required": [
@@ -535,7 +559,13 @@
     "description": "Report local context store counts and location.",
     "inputSchema": {
       "type": "object",
-      "properties": {},
+      "properties": {
+        "contextSessionId": {
+          "type": "string",
+          "description": "Host session identity; adapters supply this for shared MCP connections."
+        }
+      },
+      "additionalProperties": false,
       "$schema": "http://json-schema.org/draft-07/schema#"
     },
     "annotations": {
@@ -550,7 +580,13 @@
     "description": "Run local read-only Node.js, SQLite FTS5, storage, schema, and fetch-policy checks without network or repair actions.",
     "inputSchema": {
       "type": "object",
-      "properties": {},
+      "properties": {
+        "contextSessionId": {
+          "type": "string",
+          "description": "Host session identity; adapters supply this for shared MCP connections."
+        }
+      },
+      "additionalProperties": false,
       "$schema": "http://json-schema.org/draft-07/schema#"
     },
     "annotations": {
@@ -583,6 +619,10 @@
         },
         "sourceId": {
           "type": "string"
+        },
+        "contextSessionId": {
+          "type": "string",
+          "description": "Host session identity; adapters supply this for shared MCP connections."
         }
       },
       "required": [
@@ -599,7 +639,7 @@
     }
   },
   {
-    "name": "dotdotgod_project_load",
+    "name": "project_load",
     "description": "Load a bounded documentation map and optional semantic project query.",
     "inputSchema": {
       "type": "object",
@@ -620,6 +660,10 @@
           "type": "integer",
           "minimum": 1,
           "maximum": 5
+        },
+        "contextSessionId": {
+          "type": "string",
+          "description": "Host session identity; adapters supply this for shared MCP connections."
         }
       },
       "additionalProperties": false,
@@ -633,13 +677,17 @@
     }
   },
   {
-    "name": "dotdotgod_embedding_status",
+    "name": "embedding_status",
     "description": "Inspect the optional persistent embedding runtime without installing or contacting a registry.",
     "inputSchema": {
       "type": "object",
       "properties": {
         "root": {
           "type": "string"
+        },
+        "contextSessionId": {
+          "type": "string",
+          "description": "Host session identity; adapters supply this for shared MCP connections."
         }
       },
       "additionalProperties": false,
@@ -653,7 +701,7 @@
     }
   },
   {
-    "name": "dotdotgod_embedding_install",
+    "name": "embedding_install",
     "description": "After explicit user approval, install the fixed optional embedding runtime persistently. Uses network and dependency install scripts.",
     "inputSchema": {
       "type": "object",
@@ -664,6 +712,10 @@
         "confirm": {
           "type": "boolean",
           "const": true
+        },
+        "contextSessionId": {
+          "type": "string",
+          "description": "Host session identity; adapters supply this for shared MCP connections."
         }
       },
       "required": [
@@ -681,7 +733,7 @@
     }
   },
   {
-    "name": "dotdotgod_project_impact",
+    "name": "project_impact",
     "description": "Run bounded graph impact for up to 20 changed paths.",
     "inputSchema": {
       "type": "object",
@@ -696,6 +748,10 @@
           },
           "minItems": 1,
           "maxItems": 20
+        },
+        "contextSessionId": {
+          "type": "string",
+          "description": "Host session identity; adapters supply this for shared MCP connections."
         }
       },
       "required": [
@@ -712,7 +768,33 @@
     }
   },
   {
-    "name": "dotdotgod_project_initialize",
+    "name": "impact_status",
+    "description": "Read this host session's advisory pending impact paths. Does not run reviews or clear pending state.",
+    "inputSchema": {
+      "type": "object",
+      "properties": {
+        "limit": {
+          "type": "integer",
+          "minimum": 1,
+          "maximum": 50
+        },
+        "contextSessionId": {
+          "type": "string",
+          "description": "Host session identity; adapters supply this for shared MCP connections."
+        }
+      },
+      "additionalProperties": false,
+      "$schema": "http://json-schema.org/draft-07/schema#"
+    },
+    "annotations": {
+      "readOnlyHint": true
+    },
+    "execution": {
+      "taskSupport": "forbidden"
+    }
+  },
+  {
+    "name": "project_initialize",
     "description": "Initialize project memory; dry-run is default and writes require explicit confirmation.",
     "inputSchema": {
       "type": "object",
@@ -734,6 +816,10 @@
         },
         "dotdotSetting": {
           "type": "boolean"
+        },
+        "contextSessionId": {
+          "type": "string",
+          "description": "Host session identity; adapters supply this for shared MCP connections."
         }
       },
       "additionalProperties": false,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dotdotgod/hermes",
-  "version": "0.6.5",
+  "version": "0.6.7",
   "description": "Hermes CLI and messaging-gateway adapter without Plan Mode.",
   "type": "module",
   "publishConfig": {
@@ -13,7 +13,7 @@
   "devDependencies": {
     "@modelcontextprotocol/sdk": "^1.25.2",
     "esbuild": "0.27.3",
-    "@dotdotgod/context": "0.6.5"
+    "@dotdotgod/context": "0.6.7"
   },
   "files": [
     "plugin.yaml",

package/plugin.yaml

@@ -1,8 +1,40 @@
 name: dotdotgod
-version: 0.6.5
+version: 0.6.7
 description: Project memory, isolated context tools and impact checks for Hermes CLI and messaging gateway; no Plan Mode.
 author: dotdotgod
 license: Elastic-2.0
+provides_tools:
+  - doctor
+  - context_heal
+  - index
+  - purge
+  - search
+  - session_resume
+  - stats
+  - embedding_install
+  - embedding_status
+  - execute
+  - execute_file
+  - fetch_and_index
+  - impact_status
+  - ingestion_job_cancel
+  - ingestion_job_start
+  - ingestion_job_status
+  - project_impact
+  - project_initialize
+  - project_load
+  - select_root
+provides_hooks:
+  - pre_llm_call
+  - pre_tool_call
+  - on_session_finalize
+  - on_session_reset
+  - on_session_end
+provides_skills:
+  - project-initializer
+  - project-load
+  - impact-review
+  - document-clarify
 config_schema:
   roots:
     type: dict

package/policy.py

@@ -55,7 +55,7 @@ def gate(name, args, pending):
         return None
     opaque = name.endswith("execute_file") or (name == "process" and args.get("action") in {"write", "submit"})
     if opaque or any(GATE.search(text) for text in commands(name, args)):
-        return "Run dotdotgod_project_impact for pending paths before verification/commit/push/publish: " + ", ".join(sorted(pending)[:8])
+        return "Run project_impact for pending paths before verification/commit/push/publish: " + ", ".join(sorted(pending)[:8])
     return None
 
 

package/runtime.py

@@ -120,9 +120,9 @@ class Runtime:
 
     def call_with_session(self, name, args, session):
         with self.lock:
-            if name == "dotdotgod_select_root":
+            if name == "select_root":
                 return self.select(session, args.get("label"))
-            if session.root is None and not session.parent_id and name == "dotdotgod_project_initialize":
+            if session.root is None and not session.parent_id and name == "project_initialize":
                 target = args.get("root")
                 if not isinstance(target, str) or not Path(target).is_absolute():
                     raise ValueError("Initialization without selection requires an explicit absolute root directory")
@@ -134,7 +134,7 @@ class Runtime:
                     return proxy.call(name, {**args, "root": str(root)})
                 finally:
                     proxy.close()
-            if name == "dotdotgod_project_load" and args.get("root"):
+            if name == "project_load" and args.get("root"):
                 base = session.root or self.launch_root
                 target = contained(base, args["root"])
                 if target != session.root:
@@ -143,9 +143,9 @@ class Runtime:
                 session.root = Path(self.ctx.get_config("cli_root", "") or self.launch_root).resolve(strict=True)
                 if not session.root.is_dir():
                     raise ValueError("Project root must be a directory")
-        if name == "dotdotgod_impact_status":
+        if name == "impact_status":
             return envelope({"ok": True, "pending": list(self.pending(session))})
-        if name == "dotdotgod_project_load":
+        if name == "project_load":
             if contained(session.root, args.get("root") or ".") != session.root:
                 self.select(session, str(contained(session.root, args["root"])))
             return self.load(session, args)
@@ -153,12 +153,12 @@ class Runtime:
             reason = self.check(session, name, args)
             if reason:
                 raise PermissionError(reason)
-        if name == "dotdotgod_project_impact":
+        if name == "project_impact":
             before = self.pending(session)
             paths = [os.path.relpath(contained(session.root, path), session.root) for path in args.get("paths", [])]
             args = {**args, "paths": paths}
         value = self.client(session).call(name, args)
-        if name == "dotdotgod_project_impact" and not value.get("isError") and value.get("structuredContent", {}).get("ok") is True:
+        if name == "project_impact" and not value.get("isError") and value.get("structuredContent", {}).get("ok") is True:
             with self.lock:
                 after = self.pending(session)
                 key = "impact:" + digest(str(session.root))
@@ -183,7 +183,7 @@ class Runtime:
                 return None
             if session.root is None:
                 return None
-            if tool_name == "dotdotgod_select_root":
+            if tool_name == "select_root":
                 return None
             reason = self.check(session, tool_name, args)
             if reason:
@@ -214,7 +214,7 @@ class Runtime:
                     session.root = Path(self.ctx.get_config("cli_root", "") or self.launch_root).resolve(strict=True)
         if session.root is None:
             labels = list(self.allowed(session))
-            context = "dotdotgod is inactive; ordinary host tools remain available. Select a project using dotdotgod_select_root with a configured label or absolute directory path, or initialize an explicit absolute directory with existing write confirmation. Initialization does not select a project."
+            context = "dotdotgod is inactive; ordinary host tools remain available. Select a project using select_root with a configured label or absolute directory path, or initialize an explicit absolute directory with existing write confirmation. Initialization does not select a project."
             if labels:
                 context += " Configured project labels: " + json.dumps(labels)
             return {"context": context}
@@ -222,7 +222,7 @@ class Runtime:
             parts = []
             text = user_message if isinstance(user_message, str) else " ".join(p.get("text", "") for p in user_message if isinstance(p, dict))
             if not session.loaded and not re.search(r"(?:^|\s)/?dd:no-load\b|(?:^|\s)/no-load\b", text):
-                parts.append("Call dotdotgod_project_load once with an agent-selected focus, then continue the original request. Read AGENTS.md and maintained README indexes selectively.")
+                parts.append("Call project_load once with an agent-selected focus, then continue the original request. Read AGENTS.md and maintained README indexes selectively.")
             if text.strip():
                 try:
                     expanded = self.cli(session, ["expand", str(session.root), text, "--json", "--with-impact", "--fuzzy"])
@@ -233,7 +233,7 @@ class Runtime:
                     parts.append("Reference expansion unavailable; use README routing and explicit targeted reads.")
             pending = self.pending(session)
             if pending:
-                parts.append("Impact pending: " + ", ".join(list(pending)[:8]) + ". Run dotdotgod_project_impact before broad tests or release commands.")
+                parts.append("Impact pending: " + ", ".join(list(pending)[:8]) + ". Run project_impact before broad tests or release commands.")
             return {"context": "\n\n".join(parts)} if parts else None
         except Exception as error:
             return {"context": "dotdotgod context unavailable: " + str(error) + "; do not bypass root/impact checks."}

package/skills/document-clarify/SKILL.md

@@ -7,7 +7,7 @@ description: Document Clarify for dotdotgod project memory in Hermes CLI and mes
 
 # Document Clarify
 
-Use the operator-authorized selected repository. Prefer the native dotdotgod_project_initialize, dotdotgod_project_load and dotdotgod_project_impact tools for their respective workflows. Context tools use dotdotgod_ names; results contain content and structuredContent, not Pi codemode objects. Do not bypass host permissions or pending impact gates. Hermes native delegate_task handles delegation; this adapter has no Plan Mode.
+Use the operator-authorized selected repository. Prefer project_initialize, project_load and project_impact from the dotdotgod toolset for their respective workflows. Context tools use the shared MCP catalog names without adapter aliases; inspect content, structuredContent and isError. Do not bypass host permissions or pending impact gates. Hermes native delegate_task handles delegation; this adapter has no Plan Mode.
 
 ## Memory-Area Context
 

package/skills/impact-review/SKILL.md

@@ -7,7 +7,7 @@ description: Impact Review for dotdotgod project memory in Hermes CLI and messag
 
 # Impact Review
 
-Use the operator-authorized selected repository. Prefer the native dotdotgod_project_initialize, dotdotgod_project_load and dotdotgod_project_impact tools for their respective workflows. Context tools use dotdotgod_ names; results contain content and structuredContent, not Pi codemode objects. Do not bypass host permissions or pending impact gates. Hermes native delegate_task handles delegation; this adapter has no Plan Mode.
+Use the operator-authorized selected repository. Prefer project_initialize, project_load and project_impact from the dotdotgod toolset for their respective workflows. Context tools use the shared MCP catalog names without adapter aliases; inspect content, structuredContent and isError. Do not bypass host permissions or pending impact gates. Hermes native delegate_task handles delegation; this adapter has no Plan Mode.
 
 ## Goal
 

package/skills/project-initializer/SKILL.md

@@ -7,7 +7,7 @@ description: Project Initializer for dotdotgod project memory in Hermes CLI and
 
 # Project Initializer
 
-Use the operator-authorized selected repository. Prefer the native dotdotgod_project_initialize, dotdotgod_project_load and dotdotgod_project_impact tools for their respective workflows. Context tools use dotdotgod_ names; results contain content and structuredContent, not Pi codemode objects. Do not bypass host permissions or pending impact gates. Hermes native delegate_task handles delegation; this adapter has no Plan Mode.
+Use the operator-authorized selected repository. Prefer project_initialize, project_load and project_impact from the dotdotgod toolset for their respective workflows. Context tools use the shared MCP catalog names without adapter aliases; inspect content, structuredContent and isError. Do not bypass host permissions or pending impact gates. Hermes native delegate_task handles delegation; this adapter has no Plan Mode.
 
 ## Goal
 

package/skills/project-initializer/references/agent-docs.md

@@ -7,6 +7,7 @@ Use `AGENTS.md` as the canonical shared instruction file.
 - `AGENTS.md`: preferred shared file name. OpenAI Codex recognizes this convention, and the community `agents.md` convention uses the plural form.
 - `CLAUDE.md`: Claude Code's project memory file. Keep it thin and import `AGENTS.md` with `@AGENTS.md`.
 - `CODEX.md`: project-local Codex pointer. Keep it thin and link to `AGENTS.md`.
+- OpenCode reads `AGENTS.md` natively; do not create an `OPENCODE.md` copy.
 - `.github/copilot-instructions.md`: optional Copilot surface. If present, route to `AGENTS.md`, `docs/README.md`, and project commands instead of copying the full rules body.
 - `.cursor/rules/*.md`: optional Cursor path-scoped rules. If present, keep Cursor-specific scoping there and route durable project rules to shared docs.
 - `llms.txt`: optional documentation discovery surface. If present, point to README indexes and bounded docs entrypoints instead of embedding large docs bodies.

package/skills/project-load/SKILL.md

@@ -7,7 +7,7 @@ description: Project Load for dotdotgod project memory in Hermes CLI and messagi
 
 # Project Load
 
-Use the operator-authorized selected repository. Prefer the native dotdotgod_project_initialize, dotdotgod_project_load and dotdotgod_project_impact tools for their respective workflows. Context tools use dotdotgod_ names; results contain content and structuredContent, not Pi codemode objects. Do not bypass host permissions or pending impact gates. Hermes native delegate_task handles delegation; this adapter has no Plan Mode.
+Use the operator-authorized selected repository. Prefer project_initialize, project_load and project_impact from the dotdotgod toolset for their respective workflows. Context tools use the shared MCP catalog names without adapter aliases; inspect content, structuredContent and isError. Do not bypass host permissions or pending impact gates. Hermes native delegate_task handles delegation; this adapter has no Plan Mode.
 
 ## CLI Context