@wowok/agent-mcp 3.0.0 → 3.0.2

package/dist/schemas/employee_operation.schema.json

@@ -106,17 +106,25 @@
           "description": "Progress node name the employee was assigned to."
         },
         "assigned_at": {
+          "description": "Assignment timestamp (ms) — when the progress ENTERED this node. Omit to derive it from monitored ProgressEvents (requires `progress`).",
           "type": "integer",
           "minimum": -9007199254740991,
-          "maximum": 9007199254740991,
-          "description": "Assignment timestamp (ms)."
+          "maximum": 9007199254740991
         },
         "advanced_at": {
-          "description": "Advance timestamp (ms); omitted = still waiting (status warn).",
+          "description": "Advance timestamp (ms) — when the progress LEFT this node. Omit to derive it; still-current node = still waiting (status warn).",
           "type": "integer",
           "minimum": -9007199254740991,
           "maximum": 9007199254740991
         },
+        "progress": {
+          "description": "Progress object address — enables automatic assigned_at/advanced_at derivation from its monitored ProgressEvents (P1-3). Explicit timestamps override derived values.",
+          "type": "string"
+        },
+        "network": {
+          "description": "Network alias for the monitor event lookup; defaults to the current network.",
+          "type": "string"
+        },
         "budget_ms": {
           "description": "Response-time budget (ms); defaults to the stored profile's budget, else 48h.",
           "type": "integer",
@@ -130,8 +138,7 @@
       },
       "required": [
         "action",
-        "node",
-        "assigned_at"
+        "node"
       ],
       "additionalProperties": false
     },
@@ -171,6 +178,142 @@
         "loss_amount"
       ],
       "additionalProperties": false
+    },
+    {
+      "type": "object",
+      "properties": {
+        "action": {
+          "type": "string",
+          "const": "suggest_incentive"
+        },
+        "account": {
+          "type": "string",
+          "description": "Employee account address."
+        },
+        "kpis": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "properties": {
+              "node": {
+                "type": "string",
+                "description": "Progress node name."
+              },
+              "reaction_ms": {
+                "type": "integer",
+                "minimum": -9007199254740991,
+                "maximum": 9007199254740991,
+                "description": "Measured reaction time (ms); -1 when still pending."
+              },
+              "within_budget": {
+                "type": "boolean"
+              },
+              "status": {
+                "type": "string",
+                "enum": [
+                  "pass",
+                  "warn",
+                  "fail"
+                ]
+              }
+            },
+            "required": [
+              "node",
+              "reaction_ms",
+              "within_budget",
+              "status"
+            ],
+            "additionalProperties": false
+          },
+          "description": "Node reaction KPIs from prior assess_kpi calls."
+        },
+        "acceptance": {
+          "description": "WIP evidence per node; a node missing here counts as an acceptance gap.",
+          "type": "array",
+          "items": {
+            "type": "object",
+            "properties": {
+              "node": {
+                "type": "string",
+                "description": "Machine node the acceptance refers to."
+              },
+              "wip_hashes": {
+                "type": "array",
+                "items": {
+                  "type": "string"
+                },
+                "description": "WIP evidence hashes submitted for the node."
+              },
+              "submitted_at": {
+                "description": "Evidence submission timestamp (ms).",
+                "type": "integer",
+                "minimum": -9007199254740991,
+                "maximum": 9007199254740991
+              }
+            },
+            "required": [
+              "node",
+              "wip_hashes"
+            ],
+            "additionalProperties": false
+          }
+        },
+        "liability": {
+          "description": "Resolution from a prior resolve_liability call — include when an error-loss occurred.",
+          "type": "object",
+          "properties": {
+            "bears": {
+              "type": "string",
+              "enum": [
+                "merchant",
+                "employee"
+              ]
+            },
+            "must_compensate_before_resume": {
+              "type": "boolean"
+            },
+            "note": {
+              "type": "string"
+            }
+          },
+          "required": [
+            "bears",
+            "must_compensate_before_resume",
+            "note"
+          ],
+          "additionalProperties": false
+        },
+        "available_rewards": {
+          "description": "Reward objects the merchant can grant; without them a passing employee gets a 'configure a Reward' recommendation.",
+          "type": "array",
+          "items": {
+            "type": "object",
+            "properties": {
+              "address": {
+                "type": "string",
+                "description": "Reward object address."
+              },
+              "description": {
+                "type": "string"
+              }
+            },
+            "required": [
+              "address"
+            ],
+            "additionalProperties": false
+          }
+        },
+        "prior_compensation": {
+          "description": "Compensation already paid by this employee for prior losses (raw units).",
+          "type": "string"
+        }
+      },
+      "required": [
+        "action",
+        "account",
+        "kpis"
+      ],
+      "additionalProperties": false
     }
   ]
 }

package/dist/schemas/evaluation_operation.output.json

@@ -733,11 +733,84 @@
                       "summary"
                     ],
                     "additionalProperties": false
+                  },
+                  "next": {
+                    "type": "object",
+                    "properties": {
+                      "operation": {
+                        "type": "string",
+                        "description": "Next on-chain operation label: demand.present_service | demand.present_service_with_passport | demand.publish | service.order_new."
+                      },
+                      "operation_type": {
+                        "type": "string",
+                        "enum": [
+                          "demand",
+                          "service"
+                        ],
+                        "description": "The onchain_operations operation_type to use."
+                      },
+                      "preconditions": {
+                        "type": "array",
+                        "items": {
+                          "type": "string"
+                        },
+                        "description": "Precondition checklist to verify (query/watch) before writing."
+                      },
+                      "rationale": {
+                        "type": "string",
+                        "description": "Stable guidance describing the order-formation path."
+                      }
+                    },
+                    "required": [
+                      "operation",
+                      "operation_type",
+                      "preconditions",
+                      "rationale"
+                    ],
+                    "additionalProperties": false
+                  },
+                  "order": {
+                    "type": "object",
+                    "properties": {
+                      "operation": {
+                        "type": "string",
+                        "description": "Next on-chain operation label: demand.present_service | demand.present_service_with_passport | demand.publish | service.order_new."
+                      },
+                      "operation_type": {
+                        "type": "string",
+                        "enum": [
+                          "demand",
+                          "service"
+                        ],
+                        "description": "The onchain_operations operation_type to use."
+                      },
+                      "preconditions": {
+                        "type": "array",
+                        "items": {
+                          "type": "string"
+                        },
+                        "description": "Precondition checklist to verify (query/watch) before writing."
+                      },
+                      "rationale": {
+                        "type": "string",
+                        "description": "Stable guidance describing the order-formation path."
+                      }
+                    },
+                    "required": [
+                      "operation",
+                      "operation_type",
+                      "preconditions",
+                      "rationale"
+                    ],
+                    "additionalProperties": false,
+                    "description": "Transaction-formation bridge: create the Order on this service (service.order_new) once selected."
                   }
                 },
                 "required": [
                   "service",
-                  "result"
+                  "result",
+                  "next",
+                  "order"
                 ],
                 "additionalProperties": false
               }
@@ -918,11 +991,47 @@
                       "summary"
                     ],
                     "additionalProperties": false
+                  },
+                  "next": {
+                    "type": "object",
+                    "properties": {
+                      "operation": {
+                        "type": "string",
+                        "description": "Next on-chain operation label: demand.present_service | demand.present_service_with_passport | demand.publish | service.order_new."
+                      },
+                      "operation_type": {
+                        "type": "string",
+                        "enum": [
+                          "demand",
+                          "service"
+                        ],
+                        "description": "The onchain_operations operation_type to use."
+                      },
+                      "preconditions": {
+                        "type": "array",
+                        "items": {
+                          "type": "string"
+                        },
+                        "description": "Precondition checklist to verify (query/watch) before writing."
+                      },
+                      "rationale": {
+                        "type": "string",
+                        "description": "Stable guidance describing the order-formation path."
+                      }
+                    },
+                    "required": [
+                      "operation",
+                      "operation_type",
+                      "preconditions",
+                      "rationale"
+                    ],
+                    "additionalProperties": false
                   }
                 },
                 "required": [
                   "demand",
-                  "result"
+                  "result",
+                  "next"
                 ],
                 "additionalProperties": false
               }
@@ -1646,21 +1755,38 @@
                     ],
                     "additionalProperties": false
                   },
-                  "present": {
+                  "next": {
                     "type": "object",
                     "properties": {
                       "operation": {
                         "type": "string",
-                        "description": "Move entry to present: demand.present_service (no guard) or demand.present_service_with_passport (guarded)."
+                        "description": "Next on-chain operation label: demand.present_service | demand.present_service_with_passport | demand.publish | service.order_new."
                       },
-                      "guard_required": {
-                        "type": "boolean",
-                        "description": "True = the demand has presentation guards; a verified passport is required."
+                      "operation_type": {
+                        "type": "string",
+                        "enum": [
+                          "demand",
+                          "service"
+                        ],
+                        "description": "The onchain_operations operation_type to use."
+                      },
+                      "preconditions": {
+                        "type": "array",
+                        "items": {
+                          "type": "string"
+                        },
+                        "description": "Precondition checklist to verify (query/watch) before writing."
+                      },
+                      "rationale": {
+                        "type": "string",
+                        "description": "Stable guidance describing the order-formation path."
                       }
                     },
                     "required": [
                       "operation",
-                      "guard_required"
+                      "operation_type",
+                      "preconditions",
+                      "rationale"
                     ],
                     "additionalProperties": false
                   }
@@ -1668,7 +1794,7 @@
                 "required": [
                   "demand",
                   "result",
-                  "present"
+                  "next"
                 ],
                 "additionalProperties": false
               },

package/dist/schemas/evaluation_operation.schema.json

@@ -1236,6 +1236,38 @@
             "additionalProperties": false
           }
         },
+        "presenter_history": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "properties": {
+              "demand_id": {
+                "description": "Demand object that received the presentation.",
+                "type": "string"
+              },
+              "acceptance_score": {
+                "anyOf": [
+                  {
+                    "type": "number"
+                  },
+                  {
+                    "type": "null"
+                  }
+                ],
+                "description": "Demand owner's acceptance score (u8 on-chain, 0-100 scale). null = not yet rated."
+              },
+              "feedback_time": {
+                "description": "Feedback timestamp (ms or s, informational only).",
+                "type": "number"
+              }
+            },
+            "required": [
+              "acceptance_score"
+            ],
+            "additionalProperties": false
+          },
+          "description": "P2-2: presenter acceptance history (demand-side acceptance_score backflow) for the SINGLE party being evaluated (e.g. the merchant behind the candidate service set, or the demand owner being matched). Collect via onchain_table_item_demand_presenter across that party's Demand presenter tables. When the candidate set spans multiple unrelated parties, evaluate per-party or omit — the acceptance rule scores neutral without history."
+        },
         "injection": {
           "type": "object",
           "properties": {
@@ -1557,6 +1589,38 @@
             "additionalProperties": false
           }
         },
+        "presenter_history": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "properties": {
+              "demand_id": {
+                "description": "Demand object that received the presentation.",
+                "type": "string"
+              },
+              "acceptance_score": {
+                "anyOf": [
+                  {
+                    "type": "number"
+                  },
+                  {
+                    "type": "null"
+                  }
+                ],
+                "description": "Demand owner's acceptance score (u8 on-chain, 0-100 scale). null = not yet rated."
+              },
+              "feedback_time": {
+                "description": "Feedback timestamp (ms or s, informational only).",
+                "type": "number"
+              }
+            },
+            "required": [
+              "acceptance_score"
+            ],
+            "additionalProperties": false
+          },
+          "description": "P2-2: presenter acceptance history (demand-side acceptance_score backflow) for the SINGLE party being evaluated (e.g. the merchant behind the candidate service set, or the demand owner being matched). Collect via onchain_table_item_demand_presenter across that party's Demand presenter tables. When the candidate set spans multiple unrelated parties, evaluate per-party or omit — the acceptance rule scores neutral without history."
+        },
         "injection": {
           "type": "object",
           "properties": {
@@ -1945,6 +2009,38 @@
           ],
           "additionalProperties": false
         },
+        "presenter_history": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "properties": {
+              "demand_id": {
+                "description": "Demand object that received the presentation.",
+                "type": "string"
+              },
+              "acceptance_score": {
+                "anyOf": [
+                  {
+                    "type": "number"
+                  },
+                  {
+                    "type": "null"
+                  }
+                ],
+                "description": "Demand owner's acceptance score (u8 on-chain, 0-100 scale). null = not yet rated."
+              },
+              "feedback_time": {
+                "description": "Feedback timestamp (ms or s, informational only).",
+                "type": "number"
+              }
+            },
+            "required": [
+              "acceptance_score"
+            ],
+            "additionalProperties": false
+          },
+          "description": "P2-2: presenter acceptance history (demand-side acceptance_score backflow) for the SINGLE party being evaluated (e.g. the merchant behind the candidate service set, or the demand owner being matched). Collect via onchain_table_item_demand_presenter across that party's Demand presenter tables. When the candidate set spans multiple unrelated parties, evaluate per-party or omit — the acceptance rule scores neutral without history."
+        },
         "injection": {
           "type": "object",
           "properties": {
@@ -2222,18 +2318,18 @@
           "const": "evidence_review"
         },
         "kind": {
+          "description": "Off-chain evidence kind entering the closure workflow (single-item mode; omit when `items` is given).",
           "type": "string",
           "enum": [
             "signature_photo",
             "voice_recording",
             "delivery_proof",
             "weather_data"
-          ],
-          "description": "Off-chain evidence kind entering the closure workflow."
+          ]
         },
         "hash_committed": {
-          "type": "boolean",
-          "description": "Whether the evidence hash is committed on-chain (authenticity anchor)."
+          "description": "Whether the evidence hash is committed on-chain (authenticity anchor; single-item mode).",
+          "type": "boolean"
         },
         "digital_check_passed": {
           "description": "OCR / machine check passed (e.g. signature recognized, waybill matched).",
@@ -2242,12 +2338,53 @@
         "contradiction": {
           "description": "A contradicting signal detected (e.g. waybill number mismatch).",
           "type": "boolean"
+        },
+        "items": {
+          "description": "P2-3 list mode: review a COLLECTION of evidence items together → structured usable/manual/rejected list plus `proof_candidates` (auto-passed items with their Proof refs) the dispute initiator may reference in the dispute description (human confirms the final selection — never auto-attached). When omitted, single-item mode requires `kind` + `hash_committed`.",
+          "minItems": 1,
+          "type": "array",
+          "items": {
+            "type": "object",
+            "properties": {
+              "id": {
+                "type": "string",
+                "minLength": 1,
+                "description": "Caller-side identifier (file name, Proof object id, repository ref...)."
+              },
+              "kind": {
+                "type": "string",
+                "enum": [
+                  "signature_photo",
+                  "voice_recording",
+                  "delivery_proof",
+                  "weather_data"
+                ]
+              },
+              "hash_committed": {
+                "type": "boolean"
+              },
+              "digital_check_passed": {
+                "type": "boolean"
+              },
+              "contradiction": {
+                "type": "boolean"
+              },
+              "proof_ref": {
+                "description": "On-chain Proof object reference (WTS proof) when already anchored.",
+                "type": "string"
+              }
+            },
+            "required": [
+              "id",
+              "kind",
+              "hash_committed"
+            ],
+            "additionalProperties": false
+          }
         }
       },
       "required": [
-        "action",
-        "kind",
-        "hash_committed"
+        "action"
       ],
       "additionalProperties": false
     },
@@ -3041,6 +3178,38 @@
           "description": "Force fresh on-chain enumeration (bypass the 120s local list cache).",
           "type": "boolean"
         },
+        "presenter_history": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "properties": {
+              "demand_id": {
+                "description": "Demand object that received the presentation.",
+                "type": "string"
+              },
+              "acceptance_score": {
+                "anyOf": [
+                  {
+                    "type": "number"
+                  },
+                  {
+                    "type": "null"
+                  }
+                ],
+                "description": "Demand owner's acceptance score (u8 on-chain, 0-100 scale). null = not yet rated."
+              },
+              "feedback_time": {
+                "description": "Feedback timestamp (ms or s, informational only).",
+                "type": "number"
+              }
+            },
+            "required": [
+              "acceptance_score"
+            ],
+            "additionalProperties": false
+          },
+          "description": "P2-2: presenter acceptance history (demand-side acceptance_score backflow) for the SINGLE party being evaluated (e.g. the merchant behind the candidate service set, or the demand owner being matched). Collect via onchain_table_item_demand_presenter across that party's Demand presenter tables. When the candidate set spans multiple unrelated parties, evaluate per-party or omit — the acceptance rule scores neutral without history."
+        },
         "injection": {
           "type": "object",
           "properties": {

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-09-07T08:17:17.098Z",
+  "generatedAt": "2026-09-09T00:35:02.238Z",
   "tools": [
     {
       "name": "onchain_operations",
@@ -82,6 +82,12 @@
       "path": "./monitor_subscription.schema.json",
       "outputPath": "./monitor_subscription.output.json"
     },
+    {
+      "name": "keeper_operation",
+      "title": "Keeper - Actionable Reminders & Authorized Auto-Execution",
+      "path": "./keeper_operation.schema.json",
+      "outputPath": "./keeper_operation.output.json"
+    },
     {
       "name": "wowok_buildin_info",
       "title": "WoWok Build-in Information",