1.0 mvp

rust/crates/mnote-web/src/hermes_tools/manifest.rs

@@ -14,11 +14,11 @@ pub fn manifest() -> Value {
         },
         "tools": [
             page_get_tool(),
-            planned_tool("mnote.page.save", ["page.write"]),
-            planned_tool("mnote.page.update_title", ["page.write"]),
-            planned_tool("mnote.page.update_options", ["page.write"]),
-            planned_tool("mnote.artifact.create_summary", ["artifact.write"]),
-            planned_tool("mnote.artifact.create_ai_note", ["artifact.write"])
+            page_save_tool(),
+            available_tool("mnote.page.update_title", "更新当前页面标题", ["page.write"]),
+            available_tool("mnote.page.update_options", "更新当前页面设置", ["page.write"]),
+            available_tool("mnote.artifact.create_summary", "为当前页面创建或更新 AI Summary", ["artifact.write"]),
+            available_tool("mnote.artifact.create_ai_note", "基于当前页面创建新的 AI Note", ["artifact.write"])
         ]
     })
 }
@@ -47,12 +47,49 @@ fn page_get_tool() -> Value {
     })
 }
 
-fn planned_tool(name: &str, scope: impl IntoIterator<Item = &'static str>) -> Value {
+fn page_save_tool() -> Value {
     json!({
-        "name": name,
-        "description": "已冻结合同，按 7-4 后续 task 接入 Rust runtime / kernel",
+        "name": "mnote.page.save",
+        "description": "保存当前页面正文；replace 覆盖正文，append/prepend 会先读取当前 Page Aggregate 后合成完整正文再保存",
         "schemaVersion": TOOL_SCHEMA_VERSION,
+        "capabilityScope": ["page.write"],
+        "status": "available",
+        "inputSchema": {
+            "type": "object",
+            "required": ["workspaceId", "documentId", "sessionId", "runId", "toolCallId", "traceId", "content", "dryRun", "idempotencyKey"],
+            "properties": {
+                "workspaceId": { "type": "string" },
+                "documentId": { "type": "string" },
+                "sessionId": { "type": "string" },
+                "runId": { "type": "string" },
+                "toolCallId": { "type": "string" },
+                "traceId": { "type": "string" },
+                "content": {
+                    "description": "要写入的正文块数组、{blocks:[...]}、TipTap content 数组或纯文本",
+                    "type": ["array", "object", "string"]
+                },
+                "mode": {
+                    "type": "string",
+                    "enum": ["replace", "append", "prepend"],
+                    "default": "replace"
+                },
+                "dryRun": { "type": "boolean" },
+                "idempotencyKey": { "type": "string" }
+            }
+        }
+    })
+}
+
+fn available_tool(
+    name: &str,
+    description: &str,
+    scope: impl IntoIterator<Item = &'static str>,
+) -> Value {
+    json!({
+        "name": name,
+        "description": description,
+        "schemaVersion": TOOL_SCHEMA_VERSION,
         "capabilityScope": scope.into_iter().collect::<Vec<_>>(),
-        "status": "planned"
+        "status": "available"
     })
 }