@wowok/agent-mcp 2.7.0 → 2.7.2

package/dist/schemas/onchain_table_data.output.json

@@ -1681,7 +1681,7 @@
                                           "type": "null"
                                         }
                                       ],
-                                      "description": "Guard reference for this forward. Accepts TWO formats:\n• STRING (preferred): \"my_guard_name\" — the Guard's name or address as a plain string.\n• OBJECT (only when retained_submission is needed): {guard: \"my_guard_name\", retained_submission: [1,2,3]}.\nFOLLOW THE SCHEMA FIELD STRUCTURE: A Guard reference is fundamentally a STRING (the Guard object's name or address). Provide a string when you only need to reference a Guard — do NOT wrap a bare string in an object structure. The OBJECT form {guard: \"...\", retained_submission: [...]} exists ONLY to carry additional `retained_submission` data alongside the string reference; inside the object, the `guard` field is STILL a string. In short: string-in for a string reference, object-in only when you need to pass extra data.\nCOGNITIVE PRINCIPLE: Guard validation ALWAYS occurs BEFORE the forward operation. A Guard that queries state of the SAME Progress object this forward operates on (e.g. progress.current) will see the PRE-transition value (source node), NOT the target node. If the Guard checks progress.current == target_node, it will ALWAYS FAIL. Querying a DIFFERENT Progress object (cross-machine) is safe and reasonable — that progress is not modified by this forward. For target-node verification after transition, bind the Guard to the Allocator instead (allocation.alloc runs AFTER the state transition completes)."
+                                      "description": "Guard reference for this forward. Accepts TWO formats:\n• STRING (preferred): \"my_guard_name\" — the Guard's name or address as a plain string.\n• OBJECT (only when retained_submission is needed): {guard: \"my_guard_name\", retained_submission: [1,2,3]}.\nFOLLOW THE SCHEMA FIELD STRUCTURE: A Guard reference is fundamentally a STRING (the Guard object's name or address). Provide a string when you only need to reference a Guard — do NOT wrap a bare string in an object structure. The OBJECT form {guard: \"...\", retained_submission: [...]} exists ONLY to carry additional `retained_submission` data alongside the string reference; inside the object, the `guard` field is STILL a string. In short: string-in for a string reference, object-in only when you need to pass extra data.\nCOGNITIVE PRINCIPLE: Guard validation ALWAYS occurs BEFORE the forward operation. A Guard that queries state of the SAME Progress object this forward operates on (e.g. progress.current) will see the PRE-transition value (source node), NOT the target node. If the Guard checks progress.current == target_node, it will ALWAYS FAIL. Querying a DIFFERENT Progress object (cross-machine) is safe and reasonable — that progress is not modified by this forward. For target-node verification after transition, bind the Guard to the Allocator instead (allocation.alloc runs AFTER the state transition completes).\n⚠️ T1 LOSSY POINT (B-3): WoWok has NO on-chain cron. A business phrase like 'after N days, auto-X' is NOT an automatic trigger — it decomposes into (1) a time_guard that checks elapsed time, and (2) an OFF-CHAIN keeper that must submit the forward when the guard passes. Configuring a time_guard WITHOUT a keeper means nothing ever fires."
                                     }
                                   },
                                   "required": [
@@ -2550,13 +2550,16 @@
                   "items": {
                     "type": "string"
                   },
-                  "description": "Phase 4 P4-6.C: Role-targeted advice strings (user/merchant/arbitrator). Example: ['Strengthen loyalty flywheel','Optimize first-order conversion']"
+                  "description": "Phase 4 P4-6.C: Role-targeted advice strings (merchant/customer/prospect/supplier/collaborator/arbitrator). Example: ['Strengthen loyalty flywheel','Optimize first-order conversion']"
                 },
                 "role": {
                   "type": "string",
                   "enum": [
-                    "user",
                     "merchant",
+                    "customer",
+                    "prospect",
+                    "supplier",
+                    "collaborator",
                     "arbitrator"
                   ],
                   "description": "Phase 4 P4-6.C: Role used for advice routing. Example: 'merchant'"

package/dist/schemas/persona_operation.output.json

@@ -0,0 +1,392 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "https://wowok.net/schemas/persona_operation.json",
+  "title": "Persona - User Identity Setting",
+  "description": "Read/write the user's systematic identity setting (persona): preferences, competitive strategy, experience rules, self profile, and spec. Each persona has a long-term layer (stable) and a current layer (transient, higher priority), bound to a scope: system (all accounts) or account (one chain address, higher priority).",
+  "$ref": "#/definitions/persona_operation",
+  "definitions": {
+    "persona_operation": {
+      "anyOf": [
+        {
+          "type": "object",
+          "properties": {
+            "action": {
+              "type": "string",
+              "const": "get"
+            },
+            "effective": {
+              "type": "object",
+              "properties": {
+                "scope": {
+                  "type": "string",
+                  "enum": [
+                    "system",
+                    "account"
+                  ]
+                },
+                "account": {
+                  "type": "string"
+                },
+                "role": {
+                  "type": "string",
+                  "enum": [
+                    "merchant",
+                    "customer",
+                    "prospect",
+                    "supplier",
+                    "collaborator",
+                    "arbitrator"
+                  ]
+                },
+                "industries": {
+                  "type": "array",
+                  "items": {
+                    "type": "string",
+                    "enum": [
+                      "freelance",
+                      "rental",
+                      "education",
+                      "travel",
+                      "subscription",
+                      "retail"
+                    ]
+                  }
+                },
+                "layer": {
+                  "type": "object",
+                  "properties": {
+                    "identity": {
+                      "type": "object",
+                      "properties": {
+                        "region": {
+                          "type": "string"
+                        },
+                        "languages": {
+                          "type": "array",
+                          "items": {
+                            "type": "string"
+                          }
+                        },
+                        "self_description": {
+                          "type": "string"
+                        }
+                      },
+                      "additionalProperties": false
+                    },
+                    "preferences": {
+                      "type": "object",
+                      "additionalProperties": {}
+                    },
+                    "strategy": {
+                      "type": "array",
+                      "items": {
+                        "type": "string"
+                      }
+                    },
+                    "rules": {
+                      "type": "array",
+                      "items": {
+                        "type": "string"
+                      }
+                    },
+                    "requirements": {
+                      "type": "array",
+                      "items": {
+                        "type": "string"
+                      }
+                    },
+                    "spec": {
+                      "type": "string"
+                    }
+                  },
+                  "additionalProperties": false
+                },
+                "sources": {
+                  "type": "array",
+                  "items": {
+                    "type": "object",
+                    "properties": {
+                      "scope": {
+                        "$ref": "#/definitions/persona_operation/anyOf/0/properties/effective/properties/scope"
+                      },
+                      "account": {
+                        "type": "string"
+                      },
+                      "part": {
+                        "type": "string",
+                        "enum": [
+                          "long_term",
+                          "current"
+                        ]
+                      }
+                    },
+                    "required": [
+                      "scope",
+                      "part"
+                    ],
+                    "additionalProperties": false
+                  }
+                }
+              },
+              "required": [
+                "scope",
+                "role",
+                "industries",
+                "layer",
+                "sources"
+              ],
+              "additionalProperties": false
+            },
+            "context_text": {
+              "type": "string"
+            },
+            "injection": {
+              "type": "object",
+              "additionalProperties": {}
+            }
+          },
+          "required": [
+            "action",
+            "effective",
+            "context_text",
+            "injection"
+          ],
+          "additionalProperties": false
+        },
+        {
+          "type": "object",
+          "properties": {
+            "action": {
+              "type": "string",
+              "const": "list"
+            },
+            "personas": {
+              "type": "array",
+              "items": {
+                "type": "object",
+                "properties": {
+                  "version": {
+                    "type": "number"
+                  },
+                  "scope": {
+                    "$ref": "#/definitions/persona_operation/anyOf/0/properties/effective/properties/scope"
+                  },
+                  "account": {
+                    "type": "string"
+                  },
+                  "role": {
+                    "$ref": "#/definitions/persona_operation/anyOf/0/properties/effective/properties/role"
+                  },
+                  "industries": {
+                    "type": "array",
+                    "items": {
+                      "$ref": "#/definitions/persona_operation/anyOf/0/properties/effective/properties/industries/items"
+                    }
+                  },
+                  "long_term": {
+                    "$ref": "#/definitions/persona_operation/anyOf/0/properties/effective/properties/layer"
+                  },
+                  "current": {
+                    "$ref": "#/definitions/persona_operation/anyOf/0/properties/effective/properties/layer"
+                  },
+                  "updated_at": {
+                    "type": "number"
+                  }
+                },
+                "required": [
+                  "version",
+                  "scope",
+                  "role",
+                  "industries",
+                  "long_term",
+                  "current",
+                  "updated_at"
+                ],
+                "additionalProperties": false
+              }
+            },
+            "defaults": {
+              "type": "array",
+              "items": {
+                "$ref": "#/definitions/persona_operation/anyOf/1/properties/personas/items"
+              }
+            }
+          },
+          "required": [
+            "action",
+            "personas",
+            "defaults"
+          ],
+          "additionalProperties": false
+        },
+        {
+          "type": "object",
+          "properties": {
+            "action": {
+              "type": "string",
+              "const": "set"
+            },
+            "persona": {
+              "$ref": "#/definitions/persona_operation/anyOf/1/properties/personas/items"
+            },
+            "line_count": {
+              "type": "number"
+            }
+          },
+          "required": [
+            "action",
+            "persona",
+            "line_count"
+          ],
+          "additionalProperties": false
+        },
+        {
+          "type": "object",
+          "properties": {
+            "action": {
+              "type": "string",
+              "const": "analyze"
+            },
+            "analysis": {
+              "type": "object",
+              "properties": {
+                "role": {
+                  "$ref": "#/definitions/persona_operation/anyOf/0/properties/effective/properties/role"
+                },
+                "industries": {
+                  "type": "array",
+                  "items": {
+                    "$ref": "#/definitions/persona_operation/anyOf/0/properties/effective/properties/industries/items"
+                  }
+                },
+                "preferences": {
+                  "type": "object",
+                  "additionalProperties": {}
+                },
+                "requirements": {
+                  "type": "array",
+                  "items": {
+                    "type": "string"
+                  }
+                },
+                "rules": {
+                  "type": "array",
+                  "items": {
+                    "type": "string"
+                  }
+                },
+                "suggestions": {
+                  "type": "array",
+                  "items": {
+                    "type": "object",
+                    "properties": {
+                      "field": {
+                        "type": "string"
+                      },
+                      "value": {},
+                      "reason": {
+                        "type": "string"
+                      }
+                    },
+                    "required": [
+                      "field",
+                      "reason"
+                    ],
+                    "additionalProperties": false
+                  }
+                },
+                "confidence": {
+                  "type": "number"
+                }
+              },
+              "required": [
+                "industries",
+                "preferences",
+                "requirements",
+                "rules",
+                "suggestions",
+                "confidence"
+              ],
+              "additionalProperties": false
+            }
+          },
+          "required": [
+            "action",
+            "analysis"
+          ],
+          "additionalProperties": false
+        },
+        {
+          "type": "object",
+          "properties": {
+            "action": {
+              "type": "string",
+              "const": "apply"
+            },
+            "persona": {
+              "$ref": "#/definitions/persona_operation/anyOf/1/properties/personas/items"
+            },
+            "effective": {
+              "$ref": "#/definitions/persona_operation/anyOf/0/properties/effective"
+            },
+            "applied": {
+              "type": "array",
+              "items": {
+                "$ref": "#/definitions/persona_operation/anyOf/3/properties/analysis/properties/suggestions/items"
+              }
+            }
+          },
+          "required": [
+            "action",
+            "persona",
+            "effective",
+            "applied"
+          ],
+          "additionalProperties": false
+        },
+        {
+          "type": "object",
+          "properties": {
+            "action": {
+              "type": "string",
+              "const": "sync"
+            },
+            "persona": {
+              "$ref": "#/definitions/persona_operation/anyOf/1/properties/personas/items"
+            },
+            "applied": {
+              "$ref": "#/definitions/persona_operation/anyOf/0/properties/effective/properties/layer"
+            },
+            "effective": {
+              "$ref": "#/definitions/persona_operation/anyOf/0/properties/effective"
+            }
+          },
+          "required": [
+            "action",
+            "persona",
+            "applied",
+            "effective"
+          ],
+          "additionalProperties": false
+        },
+        {
+          "type": "object",
+          "properties": {
+            "action": {
+              "type": "string",
+              "const": "remove"
+            },
+            "removed": {
+              "type": "boolean"
+            }
+          },
+          "required": [
+            "action",
+            "removed"
+          ],
+          "additionalProperties": false
+        }
+      ]
+    }
+  }
+}

package/dist/schemas/persona_operation.schema.json

@@ -0,0 +1,250 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "https://wowok.net/schemas/persona_operation.json",
+  "title": "Persona - User Identity Setting",
+  "description": "Read/write the user's systematic identity setting (persona): preferences, competitive strategy, experience rules, self profile, and spec. Each persona has a long-term layer (stable) and a current layer (transient, higher priority), bound to a scope: system (all accounts) or account (one chain address, higher priority).",
+  "$ref": "#/definitions/persona_operation",
+  "definitions": {
+    "persona_operation": {
+      "anyOf": [
+        {
+          "type": "object",
+          "properties": {
+            "action": {
+              "type": "string",
+              "const": "get"
+            },
+            "account": {
+              "type": "string",
+              "description": "Chain account address; omitted = system only."
+            },
+            "industry": {
+              "type": "string",
+              "enum": [
+                "freelance",
+                "rental",
+                "education",
+                "travel",
+                "subscription",
+                "retail"
+              ]
+            },
+            "role": {
+              "type": "string",
+              "enum": [
+                "merchant",
+                "customer",
+                "prospect",
+                "supplier",
+                "collaborator",
+                "arbitrator"
+              ]
+            }
+          },
+          "required": [
+            "action"
+          ],
+          "additionalProperties": false
+        },
+        {
+          "type": "object",
+          "properties": {
+            "action": {
+              "type": "string",
+              "const": "list"
+            }
+          },
+          "required": [
+            "action"
+          ],
+          "additionalProperties": false
+        },
+        {
+          "type": "object",
+          "properties": {
+            "action": {
+              "type": "string",
+              "const": "set"
+            },
+            "scope": {
+              "type": "string",
+              "enum": [
+                "system",
+                "account"
+              ]
+            },
+            "account": {
+              "type": "string",
+              "description": "Required when scope=account."
+            },
+            "role": {
+              "$ref": "#/definitions/persona_operation/anyOf/0/properties/role"
+            },
+            "industries": {
+              "type": "array",
+              "items": {
+                "$ref": "#/definitions/persona_operation/anyOf/0/properties/industry"
+              },
+              "default": []
+            },
+            "long_term": {
+              "type": "object",
+              "properties": {
+                "identity": {
+                  "type": "object",
+                  "properties": {
+                    "region": {
+                      "type": "string"
+                    },
+                    "languages": {
+                      "type": "array",
+                      "items": {
+                        "type": "string"
+                      }
+                    },
+                    "self_description": {
+                      "type": "string"
+                    }
+                  },
+                  "additionalProperties": false
+                },
+                "preferences": {
+                  "type": "object",
+                  "additionalProperties": {}
+                },
+                "strategy": {
+                  "type": "array",
+                  "items": {
+                    "type": "string"
+                  }
+                },
+                "rules": {
+                  "type": "array",
+                  "items": {
+                    "type": "string"
+                  }
+                },
+                "requirements": {
+                  "type": "array",
+                  "items": {
+                    "type": "string"
+                  }
+                },
+                "spec": {
+                  "type": "string"
+                }
+              },
+              "additionalProperties": false
+            },
+            "current": {
+              "$ref": "#/definitions/persona_operation/anyOf/2/properties/long_term"
+            }
+          },
+          "required": [
+            "action",
+            "scope",
+            "role"
+          ],
+          "additionalProperties": false
+        },
+        {
+          "type": "object",
+          "properties": {
+            "action": {
+              "type": "string",
+              "const": "analyze"
+            },
+            "context": {
+              "type": "string",
+              "description": "Free-form context: website URL, experience summary, self description, goal."
+            }
+          },
+          "required": [
+            "action",
+            "context"
+          ],
+          "additionalProperties": false
+        },
+        {
+          "type": "object",
+          "properties": {
+            "action": {
+              "type": "string",
+              "const": "apply"
+            },
+            "context": {
+              "type": "string",
+              "description": "Free-form context whose extracted signals feed the CURRENT layer."
+            },
+            "scope": {
+              "$ref": "#/definitions/persona_operation/anyOf/2/properties/scope"
+            },
+            "account": {
+              "type": "string"
+            },
+            "role": {
+              "$ref": "#/definitions/persona_operation/anyOf/0/properties/role"
+            },
+            "industries": {
+              "type": "array",
+              "items": {
+                "$ref": "#/definitions/persona_operation/anyOf/0/properties/industry"
+              }
+            },
+            "mode": {
+              "type": "string",
+              "enum": [
+                "merge",
+                "replace"
+              ],
+              "description": "merge (default) unions strategy/rules/requirements into current; replace discards the existing current layer."
+            }
+          },
+          "required": [
+            "action",
+            "context",
+            "scope"
+          ],
+          "additionalProperties": false
+        },
+        {
+          "type": "object",
+          "properties": {
+            "action": {
+              "type": "string",
+              "const": "sync"
+            },
+            "account": {
+              "type": "string",
+              "description": "Account whose behavior (experience layer) is merged into its CURRENT layer. Omit to sync the system persona."
+            }
+          },
+          "required": [
+            "action"
+          ],
+          "additionalProperties": false
+        },
+        {
+          "type": "object",
+          "properties": {
+            "action": {
+              "type": "string",
+              "const": "remove"
+            },
+            "scope": {
+              "$ref": "#/definitions/persona_operation/anyOf/2/properties/scope"
+            },
+            "account": {
+              "type": "string"
+            }
+          },
+          "required": [
+            "action",
+            "scope"
+          ],
+          "additionalProperties": false
+        }
+      ]
+    }
+  }
+}