@wowok/agent-mcp 2.3.16 → 2.3.18

package/dist/schemas/onchain_operations.output.json

@@ -1612,13 +1612,18 @@
                     "permission_denied",
                     "immutable_violation",
                     "network_error",
+                    "rate_limit",
+                    "gas_exceeded",
+                    "bcs_error",
+                    "signature_error",
+                    "config_error",
                     "unknown"
                   ],
-                  "description": "Error classification for programmatic recovery. Constraint: enum of 9 values. Relation: drives Recover Loop strategy selection. Example: 'insufficient_balance'"
+                  "description": "Error classification for programmatic recovery. Constraint: enum of 14 values. Relation: drives Recover Loop strategy selection. Example: 'insufficient_balance'"
                 },
                 "retryable": {
                   "type": "boolean",
-                  "description": "Whether the same call can be retried as-is. Constraint: true only for network_error and insufficient_balance. Example: true"
+                  "description": "Whether the same call can be retried as-is. Constraint: true for network_error, rate_limit, gas_exceeded, and insufficient_balance. Example: true"
                 },
                 "recovery_hint": {
                   "type": "string",
@@ -2378,6 +2383,230 @@
               ],
               "additionalProperties": false,
               "description": "Phase 4 industry evolution context (populated when industry_evolution service is enabled). Provides AI with industry health signals and evolution advice."
+            },
+            "guard_advice": {
+              "type": "object",
+              "properties": {
+                "current_round": {
+                  "type": "string",
+                  "enum": [
+                    "R1",
+                    "R2",
+                    "R3",
+                    "R4",
+                    "R5",
+                    "R6",
+                    "R7",
+                    "R8",
+                    "R9",
+                    "R10"
+                  ],
+                  "description": "Current R1-R10 dialogue round. R1=intent, R2=table, R3=tree, R4=rely, R5=binding, R6=review, R7=CREATE, R8=test, R9=bind, R10=verify. Example: 'R3'"
+                },
+                "puzzle_status": {
+                  "type": "object",
+                  "properties": {
+                    "intent": {
+                      "type": "boolean",
+                      "description": "Intent dimension complete (action + rule + failure conditions)"
+                    },
+                    "binding": {
+                      "type": "boolean",
+                      "description": "Binding dimension complete (host object + field + circular ref)"
+                    },
+                    "data": {
+                      "type": "boolean",
+                      "description": "Data dimension complete (table entries + witnesses)"
+                    },
+                    "query": {
+                      "type": "boolean",
+                      "description": "Query dimension complete (query instructions if needed)"
+                    },
+                    "logic": {
+                      "type": "boolean",
+                      "description": "Logic dimension complete (root node returns Bool)"
+                    },
+                    "constraints": {
+                      "type": "boolean",
+                      "description": "Constraints dimension complete (10 Pitfalls checked)"
+                    }
+                  },
+                  "required": [
+                    "intent",
+                    "binding",
+                    "data",
+                    "query",
+                    "logic",
+                    "constraints"
+                  ],
+                  "additionalProperties": false,
+                  "description": "Information puzzle completeness (6 dimensions). Missing dimensions need user input before CREATE."
+                },
+                "matched_scene": {
+                  "type": "string",
+                  "description": "Matched Guard scene id from the 8 binding scenarios ledger. Example: 'machine_forward_guard'"
+                },
+                "scene_description": {
+                  "type": "string",
+                  "description": "Human-readable scene description. Example: '工作流节点推进验证（Forward.guard）'"
+                },
+                "scene_constraints": {
+                  "type": "array",
+                  "items": {
+                    "type": "string"
+                  },
+                  "description": "Special constraints for the matched scene. Example: ['Machine 发布后 Forward.guard 不可修改']"
+                },
+                "suggested_patterns": {
+                  "type": "array",
+                  "items": {
+                    "type": "string"
+                  },
+                  "description": "Suggested Guard patterns based on user intent. Example: ['时间锁','进度状态检查']"
+                },
+                "available_queries": {
+                  "type": "array",
+                  "items": {
+                    "type": "object",
+                    "properties": {
+                      "id": {
+                        "type": "integer",
+                        "description": "Query instruction ID. Example: 1253"
+                      },
+                      "name": {
+                        "type": "string",
+                        "description": "Query instruction name. Example: 'progress.current_node_name'"
+                      },
+                      "objectType": {
+                        "type": "string",
+                        "description": "Target object type. Example: 'Progress'"
+                      },
+                      "returnType": {
+                        "type": "string",
+                        "description": "Return value type. Example: 'String'"
+                      },
+                      "description": {
+                        "type": "string",
+                        "description": "Query description"
+                      }
+                    },
+                    "required": [
+                      "id",
+                      "name",
+                      "objectType",
+                      "returnType"
+                    ],
+                    "additionalProperties": false,
+                    "description": "A Guard query instruction available for the current context (subset of GUARDQUERY 375 entries)."
+                  },
+                  "description": "Available query instructions for the current context (subset of 375 GUARDQUERY entries)"
+                },
+                "risk_warnings": {
+                  "type": "array",
+                  "items": {
+                    "type": "string"
+                  },
+                  "description": "Risk warnings for the current Guard design. Example: ['Guard 创建后不可修改','时间锁测试用 1000ms']"
+                },
+                "pending_questions": {
+                  "type": "array",
+                  "items": {
+                    "type": "string"
+                  },
+                  "description": "Questions for the user to complete the puzzle. Example: ['Guard 将绑定到哪个 Host Object？']"
+                },
+                "confirmation_text": {
+                  "type": "string",
+                  "description": "Structured semantic confirmation text for user review (generated when puzzle is complete). User must explicitly confirm before CREATE."
+                },
+                "test_result": {
+                  "type": "object",
+                  "properties": {
+                    "status": {
+                      "type": "string",
+                      "enum": [
+                        "pass",
+                        "fail",
+                        "not_tested"
+                      ]
+                    },
+                    "failure_node": {
+                      "type": "string",
+                      "description": "Node that caused failure (if fail)"
+                    },
+                    "passport_id": {
+                      "type": "string",
+                      "description": "Generated Passport ID (if pass)"
+                    }
+                  },
+                  "required": [
+                    "status"
+                  ],
+                  "additionalProperties": false,
+                  "description": "gen_passport static test result. Must pass before CREATE."
+                },
+                "risk_assessment": {
+                  "type": "object",
+                  "properties": {
+                    "overall_risk": {
+                      "type": "string",
+                      "enum": [
+                        "critical",
+                        "high",
+                        "medium",
+                        "low",
+                        "info"
+                      ],
+                      "description": "Overall risk level (highest from all risks)"
+                    },
+                    "risk_count": {
+                      "type": "integer",
+                      "description": "Total number of detected risks"
+                    },
+                    "critical_count": {
+                      "type": "integer",
+                      "description": "Number of critical risks"
+                    },
+                    "high_count": {
+                      "type": "integer",
+                      "description": "Number of high risks"
+                    },
+                    "needs_human_review": {
+                      "type": "boolean",
+                      "description": "Whether human review is required (critical or 2+ high risks)"
+                    },
+                    "top_risks": {
+                      "type": "array",
+                      "items": {
+                        "type": "string"
+                      },
+                      "description": "Top risk titles (critical and high, max 3)"
+                    },
+                    "stakeholder_advice": {
+                      "type": "object",
+                      "additionalProperties": {
+                        "type": "array",
+                        "items": {
+                          "type": "string"
+                        }
+                      },
+                      "description": "Per-stakeholder advice. Key=stakeholder (customer/provider/arbitrator/claimant), value=advice list"
+                    }
+                  },
+                  "required": [
+                    "overall_risk",
+                    "risk_count",
+                    "critical_count",
+                    "high_count",
+                    "needs_human_review",
+                    "top_risks"
+                  ],
+                  "additionalProperties": false,
+                  "description": "Business-layer risk assessment (game theory, data source trust, logic gaps). Populated during Guard design to warn about business risks beyond syntax."
+                }
+              },
+              "additionalProperties": false,
+              "description": "Phase 5 Guard capability advice (populated when user intent involves Guard). Provides puzzle status, scene matching, suggested patterns, available queries, risk warnings, and confirmation text. AI uses this to guide Guard design dialogue (R1-R10)."
             }
           },
           "required": [
@@ -2531,6 +2760,52 @@
           ],
           "additionalProperties": false,
           "description": "L4 Harness report (Verify + Recover). Present only when the Harness is injected and an Expected Result was declared for this operation. Relation: produced by handler.ts calling harness.verify() and harness.recover(). Example: {verify:{status:'fail', mismatches:[...]}, recovery:{strategy:'recreate'}}"
+        },
+        "schema_warning": {
+          "type": "object",
+          "properties": {
+            "compatible": {
+              "type": "boolean",
+              "description": "Whether the client schema version is compatible with the server."
+            },
+            "warnings": {
+              "type": "array",
+              "items": {
+                "type": "string"
+              },
+              "description": "Schema compatibility warnings or errors."
+            },
+            "client_version": {
+              "type": "string",
+              "description": "The client schema version that was checked."
+            },
+            "server_versions": {
+              "type": "object",
+              "properties": {
+                "sdk": {
+                  "type": "string",
+                  "description": "Server-side SDK schema version."
+                },
+                "mcp": {
+                  "type": "string",
+                  "description": "Server-side MCP tool schema version."
+                }
+              },
+              "required": [
+                "sdk",
+                "mcp"
+              ],
+              "additionalProperties": false,
+              "description": "Server-side schema versions."
+            }
+          },
+          "required": [
+            "compatible",
+            "warnings",
+            "server_versions"
+          ],
+          "additionalProperties": false,
+          "description": "Schema compatibility warning. Present only when client_schema_version is provided in env and a mismatch is detected."
         }
       },
       "required": [

package/dist/schemas/onchain_operations.schema.json

@@ -342,24 +342,11 @@
               }
             },
             "root": {
-              "description": "Root definition: either a direct node tree (type='node') or a file reference (type='file'). When type='file', the file can define all Guard fields (namedNew, description, table, root, rely), and schema fields override file content. For the node structure, see guard-node-schema.json for complete GuardNode definitions.",
+              "description": "Root definition: either a direct GuardNode computation tree (no type wrapper) or a file reference (type='file'). When type='file', the file can define all Guard fields (namedNew, description, table, root, rely), and schema fields override file content. For the node structure, see guard-node-schema.json for complete GuardNode definitions. IMPORTANT: The root node MUST be a logical operation returning Bool (e.g., logic_and, logic_or, logic_equal, query_reward_record_exists, etc.)",
               "oneOf": [
                 {
-                  "type": "object",
-                  "description": "Direct node tree - the node MUST be a logical operation returning Bool (e.g., logic_and, logic_or, logic_equal, query_reward_record_exists, etc.)",
-                  "properties": {
-                    "type": {
-                      "const": "node"
-                    },
-                    "node": {
-                      "$ref": "guard-node-schema.json",
-                      "description": "Guard computational tree root node. MUST return a Bool value (pass/fail). See guard-node-schema.json for complete node type definitions including: identifier, query, logic_*, calc_*, convert_*, vec_*, query_reward_record_*, query_progress_history_*, etc."
-                    }
-                  },
-                  "required": [
-                    "type",
-                    "node"
-                  ]
+                  "$ref": "guard-node-schema.json",
+                  "description": "Direct GuardNode computation tree - the node MUST be a logical operation returning Bool (e.g., logic_and, logic_or, logic_equal, query_reward_record_exists, etc.). No 'type: node' wrapper needed."
                 },
                 {
                   "type": "object",
@@ -606,6 +593,14 @@
         "project": {
           "type": "string",
           "description": "Phase 2 ProjectService: explicit project prefix to assign this object to (e.g. 'myshop'). When set, the object is tagged with 'project:<prefix>' automatically. Overrides the prefix parsed from the object name."
+        },
+        "client_schema_version": {
+          "type": "string",
+          "description": "Client-side schema version (semver, e.g. '1.0.0'). When provided, the server checks compatibility and attaches warnings if mismatched."
+        },
+        "schema_strict_mode": {
+          "type": "boolean",
+          "description": "When true, schema incompatibility returns an error instead of a warning. Default: false (warn mode)."
         }
       },
       "additionalProperties": false,
@@ -8712,6 +8707,14 @@
             "project": {
               "type": "string",
               "description": "Phase 2 ProjectService: explicit project prefix to assign this object to (e.g. 'myshop'). When set, the object is tagged with 'project:<prefix>' automatically. Overrides the prefix parsed from the object name."
+            },
+            "client_schema_version": {
+              "type": "string",
+              "description": "Client-side schema version (semver, e.g. '1.0.0'). When provided, the server checks compatibility and attaches warnings if mismatched."
+            },
+            "schema_strict_mode": {
+              "type": "boolean",
+              "description": "When true, schema incompatibility returns an error instead of a warning. Default: false (warn mode)."
             }
           },
           "additionalProperties": false,

package/dist/schemas/onchain_operations_allocation.schema.json

@@ -413,6 +413,14 @@
         "project": {
           "type": "string",
           "description": "Phase 2 ProjectService: explicit project prefix to assign this object to (e.g. 'myshop'). When set, the object is tagged with 'project:<prefix>' automatically. Overrides the prefix parsed from the object name."
+        },
+        "client_schema_version": {
+          "type": "string",
+          "description": "Client-side schema version (semver, e.g. '1.0.0'). When provided, the server checks compatibility and attaches warnings if mismatched."
+        },
+        "schema_strict_mode": {
+          "type": "boolean",
+          "description": "When true, schema incompatibility returns an error instead of a warning. Default: false (warn mode)."
         }
       },
       "additionalProperties": false,

package/dist/schemas/onchain_operations_arbitration.schema.json

@@ -665,6 +665,14 @@
         "project": {
           "type": "string",
           "description": "Phase 2 ProjectService: explicit project prefix to assign this object to (e.g. 'myshop'). When set, the object is tagged with 'project:<prefix>' automatically. Overrides the prefix parsed from the object name."
+        },
+        "client_schema_version": {
+          "type": "string",
+          "description": "Client-side schema version (semver, e.g. '1.0.0'). When provided, the server checks compatibility and attaches warnings if mismatched."
+        },
+        "schema_strict_mode": {
+          "type": "boolean",
+          "description": "When true, schema incompatibility returns an error instead of a warning. Default: false (warn mode)."
         }
       },
       "additionalProperties": false,

package/dist/schemas/onchain_operations_contact.schema.json

@@ -352,6 +352,14 @@
         "project": {
           "type": "string",
           "description": "Phase 2 ProjectService: explicit project prefix to assign this object to (e.g. 'myshop'). When set, the object is tagged with 'project:<prefix>' automatically. Overrides the prefix parsed from the object name."
+        },
+        "client_schema_version": {
+          "type": "string",
+          "description": "Client-side schema version (semver, e.g. '1.0.0'). When provided, the server checks compatibility and attaches warnings if mismatched."
+        },
+        "schema_strict_mode": {
+          "type": "boolean",
+          "description": "When true, schema incompatibility returns an error instead of a warning. Default: false (warn mode)."
         }
       },
       "additionalProperties": false,

package/dist/schemas/onchain_operations_demand.schema.json

@@ -483,6 +483,14 @@
         "project": {
           "type": "string",
           "description": "Phase 2 ProjectService: explicit project prefix to assign this object to (e.g. 'myshop'). When set, the object is tagged with 'project:<prefix>' automatically. Overrides the prefix parsed from the object name."
+        },
+        "client_schema_version": {
+          "type": "string",
+          "description": "Client-side schema version (semver, e.g. '1.0.0'). When provided, the server checks compatibility and attaches warnings if mismatched."
+        },
+        "schema_strict_mode": {
+          "type": "boolean",
+          "description": "When true, schema incompatibility returns an error instead of a warning. Default: false (warn mode)."
         }
       },
       "additionalProperties": false,

package/dist/schemas/onchain_operations_gen_passport.schema.json

@@ -600,6 +600,14 @@
             "project": {
               "type": "string",
               "description": "Phase 2 ProjectService: explicit project prefix to assign this object to (e.g. 'myshop'). When set, the object is tagged with 'project:<prefix>' automatically. Overrides the prefix parsed from the object name."
+            },
+            "client_schema_version": {
+              "type": "string",
+              "description": "Client-side schema version (semver, e.g. '1.0.0'). When provided, the server checks compatibility and attaches warnings if mismatched."
+            },
+            "schema_strict_mode": {
+              "type": "boolean",
+              "description": "When true, schema incompatibility returns an error instead of a warning. Default: false (warn mode)."
             }
           },
           "additionalProperties": false,
@@ -658,6 +666,14 @@
         "project": {
           "type": "string",
           "description": "Phase 2 ProjectService: explicit project prefix to assign this object to (e.g. 'myshop'). When set, the object is tagged with 'project:<prefix>' automatically. Overrides the prefix parsed from the object name."
+        },
+        "client_schema_version": {
+          "type": "string",
+          "description": "Client-side schema version (semver, e.g. '1.0.0'). When provided, the server checks compatibility and attaches warnings if mismatched."
+        },
+        "schema_strict_mode": {
+          "type": "boolean",
+          "description": "When true, schema incompatibility returns an error instead of a warning. Default: false (warn mode)."
         }
       },
       "additionalProperties": false,

package/dist/schemas/onchain_operations_guard.schema.json

@@ -78,24 +78,11 @@
           }
         },
         "root": {
-          "description": "Root definition: either a direct node tree (type='node') or a file reference (type='file'). When type='file', the file can define all Guard fields (namedNew, description, table, root, rely), and schema fields override file content. For the node structure, see guard-node-schema.json for complete GuardNode definitions.",
+          "description": "Root definition: either a direct GuardNode computation tree (no type wrapper) or a file reference (type='file'). When type='file', the file can define all Guard fields (namedNew, description, table, root, rely), and schema fields override file content. For the node structure, see guard-node-schema.json for complete GuardNode definitions. IMPORTANT: The root node MUST be a logical operation returning Bool (e.g., logic_and, logic_or, logic_equal, query_reward_record_exists, etc.)",
           "oneOf": [
             {
-              "type": "object",
-              "description": "Direct node tree - the node MUST be a logical operation returning Bool (e.g., logic_and, logic_or, logic_equal, query_reward_record_exists, etc.)",
-              "properties": {
-                "type": {
-                  "const": "node"
-                },
-                "node": {
-                  "$ref": "guard-node-schema.json",
-                  "description": "Guard computational tree root node. MUST return a Bool value (pass/fail). See guard-node-schema.json for complete node type definitions including: identifier, query, logic_*, calc_*, convert_*, vec_*, query_reward_record_*, query_progress_history_*, etc."
-                }
-              },
-              "required": [
-                "type",
-                "node"
-              ]
+              "$ref": "guard-node-schema.json",
+              "description": "Direct GuardNode computation tree - the node MUST be a logical operation returning Bool (e.g., logic_and, logic_or, logic_equal, query_reward_record_exists, etc.). No 'type: node' wrapper needed."
             },
             {
               "type": "object",
@@ -210,6 +197,14 @@
         "project": {
           "type": "string",
           "description": "Phase 2 ProjectService: explicit project prefix to assign this object to (e.g. 'myshop'). When set, the object is tagged with 'project:<prefix>' automatically. Overrides the prefix parsed from the object name."
+        },
+        "client_schema_version": {
+          "type": "string",
+          "description": "Client-side schema version (semver, e.g. '1.0.0'). When provided, the server checks compatibility and attaches warnings if mismatched."
+        },
+        "schema_strict_mode": {
+          "type": "boolean",
+          "description": "When true, schema incompatibility returns an error instead of a warning. Default: false (warn mode)."
         }
       },
       "additionalProperties": false,

package/dist/schemas/onchain_operations_machine.schema.json

@@ -854,6 +854,14 @@
         "project": {
           "type": "string",
           "description": "Phase 2 ProjectService: explicit project prefix to assign this object to (e.g. 'myshop'). When set, the object is tagged with 'project:<prefix>' automatically. Overrides the prefix parsed from the object name."
+        },
+        "client_schema_version": {
+          "type": "string",
+          "description": "Client-side schema version (semver, e.g. '1.0.0'). When provided, the server checks compatibility and attaches warnings if mismatched."
+        },
+        "schema_strict_mode": {
+          "type": "boolean",
+          "description": "When true, schema incompatibility returns an error instead of a warning. Default: false (warn mode)."
         }
       },
       "additionalProperties": false,

package/dist/schemas/onchain_operations_order.schema.json

@@ -329,6 +329,14 @@
         "project": {
           "type": "string",
           "description": "Phase 2 ProjectService: explicit project prefix to assign this object to (e.g. 'myshop'). When set, the object is tagged with 'project:<prefix>' automatically. Overrides the prefix parsed from the object name."
+        },
+        "client_schema_version": {
+          "type": "string",
+          "description": "Client-side schema version (semver, e.g. '1.0.0'). When provided, the server checks compatibility and attaches warnings if mismatched."
+        },
+        "schema_strict_mode": {
+          "type": "boolean",
+          "description": "When true, schema incompatibility returns an error instead of a warning. Default: false (warn mode)."
         }
       },
       "additionalProperties": false,

package/dist/schemas/onchain_operations_payment.schema.json

@@ -216,6 +216,14 @@
         "project": {
           "type": "string",
           "description": "Phase 2 ProjectService: explicit project prefix to assign this object to (e.g. 'myshop'). When set, the object is tagged with 'project:<prefix>' automatically. Overrides the prefix parsed from the object name."
+        },
+        "client_schema_version": {
+          "type": "string",
+          "description": "Client-side schema version (semver, e.g. '1.0.0'). When provided, the server checks compatibility and attaches warnings if mismatched."
+        },
+        "schema_strict_mode": {
+          "type": "boolean",
+          "description": "When true, schema incompatibility returns an error instead of a warning. Default: false (warn mode)."
         }
       },
       "additionalProperties": false,

package/dist/schemas/onchain_operations_permission.schema.json

@@ -587,6 +587,14 @@
         "project": {
           "type": "string",
           "description": "Phase 2 ProjectService: explicit project prefix to assign this object to (e.g. 'myshop'). When set, the object is tagged with 'project:<prefix>' automatically. Overrides the prefix parsed from the object name."
+        },
+        "client_schema_version": {
+          "type": "string",
+          "description": "Client-side schema version (semver, e.g. '1.0.0'). When provided, the server checks compatibility and attaches warnings if mismatched."
+        },
+        "schema_strict_mode": {
+          "type": "boolean",
+          "description": "When true, schema incompatibility returns an error instead of a warning. Default: false (warn mode)."
         }
       },
       "additionalProperties": false,

package/dist/schemas/onchain_operations_personal.schema.json

@@ -781,6 +781,14 @@
         "project": {
           "type": "string",
           "description": "Phase 2 ProjectService: explicit project prefix to assign this object to (e.g. 'myshop'). When set, the object is tagged with 'project:<prefix>' automatically. Overrides the prefix parsed from the object name."
+        },
+        "client_schema_version": {
+          "type": "string",
+          "description": "Client-side schema version (semver, e.g. '1.0.0'). When provided, the server checks compatibility and attaches warnings if mismatched."
+        },
+        "schema_strict_mode": {
+          "type": "boolean",
+          "description": "When true, schema incompatibility returns an error instead of a warning. Default: false (warn mode)."
         }
       },
       "additionalProperties": false,

package/dist/schemas/onchain_operations_progress.schema.json

@@ -250,6 +250,14 @@
         "project": {
           "type": "string",
           "description": "Phase 2 ProjectService: explicit project prefix to assign this object to (e.g. 'myshop'). When set, the object is tagged with 'project:<prefix>' automatically. Overrides the prefix parsed from the object name."
+        },
+        "client_schema_version": {
+          "type": "string",
+          "description": "Client-side schema version (semver, e.g. '1.0.0'). When provided, the server checks compatibility and attaches warnings if mismatched."
+        },
+        "schema_strict_mode": {
+          "type": "boolean",
+          "description": "When true, schema incompatibility returns an error instead of a warning. Default: false (warn mode)."
         }
       },
       "additionalProperties": false,

package/dist/schemas/onchain_operations_repository.schema.json

@@ -1074,6 +1074,14 @@
         "project": {
           "type": "string",
           "description": "Phase 2 ProjectService: explicit project prefix to assign this object to (e.g. 'myshop'). When set, the object is tagged with 'project:<prefix>' automatically. Overrides the prefix parsed from the object name."
+        },
+        "client_schema_version": {
+          "type": "string",
+          "description": "Client-side schema version (semver, e.g. '1.0.0'). When provided, the server checks compatibility and attaches warnings if mismatched."
+        },
+        "schema_strict_mode": {
+          "type": "boolean",
+          "description": "When true, schema incompatibility returns an error instead of a warning. Default: false (warn mode)."
         }
       },
       "additionalProperties": false,

package/dist/schemas/onchain_operations_reward.schema.json

@@ -454,6 +454,14 @@
         "project": {
           "type": "string",
           "description": "Phase 2 ProjectService: explicit project prefix to assign this object to (e.g. 'myshop'). When set, the object is tagged with 'project:<prefix>' automatically. Overrides the prefix parsed from the object name."
+        },
+        "client_schema_version": {
+          "type": "string",
+          "description": "Client-side schema version (semver, e.g. '1.0.0'). When provided, the server checks compatibility and attaches warnings if mismatched."
+        },
+        "schema_strict_mode": {
+          "type": "boolean",
+          "description": "When true, schema incompatibility returns an error instead of a warning. Default: false (warn mode)."
         }
       },
       "additionalProperties": false,

package/dist/schemas/onchain_operations_service.schema.json

@@ -913,6 +913,14 @@
         "project": {
           "type": "string",
           "description": "Phase 2 ProjectService: explicit project prefix to assign this object to (e.g. 'myshop'). When set, the object is tagged with 'project:<prefix>' automatically. Overrides the prefix parsed from the object name."
+        },
+        "client_schema_version": {
+          "type": "string",
+          "description": "Client-side schema version (semver, e.g. '1.0.0'). When provided, the server checks compatibility and attaches warnings if mismatched."
+        },
+        "schema_strict_mode": {
+          "type": "boolean",
+          "description": "When true, schema incompatibility returns an error instead of a warning. Default: false (warn mode)."
         }
       },
       "additionalProperties": false,