@wowok/agent-mcp 2.3.0 → 2.3.2

package/dist/schemas/guard-node-schema.json

@@ -0,0 +1,918 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "https://wowok.net/schemas/guard-node.json",
+  "title": "GuardNode",
+  "description": "Guard computational tree node. Each node represents an operation that returns a typed value. Nodes can be nested to build complex validation logic. IMPORTANT: This schema uses type discrimination - each node MUST have a 'type' field that determines its structure. The 'returns' field in each node definition indicates the return type.",
+  "oneOf": [
+    { "$ref": "#/definitions/IdentifierNode" },
+    { "$ref": "#/definitions/QueryNode" },
+    { "$ref": "#/definitions/ContextNode" },
+    { "$ref": "#/definitions/LogicAsU256GreaterOrEqualNode" },
+    { "$ref": "#/definitions/LogicAsU256LesserOrEqualNode" },
+    { "$ref": "#/definitions/LogicAsU256GreaterNode" },
+    { "$ref": "#/definitions/LogicAsU256LesserNode" },
+    { "$ref": "#/definitions/LogicAsU256EqualNode" },
+    { "$ref": "#/definitions/LogicEqualNode" },
+    { "$ref": "#/definitions/LogicNotNode" },
+    { "$ref": "#/definitions/LogicAndNode" },
+    { "$ref": "#/definitions/LogicOrNode" },
+    { "$ref": "#/definitions/LogicStringContainsNode" },
+    { "$ref": "#/definitions/LogicStringNocaseContainsNode" },
+    { "$ref": "#/definitions/LogicStringNocaseEqualNode" },
+    { "$ref": "#/definitions/CalcNumberAddNode" },
+    { "$ref": "#/definitions/CalcNumberMultiplyNode" },
+    { "$ref": "#/definitions/CalcNumberSubtractNode" },
+    { "$ref": "#/definitions/CalcNumberDivideNode" },
+    { "$ref": "#/definitions/CalcNumberModNode" },
+    { "$ref": "#/definitions/CalcStringLengthNode" },
+    { "$ref": "#/definitions/CalcStringContainsNode" },
+    { "$ref": "#/definitions/CalcStringNocaseContainsNode" },
+    { "$ref": "#/definitions/CalcStringNocaseEqualNode" },
+    { "$ref": "#/definitions/CalcStringIndexofNode" },
+    { "$ref": "#/definitions/CalcStringNocaseIndexofNode" },
+    { "$ref": "#/definitions/ConvertNumberAddressNode" },
+    { "$ref": "#/definitions/ConvertAddressNumberNode" },
+    { "$ref": "#/definitions/ConvertNumberStringNode" },
+    { "$ref": "#/definitions/ConvertStringNumberNode" },
+    { "$ref": "#/definitions/ConvertSafeU8Node" },
+    { "$ref": "#/definitions/ConvertSafeU16Node" },
+    { "$ref": "#/definitions/ConvertSafeU32Node" },
+    { "$ref": "#/definitions/ConvertSafeU64Node" },
+    { "$ref": "#/definitions/ConvertSafeU128Node" },
+    { "$ref": "#/definitions/ConvertSafeU256Node" },
+    { "$ref": "#/definitions/VecLengthNode" },
+    { "$ref": "#/definitions/VecContainsBoolNode" },
+    { "$ref": "#/definitions/VecContainsAddressNode" },
+    { "$ref": "#/definitions/VecContainsStringNode" },
+    { "$ref": "#/definitions/VecContainsStringNocaseNode" },
+    { "$ref": "#/definitions/VecContainsNumberNode" },
+    { "$ref": "#/definitions/QueryProgressHistoryFindNode" },
+    { "$ref": "#/definitions/QueryProgressHistorySessionFindNode" },
+    { "$ref": "#/definitions/QueryProgressHistorySessionForwardFindNode" },
+    { "$ref": "#/definitions/QueryProgressHistorySessionCountNode" },
+    { "$ref": "#/definitions/QueryProgressHistorySessionForwardCountNode" },
+    { "$ref": "#/definitions/QueryProgressHistorySessionForwardRetainedSubmissionCountNode" },
+    { "$ref": "#/definitions/QueryRewardRecordFindNode" },
+    { "$ref": "#/definitions/QueryRewardRecordCountNode" },
+    { "$ref": "#/definitions/QueryRewardRecordExistsNode" }
+  ],
+  "definitions": {
+    "GuardIdentifier": {
+      "type": "integer",
+      "minimum": 0,
+      "maximum": 255,
+      "description": "Identifier index (0-255) referencing a value in the Guard table"
+    },
+    "GuardNodeRef": {
+      "description": "Reference to a GuardNode. This is a recursive structure that can be any of the node types defined in this schema. Use the 'type' field to determine which node type it is.",
+      "oneOf": [
+        { "$ref": "#/definitions/IdentifierNode" },
+        { "$ref": "#/definitions/QueryNode" },
+        { "$ref": "#/definitions/ContextNode" },
+        { "$ref": "#/definitions/LogicAsU256GreaterOrEqualNode" },
+        { "$ref": "#/definitions/LogicAsU256LesserOrEqualNode" },
+        { "$ref": "#/definitions/LogicAsU256GreaterNode" },
+        { "$ref": "#/definitions/LogicAsU256LesserNode" },
+        { "$ref": "#/definitions/LogicAsU256EqualNode" },
+        { "$ref": "#/definitions/LogicEqualNode" },
+        { "$ref": "#/definitions/LogicNotNode" },
+        { "$ref": "#/definitions/LogicAndNode" },
+        { "$ref": "#/definitions/LogicOrNode" },
+        { "$ref": "#/definitions/LogicStringContainsNode" },
+        { "$ref": "#/definitions/LogicStringNocaseContainsNode" },
+        { "$ref": "#/definitions/LogicStringNocaseEqualNode" },
+        { "$ref": "#/definitions/CalcNumberAddNode" },
+        { "$ref": "#/definitions/CalcNumberMultiplyNode" },
+        { "$ref": "#/definitions/CalcNumberSubtractNode" },
+        { "$ref": "#/definitions/CalcNumberDivideNode" },
+        { "$ref": "#/definitions/CalcNumberModNode" },
+        { "$ref": "#/definitions/CalcStringLengthNode" },
+        { "$ref": "#/definitions/CalcStringContainsNode" },
+        { "$ref": "#/definitions/CalcStringNocaseContainsNode" },
+        { "$ref": "#/definitions/CalcStringNocaseEqualNode" },
+        { "$ref": "#/definitions/CalcStringIndexofNode" },
+        { "$ref": "#/definitions/CalcStringNocaseIndexofNode" },
+        { "$ref": "#/definitions/ConvertNumberAddressNode" },
+        { "$ref": "#/definitions/ConvertAddressNumberNode" },
+        { "$ref": "#/definitions/ConvertNumberStringNode" },
+        { "$ref": "#/definitions/ConvertStringNumberNode" },
+        { "$ref": "#/definitions/ConvertSafeU8Node" },
+        { "$ref": "#/definitions/ConvertSafeU16Node" },
+        { "$ref": "#/definitions/ConvertSafeU32Node" },
+        { "$ref": "#/definitions/ConvertSafeU64Node" },
+        { "$ref": "#/definitions/ConvertSafeU128Node" },
+        { "$ref": "#/definitions/ConvertSafeU256Node" },
+        { "$ref": "#/definitions/VecLengthNode" },
+        { "$ref": "#/definitions/VecContainsBoolNode" },
+        { "$ref": "#/definitions/VecContainsAddressNode" },
+        { "$ref": "#/definitions/VecContainsStringNode" },
+        { "$ref": "#/definitions/VecContainsStringNocaseNode" },
+        { "$ref": "#/definitions/VecContainsNumberNode" },
+        { "$ref": "#/definitions/QueryProgressHistoryFindNode" },
+        { "$ref": "#/definitions/QueryProgressHistorySessionFindNode" },
+        { "$ref": "#/definitions/QueryProgressHistorySessionForwardFindNode" },
+        { "$ref": "#/definitions/QueryProgressHistorySessionCountNode" },
+        { "$ref": "#/definitions/QueryProgressHistorySessionForwardCountNode" },
+        { "$ref": "#/definitions/QueryProgressHistorySessionForwardRetainedSubmissionCountNode" },
+        { "$ref": "#/definitions/QueryRewardRecordFindNode" },
+        { "$ref": "#/definitions/QueryRewardRecordCountNode" },
+        { "$ref": "#/definitions/QueryRewardRecordExistsNode" }
+      ]
+    },
+    "GuardNodeArray": {
+      "type": "array",
+      "items": { "$ref": "#/definitions/GuardNodeRef" },
+      "minItems": 1,
+      "maxItems": 8,
+      "description": "Array of 1-8 child GuardNodes. All nodes in the array are evaluated and their results are combined according to the parent node's logic."
+    },
+    "WitnessType": {
+      "type": "integer",
+      "description": "Witness type for converting object data. Common values: 100 (TypeOrderProgress) for querying order progress, 200 (TypeOrder) for order data"
+    },
+    "IdentifierNode": {
+      "type": "object",
+      "properties": {
+        "type": { "const": "identifier" },
+        "identifier": { "$ref": "#/definitions/GuardIdentifier" }
+      },
+      "required": ["type", "identifier"],
+      "additionalProperties": false,
+      "returns": "any",
+      "description": "Returns the constant value stored at the specified identifier in the Guard table. Return type depends on the table item's value_type (U8, U16, U32, U64, U128, U256, Bool, Address, String, Vec)."
+    },
+    "QueryNode": {
+      "type": "object",
+      "properties": {
+        "type": { "const": "query" },
+        "query": {
+          "oneOf": [
+            { "type": "integer", "description": "Query instruction ID (e.g., 1562 for order.owner, 1563 for order.service, 1253 for order.progress.node)" },
+            { "type": "string", "description": "Query instruction name (e.g., 'order.owner', 'order.service')" }
+          ]
+        },
+        "object": {
+          "type": "object",
+          "properties": {
+            "identifier": { "$ref": "#/definitions/GuardIdentifier" },
+            "convert_witness": { "$ref": "#/definitions/WitnessType" }
+          },
+          "required": ["identifier"],
+          "additionalProperties": false,
+          "description": "The object to query from the Guard table"
+        },
+        "parameters": {
+          "type": "array",
+          "items": { "$ref": "#/definitions/GuardNodeRef" },
+          "description": "Parameters required by the query (must match the query's expected parameter types)"
+        }
+      },
+      "required": ["type", "query", "object", "parameters"],
+      "additionalProperties": false,
+      "returns": "any",
+      "description": "Returns the result of executing a data query instruction on the specified object. Return type depends on the query being executed. Use convert_witness to access specific object data like order progress."
+    },
+    "ContextNode": {
+      "type": "object",
+      "properties": {
+        "type": { "const": "context" },
+        "context": {
+          "type": "string",
+          "enum": ["Signer", "Clock", "Guard"],
+          "description": "System context type: Signer returns transaction sender address (Address), Clock returns current on-chain timestamp (U64), Guard returns current Guard object ID (Address)"
+        }
+      },
+      "required": ["type", "context"],
+      "additionalProperties": false,
+      "returns": "Address | U64",
+      "description": "Returns system context information. Signer and Guard return Address, Clock returns U64."
+    },
+    "LogicAsU256GreaterOrEqualNode": {
+      "type": "object",
+      "properties": {
+        "type": { "const": "logic_as_u256_greater_or_equal" },
+        "nodes": { "$ref": "#/definitions/GuardNodeArray" }
+      },
+      "required": ["type", "nodes"],
+      "additionalProperties": false,
+      "returns": "Bool",
+      "description": "Returns Bool. Requires 2-8 numeric nodes (U8, U16, U32, U64, U128, U256). Returns true if first >= all others."
+    },
+    "LogicAsU256LesserOrEqualNode": {
+      "type": "object",
+      "properties": {
+        "type": { "const": "logic_as_u256_lesser_or_equal" },
+        "nodes": { "$ref": "#/definitions/GuardNodeArray" }
+      },
+      "required": ["type", "nodes"],
+      "additionalProperties": false,
+      "returns": "Bool",
+      "description": "Returns Bool. Requires 2-8 numeric nodes. Returns true if first <= all others."
+    },
+    "LogicAsU256GreaterNode": {
+      "type": "object",
+      "properties": {
+        "type": { "const": "logic_as_u256_greater" },
+        "nodes": { "$ref": "#/definitions/GuardNodeArray" }
+      },
+      "required": ["type", "nodes"],
+      "additionalProperties": false,
+      "returns": "Bool",
+      "description": "Returns Bool. Requires 2-8 numeric nodes. Returns true if first > all others."
+    },
+    "LogicAsU256LesserNode": {
+      "type": "object",
+      "properties": {
+        "type": { "const": "logic_as_u256_lesser" },
+        "nodes": { "$ref": "#/definitions/GuardNodeArray" }
+      },
+      "required": ["type", "nodes"],
+      "additionalProperties": false,
+      "returns": "Bool",
+      "description": "Returns Bool. Requires 2-8 numeric nodes. Returns true if first < all others."
+    },
+    "LogicAsU256EqualNode": {
+      "type": "object",
+      "properties": {
+        "type": { "const": "logic_as_u256_equal" },
+        "nodes": { "$ref": "#/definitions/GuardNodeArray" }
+      },
+      "required": ["type", "nodes"],
+      "additionalProperties": false,
+      "returns": "Bool",
+      "description": "Returns Bool. Requires 2-8 numeric nodes. Returns true if first equals all others."
+    },
+    "LogicEqualNode": {
+      "type": "object",
+      "properties": {
+        "type": { "const": "logic_equal" },
+        "nodes": { "$ref": "#/definitions/GuardNodeArray" }
+      },
+      "required": ["type", "nodes"],
+      "additionalProperties": false,
+      "returns": "Bool",
+      "description": "Returns Bool. Requires 2-8 nodes of any type. Returns true if type and value match for all. Can compare Address, String, Bool, or numeric types."
+    },
+    "LogicNotNode": {
+      "type": "object",
+      "properties": {
+        "type": { "const": "logic_not" },
+        "node": { "$ref": "#/definitions/GuardNodeRef" }
+      },
+      "required": ["type", "node"],
+      "additionalProperties": false,
+      "returns": "Bool",
+      "description": "Returns Bool. Inverts the boolean value of the child node. The child node must return Bool."
+    },
+    "LogicAndNode": {
+      "type": "object",
+      "properties": {
+        "type": { "const": "logic_and" },
+        "nodes": { "$ref": "#/definitions/GuardNodeArray" }
+      },
+      "required": ["type", "nodes"],
+      "additionalProperties": false,
+      "returns": "Bool",
+      "description": "Returns Bool. Requires 2-8 boolean nodes. Returns true if ALL are true. This is the most common root node type for combining multiple validation conditions."
+    },
+    "LogicOrNode": {
+      "type": "object",
+      "properties": {
+        "type": { "const": "logic_or" },
+        "nodes": { "$ref": "#/definitions/GuardNodeArray" }
+      },
+      "required": ["type", "nodes"],
+      "additionalProperties": false,
+      "returns": "Bool",
+      "description": "Returns Bool. Requires 2-8 boolean nodes. Returns true if ANY is true."
+    },
+    "LogicStringContainsNode": {
+      "type": "object",
+      "properties": {
+        "type": { "const": "logic_string_contains" },
+        "nodes": { "$ref": "#/definitions/GuardNodeArray" }
+      },
+      "required": ["type", "nodes"],
+      "additionalProperties": false,
+      "returns": "Bool",
+      "description": "Returns Bool. Requires 2-8 string nodes. First is haystack, others are needles. Case-sensitive substring check."
+    },
+    "LogicStringNocaseContainsNode": {
+      "type": "object",
+      "properties": {
+        "type": { "const": "logic_string_nocase_contains" },
+        "nodes": { "$ref": "#/definitions/GuardNodeArray" }
+      },
+      "required": ["type", "nodes"],
+      "additionalProperties": false,
+      "returns": "Bool",
+      "description": "Returns Bool. String contains check, case-insensitive."
+    },
+    "LogicStringNocaseEqualNode": {
+      "type": "object",
+      "properties": {
+        "type": { "const": "logic_string_nocase_equal" },
+        "nodes": { "$ref": "#/definitions/GuardNodeArray" }
+      },
+      "required": ["type", "nodes"],
+      "additionalProperties": false,
+      "returns": "Bool",
+      "description": "Returns Bool. String equality check, case-insensitive."
+    },
+    "CalcNumberAddNode": {
+      "type": "object",
+      "properties": {
+        "type": { "const": "calc_number_add" },
+        "nodes": { "$ref": "#/definitions/GuardNodeArray" }
+      },
+      "required": ["type", "nodes"],
+      "additionalProperties": false,
+      "returns": "U256",
+      "description": "Returns U256. Adds all numeric nodes (first + second + third + ...). All inputs must be numeric types."
+    },
+    "CalcNumberMultiplyNode": {
+      "type": "object",
+      "properties": {
+        "type": { "const": "calc_number_multiply" },
+        "nodes": { "$ref": "#/definitions/GuardNodeArray" }
+      },
+      "required": ["type", "nodes"],
+      "additionalProperties": false,
+      "returns": "U256",
+      "description": "Returns U256. Multiplies all numeric nodes (first * second * third * ...)"
+    },
+    "CalcNumberSubtractNode": {
+      "type": "object",
+      "properties": {
+        "type": { "const": "calc_number_subtract" },
+        "nodes": { "$ref": "#/definitions/GuardNodeArray" }
+      },
+      "required": ["type", "nodes"],
+      "additionalProperties": false,
+      "returns": "U256",
+      "description": "Returns U256. Subtracts subsequent nodes from first (first - second - third - ...)"
+    },
+    "CalcNumberDivideNode": {
+      "type": "object",
+      "properties": {
+        "type": { "const": "calc_number_divide" },
+        "nodes": { "$ref": "#/definitions/GuardNodeArray" }
+      },
+      "required": ["type", "nodes"],
+      "additionalProperties": false,
+      "returns": "U256",
+      "description": "Returns U256. Divides first by subsequent nodes (first / second / third / ...). Division by zero will fail."
+    },
+    "CalcNumberModNode": {
+      "type": "object",
+      "properties": {
+        "type": { "const": "calc_number_mod" },
+        "nodes": { "$ref": "#/definitions/GuardNodeArray" }
+      },
+      "required": ["type", "nodes"],
+      "additionalProperties": false,
+      "returns": "U256",
+      "description": "Returns U256. Modulo operation (first % second % third % ...)"
+    },
+    "CalcStringLengthNode": {
+      "type": "object",
+      "properties": {
+        "type": { "const": "calc_string_length" },
+        "node": { "$ref": "#/definitions/GuardNodeRef" }
+      },
+      "required": ["type", "node"],
+      "additionalProperties": false,
+      "returns": "U64",
+      "description": "Returns U64. Returns the length of the string in bytes."
+    },
+    "CalcStringContainsNode": {
+      "type": "object",
+      "properties": {
+        "type": { "const": "calc_string_contains" },
+        "nodes": { "$ref": "#/definitions/GuardNodeArray" }
+      },
+      "required": ["type", "nodes"],
+      "additionalProperties": false,
+      "returns": "Bool",
+      "description": "Returns Bool. String contains check (for use in calculations). First is haystack, others are needles."
+    },
+    "CalcStringNocaseContainsNode": {
+      "type": "object",
+      "properties": {
+        "type": { "const": "calc_string_nocase_contains" },
+        "nodes": { "$ref": "#/definitions/GuardNodeArray" }
+      },
+      "required": ["type", "nodes"],
+      "additionalProperties": false,
+      "returns": "Bool",
+      "description": "Returns Bool. Case-insensitive string contains."
+    },
+    "CalcStringNocaseEqualNode": {
+      "type": "object",
+      "properties": {
+        "type": { "const": "calc_string_nocase_equal" },
+        "nodes": { "$ref": "#/definitions/GuardNodeArray" }
+      },
+      "required": ["type", "nodes"],
+      "additionalProperties": false,
+      "returns": "Bool",
+      "description": "Returns Bool. Case-insensitive string equality."
+    },
+    "CalcStringIndexofNode": {
+      "type": "object",
+      "properties": {
+        "type": { "const": "calc_string_indexof" },
+        "nodeLeft": { "$ref": "#/definitions/GuardNodeRef" },
+        "nodeRight": { "$ref": "#/definitions/GuardNodeRef" },
+        "order": { "type": "string", "enum": ["forward", "backward"] }
+      },
+      "required": ["type", "nodeLeft", "nodeRight", "order"],
+      "additionalProperties": false,
+      "returns": "U64",
+      "description": "Returns U64. Finds index of substring. Returns -1 (as U64 max) if not found. 'forward' searches from start, 'backward' from end."
+    },
+    "CalcStringNocaseIndexofNode": {
+      "type": "object",
+      "properties": {
+        "type": { "const": "calc_string_nocase_indexof" },
+        "nodeLeft": { "$ref": "#/definitions/GuardNodeRef" },
+        "nodeRight": { "$ref": "#/definitions/GuardNodeRef" },
+        "order": { "type": "string", "enum": ["forward", "backward"] }
+      },
+      "required": ["type", "nodeLeft", "nodeRight", "order"],
+      "additionalProperties": false,
+      "returns": "U64",
+      "description": "Returns U64. Case-insensitive index search."
+    },
+    "ConvertNumberAddressNode": {
+      "type": "object",
+      "properties": {
+        "type": { "const": "convert_number_address" },
+        "node": { "$ref": "#/definitions/GuardNodeRef" }
+      },
+      "required": ["type", "node"],
+      "additionalProperties": false,
+      "returns": "Address",
+      "description": "Returns Address. Converts a U64 number to an address. Useful for converting numeric IDs to addresses."
+    },
+    "ConvertAddressNumberNode": {
+      "type": "object",
+      "properties": {
+        "type": { "const": "convert_address_number" },
+        "node": { "$ref": "#/definitions/GuardNodeRef" }
+      },
+      "required": ["type", "node"],
+      "additionalProperties": false,
+      "returns": "U64",
+      "description": "Returns U64. Converts an address to a number (takes the lower 8 bytes)."
+    },
+    "ConvertNumberStringNode": {
+      "type": "object",
+      "properties": {
+        "type": { "const": "convert_number_string" },
+        "node": { "$ref": "#/definitions/GuardNodeRef" }
+      },
+      "required": ["type", "node"],
+      "additionalProperties": false,
+      "returns": "String",
+      "description": "Returns String. Converts a number to its decimal string representation."
+    },
+    "ConvertStringNumberNode": {
+      "type": "object",
+      "properties": {
+        "type": { "const": "convert_string_number" },
+        "node": { "$ref": "#/definitions/GuardNodeRef" }
+      },
+      "required": ["type", "node"],
+      "additionalProperties": false,
+      "returns": "U256",
+      "description": "Returns U256. Parses a decimal string as a number. Returns 0 if parsing fails."
+    },
+    "ConvertSafeU8Node": {
+      "type": "object",
+      "properties": {
+        "type": { "const": "convert_safe_u8" },
+        "node": { "$ref": "#/definitions/GuardNodeRef" }
+      },
+      "required": ["type", "node"],
+      "additionalProperties": false,
+      "returns": "U8",
+      "description": "Returns U8. Safely converts a number to U8 with overflow protection (values > 255 become 255)."
+    },
+    "ConvertSafeU16Node": {
+      "type": "object",
+      "properties": {
+        "type": { "const": "convert_safe_u16" },
+        "node": { "$ref": "#/definitions/GuardNodeRef" }
+      },
+      "required": ["type", "node"],
+      "additionalProperties": false,
+      "returns": "U16",
+      "description": "Returns U16. Safely converts a number to U16 with overflow protection."
+    },
+    "ConvertSafeU32Node": {
+      "type": "object",
+      "properties": {
+        "type": { "const": "convert_safe_u32" },
+        "node": { "$ref": "#/definitions/GuardNodeRef" }
+      },
+      "required": ["type", "node"],
+      "additionalProperties": false,
+      "returns": "U32",
+      "description": "Returns U32. Safely converts a number to U32 with overflow protection."
+    },
+    "ConvertSafeU64Node": {
+      "type": "object",
+      "properties": {
+        "type": { "const": "convert_safe_u64" },
+        "node": { "$ref": "#/definitions/GuardNodeRef" }
+      },
+      "required": ["type", "node"],
+      "additionalProperties": false,
+      "returns": "U64",
+      "description": "Returns U64. Safely converts a number to U64 with overflow protection."
+    },
+    "ConvertSafeU128Node": {
+      "type": "object",
+      "properties": {
+        "type": { "const": "convert_safe_u128" },
+        "node": { "$ref": "#/definitions/GuardNodeRef" }
+      },
+      "required": ["type", "node"],
+      "additionalProperties": false,
+      "returns": "U128",
+      "description": "Returns U128. Safely converts a number to U128 with overflow protection."
+    },
+    "ConvertSafeU256Node": {
+      "type": "object",
+      "properties": {
+        "type": { "const": "convert_safe_u256" },
+        "node": { "$ref": "#/definitions/GuardNodeRef" }
+      },
+      "required": ["type", "node"],
+      "additionalProperties": false,
+      "returns": "U256",
+      "description": "Returns U256. Safely converts a number to U256 with overflow protection."
+    },
+    "VecLengthNode": {
+      "type": "object",
+      "properties": {
+        "type": { "const": "vec_length" },
+        "node": { "$ref": "#/definitions/GuardNodeRef" }
+      },
+      "required": ["type", "node"],
+      "additionalProperties": false,
+      "returns": "U64",
+      "description": "Returns U64. Returns the length of a vector (array)."
+    },
+    "VecContainsBoolNode": {
+      "type": "object",
+      "properties": {
+        "type": { "const": "vec_contains_bool" },
+        "nodes": { "$ref": "#/definitions/GuardNodeArray" }
+      },
+      "required": ["type", "nodes"],
+      "additionalProperties": false,
+      "returns": "Bool",
+      "description": "Returns Bool. Checks if vector contains a boolean value. First node is the vector, others are values to check."
+    },
+    "VecContainsAddressNode": {
+      "type": "object",
+      "properties": {
+        "type": { "const": "vec_contains_address" },
+        "nodes": { "$ref": "#/definitions/GuardNodeArray" }
+      },
+      "required": ["type", "nodes"],
+      "additionalProperties": false,
+      "returns": "Bool",
+      "description": "Returns Bool. Checks if vector contains an address."
+    },
+    "VecContainsStringNode": {
+      "type": "object",
+      "properties": {
+        "type": { "const": "vec_contains_string" },
+        "nodes": { "$ref": "#/definitions/GuardNodeArray" }
+      },
+      "required": ["type", "nodes"],
+      "additionalProperties": false,
+      "returns": "Bool",
+      "description": "Returns Bool. Checks if vector contains a string."
+    },
+    "VecContainsStringNocaseNode": {
+      "type": "object",
+      "properties": {
+        "type": { "const": "vec_contains_string_nocase" },
+        "nodes": { "$ref": "#/definitions/GuardNodeArray" }
+      },
+      "required": ["type", "nodes"],
+      "additionalProperties": false,
+      "returns": "Bool",
+      "description": "Returns Bool. Case-insensitive vector string contains."
+    },
+    "VecContainsNumberNode": {
+      "type": "object",
+      "properties": {
+        "type": { "const": "vec_contains_number" },
+        "nodes": { "$ref": "#/definitions/GuardNodeArray" }
+      },
+      "required": ["type", "nodes"],
+      "additionalProperties": false,
+      "returns": "Bool",
+      "description": "Returns Bool. Checks if vector contains a number."
+    },
+    "QueryProgressHistoryFindNode": {
+      "type": "object",
+      "properties": {
+        "type": { "const": "query_progress_history_find" },
+        "object": {
+          "type": "object",
+          "properties": {
+            "identifier": { "$ref": "#/definitions/GuardIdentifier" }
+          },
+          "required": ["identifier"],
+          "additionalProperties": false
+        },
+        "where": {
+          "type": "object",
+          "properties": {
+            "node": { "type": "string", "description": "Filter by node name" },
+            "nextNode": { "type": "string", "description": "Filter by next node name" },
+            "timeMin": { "type": "string", "description": "Minimum timestamp (inclusive) as U64 string" },
+            "timeMax": { "type": "string", "description": "Maximum timestamp (inclusive) as U64 string" },
+            "indexMin": { "type": "string", "description": "Minimum history index (inclusive) as U64 string" },
+            "indexMax": { "type": "string", "description": "Maximum history index (inclusive) as U64 string" }
+          },
+          "additionalProperties": false
+        },
+        "find": { "type": "string", "enum": ["first", "last"], "description": "'first' finds earliest, 'last' finds most recent" }
+      },
+      "required": ["type", "object", "where", "find"],
+      "additionalProperties": false,
+      "returns": "U64",
+      "description": "Returns U64. Finds the index of the first or last history entry matching the filter conditions. Returns index if found, throws error if not found."
+    },
+    "QueryProgressHistorySessionFindNode": {
+      "type": "object",
+      "properties": {
+        "type": { "const": "query_progress_history_session_find" },
+        "object": {
+          "type": "object",
+          "properties": {
+            "identifier": { "$ref": "#/definitions/GuardIdentifier" }
+          },
+          "required": ["identifier"],
+          "additionalProperties": false
+        },
+        "historyIdx": { "$ref": "#/definitions/GuardNodeRef", "description": "History entry index (U64)" },
+        "where": {
+          "type": "object",
+          "properties": {
+            "nextNode": { "type": "string", "description": "Filter by next node name" }
+          },
+          "additionalProperties": false
+        },
+        "find": { "type": "string", "enum": ["first", "last"] }
+      },
+      "required": ["type", "object", "historyIdx", "where", "find"],
+      "additionalProperties": false,
+      "returns": "U64",
+      "description": "Returns U64. Finds the index of the first or last session within the specified history entry."
+    },
+    "QueryProgressHistorySessionForwardFindNode": {
+      "type": "object",
+      "properties": {
+        "type": { "const": "query_progress_history_session_forward_find" },
+        "object": {
+          "type": "object",
+          "properties": {
+            "identifier": { "$ref": "#/definitions/GuardIdentifier" }
+          },
+          "required": ["identifier"],
+          "additionalProperties": false
+        },
+        "historyIdx": { "$ref": "#/definitions/GuardNodeRef", "description": "History entry index (U64)" },
+        "sessionIdx": { "$ref": "#/definitions/GuardNodeRef", "description": "Session index within history (U64)" },
+        "where": {
+          "type": "object",
+          "properties": {
+            "who": { "type": "string", "description": "Filter by operator address" },
+            "operation": { "type": "string", "description": "Filter by operation name" },
+            "accomplished": { "type": "boolean", "description": "Filter by accomplished status" },
+            "timeMin": { "type": "string", "description": "Minimum timestamp as U64 string" },
+            "timeMax": { "type": "string", "description": "Maximum timestamp as U64 string" }
+          },
+          "additionalProperties": false
+        },
+        "find": { "type": "string", "enum": ["first", "last"] }
+      },
+      "required": ["type", "object", "historyIdx", "sessionIdx", "where", "find"],
+      "additionalProperties": false,
+      "returns": "U64",
+      "description": "Returns U64. Finds the index of the first or last forward operation within the specified history session."
+    },
+    "QueryProgressHistorySessionCountNode": {
+      "type": "object",
+      "properties": {
+        "type": { "const": "query_progress_history_session_count" },
+        "object": {
+          "type": "object",
+          "properties": {
+            "identifier": { "$ref": "#/definitions/GuardIdentifier" }
+          },
+          "required": ["identifier"],
+          "additionalProperties": false
+        },
+        "historyIdx": { "$ref": "#/definitions/GuardNodeRef", "description": "History entry index (U64)" }
+      },
+      "required": ["type", "object", "historyIdx"],
+      "additionalProperties": false,
+      "returns": "U64",
+      "description": "Returns U64. Counts the number of sessions within the specified history entry."
+    },
+    "QueryProgressHistorySessionForwardCountNode": {
+      "type": "object",
+      "properties": {
+        "type": { "const": "query_progress_history_session_forward_count" },
+        "object": {
+          "type": "object",
+          "properties": {
+            "identifier": { "$ref": "#/definitions/GuardIdentifier" }
+          },
+          "required": ["identifier"],
+          "additionalProperties": false
+        },
+        "historyIdx": { "$ref": "#/definitions/GuardNodeRef", "description": "History entry index (U64)" },
+        "sessionIdx": { "$ref": "#/definitions/GuardNodeRef", "description": "Session index within history (U64)" }
+      },
+      "required": ["type", "object", "historyIdx", "sessionIdx"],
+      "additionalProperties": false,
+      "returns": "U64",
+      "description": "Returns U64. Counts the number of forward operations within the specified history session."
+    },
+    "QueryProgressHistorySessionForwardRetainedSubmissionCountNode": {
+      "type": "object",
+      "properties": {
+        "type": { "const": "query_progress_history_session_forward_retained_submission_count" },
+        "object": {
+          "type": "object",
+          "properties": {
+            "identifier": { "$ref": "#/definitions/GuardIdentifier" }
+          },
+          "required": ["identifier"],
+          "additionalProperties": false
+        },
+        "historyIdx": { "$ref": "#/definitions/GuardNodeRef", "description": "History entry index (U64)" },
+        "sessionIdx": { "$ref": "#/definitions/GuardNodeRef", "description": "Session index within history (U64)" },
+        "forwardIdx": { "$ref": "#/definitions/GuardNodeRef", "description": "Forward operation index (U64)" }
+      },
+      "required": ["type", "object", "historyIdx", "sessionIdx", "forwardIdx"],
+      "additionalProperties": false,
+      "returns": "U64",
+      "description": "Returns U64. Counts the number of retained submissions within the specified forward operation."
+    },
+    "QueryRewardRecordFindNode": {
+      "type": "object",
+      "properties": {
+        "type": { "const": "query_reward_record_find" },
+        "object": {
+          "type": "object",
+          "properties": {
+            "identifier": { "$ref": "#/definitions/GuardIdentifier" }
+          },
+          "required": ["identifier"],
+          "additionalProperties": false,
+          "description": "Reference to the Reward object in the Guard table (must be Address type)"
+        },
+        "find": { "type": "string", "enum": ["first", "last"], "description": "'first' finds earliest, 'last' finds most recent" },
+        "recipient": {
+          "type": "object",
+          "properties": {
+            "identifier": { "$ref": "#/definitions/GuardIdentifier" }
+          },
+          "required": ["identifier"],
+          "additionalProperties": false,
+          "description": "Optional: Identifier reference to recipient address in Guard table (must be Address type). If not specified, uses the transaction signer address."
+        },
+        "where": {
+          "type": "object",
+          "properties": {
+            "guard": { "type": "string", "description": "Optional: Guard object address constant to match" },
+            "timeMin": { "type": "string", "description": "Optional: minimum timestamp (inclusive) as U64 string" },
+            "timeMax": { "type": "string", "description": "Optional: maximum timestamp (inclusive) as U64 string" },
+            "amountMin": { "type": "string", "description": "Optional: minimum reward amount (inclusive) as U64 string" },
+            "amountMax": { "type": "string", "description": "Optional: maximum reward amount (inclusive) as U64 string" },
+            "storeFromId": {
+              "type": "object",
+              "properties": {
+                "identifier": { "$ref": "#/definitions/GuardIdentifier" }
+              },
+              "required": ["identifier"],
+              "additionalProperties": false,
+              "description": "Optional: identifier reference to store_from_id address. If not specified, field is ignored during matching."
+            }
+          },
+          "additionalProperties": false,
+          "description": "Filter conditions for the reward record query"
+        }
+      },
+      "required": ["type", "object", "find", "where"],
+      "additionalProperties": false,
+      "returns": "U64",
+      "description": "Returns U64. Finds the index of the first or last reward record matching the specified recipient and filter conditions. Returns record index if found, throws error if not found. Use this to verify a reward has NOT been claimed (wrap in logic_not). If recipient is not specified, uses the transaction signer address."
+    },
+    "QueryRewardRecordCountNode": {
+      "type": "object",
+      "properties": {
+        "type": { "const": "query_reward_record_count" },
+        "object": {
+          "type": "object",
+          "properties": {
+            "identifier": { "$ref": "#/definitions/GuardIdentifier" }
+          },
+          "required": ["identifier"],
+          "additionalProperties": false,
+          "description": "Reference to the Reward object in the Guard table (must be Address type)"
+        },
+        "recipient": {
+          "type": "object",
+          "properties": {
+            "identifier": { "$ref": "#/definitions/GuardIdentifier" }
+          },
+          "required": ["identifier"],
+          "additionalProperties": false,
+          "description": "Optional: Identifier reference to recipient address in Guard table (must be Address type). If not specified, uses the transaction signer address."
+        },
+        "where": {
+          "type": "object",
+          "properties": {
+            "guard": { "type": "string" },
+            "timeMin": { "type": "string" },
+            "timeMax": { "type": "string" },
+            "amountMin": { "type": "string" },
+            "amountMax": { "type": "string" },
+            "storeFromId": {
+              "type": "object",
+              "properties": {
+                "identifier": { "$ref": "#/definitions/GuardIdentifier" }
+              },
+              "required": ["identifier"],
+              "additionalProperties": false
+            }
+          },
+          "additionalProperties": false
+        }
+      },
+      "required": ["type", "object", "where"],
+      "additionalProperties": false,
+      "returns": "U64",
+      "description": "Returns U64. Counts the number of reward records matching the specified recipient and filter conditions. If recipient is not specified, uses the transaction signer address."
+    },
+    "QueryRewardRecordExistsNode": {
+      "type": "object",
+      "properties": {
+        "type": { "const": "query_reward_record_exists" },
+        "object": {
+          "type": "object",
+          "properties": {
+            "identifier": { "$ref": "#/definitions/GuardIdentifier" }
+          },
+          "required": ["identifier"],
+          "additionalProperties": false,
+          "description": "Reference to the Reward object in the Guard table (must be Address type)"
+        },
+        "recipient": {
+          "type": "object",
+          "properties": {
+            "identifier": { "$ref": "#/definitions/GuardIdentifier" }
+          },
+          "required": ["identifier"],
+          "additionalProperties": false,
+          "description": "Optional: Identifier reference to recipient address in Guard table (must be Address type). If not specified, uses the transaction signer address."
+        },
+        "where": {
+          "type": "object",
+          "properties": {
+            "guard": { "type": "string" },
+            "timeMin": { "type": "string" },
+            "timeMax": { "type": "string" },
+            "amountMin": { "type": "string" },
+            "amountMax": { "type": "string" },
+            "storeFromId": {
+              "type": "object",
+              "properties": {
+                "identifier": { "$ref": "#/definitions/GuardIdentifier" }
+              },
+              "required": ["identifier"],
+              "additionalProperties": false
+            }
+          },
+          "additionalProperties": false
+        }
+      },
+      "required": ["type", "object", "where"],
+      "additionalProperties": false,
+      "returns": "Bool",
+      "description": "Returns Bool. Returns true if at least one reward record exists matching the specified recipient and filter conditions, otherwise false. Use this to check if a reward has been claimed. If recipient is not specified, uses the transaction signer address."
+    }
+  }
+}