@wowok/agent-mcp 2.5.5 → 2.6.0

package/dist/schema/trust/index.d.ts

@@ -127,7 +127,6 @@ export declare const TrustScoreOutputSchema: z.ZodObject<{
             }, "strip", z.ZodTypeAny, {
                 name: "fund" | "workflow" | "trust" | "behavior";
                 score: number;
-                max_score: number;
                 checks: {
                     description: string;
                     id: string;
@@ -136,10 +135,10 @@ export declare const TrustScoreOutputSchema: z.ZodObject<{
                     weight: number;
                     advice?: string | undefined;
                 }[];
+                max_score: number;
             }, {
                 name: "fund" | "workflow" | "trust" | "behavior";
                 score: number;
-                max_score: number;
                 checks: {
                     description: string;
                     id: string;
@@ -148,6 +147,7 @@ export declare const TrustScoreOutputSchema: z.ZodObject<{
                     weight: number;
                     advice?: string | undefined;
                 }[];
+                max_score: number;
             }>, "many">;
         }, "strip", z.ZodTypeAny, {
             advice: string[];
@@ -155,7 +155,6 @@ export declare const TrustScoreOutputSchema: z.ZodObject<{
             dimensions: {
                 name: "fund" | "workflow" | "trust" | "behavior";
                 score: number;
-                max_score: number;
                 checks: {
                     description: string;
                     id: string;
@@ -164,6 +163,7 @@ export declare const TrustScoreOutputSchema: z.ZodObject<{
                     weight: number;
                     advice?: string | undefined;
                 }[];
+                max_score: number;
             }[];
             total: number;
             red_flags: string[];
@@ -173,7 +173,6 @@ export declare const TrustScoreOutputSchema: z.ZodObject<{
             dimensions: {
                 name: "fund" | "workflow" | "trust" | "behavior";
                 score: number;
-                max_score: number;
                 checks: {
                     description: string;
                     id: string;
@@ -182,6 +181,7 @@ export declare const TrustScoreOutputSchema: z.ZodObject<{
                     weight: number;
                     advice?: string | undefined;
                 }[];
+                max_score: number;
             }[];
             total: number;
             red_flags: string[];
@@ -231,7 +231,6 @@ export declare const TrustScoreOutputSchema: z.ZodObject<{
             dimensions: {
                 name: "fund" | "workflow" | "trust" | "behavior";
                 score: number;
-                max_score: number;
                 checks: {
                     description: string;
                     id: string;
@@ -240,6 +239,7 @@ export declare const TrustScoreOutputSchema: z.ZodObject<{
                     weight: number;
                     advice?: string | undefined;
                 }[];
+                max_score: number;
             }[];
             total: number;
             red_flags: string[];
@@ -281,7 +281,6 @@ export declare const TrustScoreOutputSchema: z.ZodObject<{
             dimensions: {
                 name: "fund" | "workflow" | "trust" | "behavior";
                 score: number;
-                max_score: number;
                 checks: {
                     description: string;
                     id: string;
@@ -290,6 +289,7 @@ export declare const TrustScoreOutputSchema: z.ZodObject<{
                     weight: number;
                     advice?: string | undefined;
                 }[];
+                max_score: number;
             }[];
             total: number;
             red_flags: string[];
@@ -333,7 +333,6 @@ export declare const TrustScoreOutputSchema: z.ZodObject<{
             dimensions: {
                 name: "fund" | "workflow" | "trust" | "behavior";
                 score: number;
-                max_score: number;
                 checks: {
                     description: string;
                     id: string;
@@ -342,6 +341,7 @@ export declare const TrustScoreOutputSchema: z.ZodObject<{
                     weight: number;
                     advice?: string | undefined;
                 }[];
+                max_score: number;
             }[];
             total: number;
             red_flags: string[];
@@ -385,7 +385,6 @@ export declare const TrustScoreOutputSchema: z.ZodObject<{
             dimensions: {
                 name: "fund" | "workflow" | "trust" | "behavior";
                 score: number;
-                max_score: number;
                 checks: {
                     description: string;
                     id: string;
@@ -394,6 +393,7 @@ export declare const TrustScoreOutputSchema: z.ZodObject<{
                     weight: number;
                     advice?: string | undefined;
                 }[];
+                max_score: number;
             }[];
             total: number;
             red_flags: string[];

package/dist/schemas/account_operation.output.json

@@ -31,16 +31,9 @@
                           "type": "string",
                           "description": "Account name"
                         },
-                        "m": {
-                          "anyOf": [
-                            {
-                              "$ref": "#/definitions/account_operation/properties/result/anyOf/0/properties/data/properties/gen/properties/name"
-                            },
-                            {
-                              "type": "null"
-                            }
-                          ],
-                          "description": "Messenger name if enabled"
+                        "messenger": {
+                          "type": "boolean",
+                          "description": "Messenger enabled flag"
                         }
                       },
                       "required": [
@@ -1322,20 +1315,13 @@
                           "$ref": "#/definitions/account_operation/properties/result/anyOf/0/properties/data/properties/faucet/properties/name_or_address",
                           "description": "Account name or address"
                         },
-                        "m": {
-                          "anyOf": [
-                            {
-                              "$ref": "#/definitions/account_operation/properties/result/anyOf/0/properties/data/properties/gen/properties/name"
-                            },
-                            {
-                              "type": "null"
-                            }
-                          ],
-                          "description": "Messenger name if enabled, null if disabled"
+                        "enabled": {
+                          "type": "boolean",
+                          "description": "Messenger enabled flag"
                         }
                       },
                       "required": [
-                        "m"
+                        "enabled"
                       ],
                       "additionalProperties": false,
                       "description": "Result of enabling or disabling messenger for an account"

package/dist/schemas/account_operation.schema.json

@@ -13,22 +13,15 @@
           "properties": {
             "name": {
               "type": "string",
-              "description": "Account name (max 64 characters). Use empty string '' or omit for the default account."
+              "description": "Account name (max 64 characters). Use empty string '' or omit for the default account. Recommended convention: <role>-<number> (e.g. shop-001, user-001, arb-001) for easy filtering and batch operations."
             },
             "replaceExistName": {
               "type": "boolean",
-              "description": "If true, existing account with the same name will lose the name; if false (default), throw error when name exists"
+              "description": "DISCOURAGED. If true, an existing account with the same name will be SUSPENDED (not just renamed) to free the name for the new account. The old account moves to the Suspended tab and cannot sign transactions until resumed with a new name. FORBIDDEN on the default account (name='' or omitted) — the default account is unique and cannot be replaced; use suspend() explicitly instead. Prefer versioned names (e.g. 'shop_v2') over replaceExistName for production. Default: false (throws AccountNameExist on collision)."
             },
-            "m": {
-              "anyOf": [
-                {
-                  "$ref": "#/definitions/account_operation/properties/gen/properties/name"
-                },
-                {
-                  "type": "null"
-                }
-              ],
-              "description": "Messenger name to enable messenger for this account (max 64 characters). If null, disable messenger. Omit to leave messenger unchanged."
+            "messenger": {
+              "type": "boolean",
+              "description": "Enable messenger for this account. true=enable, false=disable, omit=unchanged. Account name is used for messenger identity lookup (no separate messenger name)."
             }
           },
           "additionalProperties": false,
@@ -230,20 +223,13 @@
               "$ref": "#/definitions/account_operation/properties/faucet/properties/name_or_address",
               "description": "Account name or address. Use empty string '' for the default account. Defaults to '' if omitted."
             },
-            "m": {
-              "anyOf": [
-                {
-                  "$ref": "#/definitions/account_operation/properties/gen/properties/name"
-                },
-                {
-                  "type": "null"
-                }
-              ],
-              "description": "Messenger name to enable messenger for this account (max 64 characters). If null, disable messenger."
+            "enabled": {
+              "type": "boolean",
+              "description": "true to enable messenger, false to disable"
             }
           },
           "required": [
-            "m"
+            "enabled"
           ],
           "additionalProperties": false,
           "description": "Enable or disable messenger for an account"

package/dist/schemas/index.json

@@ -2,7 +2,7 @@
   "$schema": "http://json-schema.org/draft-07/schema#",
   "title": "WoWok MCP Schema Index",
   "description": "Index of all available JSON schemas for WoWok MCP tools",
-  "generatedAt": "2026-07-24T00:13:51.333Z",
+  "generatedAt": "2026-07-24T21:15:38.360Z",
   "tools": [
     {
       "name": "onchain_operations",

package/dist/schemas/messenger_operation.schema.json

@@ -123,9 +123,9 @@
                   "type": "boolean",
                   "description": "Force send even if there are pending Guard messages"
                 },
-                "new_messenger_name": {
-                  "type": "string",
-                  "description": "New messenger name for recipient"
+                "enable_messenger": {
+                  "type": "boolean",
+                  "description": "Auto-enable messenger for the sender account if not already enabled"
                 },
                 "network": {
                   "type": "string",
@@ -202,9 +202,9 @@
                   "type": "boolean",
                   "description": "Force send even if there are pending Guard messages"
                 },
-                "new_messenger_name": {
-                  "type": "string",
-                  "description": "New messenger name for recipient"
+                "enable_messenger": {
+                  "type": "boolean",
+                  "description": "Auto-enable messenger for the sender account if not already enabled"
                 },
                 "network": {
                   "$ref": "#/definitions/messenger_operation/anyOf/1/properties/options/properties/network",

package/dist/schemas/project_operation.output.json

@@ -122,6 +122,10 @@
                         "type": "number",
                         "description": "Number of objects in this project (from project_objects table)."
                       },
+                      "evaluationCount": {
+                        "type": "number",
+                        "description": "Number of stored evaluations for this project (from evaluations table)."
+                      },
                       "objectTypes": {
                         "type": "array",
                         "items": {
@@ -147,6 +151,7 @@
                       "updatedAt",
                       "metadata",
                       "objectCount",
+                      "evaluationCount",
                       "objectTypes"
                     ],
                     "additionalProperties": false
@@ -622,6 +627,101 @@
                           "null"
                         ]
                       },
+                      "details": {
+                        "anyOf": [
+                          {
+                            "type": "object",
+                            "properties": {
+                              "criterionScores": {
+                                "type": "array",
+                                "items": {
+                                  "type": "object",
+                                  "properties": {
+                                    "name": {
+                                      "type": "string",
+                                      "description": "Criterion name (e.g. 'Service Published', 'Governance Present')."
+                                    },
+                                    "score": {
+                                      "type": "number",
+                                      "description": "Per-criterion score (0-100, higher = better)."
+                                    },
+                                    "weight": {
+                                      "type": "number",
+                                      "description": "Weight in the overall score (0-1)."
+                                    },
+                                    "rationale": {
+                                      "type": "string",
+                                      "description": "Why this score was assigned."
+                                    }
+                                  },
+                                  "required": [
+                                    "name",
+                                    "score",
+                                    "weight",
+                                    "rationale"
+                                  ],
+                                  "additionalProperties": false
+                                },
+                                "description": "Per-criterion scores with rationale."
+                              },
+                              "findings": {
+                                "type": "array",
+                                "items": {
+                                  "type": "object",
+                                  "properties": {
+                                    "criterion": {
+                                      "type": "string",
+                                      "description": "Criterion this finding relates to."
+                                    },
+                                    "severity": {
+                                      "type": "string",
+                                      "enum": [
+                                        "critical",
+                                        "warning",
+                                        "info"
+                                      ],
+                                      "description": "Severity level: critical (blocks deployment), warning (should fix), info (advisory)."
+                                    },
+                                    "message": {
+                                      "type": "string",
+                                      "description": "Human-readable finding description."
+                                    },
+                                    "deduction": {
+                                      "type": "number",
+                                      "description": "Score deduction applied (negative number, e.g. -20)."
+                                    }
+                                  },
+                                  "required": [
+                                    "criterion",
+                                    "severity",
+                                    "message",
+                                    "deduction"
+                                  ],
+                                  "additionalProperties": false
+                                },
+                                "description": "Negative findings (warnings/critical issues) with deductions."
+                              },
+                              "strengths": {
+                                "type": "array",
+                                "items": {
+                                  "type": "string"
+                                },
+                                "description": "Positive evidence explaining high scores."
+                              }
+                            },
+                            "required": [
+                              "criterionScores",
+                              "findings",
+                              "strengths"
+                            ],
+                            "additionalProperties": false
+                          },
+                          {
+                            "type": "null"
+                          }
+                        ],
+                        "description": "Structured inspection content (criterion scores, findings, strengths). Null for evaluations created before details were stored."
+                      },
                       "evaluatedAt": {
                         "type": "number"
                       }
@@ -631,6 +731,7 @@
                       "evalType",
                       "score",
                       "summary",
+                      "details",
                       "evaluatedAt"
                     ],
                     "additionalProperties": false
@@ -1381,6 +1482,85 @@
                 "next_action"
               ],
               "additionalProperties": false
+            },
+            {
+              "type": "object",
+              "properties": {
+                "action": {
+                  "type": "string",
+                  "const": "generate_deployment_doc"
+                },
+                "markdown": {
+                  "type": "string",
+                  "description": "Generated deployment document markdown content (follows 71-deployment-list-spec)."
+                },
+                "validation": {
+                  "type": "object",
+                  "properties": {
+                    "valid": {
+                      "type": "boolean",
+                      "description": "True iff no D-check FAIL."
+                    },
+                    "checks": {
+                      "type": "array",
+                      "items": {
+                        "type": "object",
+                        "properties": {
+                          "check_id": {
+                            "type": "string"
+                          },
+                          "description": {
+                            "type": "string"
+                          },
+                          "status": {
+                            "type": "string",
+                            "enum": [
+                              "PASS",
+                              "FAIL",
+                              "WARN"
+                            ]
+                          },
+                          "notes": {
+                            "type": "string"
+                          }
+                        },
+                        "required": [
+                          "check_id",
+                          "description",
+                          "status"
+                        ],
+                        "additionalProperties": false
+                      },
+                      "description": "D-01..D-18 check results."
+                    },
+                    "errors": {
+                      "type": "array",
+                      "items": {
+                        "type": "string"
+                      },
+                      "description": "List of FAIL error messages."
+                    }
+                  },
+                  "required": [
+                    "valid",
+                    "checks",
+                    "errors"
+                  ],
+                  "additionalProperties": false,
+                  "description": "Deployment doc validation result against D-01..D-18."
+                },
+                "saved": {
+                  "type": "boolean",
+                  "description": "Whether the markdown was persisted to SQLite project_documents table."
+                }
+              },
+              "required": [
+                "action",
+                "markdown",
+                "validation",
+                "saved"
+              ],
+              "additionalProperties": false
             }
           ],
           "description": "Query result — shape depends on action"

package/dist/schemas/project_operation.schema.json

@@ -28,7 +28,8 @@
             "refresh_objects",
             "get_object_diff",
             "delete_project",
-            "assemble_context"
+            "assemble_context",
+            "generate_deployment_doc"
           ],
           "description": "Action to perform. Two categories:\n1. Project Entity + Evaluation (15, GLM6): list_projects, create_project, create_project_from_onchain, update_project, get_project_detail, add_object, remove_object, create_version, build_graph, get_graph, evaluate_project, save_evaluation, compare_projects, refresh_objects, get_object_diff. Projects are first-class entities with SQLite persistence, rigid project-object relationships, three-pathway graph construction, and a dual rule-based + LLM-assisted evaluation engine.\n2. Context Assembly (1): assemble_context (query on-chain object states + extract embedded history + optional events, and assemble a structured semantic context for LLM consumption). Required input: context_objects (array of object IDs/names). Optional: include_events (query recent state-transition events)."
         },
@@ -306,6 +307,18 @@
         "diff_to_time": {
           "type": "integer",
           "description": "End timestamp (ms) for get_object_diff."
+        },
+        "network": {
+          "type": "string",
+          "enum": [
+            "testnet",
+            "mainnet"
+          ],
+          "description": "Target network for generate_deployment_doc. Required when action='generate_deployment_doc'."
+        },
+        "save": {
+          "type": "boolean",
+          "description": "When true (default), persist the generated MD to SQLite project_documents table for generate_deployment_doc."
         }
       },
       "required": [

package/dist/schemas/query_toolkit.output.json

@@ -572,12 +572,13 @@
             "type": "number",
             "description": "Timestamp when account was last updated"
           },
-          "m": {
-            "type": [
-              "string",
-              "null"
-            ],
-            "description": "Messenger name, indicates this account has messenger enabled"
+          "messenger": {
+            "type": "boolean",
+            "description": "Whether messenger is enabled for this account"
+          },
+          "suspendedName": {
+            "type": "string",
+            "description": "Name before suspension (set by suspend, cleared by resume)"
           }
         },
         "required": [

package/dist/schemas/query_toolkit.schema.json

@@ -99,10 +99,6 @@
                   "type": "boolean",
                   "description": "Filter accounts with messenger enabled"
                 },
-                "m": {
-                  "$ref": "#/definitions/query_toolkit/anyOf/0/properties/filter/properties/name",
-                  "description": "Filter by messenger name (supports fuzzy match)"
-                },
                 "createdAt": {
                   "type": "object",
                   "properties": {

package/dist/telemetry/storage.js

@@ -1,8 +1,8 @@
 import { mkdir, appendFile, stat, rename } from "fs/promises";
 import { dirname, join } from "path";
-import { homedir } from "os";
+import { getWowMcpDir } from "@wowok/wowok";
 const MAX_SIZE_BYTES = 10 * 1024 * 1024;
-const DATA_DIR = join(homedir(), ".wowok", "data");
+const DATA_DIR = join(getWowMcpDir(), "data");
 const TELEMETRY_FILE = join(DATA_DIR, "telemetry.jsonl");
 const ROTATED_FILE = join(DATA_DIR, "telemetry.jsonl.1");
 class JsonlStorage {

package/dist/tools/handlers/onchain.js

@@ -132,6 +132,13 @@ export async function handleOnchainOperations(args) {
                 return output;
             }
             case "progress": {
+                if (validated.data?.operate) {
+                    constraintWarnings.push("Progress routing hint: if this Progress is bound to an Order and the target " +
+                        "Forward uses namedOperator=\"\" (empty string = OrderHolder), use " +
+                        "order.progress (NOT progress.operate). Direct progress::next fails with " +
+                        "Permission denied for OrderHolder forwards. Use progress.operate only for " +
+                        "non-empty namedOperator or permissionIndex-only forwards.");
+                }
                 const callProgress = new CallProgress(validated.data);
                 const result = validated.submission
                     ? await callProgress.call_with_submission(env, await transformSubmission(validated.submission))
@@ -281,6 +288,12 @@ export async function handleOnchainOperations(args) {
                 return output;
             }
             case "order": {
+                if (validated.data?.progress) {
+                    constraintWarnings.push("Order routing hint: order.progress works only for Forwards with " +
+                        "namedOperator=\"\" (OrderHolder). If the target Forward uses a " +
+                        "non-empty namedOperator or permissionIndex-only, use progress.operate " +
+                        "on the Progress object directly instead.");
+                }
                 const callOrder = new CallOrder(validated.data);
                 const result = validated.submission
                     ? await callOrder.call_with_submission(env, await transformSubmission(validated.submission))

package/dist/tools/handlers/project.js

@@ -1,4 +1,6 @@
 import { assembleContext } from "../../project/context-assembly.js";
+import { generateDeploymentDocFromProject } from "../../project/deployment-bridge.js";
+import { LocalProject } from "@wowok/wowok";
 import { handleListProjects, handleCreateProject, handleCreateProjectFromOnchain, handleUpdateProject, handleGetProjectDetail, handleAddObject, handleRemoveObject, handleUpdateObject, handleCreateVersion, handleBuildGraph, handleGetGraph, handleEvaluateProject, handleSaveEvaluation, handleCompareProjects, handleRefreshObjects, handleGetObjectDiff, handleDeleteProject, } from "../../project/handlers.js";
 import { strictParse } from "../../schema/index.js";
 import { ProjectOperationInputSchema } from "../../schema/project/index.js";
@@ -61,6 +63,26 @@ export async function handleProjectOperation(args) {
         case "assemble_context":
             result = await assembleContext(validated);
             break;
+        case "generate_deployment_doc": {
+            const { project_id, network, save = true } = validated;
+            if (!project_id) {
+                throw new Error("'project_id' is required for generate_deployment_doc");
+            }
+            if (!network) {
+                throw new Error("'network' is required for generate_deployment_doc");
+            }
+            const genResult = await generateDeploymentDocFromProject(project_id, network);
+            if (save) {
+                await LocalProject.Instance().saveDocument(project_id, network, genResult.markdown);
+            }
+            result = {
+                action: "generate_deployment_doc",
+                markdown: genResult.markdown,
+                validation: genResult.validation,
+                saved: save,
+            };
+            break;
+        }
         default:
             throw new Error(`Unknown project_operation action: ${String(action)}`);
     }

package/dist/tools/index.js

@@ -324,7 +324,7 @@ export const TOOL_REGISTRY = [
                 "  • order_monitor — In-progress Order Monitoring (Phase 3 C-3.2, default OFF)\n" +
                 "  • industry_evolution — Industry Specialization Evolution Flywheel (Phase 4, default ON)\n\n" +
                 "NOTE: Toggles persist for the MCP process lifetime. Set WOWOK_RUNTIME_CONFIG_PERSIST=1 " +
-                "to persist across sessions to ~/.wowok/runtime-config.json.\n\n" +
+                "to persist across sessions to ~/.wow/mcp/runtime-config.json.\n\n" +
                 "💡 Schema hint: Use schema_query with action='get' and name='config_operation' to retrieve the exact parameter schema with all actions and field definitions.",
             inputSchema: ConfigOperationInputSchema,
             outputSchema: ConfigOperationOutputSchema,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wowok/agent-mcp",
-  "version": "2.5.5",
+  "version": "2.6.0",
   "description": "Making It Easy for AI Agents to Communicate, Collaborate, Trade, and Trust.",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -50,7 +50,7 @@
   "license": "Apache-2.0",
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.29.0",
-    "@wowok/wowok": "2.5.5",
+    "@wowok/wowok": "2.6.0",
     "lodash": "^4.18.1",
     "zod": "^3.25.76",
     "zod-to-json-schema": "^3.25.2"