@epilot/sdk 2.19.11 → 2.19.12

package/docs/entity-mapping.md

@@ -63,6 +63,12 @@ const { data } = await entityMappingClient.storeConfig(...)
 - [`MapCondition`](#mapcondition)
 - [`ConditionNode`](#conditionnode)
 - [`RelationAttribute`](#relationattribute)
+- [`GraphContextEntry`](#graphcontextentry)
+- [`GraphSeed`](#graphseed)
+- [`GraphDefinition`](#graphdefinition)
+- [`GraphNode`](#graphnode)
+- [`GraphNodeFilter`](#graphnodefilter)
+- [`GraphEdge`](#graphedge)
 - [`MappingAttributeV2`](#mappingattributev2)
 - [`AttributeOrigin`](#attributeorigin)
 - [`OperationNode`](#operationnode)
@@ -106,66 +112,15 @@ const { data } = await client.storeConfig(
         allow_failure: true,
         target_schema: 'string',
         target_unique: ['string'],
-        loop_config: {
-          source_path: 'string',
-          length: 'the length of the array'
-        },
+        use_uniqueness_criteria: false,
+        loop_config: { /* ... */ },
         conditionMode: 'oneOf',
-        conditions: [
-          {
-            _exists: {
-              source: 'string',
-              value: 'string'
-            },
-            _equals: {
-              source: 'string',
-              value: 'string'
-            },
-            _not_exists: {
-              source: 'string',
-              value: 'string'
-            },
-            _any_of: {
-              source: 'string',
-              value: 'string'
-            }
-          }
-        ],
-        mapping_attributes: [
-          {
-            target: '_tags',
-            operation: {
-              _append: ['new', 'tags'],
-              _uniq: true
-            }
-          },
-          {
-            mode: 'copy_if_exists',
-            target: 'string',
-            value: {}
-          }
-        ],
-        relation_attributes: [
-          {
-            target: 'string',
-            target_tags: ['string'],
-            target_tags_include_source: false,
-            override_with_source_filter: false,
-            source_filter: {
-              limit: 0,
-              schema: 'string',
-              attribute: 'string',
-              relation_tag: 'string',
-              tag: 'string',
-              self: false
-            },
-            related_to: {},
-            mode: 'append',
-            origin: 'system_recommendation'
-          }
-        ],
+        conditions: [ /* ... */ ],
+        mapping_attributes: [ /* ... */ ],
+        relation_attributes: [ /* ... */ ],
         linkback_relation_attribute: 'mapped_entities',
-        linkback_relation_tags: ['string']
+        linkback_relation_tags: ['string'],
+        graph_context: [ /* ... */ ]
       }
     ],
     created_at: '1970-01-01T00:00:00.000Z',
@@ -205,66 +160,15 @@ const { data } = await client.storeConfig(
       "allow_failure": true,
       "target_schema": "string",
       "target_unique": ["string"],
-      "loop_config": {
-        "source_path": "string",
-        "length": "the length of the array"
-      },
+      "use_uniqueness_criteria": false,
+      "loop_config": {},
       "conditionMode": "oneOf",
-      "conditions": [
-        {
-          "_exists": {
-            "source": "string",
-            "value": "string"
-          },
-          "_equals": {
-            "source": "string",
-            "value": "string"
-          },
-          "_not_exists": {
-            "source": "string",
-            "value": "string"
-          },
-          "_any_of": {
-            "source": "string",
-            "value": "string"
-          }
-        }
-      ],
-      "mapping_attributes": [
-        {
-          "target": "_tags",
-          "operation": {
-            "_append": ["new", "tags"],
-            "_uniq": true
-          }
-        },
-        {
-          "mode": "copy_if_exists",
-          "target": "string",
-          "value": {}
-        }
-      ],
-      "relation_attributes": [
-        {
-          "target": "string",
-          "target_tags": ["string"],
-          "target_tags_include_source": false,
-          "override_with_source_filter": false,
-          "source_filter": {
-            "limit": 0,
-            "schema": "string",
-            "attribute": "string",
-            "relation_tag": "string",
-            "tag": "string",
-            "self": false
-          },
-          "related_to": {},
-          "mode": "append",
-          "origin": "system_recommendation"
-        }
-      ],
+      "conditions": [],
+      "mapping_attributes": [],
+      "relation_attributes": [],
       "linkback_relation_attribute": "mapped_entities",
-      "linkback_relation_tags": ["string"]
+      "linkback_relation_tags": ["string"],
+      "graph_context": []
     }
   ],
   "created_at": "1970-01-01T00:00:00.000Z",
@@ -319,66 +223,15 @@ const { data } = await client.getConfig({
       "allow_failure": true,
       "target_schema": "string",
       "target_unique": ["string"],
-      "loop_config": {
-        "source_path": "string",
-        "length": "the length of the array"
-      },
+      "use_uniqueness_criteria": false,
+      "loop_config": {},
       "conditionMode": "oneOf",
-      "conditions": [
-        {
-          "_exists": {
-            "source": "string",
-            "value": "string"
-          },
-          "_equals": {
-            "source": "string",
-            "value": "string"
-          },
-          "_not_exists": {
-            "source": "string",
-            "value": "string"
-          },
-          "_any_of": {
-            "source": "string",
-            "value": "string"
-          }
-        }
-      ],
-      "mapping_attributes": [
-        {
-          "target": "_tags",
-          "operation": {
-            "_append": ["new", "tags"],
-            "_uniq": true
-          }
-        },
-        {
-          "mode": "copy_if_exists",
-          "target": "string",
-          "value": {}
-        }
-      ],
-      "relation_attributes": [
-        {
-          "target": "string",
-          "target_tags": ["string"],
-          "target_tags_include_source": false,
-          "override_with_source_filter": false,
-          "source_filter": {
-            "limit": 0,
-            "schema": "string",
-            "attribute": "string",
-            "relation_tag": "string",
-            "tag": "string",
-            "self": false
-          },
-          "related_to": {},
-          "mode": "append",
-          "origin": "system_recommendation"
-        }
-      ],
+      "conditions": [],
+      "mapping_attributes": [],
+      "relation_attributes": [],
       "linkback_relation_attribute": "mapped_entities",
-      "linkback_relation_tags": ["string"]
+      "linkback_relation_tags": ["string"],
+      "graph_context": []
     }
   ],
   "created_at": "1970-01-01T00:00:00.000Z",
@@ -433,66 +286,15 @@ const { data } = await client.deleteConfig({
       "allow_failure": true,
       "target_schema": "string",
       "target_unique": ["string"],
-      "loop_config": {
-        "source_path": "string",
-        "length": "the length of the array"
-      },
+      "use_uniqueness_criteria": false,
+      "loop_config": {},
       "conditionMode": "oneOf",
-      "conditions": [
-        {
-          "_exists": {
-            "source": "string",
-            "value": "string"
-          },
-          "_equals": {
-            "source": "string",
-            "value": "string"
-          },
-          "_not_exists": {
-            "source": "string",
-            "value": "string"
-          },
-          "_any_of": {
-            "source": "string",
-            "value": "string"
-          }
-        }
-      ],
-      "mapping_attributes": [
-        {
-          "target": "_tags",
-          "operation": {
-            "_append": ["new", "tags"],
-            "_uniq": true
-          }
-        },
-        {
-          "mode": "copy_if_exists",
-          "target": "string",
-          "value": {}
-        }
-      ],
-      "relation_attributes": [
-        {
-          "target": "string",
-          "target_tags": ["string"],
-          "target_tags_include_source": false,
-          "override_with_source_filter": false,
-          "source_filter": {
-            "limit": 0,
-            "schema": "string",
-            "attribute": "string",
-            "relation_tag": "string",
-            "tag": "string",
-            "self": false
-          },
-          "related_to": {},
-          "mode": "append",
-          "origin": "system_recommendation"
-        }
-      ],
+      "conditions": [],
+      "mapping_attributes": [],
+      "relation_attributes": [],
       "linkback_relation_attribute": "mapped_entities",
-      "linkback_relation_tags": ["string"]
+      "linkback_relation_tags": ["string"],
+      "graph_context": []
     }
   ],
   "created_at": "1970-01-01T00:00:00.000Z",
@@ -536,93 +338,12 @@ const { data } = await client.getAllVersions({
   "configs": [
     {
       "id": "string",
-      "source": {
-        "type": "journey",
-        "config": {
-          "journey_id": "string"
-        }
-      },
-      "targets": [
-        {
-          "id": "string",
-          "name": "string",
-          "allow_failure": true,
-          "target_schema": "string",
-          "target_unique": ["string"],
-          "loop_config": {
-            "source_path": "string",
-            "length": "the length of the array"
-          },
-          "conditionMode": "oneOf",
-          "conditions": [
-            {
-              "_exists": {
-                "source": "string",
-                "value": "string"
-              },
-              "_equals": {
-                "source": "string",
-                "value": "string"
-              },
-              "_not_exists": {
-                "source": "string",
-                "value": "string"
-              },
-              "_any_of": {
-                "source": "string",
-                "value": "string"
-              }
-            }
-          ],
-          "mapping_attributes": [
-            {
-              "target": "_tags",
-              "operation": {
-                "_append": ["new", "tags"],
-                "_uniq": true
-              }
-            },
-            {
-              "mode": "copy_if_exists",
-              "target": "string",
-              "value": {}
-            }
-          ],
-          "relation_attributes": [
-            {
-              "target": "string",
-              "target_tags": ["string"],
-              "target_tags_include_source": false,
-              "override_with_source_filter": false,
-              "source_filter": {
-                "limit": 0,
-                "schema": "string",
-                "attribute": "string",
-                "relation_tag": "string",
-                "tag": "string",
-                "self": false
-              },
-              "related_to": {},
-              "mode": "append",
-              "origin": "system_recommendation"
-            }
-          ],
-          "linkback_relation_attribute": "mapped_entities",
-          "linkback_relation_tags": ["string"]
-        }
-      ],
+      "source": {},
+      "targets": [],
       "created_at": "1970-01-01T00:00:00.000Z",
       "updated_at": "1970-01-01T00:00:00.000Z",
-      "created_by": {
-        "type": "user",
-        "org_id": "string",
-        "user_id": "string"
-      },
-      "last_updated_by": {
-        "type": "user",
-        "org_id": "string",
-        "user_id": "string"
-      },
+      "created_by": {},
+      "last_updated_by": {},
       "org_id": "66",
       "version": 2
     }
@@ -660,66 +381,15 @@ const { data } = await client.storeNewVersion(
         allow_failure: true,
         target_schema: 'string',
         target_unique: ['string'],
-        loop_config: {
-          source_path: 'string',
-          length: 'the length of the array'
-        },
+        use_uniqueness_criteria: false,
+        loop_config: { /* ... */ },
         conditionMode: 'oneOf',
-        conditions: [
-          {
-            _exists: {
-              source: 'string',
-              value: 'string'
-            },
-            _equals: {
-              source: 'string',
-              value: 'string'
-            },
-            _not_exists: {
-              source: 'string',
-              value: 'string'
-            },
-            _any_of: {
-              source: 'string',
-              value: 'string'
-            }
-          }
-        ],
-        mapping_attributes: [
-          {
-            target: '_tags',
-            operation: {
-              _append: ['new', 'tags'],
-              _uniq: true
-            }
-          },
-          {
-            mode: 'copy_if_exists',
-            target: 'string',
-            value: {}
-          }
-        ],
-        relation_attributes: [
-          {
-            target: 'string',
-            target_tags: ['string'],
-            target_tags_include_source: false,
-            override_with_source_filter: false,
-            source_filter: {
-              limit: 0,
-              schema: 'string',
-              attribute: 'string',
-              relation_tag: 'string',
-              tag: 'string',
-              self: false
-            },
-            related_to: {},
-            mode: 'append',
-            origin: 'system_recommendation'
-          }
-        ],
+        conditions: [ /* ... */ ],
+        mapping_attributes: [ /* ... */ ],
+        relation_attributes: [ /* ... */ ],
         linkback_relation_attribute: 'mapped_entities',
-        linkback_relation_tags: ['string']
+        linkback_relation_tags: ['string'],
+        graph_context: [ /* ... */ ]
       }
     ],
     created_at: '1970-01-01T00:00:00.000Z',
@@ -759,66 +429,15 @@ const { data } = await client.storeNewVersion(
       "allow_failure": true,
       "target_schema": "string",
       "target_unique": ["string"],
-      "loop_config": {
-        "source_path": "string",
-        "length": "the length of the array"
-      },
+      "use_uniqueness_criteria": false,
+      "loop_config": {},
       "conditionMode": "oneOf",
-      "conditions": [
-        {
-          "_exists": {
-            "source": "string",
-            "value": "string"
-          },
-          "_equals": {
-            "source": "string",
-            "value": "string"
-          },
-          "_not_exists": {
-            "source": "string",
-            "value": "string"
-          },
-          "_any_of": {
-            "source": "string",
-            "value": "string"
-          }
-        }
-      ],
-      "mapping_attributes": [
-        {
-          "target": "_tags",
-          "operation": {
-            "_append": ["new", "tags"],
-            "_uniq": true
-          }
-        },
-        {
-          "mode": "copy_if_exists",
-          "target": "string",
-          "value": {}
-        }
-      ],
-      "relation_attributes": [
-        {
-          "target": "string",
-          "target_tags": ["string"],
-          "target_tags_include_source": false,
-          "override_with_source_filter": false,
-          "source_filter": {
-            "limit": 0,
-            "schema": "string",
-            "attribute": "string",
-            "relation_tag": "string",
-            "tag": "string",
-            "self": false
-          },
-          "related_to": {},
-          "mode": "append",
-          "origin": "system_recommendation"
-        }
-      ],
+      "conditions": [],
+      "mapping_attributes": [],
+      "relation_attributes": [],
       "linkback_relation_attribute": "mapped_entities",
-      "linkback_relation_tags": ["string"]
+      "linkback_relation_tags": ["string"],
+      "graph_context": []
     }
   ],
   "created_at": "1970-01-01T00:00:00.000Z",
@@ -874,66 +493,15 @@ const { data } = await client.getConfigVersion({
       "allow_failure": true,
       "target_schema": "string",
       "target_unique": ["string"],
-      "loop_config": {
-        "source_path": "string",
-        "length": "the length of the array"
-      },
+      "use_uniqueness_criteria": false,
+      "loop_config": {},
       "conditionMode": "oneOf",
-      "conditions": [
-        {
-          "_exists": {
-            "source": "string",
-            "value": "string"
-          },
-          "_equals": {
-            "source": "string",
-            "value": "string"
-          },
-          "_not_exists": {
-            "source": "string",
-            "value": "string"
-          },
-          "_any_of": {
-            "source": "string",
-            "value": "string"
-          }
-        }
-      ],
-      "mapping_attributes": [
-        {
-          "target": "_tags",
-          "operation": {
-            "_append": ["new", "tags"],
-            "_uniq": true
-          }
-        },
-        {
-          "mode": "copy_if_exists",
-          "target": "string",
-          "value": {}
-        }
-      ],
-      "relation_attributes": [
-        {
-          "target": "string",
-          "target_tags": ["string"],
-          "target_tags_include_source": false,
-          "override_with_source_filter": false,
-          "source_filter": {
-            "limit": 0,
-            "schema": "string",
-            "attribute": "string",
-            "relation_tag": "string",
-            "tag": "string",
-            "self": false
-          },
-          "related_to": {},
-          "mode": "append",
-          "origin": "system_recommendation"
-        }
-      ],
+      "conditions": [],
+      "mapping_attributes": [],
+      "relation_attributes": [],
       "linkback_relation_attribute": "mapped_entities",
-      "linkback_relation_tags": ["string"]
+      "linkback_relation_tags": ["string"],
+      "graph_context": []
     }
   ],
   "created_at": "1970-01-01T00:00:00.000Z",
@@ -973,6 +541,10 @@ const { data } = await client.executeMapping(
       entity_id: 'string',
       entity_schema: 'submission'
     },
+    loop_ref: {
+      entity_id: 'string',
+      entity_schema: 'submission'
+    },
     targets: [
       {
         id: 'string',
@@ -980,66 +552,15 @@ const { data } = await client.executeMapping(
         allow_failure: true,
         target_schema: 'string',
         target_unique: ['string'],
-        loop_config: {
-          source_path: 'string',
-          length: 'the length of the array'
-        },
+        use_uniqueness_criteria: false,
+        loop_config: { /* ... */ },
         conditionMode: 'oneOf',
-        conditions: [
-          {
-            _exists: {
-              source: 'string',
-              value: 'string'
-            },
-            _equals: {
-              source: 'string',
-              value: 'string'
-            },
-            _not_exists: {
-              source: 'string',
-              value: 'string'
-            },
-            _any_of: {
-              source: 'string',
-              value: 'string'
-            }
-          }
-        ],
-        mapping_attributes: [
-          {
-            target: '_tags',
-            operation: {
-              _append: ['new', 'tags'],
-              _uniq: true
-            }
-          },
-          {
-            mode: 'copy_if_exists',
-            target: 'string',
-            value: {}
-          }
-        ],
-        relation_attributes: [
-          {
-            target: 'string',
-            target_tags: ['string'],
-            target_tags_include_source: false,
-            override_with_source_filter: false,
-            source_filter: {
-              limit: 0,
-              schema: 'string',
-              attribute: 'string',
-              relation_tag: 'string',
-              tag: 'string',
-              self: false
-            },
-            related_to: {},
-            mode: 'append',
-            origin: 'system_recommendation'
-          }
-        ],
+        conditions: [ /* ... */ ],
+        mapping_attributes: [ /* ... */ ],
+        relation_attributes: [ /* ... */ ],
         linkback_relation_attribute: 'mapped_entities',
-        linkback_relation_tags: ['string']
+        linkback_relation_tags: ['string'],
+        graph_context: [ /* ... */ ]
       }
     ]
   },
@@ -1065,77 +586,8 @@ const { data } = await client.executeMapping(
   ],
   "failures": [
     {
-      "target": {
-        "id": "string",
-        "name": "string",
-        "allow_failure": true,
-        "target_schema": "string",
-        "target_unique": ["string"],
-        "loop_config": {
-          "source_path": "string",
-          "length": "the length of the array"
-        },
-        "conditionMode": "oneOf",
-        "conditions": [
-          {
-            "_exists": {
-              "source": "string",
-              "value": "string"
-            },
-            "_equals": {
-              "source": "string",
-              "value": "string"
-            },
-            "_not_exists": {
-              "source": "string",
-              "value": "string"
-            },
-            "_any_of": {
-              "source": "string",
-              "value": "string"
-            }
-          }
-        ],
-        "mapping_attributes": [
-          {
-            "target": "_tags",
-            "operation": {
-              "_append": ["new", "tags"],
-              "_uniq": true
-            }
-          },
-          {
-            "mode": "copy_if_exists",
-            "target": "string",
-            "value": {}
-          }
-        ],
-        "relation_attributes": [
-          {
-            "target": "string",
-            "target_tags": ["string"],
-            "target_tags_include_source": false,
-            "override_with_source_filter": false,
-            "source_filter": {
-              "limit": 0,
-              "schema": "string",
-              "attribute": "string",
-              "relation_tag": "string",
-              "tag": "string",
-              "self": false
-            },
-            "related_to": {},
-            "mode": "append",
-            "origin": "system_recommendation"
-          }
-        ],
-        "linkback_relation_attribute": "mapped_entities",
-        "linkback_relation_tags": ["string"]
-      },
-      "error": {
-        "isSilent": true,
-        "message": "string"
-      }
+      "target": {},
+      "error": {}
     }
   ],
   "warnings": [
@@ -1191,66 +643,15 @@ const { data } = await client.searchConfigs(
       "allow_failure": true,
       "target_schema": "string",
       "target_unique": ["string"],
-      "loop_config": {
-        "source_path": "string",
-        "length": "the length of the array"
-      },
+      "use_uniqueness_criteria": false,
+      "loop_config": {},
       "conditionMode": "oneOf",
-      "conditions": [
-        {
-          "_exists": {
-            "source": "string",
-            "value": "string"
-          },
-          "_equals": {
-            "source": "string",
-            "value": "string"
-          },
-          "_not_exists": {
-            "source": "string",
-            "value": "string"
-          },
-          "_any_of": {
-            "source": "string",
-            "value": "string"
-          }
-        }
-      ],
-      "mapping_attributes": [
-        {
-          "target": "_tags",
-          "operation": {
-            "_append": ["new", "tags"],
-            "_uniq": true
-          }
-        },
-        {
-          "mode": "copy_if_exists",
-          "target": "string",
-          "value": {}
-        }
-      ],
-      "relation_attributes": [
-        {
-          "target": "string",
-          "target_tags": ["string"],
-          "target_tags_include_source": false,
-          "override_with_source_filter": false,
-          "source_filter": {
-            "limit": 0,
-            "schema": "string",
-            "attribute": "string",
-            "relation_tag": "string",
-            "tag": "string",
-            "self": false
-          },
-          "related_to": {},
-          "mode": "append",
-          "origin": "system_recommendation"
-        }
-      ],
+      "conditions": [],
+      "mapping_attributes": [],
+      "relation_attributes": [],
       "linkback_relation_attribute": "mapped_entities",
-      "linkback_relation_tags": ["string"]
+      "linkback_relation_tags": ["string"],
+      "graph_context": []
     }
   ],
   "created_at": "1970-01-01T00:00:00.000Z",
@@ -1324,6 +725,7 @@ const { data } = await client.executeRelations(
           target: 'string',
           target_tags: ['string'],
           target_tags_include_source: false,
+          target_entity_tags: ['string'],
           override_with_source_filter: false,
           source_filter: {
             limit: 0,
@@ -1404,66 +806,15 @@ const { data } = await client.getMappingConfig({
       "allow_failure": true,
       "target_schema": "string",
       "target_unique": ["string"],
-      "loop_config": {
-        "source_path": "string",
-        "length": "the length of the array"
-      },
+      "use_uniqueness_criteria": false,
+      "loop_config": {},
       "conditionMode": "oneOf",
-      "conditions": [
-        {
-          "_exists": {
-            "source": "string",
-            "value": "string"
-          },
-          "_equals": {
-            "source": "string",
-            "value": "string"
-          },
-          "_not_exists": {
-            "source": "string",
-            "value": "string"
-          },
-          "_any_of": {
-            "source": "string",
-            "value": "string"
-          }
-        }
-      ],
-      "mapping_attributes": [
-        {
-          "target": "_tags",
-          "operation": {
-            "_append": ["new", "tags"],
-            "_uniq": true
-          }
-        },
-        {
-          "mode": "copy_if_exists",
-          "target": "string",
-          "value": {}
-        }
-      ],
-      "relation_attributes": [
-        {
-          "target": "string",
-          "target_tags": ["string"],
-          "target_tags_include_source": false,
-          "override_with_source_filter": false,
-          "source_filter": {
-            "limit": 0,
-            "schema": "string",
-            "attribute": "string",
-            "relation_tag": "string",
-            "tag": "string",
-            "self": false
-          },
-          "related_to": {},
-          "mode": "append",
-          "origin": "system_recommendation"
-        }
-      ],
+      "conditions": [],
+      "mapping_attributes": [],
+      "relation_attributes": [],
       "linkback_relation_attribute": "mapped_entities",
-      "linkback_relation_tags": ["string"]
+      "linkback_relation_tags": ["string"],
+      "graph_context": []
     }
   ],
   "created_at": "1970-01-01T00:00:00.000Z",
@@ -1513,66 +864,15 @@ const { data } = await client.putMappingConfig(
         allow_failure: true,
         target_schema: 'string',
         target_unique: ['string'],
-        loop_config: {
-          source_path: 'string',
-          length: 'the length of the array'
-        },
+        use_uniqueness_criteria: false,
+        loop_config: { /* ... */ },
         conditionMode: 'oneOf',
-        conditions: [
-          {
-            _exists: {
-              source: 'string',
-              value: 'string'
-            },
-            _equals: {
-              source: 'string',
-              value: 'string'
-            },
-            _not_exists: {
-              source: 'string',
-              value: 'string'
-            },
-            _any_of: {
-              source: 'string',
-              value: 'string'
-            }
-          }
-        ],
-        mapping_attributes: [
-          {
-            target: '_tags',
-            operation: {
-              _append: ['new', 'tags'],
-              _uniq: true
-            }
-          },
-          {
-            mode: 'copy_if_exists',
-            target: 'string',
-            value: {}
-          }
-        ],
-        relation_attributes: [
-          {
-            target: 'string',
-            target_tags: ['string'],
-            target_tags_include_source: false,
-            override_with_source_filter: false,
-            source_filter: {
-              limit: 0,
-              schema: 'string',
-              attribute: 'string',
-              relation_tag: 'string',
-              tag: 'string',
-              self: false
-            },
-            related_to: {},
-            mode: 'append',
-            origin: 'system_recommendation'
-          }
-        ],
+        conditions: [ /* ... */ ],
+        mapping_attributes: [ /* ... */ ],
+        relation_attributes: [ /* ... */ ],
         linkback_relation_attribute: 'mapped_entities',
-        linkback_relation_tags: ['string']
+        linkback_relation_tags: ['string'],
+        graph_context: [ /* ... */ ]
       }
     ],
     created_at: '1970-01-01T00:00:00.000Z',
@@ -1612,66 +912,15 @@ const { data } = await client.putMappingConfig(
       "allow_failure": true,
       "target_schema": "string",
       "target_unique": ["string"],
-      "loop_config": {
-        "source_path": "string",
-        "length": "the length of the array"
-      },
+      "use_uniqueness_criteria": false,
+      "loop_config": {},
       "conditionMode": "oneOf",
-      "conditions": [
-        {
-          "_exists": {
-            "source": "string",
-            "value": "string"
-          },
-          "_equals": {
-            "source": "string",
-            "value": "string"
-          },
-          "_not_exists": {
-            "source": "string",
-            "value": "string"
-          },
-          "_any_of": {
-            "source": "string",
-            "value": "string"
-          }
-        }
-      ],
-      "mapping_attributes": [
-        {
-          "target": "_tags",
-          "operation": {
-            "_append": ["new", "tags"],
-            "_uniq": true
-          }
-        },
-        {
-          "mode": "copy_if_exists",
-          "target": "string",
-          "value": {}
-        }
-      ],
-      "relation_attributes": [
-        {
-          "target": "string",
-          "target_tags": ["string"],
-          "target_tags_include_source": false,
-          "override_with_source_filter": false,
-          "source_filter": {
-            "limit": 0,
-            "schema": "string",
-            "attribute": "string",
-            "relation_tag": "string",
-            "tag": "string",
-            "self": false
-          },
-          "related_to": {},
-          "mode": "append",
-          "origin": "system_recommendation"
-        }
-      ],
+      "conditions": [],
+      "mapping_attributes": [],
+      "relation_attributes": [],
       "linkback_relation_attribute": "mapped_entities",
-      "linkback_relation_tags": ["string"]
+      "linkback_relation_tags": ["string"],
+      "graph_context": []
     }
   ],
   "created_at": "1970-01-01T00:00:00.000Z",
@@ -1729,6 +978,7 @@ type MappingConfigsResp = {
       allow_failure?: { ... }
       target_schema: { ... }
       target_unique?: { ... }
+      use_uniqueness_criteria?: { ... }
       loop_config?: { ... }
       conditionMode?: { ... }
       conditions?: { ... }
@@ -1736,6 +986,7 @@ type MappingConfigsResp = {
       relation_attributes?: { ... }
       linkback_relation_attribute?: { ... }
       linkback_relation_tags?: { ... }
+      graph_context?: { ... }
     }>
     created_at?: string // date-time
     updated_at?: string // date-time
@@ -1775,6 +1026,7 @@ type MappingConfigs = Array<{
     allow_failure?: boolean
     target_schema: string
     target_unique?: string[]
+    use_uniqueness_criteria?: boolean
     loop_config?: {
       source_path?: { ... }
       length?: { ... }
@@ -1809,6 +1061,7 @@ type MappingConfigs = Array<{
       target: { ... }
       target_tags?: { ... }
       target_tags_include_source?: { ... }
+      target_entity_tags?: { ... }
       override_with_source_filter?: { ... }
       source_filter?: { ... }
       related_to?: { ... }
@@ -1817,6 +1070,10 @@ type MappingConfigs = Array<{
     }>
     linkback_relation_attribute?: string
     linkback_relation_tags?: string[]
+    graph_context?: Array<{
+      seed: { ... }
+      graph: { ... }
+    }>
   }>
   created_at?: string // date-time
   updated_at?: string // date-time
@@ -1855,6 +1112,7 @@ type MappingConfig = {
     allow_failure?: boolean
     target_schema: string
     target_unique?: string[]
+    use_uniqueness_criteria?: boolean
     loop_config?: {
       source_path?: { ... }
       length?: { ... }
@@ -1889,6 +1147,7 @@ type MappingConfig = {
       target: { ... }
       target_tags?: { ... }
       target_tags_include_source?: { ... }
+      target_entity_tags?: { ... }
       override_with_source_filter?: { ... }
       source_filter?: { ... }
       related_to?: { ... }
@@ -1897,6 +1156,10 @@ type MappingConfig = {
     }>
     linkback_relation_attribute?: string
     linkback_relation_tags?: string[]
+    graph_context?: Array<{
+      seed: { ... }
+      graph: { ... }
+    }>
   }>
   created_at?: string // date-time
   updated_at?: string // date-time
@@ -1935,6 +1198,7 @@ type MappingConfigV2 = {
     allow_failure?: boolean
     target_schema: string
     target_unique?: string[]
+    use_uniqueness_criteria?: boolean
     loop_config?: {
       source_path?: { ... }
       length?: { ... }
@@ -1969,6 +1233,7 @@ type MappingConfigV2 = {
       target: { ... }
       target_tags?: { ... }
       target_tags_include_source?: { ... }
+      target_entity_tags?: { ... }
       override_with_source_filter?: { ... }
       source_filter?: { ... }
       related_to?: { ... }
@@ -1977,6 +1242,10 @@ type MappingConfigV2 = {
     }>
     linkback_relation_attribute?: string
     linkback_relation_tags?: string[]
+    graph_context?: Array<{
+      seed: { ... }
+      graph: { ... }
+    }>
   }>
   created_at?: string // date-time
   updated_at?: string // date-time
@@ -2015,6 +1284,7 @@ type MappingConfigCommonFields = {
     allow_failure?: boolean
     target_schema: string
     target_unique?: string[]
+    use_uniqueness_criteria?: boolean
     loop_config?: {
       source_path?: { ... }
       length?: { ... }
@@ -2049,6 +1319,7 @@ type MappingConfigCommonFields = {
       target: { ... }
       target_tags?: { ... }
       target_tags_include_source?: { ... }
+      target_entity_tags?: { ... }
       override_with_source_filter?: { ... }
       source_filter?: { ... }
       related_to?: { ... }
@@ -2057,6 +1328,10 @@ type MappingConfigCommonFields = {
     }>
     linkback_relation_attribute?: string
     linkback_relation_tags?: string[]
+    graph_context?: Array<{
+      seed: { ... }
+      graph: { ... }
+    }>
   }>
   created_at?: string // date-time
   updated_at?: string // date-time
@@ -2102,6 +1377,7 @@ type ExecuteRelationsReq = {
       target: { ... }
       target_tags?: { ... }
       target_tags_include_source?: { ... }
+      target_entity_tags?: { ... }
       override_with_source_filter?: { ... }
       source_filter?: { ... }
       related_to?: { ... }
@@ -2163,12 +1439,17 @@ type ExecuteMappingReq = {
     entity_id: string
     entity_schema?: string
   }
+  loop_ref?: {
+    entity_id: string
+    entity_schema?: string
+  }
   targets: Array<{
     id?: string
     name?: string
     allow_failure?: boolean
     target_schema: string
     target_unique?: string[]
+    use_uniqueness_criteria?: boolean
     loop_config?: {
       source_path?: { ... }
       length?: { ... }
@@ -2203,6 +1484,7 @@ type ExecuteMappingReq = {
       target: { ... }
       target_tags?: { ... }
       target_tags_include_source?: { ... }
+      target_entity_tags?: { ... }
       override_with_source_filter?: { ... }
       source_filter?: { ... }
       related_to?: { ... }
@@ -2211,6 +1493,10 @@ type ExecuteMappingReq = {
     }>
     linkback_relation_attribute?: string
     linkback_relation_tags?: string[]
+    graph_context?: Array<{
+      seed: { ... }
+      graph: { ... }
+    }>
   }>
 }
 ```
@@ -2236,6 +1522,7 @@ type ExecuteMappingResp = {
       allow_failure?: { ... }
       target_schema: { ... }
       target_unique?: { ... }
+      use_uniqueness_criteria?: { ... }
       loop_config?: { ... }
       conditionMode?: { ... }
       conditions?: { ... }
@@ -2243,6 +1530,7 @@ type ExecuteMappingResp = {
       relation_attributes?: { ... }
       linkback_relation_attribute?: { ... }
       linkback_relation_tags?: { ... }
+      graph_context?: { ... }
     }
     error?: {
       isSilent?: { ... }
@@ -2267,6 +1555,7 @@ type MappingFailure = {
     allow_failure?: boolean
     target_schema: string
     target_unique?: string[]
+    use_uniqueness_criteria?: boolean
     loop_config?: {
       source_path?: { ... }
       length?: { ... }
@@ -2301,6 +1590,7 @@ type MappingFailure = {
       target: { ... }
       target_tags?: { ... }
       target_tags_include_source?: { ... }
+      target_entity_tags?: { ... }
       override_with_source_filter?: { ... }
       source_filter?: { ... }
       related_to?: { ... }
@@ -2309,6 +1599,10 @@ type MappingFailure = {
     }>
     linkback_relation_attribute?: string
     linkback_relation_tags?: string[]
+    graph_context?: Array<{
+      seed: { ... }
+      graph: { ... }
+    }>
   }
   error?: {
     isSilent?: boolean
@@ -2390,6 +1684,7 @@ type TargetConfig = {
   allow_failure?: boolean
   target_schema: string
   target_unique?: string[]
+  use_uniqueness_criteria?: boolean
   loop_config?: {
     source_path?: string
     length?: number
@@ -2424,6 +1719,9 @@ type TargetConfig = {
       _copy?: { ... }
       _template?: { ... }
       _random?: { ... }
+      _each?: { ... }
+      _as?: { ... }
+      _map?: { ... }
     } | string | boolean | number | Record<string, unknown> | unknown[]
     origin?: "system_recommendation" | "user_manually" | "entity_updating_system_recommendation"
   } | {
@@ -2445,6 +1743,7 @@ type TargetConfig = {
     target: string
     target_tags?: string[]
     target_tags_include_source?: boolean
+    target_entity_tags?: string[]
     override_with_source_filter?: boolean
     source_filter?: {
       limit?: { ... }
@@ -2460,6 +1759,16 @@ type TargetConfig = {
   }>
   linkback_relation_attribute?: string
   linkback_relation_tags?: string[]
+  graph_context?: Array<{
+    seed: {
+      entity_id: { ... }
+      node_id: { ... }
+    }
+    graph: {
+      nodes: { ... }
+      edges: { ... }
+    }
+  }>
 }
 ```
 
@@ -2502,6 +1811,7 @@ type RelationAttribute = {
   target: string
   target_tags?: string[]
   target_tags_include_source?: boolean
+  target_entity_tags?: string[]
   override_with_source_filter?: boolean
   source_filter?: {
     limit?: number
@@ -2517,6 +1827,108 @@ type RelationAttribute = {
 }
 ```
 
+### `GraphContextEntry`
+
+One multi-hop graph lookup against entity-api's `POST /v1/entity:graph`, resolved during
+graph_context enrichment (before mapping_attributes are evaluated). Every node in `graph.nodes`
+is merged into sourceContext under its own `id`, so listing several nodes here costs one
+entity-api call, not one p
+
+```ts
+type GraphContextEntry = {
+  seed: {
+    entity_id: string
+    node_id: string
+  }
+  graph: {
+    nodes: Array<{
+      id: { ... }
+      schema: { ... }
+      cardinality?: { ... }
+      fields?: { ... }
+      filter?: { ... }
+    }>
+    edges: Array<{
+      from: { ... }
+      to: { ... }
+    }>
+  }
+}
+```
+
+### `GraphSeed`
+
+Mirrors entity-api's GraphSeed (see entity-api openapi.yml) - the entity the graph traversal starts from.
+
+```ts
+type GraphSeed = {
+  entity_id: string
+  node_id: string
+}
+```
+
+### `GraphDefinition`
+
+Mirrors entity-api's GraphDefinition (see entity-api openapi.yml) - the shape of the graph to traverse.
+
+```ts
+type GraphDefinition = {
+  nodes: Array<{
+    id: string
+    schema: string
+    cardinality?: "one" | "many"
+    fields?: string[]
+    filter?: Array<{
+      attribute: { ... }
+      value: { ... }
+    }>
+  }>
+  edges: Array<{
+    from: string
+    to: string
+  }>
+}
+```
+
+### `GraphNode`
+
+Mirrors entity-api's GraphNode (see entity-api openapi.yml).
+
+```ts
+type GraphNode = {
+  id: string
+  schema: string
+  cardinality?: "one" | "many"
+  fields?: string[]
+  filter?: Array<{
+    attribute: string
+    value: string | number | boolean
+  }>
+}
+```
+
+### `GraphNodeFilter`
+
+Mirrors entity-api's GraphNodeFilter (see entity-api openapi.yml).
+
+```ts
+type GraphNodeFilter = {
+  attribute: string
+  value: string | number | boolean
+}
+```
+
+### `GraphEdge`
+
+Mirrors entity-api's GraphEdge (see entity-api openapi.yml).
+
+```ts
+type GraphEdge = {
+  from: string
+  to: string
+}
+```
+
 ### `MappingAttributeV2`
 
 ```ts
@@ -2537,6 +1949,21 @@ type MappingAttributeV2 = {
       min?: { ... }
       max?: { ... }
     }
+    _each?: string
+    _as?: string
+    _map?: {
+      _set?: { ... }
+      _append?: { ... }
+      _prepend?: { ... }
+      _uniq?: { ... }
+      _retain_old_values?: { ... }
+      _copy?: { ... }
+      _template?: { ... }
+      _random?: { ... }
+      _each?: { ... }
+      _as?: { ... }
+      _map?: { ... }
+    } | string | boolean | number | Record<string, unknown> | unknown[]
   } | string | boolean | number | Record<string, unknown> | unknown[]
   origin?: "system_recommendation" | "user_manually" | "entity_updating_system_recommendation"
 }
@@ -2570,6 +1997,39 @@ type OperationNode = {
     min?: number
     max?: number
   }
+  _each?: string
+  _as?: string
+  _map?: {
+    _set?: string | boolean | number | Record<string, unknown> | unknown[]
+    _append?: unknown
+    _prepend?: unknown
+    _uniq?: boolean | string[]
+    _retain_old_values?: boolean
+    _copy?: string
+    _template?: string
+    _random?: {
+      type: { ... }
+    } | {
+      type: { ... }
+      min?: { ... }
+      max?: { ... }
+    }
+    _each?: string
+    _as?: string
+    _map?: {
+      _set?: { ... }
+      _append?: { ... }
+      _prepend?: { ... }
+      _uniq?: { ... }
+      _retain_old_values?: { ... }
+      _copy?: { ... }
+      _template?: { ... }
+      _random?: { ... }
+      _each?: { ... }
+      _as?: { ... }
+      _map?: { ... }
+    } | string | boolean | number | Record<string, unknown> | unknown[]
+  } | string | boolean | number | Record<string, unknown> | unknown[]
 } | string | boolean | number | Record<string, unknown> | unknown[]
 ```
 
@@ -2591,6 +2051,39 @@ type OperationObjectNode = {
     min?: number
     max?: number
   }
+  _each?: string
+  _as?: string
+  _map?: {
+    _set?: string | boolean | number | Record<string, unknown> | unknown[]
+    _append?: unknown
+    _prepend?: unknown
+    _uniq?: boolean | string[]
+    _retain_old_values?: boolean
+    _copy?: string
+    _template?: string
+    _random?: {
+      type: { ... }
+    } | {
+      type: { ... }
+      min?: { ... }
+      max?: { ... }
+    }
+    _each?: string
+    _as?: string
+    _map?: {
+      _set?: { ... }
+      _append?: { ... }
+      _prepend?: { ... }
+      _uniq?: { ... }
+      _retain_old_values?: { ... }
+      _copy?: { ... }
+      _template?: { ... }
+      _random?: { ... }
+      _each?: { ... }
+      _as?: { ... }
+      _map?: { ... }
+    } | string | boolean | number | Record<string, unknown> | unknown[]
+  } | string | boolean | number | Record<string, unknown> | unknown[]
 }
 ```
 
@@ -2707,6 +2200,7 @@ type MappingHistoryResp = {
       allow_failure?: { ... }
       target_schema: { ... }
       target_unique?: { ... }
+      use_uniqueness_criteria?: { ... }
       loop_config?: { ... }
       conditionMode?: { ... }
       conditions?: { ... }
@@ -2714,6 +2208,7 @@ type MappingHistoryResp = {
       relation_attributes?: { ... }
       linkback_relation_attribute?: { ... }
       linkback_relation_tags?: { ... }
+      graph_context?: { ... }
     }>
   }>
 }
@@ -2751,6 +2246,7 @@ type MappingHistoryEntry = {
     allow_failure?: boolean
     target_schema: string
     target_unique?: string[]
+    use_uniqueness_criteria?: boolean
     loop_config?: {
       source_path?: { ... }
       length?: { ... }
@@ -2785,6 +2281,7 @@ type MappingHistoryEntry = {
       target: { ... }
       target_tags?: { ... }
       target_tags_include_source?: { ... }
+      target_entity_tags?: { ... }
       override_with_source_filter?: { ... }
       source_filter?: { ... }
       related_to?: { ... }
@@ -2793,6 +2290,10 @@ type MappingHistoryEntry = {
     }>
     linkback_relation_attribute?: string
     linkback_relation_tags?: string[]
+    graph_context?: Array<{
+      seed: { ... }
+      graph: { ... }
+    }>
   }>
 }
 ```
@@ -2816,6 +2317,7 @@ type MappingSource = {
     target: string
     target_tags?: string[]
     target_tags_include_source?: boolean
+    target_entity_tags?: string[]
     override_with_source_filter?: boolean
     source_filter?: {
       limit?: { ... }