@1claw/openapi-spec 0.48.2 → 0.49.0

package/openapi.json

@@ -25938,9 +25938,18 @@
       },
       "TxConditions": {
         "type": "object",
-        "description": "Signing-time AND conditions on access policies (all tiers).\nIgnored on secret reads. Evaluated when a TransactionContext is present.\n",
+        "description": "Signing-time conditions on access policies (all tiers).\nIgnored on secret reads. Evaluated when a TransactionContext is present.\nFields are combined according to `match_mode` (default AND).\n",
         "additionalProperties": true,
         "properties": {
+          "match_mode": {
+            "type": "string",
+            "enum": [
+              "all",
+              "any"
+            ],
+            "default": "all",
+            "description": "How individual condition fields are combined.\n\"all\" (default): every present field must match (AND).\n\"any\": at least one present field must match (OR).\n"
+          },
           "function_name_in": {
             "type": "array",
             "items": {
@@ -25986,6 +25995,11 @@
             "items": {
               "type": "string"
             }
+          },
+          "deep_inspect": {
+            "type": "boolean",
+            "default": false,
+            "description": "When true, conditions are also evaluated against inner calls\nextracted from wrapper transactions (multicall, Safe execTransaction,\nERC-4337 handleOps). A match on any inner call counts as an overall match.\n"
           }
         }
       },
@@ -26013,6 +26027,101 @@
           "self_approval_allowed": {
             "type": "boolean",
             "default": false
+          },
+          "skip_when": {
+            "type": "array",
+            "description": "When ALL conditions in ANY entry match, consensus is bypassed.\nUseful for exempting known-safe recipients or low-value transfers.\n",
+            "items": {
+              "$ref": "#/components/schemas/FlatConditionSet"
+            }
+          },
+          "require_when": {
+            "type": "array",
+            "description": "Consensus is ONLY required when at least one entry matches.\nIf set and none match, consensus is skipped entirely.\n",
+            "items": {
+              "$ref": "#/components/schemas/FlatConditionSet"
+            }
+          },
+          "deep_inspect": {
+            "type": "boolean",
+            "default": false,
+            "description": "When true, also evaluate conditions against inner calls extracted\nfrom wrapper transactions (multicall, Safe execTransaction,\nERC-4337 handleOps).\n"
+          }
+        }
+      },
+      "FlatConditionSet": {
+        "type": "object",
+        "description": "Flat condition set used by consensus composability. Each present field\nis AND-combined within the set. At least one field must be specified\n(unless `always` is true).\n",
+        "additionalProperties": false,
+        "properties": {
+          "value_above": {
+            "type": "string",
+            "description": "Native value threshold in gwei (numeric string)"
+          },
+          "chain_in": {
+            "type": "array",
+            "items": {
+              "type": "string"
+            }
+          },
+          "to_address_in": {
+            "type": "array",
+            "items": {
+              "type": "string"
+            }
+          },
+          "function_selector_in": {
+            "type": "array",
+            "items": {
+              "type": "string"
+            }
+          },
+          "erc20_amount_above": {
+            "type": "string",
+            "description": "ERC-20 raw token amount threshold (numeric string)"
+          },
+          "intent_type_in": {
+            "type": "array",
+            "items": {
+              "type": "string"
+            }
+          },
+          "always": {
+            "type": "boolean",
+            "description": "When true, this entry always matches regardless of other fields"
+          }
+        }
+      },
+      "TimeWindow": {
+        "type": "object",
+        "description": "Time window condition for policy evaluation. Used inside the policy\n`conditions` JSON to restrict when the policy is active.\n",
+        "properties": {
+          "start_hour": {
+            "type": "integer",
+            "minimum": 0,
+            "maximum": 23
+          },
+          "end_hour": {
+            "type": "integer",
+            "minimum": 0,
+            "maximum": 24
+          },
+          "days_of_week": {
+            "type": "array",
+            "description": "Days when policy is active (0=Sunday, 6=Saturday)",
+            "items": {
+              "type": "integer",
+              "minimum": 0,
+              "maximum": 6
+            }
+          },
+          "timezone": {
+            "type": "string",
+            "description": "IANA timezone identifier (e.g. \"America/New_York\"). Defaults to UTC."
+          },
+          "cron_expr": {
+            "type": "string",
+            "description": "Cron expression (6-field with seconds) for fine-grained scheduling."
           }
         }
       },

package/openapi.yaml

@@ -17084,10 +17084,19 @@ components:
         TxConditions:
             type: object
             description: |
-                Signing-time AND conditions on access policies (all tiers).
+                Signing-time conditions on access policies (all tiers).
                 Ignored on secret reads. Evaluated when a TransactionContext is present.
+                Fields are combined according to `match_mode` (default AND).
             additionalProperties: true
             properties:
+                match_mode:
+                    type: string
+                    enum: [all, any]
+                    default: all
+                    description: |
+                        How individual condition fields are combined.
+                        "all" (default): every present field must match (AND).
+                        "any": at least one present field must match (OR).
                 function_name_in:
                     type: array
                     items:
@@ -17119,6 +17128,13 @@ components:
                     type: array
                     items:
                         type: string
+                deep_inspect:
+                    type: boolean
+                    default: false
+                    description: |
+                        When true, conditions are also evaluated against inner calls
+                        extracted from wrapper transactions (multicall, Safe execTransaction,
+                        ERC-4337 handleOps). A match on any inner call counts as an overall match.
 
         ConsensusTrigger:
             type: object
@@ -17137,6 +17153,89 @@ components:
                 self_approval_allowed:
                     type: boolean
                     default: false
+                skip_when:
+                    type: array
+                    description: |
+                        When ALL conditions in ANY entry match, consensus is bypassed.
+                        Useful for exempting known-safe recipients or low-value transfers.
+                    items:
+                        $ref: "#/components/schemas/FlatConditionSet"
+                require_when:
+                    type: array
+                    description: |
+                        Consensus is ONLY required when at least one entry matches.
+                        If set and none match, consensus is skipped entirely.
+                    items:
+                        $ref: "#/components/schemas/FlatConditionSet"
+                deep_inspect:
+                    type: boolean
+                    default: false
+                    description: |
+                        When true, also evaluate conditions against inner calls extracted
+                        from wrapper transactions (multicall, Safe execTransaction,
+                        ERC-4337 handleOps).
+
+        FlatConditionSet:
+            type: object
+            description: |
+                Flat condition set used by consensus composability. Each present field
+                is AND-combined within the set. At least one field must be specified
+                (unless `always` is true).
+            additionalProperties: false
+            properties:
+                value_above:
+                    type: string
+                    description: Native value threshold in gwei (numeric string)
+                chain_in:
+                    type: array
+                    items:
+                        type: string
+                to_address_in:
+                    type: array
+                    items:
+                        type: string
+                function_selector_in:
+                    type: array
+                    items:
+                        type: string
+                erc20_amount_above:
+                    type: string
+                    description: ERC-20 raw token amount threshold (numeric string)
+                intent_type_in:
+                    type: array
+                    items:
+                        type: string
+                always:
+                    type: boolean
+                    description: When true, this entry always matches regardless of other fields
+
+        TimeWindow:
+            type: object
+            description: |
+                Time window condition for policy evaluation. Used inside the policy
+                `conditions` JSON to restrict when the policy is active.
+            properties:
+                start_hour:
+                    type: integer
+                    minimum: 0
+                    maximum: 23
+                end_hour:
+                    type: integer
+                    minimum: 0
+                    maximum: 24
+                days_of_week:
+                    type: array
+                    description: Days when policy is active (0=Sunday, 6=Saturday)
+                    items:
+                        type: integer
+                        minimum: 0
+                        maximum: 6
+                timezone:
+                    type: string
+                    description: IANA timezone identifier (e.g. "America/New_York"). Defaults to UTC.
+                cron_expr:
+                    type: string
+                    description: Cron expression (6-field with seconds) for fine-grained scheduling.
 
         ConsensusCondition:
             oneOf:

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@1claw/openapi-spec",
-    "version": "0.48.2",
+    "version": "0.49.0",
   "description": "OpenAPI 3.1.0 specification for the 1Claw Vault API — generate clients in any language",
   "license": "MIT",
   "repository": {