@epilot/sdk 2.15.11 → 2.15.13

package/definitions/app.json

@@ -4915,6 +4915,11 @@
             "description": "Name of the app",
             "readOnly": true
           },
+          "icon_url": {
+            "type": "string",
+            "description": "Public URL of the app logo, if one has been uploaded",
+            "readOnly": true
+          },
           "option_values": {
             "type": "array",
             "items": {

package/definitions/deduplication-runtime.json

@@ -1 +1 @@
-{"s":"https://deduplication.sls.epilot.io","o":[["deduplicate","post","/v1/deduplicate",null,1],["deduplicateAsync","post","/v1/deduplicate/job",null,1],["getDeduplicationJob","get","/v1/deduplicate/jobs/{jobId}",[["jobId","p",true]]]]}
+{"s":"https://deduplication.sls.epilot.io","o":[["deduplicate","post","/v1/deduplicate",null,1],["deduplicateAsync","post","/v1/deduplicate/job",null,1],["getDeduplicationJob","get","/v1/deduplicate/jobs/{jobId}",[["jobId","p",true]]],["detectDuplicates","post","/v1/detect-duplicates",null,1],["listUniquenessCriteria","get","/v1/uniqueness-criteria",[["schema","q"]]],["createUniquenessCriteria","post","/v1/uniqueness-criteria",null,1],["getUniquenessCriteria","get","/v1/uniqueness-criteria/{schema}",[["schema","p",true]]],["updateUniquenessCriteria","put","/v1/uniqueness-criteria/{schema}",[["schema","p",true]],1],["deleteUniquenessCriteria","delete","/v1/uniqueness-criteria/{schema}",[["schema","p",true]]]]}

package/definitions/deduplication.json

@@ -102,6 +102,193 @@
           }
         }
       }
+    },
+    "/v1/detect-duplicates": {
+      "post": {
+        "operationId": "detectDuplicates",
+        "summary": "detectDuplicates",
+        "description": "Detects potential duplicate entities for the given entity using the schema's prioritized uniqueness rules. Returns matches with a confidence score.",
+        "tags": [],
+        "requestBody": {
+          "content": {
+            "application/json": {
+              "schema": {
+                "$ref": "#/components/schemas/DetectDuplicatesRequestBody"
+              }
+            }
+          }
+        },
+        "responses": {
+          "200": {
+            "description": "Potential duplicates ranked by rule priority",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/DetectDuplicatesResponse"
+                }
+              }
+            }
+          }
+        }
+      }
+    },
+    "/v1/uniqueness-criteria": {
+      "get": {
+        "operationId": "listUniquenessCriteria",
+        "summary": "listUniquenessCriteria",
+        "description": "Lists UniquenessCriteria for the requesting organization. Optionally filtered by schema.",
+        "tags": [],
+        "parameters": [
+          {
+            "name": "schema",
+            "in": "query",
+            "required": false,
+            "schema": {
+              "type": "string"
+            },
+            "description": "Filter results to a specific entity schema."
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "Array of UniquenessCriteria records",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/UniquenessCriteriaListResponse"
+                }
+              }
+            }
+          }
+        }
+      },
+      "post": {
+        "operationId": "createUniquenessCriteria",
+        "summary": "createUniquenessCriteria",
+        "description": "Creates a new UniquenessCriteria record.",
+        "tags": [],
+        "requestBody": {
+          "content": {
+            "application/json": {
+              "schema": {
+                "$ref": "#/components/schemas/UniquenessCriteriaCreateBody"
+              }
+            }
+          }
+        },
+        "responses": {
+          "201": {
+            "description": "Created record",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/UniquenessCriteria"
+                }
+              }
+            }
+          }
+        }
+      }
+    },
+    "/v1/uniqueness-criteria/{schema}": {
+      "get": {
+        "operationId": "getUniquenessCriteria",
+        "summary": "getUniquenessCriteria",
+        "description": "Fetch a single UniquenessCriteria record.",
+        "tags": [],
+        "parameters": [
+          {
+            "name": "schema",
+            "in": "path",
+            "required": true,
+            "schema": {
+              "type": "string"
+            },
+            "description": "Entity schema slug."
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "The criteria record",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/UniquenessCriteria"
+                }
+              }
+            }
+          },
+          "404": {
+            "description": "Record not found"
+          }
+        }
+      },
+      "put": {
+        "operationId": "updateUniquenessCriteria",
+        "summary": "updateUniquenessCriteria",
+        "description": "Replace the matchRules on an existing UniquenessCriteria record.",
+        "tags": [],
+        "parameters": [
+          {
+            "name": "schema",
+            "in": "path",
+            "required": true,
+            "schema": {
+              "type": "string"
+            },
+            "description": "Entity schema slug."
+          }
+        ],
+        "requestBody": {
+          "content": {
+            "application/json": {
+              "schema": {
+                "$ref": "#/components/schemas/UniquenessCriteriaUpdateBody"
+              }
+            }
+          }
+        },
+        "responses": {
+          "200": {
+            "description": "Updated record",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/UniquenessCriteria"
+                }
+              }
+            }
+          },
+          "404": {
+            "description": "Record not found"
+          }
+        }
+      },
+      "delete": {
+        "operationId": "deleteUniquenessCriteria",
+        "summary": "deleteUniquenessCriteria",
+        "description": "Delete a UniquenessCriteria record.",
+        "tags": [],
+        "parameters": [
+          {
+            "name": "schema",
+            "in": "path",
+            "required": true,
+            "schema": {
+              "type": "string"
+            },
+            "description": "Entity schema slug."
+          }
+        ],
+        "responses": {
+          "204": {
+            "description": "Record deleted"
+          },
+          "404": {
+            "description": "Record not found"
+          }
+        }
+      }
     }
   },
   "components": {
@@ -120,20 +307,26 @@
           "type": "object",
           "properties": {
             "toKeep": {
-              "type": "string"
+              "type": "string",
+              "minLength": 1,
+              "description": "Entity id to keep and merge the duplicates into"
             },
             "toDelete": {
               "type": "array",
               "items": {
-                "type": "string"
-              }
+                "type": "string",
+                "minLength": 1
+              },
+              "minItems": 1,
+              "description": "Non-empty list of duplicate entity ids to merge into toKeep and delete"
             }
           },
           "required": [
             "toKeep",
             "toDelete"
           ]
-        }
+        },
+        "minItems": 1
       },
       "DeduplicateRequestResponse": {
         "type": "array",
@@ -303,6 +496,205 @@
           "updatedAt"
         ],
         "description": "Represents an async deduplication job"
+      },
+      "DetectDuplicatesRequestBody": {
+        "type": "object",
+        "properties": {
+          "schema": {
+            "type": "string",
+            "minLength": 1,
+            "description": "Entity schema to search (e.g. 'contact'). Must have UniquenessCriteria configured for the calling org."
+          },
+          "entity": {
+            "type": "object",
+            "additionalProperties": {},
+            "description": "The entity to look up potential duplicates for. Attribute values are extracted from this entity per the schema's match rules; system fields such as '_id' are supported. A rule is evaluated when at least one of its attributes resolves to a non-empty value on this entity; attributes without a value require candidates to also lack a value for them."
+          }
+        },
+        "required": [
+          "schema",
+          "entity"
+        ]
+      },
+      "DetectDuplicatesResponse": {
+        "type": "object",
+        "properties": {
+          "matches": {
+            "type": "array",
+            "items": {
+              "$ref": "#/components/schemas/DetectedDuplicateMatch"
+            }
+          }
+        },
+        "required": [
+          "matches"
+        ]
+      },
+      "DetectedDuplicateMatch": {
+        "type": "object",
+        "properties": {
+          "entity": {
+            "$ref": "#/components/schemas/Entity"
+          },
+          "confidence": {
+            "type": "number",
+            "minimum": 0,
+            "maximum": 1,
+            "description": "Confidence score for the match, between 0 and 1."
+          },
+          "matched_attributes": {
+            "type": "array",
+            "items": {
+              "type": "string"
+            },
+            "minItems": 1,
+            "description": "Names of the attributes that matched on the rule that produced this hit."
+          }
+        },
+        "required": [
+          "entity",
+          "confidence",
+          "matched_attributes"
+        ]
+      },
+      "UniquenessCriteriaListResponse": {
+        "type": "object",
+        "properties": {
+          "items": {
+            "type": "array",
+            "items": {
+              "$ref": "#/components/schemas/UniquenessCriteria"
+            }
+          }
+        },
+        "required": [
+          "items"
+        ]
+      },
+      "UniquenessCriteria": {
+        "type": "object",
+        "properties": {
+          "id": {
+            "type": "string",
+            "format": "uuid",
+            "description": "Unique identifier of the criteria record."
+          },
+          "orgId": {
+            "type": "string",
+            "description": "Organization the criteria belong to."
+          },
+          "schema": {
+            "type": "string",
+            "minLength": 1,
+            "description": "Entity schema these criteria apply to (e.g. 'contact')."
+          },
+          "matchRules": {
+            "type": "array",
+            "items": {
+              "$ref": "#/components/schemas/MatchRule"
+            },
+            "minItems": 1,
+            "description": "Ordered list of match rules. Order is the evaluation priority."
+          },
+          "createdAt": {
+            "type": "string",
+            "description": "ISO 8601 timestamp of record creation.",
+            "format": "date-time"
+          },
+          "updatedAt": {
+            "type": "string",
+            "description": "ISO 8601 timestamp of last update.",
+            "format": "date-time"
+          }
+        },
+        "required": [
+          "id",
+          "orgId",
+          "schema",
+          "matchRules",
+          "createdAt",
+          "updatedAt"
+        ],
+        "description": "Defines what makes an entity of a given schema unique within an organization."
+      },
+      "MatchRule": {
+        "type": "object",
+        "properties": {
+          "name": {
+            "type": "string",
+            "maxLength": 100,
+            "description": "Optional human-readable label for the rule. Purely descriptive; not used during matching."
+          },
+          "attributes": {
+            "type": "array",
+            "items": {
+              "$ref": "#/components/schemas/MatchAttribute"
+            },
+            "minItems": 1,
+            "description": "Attributes that must all match for this rule to fire. Attributes without a value on the source entity must also have no value on a matching candidate."
+          },
+          "confidence": {
+            "type": "number",
+            "minimum": 0,
+            "maximum": 1,
+            "description": "Confidence assigned to matches produced by this rule, between 0 and 1."
+          }
+        },
+        "required": [
+          "attributes",
+          "confidence"
+        ],
+        "description": "One way to identify the same entity. Evaluated in order; first rule whose attributes are all available and that returns hits wins."
+      },
+      "MatchAttribute": {
+        "type": "object",
+        "properties": {
+          "attribute": {
+            "type": "string",
+            "minLength": 1,
+            "description": "Name of the entity attribute to match on. Its query path is resolved from the entity schema at query time."
+          }
+        },
+        "required": [
+          "attribute"
+        ],
+        "description": "One attribute participating in a match rule. Wrapped as an object so per-attribute options can be added later."
+      },
+      "UniquenessCriteriaCreateBody": {
+        "type": "object",
+        "properties": {
+          "schema": {
+            "type": "string",
+            "minLength": 1,
+            "description": "Entity schema these criteria apply to."
+          },
+          "matchRules": {
+            "type": "array",
+            "items": {
+              "$ref": "#/components/schemas/MatchRule"
+            },
+            "minItems": 1
+          }
+        },
+        "required": [
+          "schema",
+          "matchRules"
+        ]
+      },
+      "UniquenessCriteriaUpdateBody": {
+        "type": "object",
+        "properties": {
+          "matchRules": {
+            "type": "array",
+            "items": {
+              "$ref": "#/components/schemas/MatchRule"
+            },
+            "minItems": 1
+          }
+        },
+        "required": [
+          "matchRules"
+        ]
       }
     }
   },

package/dist/apis/access-token.cjs

@@ -6,25 +6,25 @@ var _chunkS5HBBTKMcjs = require('../chunk-S5HBBTKM.cjs');
 
 
 
-var _chunkLNYFU7SVcjs = require('../chunk-LNYFU7SV.cjs');
+var _chunk45UKIH2Ccjs = require('../chunk-45UKIH2C.cjs');
 require('../chunk-NJK5F5TF.cjs');
 
 // src/apis/access-token.ts
 var loadDefinition = () => {
   const mod = _chunkS5HBBTKMcjs.require_access_token_runtime.call(void 0, );
-  return _chunkLNYFU7SVcjs.expand.call(void 0, _nullishCoalesce(mod.default, () => ( mod)));
+  return _chunk45UKIH2Ccjs.expand.call(void 0, _nullishCoalesce(mod.default, () => ( mod)));
 };
 var _instance = null;
 var resolve = () => {
   if (!_instance) {
     const def = loadDefinition();
-    _instance = _chunkLNYFU7SVcjs.createApiClient.call(void 0, { definition: def, apiName: "accessToken" });
+    _instance = _chunk45UKIH2Ccjs.createApiClient.call(void 0, { definition: def, apiName: "accessToken" });
   }
   return _instance;
 };
-var _handle = _chunkLNYFU7SVcjs.createApiHandle.call(void 0, {
+var _handle = _chunk45UKIH2Ccjs.createApiHandle.call(void 0, {
   resolveClient: resolve,
-  createClient: () => _chunkLNYFU7SVcjs.createApiClient.call(void 0, { definition: loadDefinition(), apiName: "accessToken" }),
+  createClient: () => _chunk45UKIH2Ccjs.createApiClient.call(void 0, { definition: loadDefinition(), apiName: "accessToken" }),
   apiName: "accessToken"
 });
 var getClient = _handle.getClient;
@@ -35,4 +35,4 @@ var accessToken = _handle;
 
 
 
-exports.accessToken = accessToken; exports.authorize = _chunkLNYFU7SVcjs.authorize; exports.createClient = createClient; exports.getClient = getClient;
+exports.accessToken = accessToken; exports.authorize = _chunk45UKIH2Ccjs.authorize; exports.createClient = createClient; exports.getClient = getClient;

package/dist/apis/access-token.js

@@ -6,7 +6,7 @@ import {
   createApiClient,
   createApiHandle,
   expand
-} from "../chunk-7NITZ7QR.js";
+} from "../chunk-EPXD4DIT.js";
 import "../chunk-YPSWSI3M.js";
 
 // src/apis/access-token.ts

package/dist/apis/address-suggestions.cjs

@@ -6,25 +6,25 @@ var _chunkLKRBFBFNcjs = require('../chunk-LKRBFBFN.cjs');
 
 
 
-var _chunkLNYFU7SVcjs = require('../chunk-LNYFU7SV.cjs');
+var _chunk45UKIH2Ccjs = require('../chunk-45UKIH2C.cjs');
 require('../chunk-NJK5F5TF.cjs');
 
 // src/apis/address-suggestions.ts
 var loadDefinition = () => {
   const mod = _chunkLKRBFBFNcjs.require_address_suggestions_runtime.call(void 0, );
-  return _chunkLNYFU7SVcjs.expand.call(void 0, _nullishCoalesce(mod.default, () => ( mod)));
+  return _chunk45UKIH2Ccjs.expand.call(void 0, _nullishCoalesce(mod.default, () => ( mod)));
 };
 var _instance = null;
 var resolve = () => {
   if (!_instance) {
     const def = loadDefinition();
-    _instance = _chunkLNYFU7SVcjs.createApiClient.call(void 0, { definition: def, apiName: "addressSuggestions" });
+    _instance = _chunk45UKIH2Ccjs.createApiClient.call(void 0, { definition: def, apiName: "addressSuggestions" });
   }
   return _instance;
 };
-var _handle = _chunkLNYFU7SVcjs.createApiHandle.call(void 0, {
+var _handle = _chunk45UKIH2Ccjs.createApiHandle.call(void 0, {
   resolveClient: resolve,
-  createClient: () => _chunkLNYFU7SVcjs.createApiClient.call(void 0, { definition: loadDefinition(), apiName: "addressSuggestions" }),
+  createClient: () => _chunk45UKIH2Ccjs.createApiClient.call(void 0, { definition: loadDefinition(), apiName: "addressSuggestions" }),
   apiName: "addressSuggestions"
 });
 var getClient = _handle.getClient;
@@ -35,4 +35,4 @@ var addressSuggestions = _handle;
 
 
 
-exports.addressSuggestions = addressSuggestions; exports.authorize = _chunkLNYFU7SVcjs.authorize; exports.createClient = createClient; exports.getClient = getClient;
+exports.addressSuggestions = addressSuggestions; exports.authorize = _chunk45UKIH2Ccjs.authorize; exports.createClient = createClient; exports.getClient = getClient;

package/dist/apis/address-suggestions.js

@@ -6,7 +6,7 @@ import {
   createApiClient,
   createApiHandle,
   expand
-} from "../chunk-7NITZ7QR.js";
+} from "../chunk-EPXD4DIT.js";
 import "../chunk-YPSWSI3M.js";
 
 // src/apis/address-suggestions.ts

package/dist/apis/address.cjs

@@ -6,25 +6,25 @@ var _chunkT67ZXTVGcjs = require('../chunk-T67ZXTVG.cjs');
 
 
 
-var _chunkLNYFU7SVcjs = require('../chunk-LNYFU7SV.cjs');
+var _chunk45UKIH2Ccjs = require('../chunk-45UKIH2C.cjs');
 require('../chunk-NJK5F5TF.cjs');
 
 // src/apis/address.ts
 var loadDefinition = () => {
   const mod = _chunkT67ZXTVGcjs.require_address_runtime.call(void 0, );
-  return _chunkLNYFU7SVcjs.expand.call(void 0, _nullishCoalesce(mod.default, () => ( mod)));
+  return _chunk45UKIH2Ccjs.expand.call(void 0, _nullishCoalesce(mod.default, () => ( mod)));
 };
 var _instance = null;
 var resolve = () => {
   if (!_instance) {
     const def = loadDefinition();
-    _instance = _chunkLNYFU7SVcjs.createApiClient.call(void 0, { definition: def, apiName: "address" });
+    _instance = _chunk45UKIH2Ccjs.createApiClient.call(void 0, { definition: def, apiName: "address" });
   }
   return _instance;
 };
-var _handle = _chunkLNYFU7SVcjs.createApiHandle.call(void 0, {
+var _handle = _chunk45UKIH2Ccjs.createApiHandle.call(void 0, {
   resolveClient: resolve,
-  createClient: () => _chunkLNYFU7SVcjs.createApiClient.call(void 0, { definition: loadDefinition(), apiName: "address" }),
+  createClient: () => _chunk45UKIH2Ccjs.createApiClient.call(void 0, { definition: loadDefinition(), apiName: "address" }),
   apiName: "address"
 });
 var getClient = _handle.getClient;
@@ -35,4 +35,4 @@ var address = _handle;
 
 
 
-exports.address = address; exports.authorize = _chunkLNYFU7SVcjs.authorize; exports.createClient = createClient; exports.getClient = getClient;
+exports.address = address; exports.authorize = _chunk45UKIH2Ccjs.authorize; exports.createClient = createClient; exports.getClient = getClient;

package/dist/apis/address.js

@@ -6,7 +6,7 @@ import {
   createApiClient,
   createApiHandle,
   expand
-} from "../chunk-7NITZ7QR.js";
+} from "../chunk-EPXD4DIT.js";
 import "../chunk-YPSWSI3M.js";
 
 // src/apis/address.ts

package/dist/apis/ai-agents.cjs

@@ -6,25 +6,25 @@ var _chunkYEBEA6XUcjs = require('../chunk-YEBEA6XU.cjs');
 
 
 
-var _chunkLNYFU7SVcjs = require('../chunk-LNYFU7SV.cjs');
+var _chunk45UKIH2Ccjs = require('../chunk-45UKIH2C.cjs');
 require('../chunk-NJK5F5TF.cjs');
 
 // src/apis/ai-agents.ts
 var loadDefinition = () => {
   const mod = _chunkYEBEA6XUcjs.require_ai_agents_runtime.call(void 0, );
-  return _chunkLNYFU7SVcjs.expand.call(void 0, _nullishCoalesce(mod.default, () => ( mod)));
+  return _chunk45UKIH2Ccjs.expand.call(void 0, _nullishCoalesce(mod.default, () => ( mod)));
 };
 var _instance = null;
 var resolve = () => {
   if (!_instance) {
     const def = loadDefinition();
-    _instance = _chunkLNYFU7SVcjs.createApiClient.call(void 0, { definition: def, apiName: "aiAgents" });
+    _instance = _chunk45UKIH2Ccjs.createApiClient.call(void 0, { definition: def, apiName: "aiAgents" });
   }
   return _instance;
 };
-var _handle = _chunkLNYFU7SVcjs.createApiHandle.call(void 0, {
+var _handle = _chunk45UKIH2Ccjs.createApiHandle.call(void 0, {
   resolveClient: resolve,
-  createClient: () => _chunkLNYFU7SVcjs.createApiClient.call(void 0, { definition: loadDefinition(), apiName: "aiAgents" }),
+  createClient: () => _chunk45UKIH2Ccjs.createApiClient.call(void 0, { definition: loadDefinition(), apiName: "aiAgents" }),
   apiName: "aiAgents"
 });
 var getClient = _handle.getClient;
@@ -35,4 +35,4 @@ var aiAgents = _handle;
 
 
 
-exports.aiAgents = aiAgents; exports.authorize = _chunkLNYFU7SVcjs.authorize; exports.createClient = createClient; exports.getClient = getClient;
+exports.aiAgents = aiAgents; exports.authorize = _chunk45UKIH2Ccjs.authorize; exports.createClient = createClient; exports.getClient = getClient;

package/dist/apis/ai-agents.js

@@ -6,7 +6,7 @@ import {
   createApiClient,
   createApiHandle,
   expand
-} from "../chunk-7NITZ7QR.js";
+} from "../chunk-EPXD4DIT.js";
 import "../chunk-YPSWSI3M.js";
 
 // src/apis/ai-agents.ts

package/dist/apis/app.cjs

@@ -6,25 +6,25 @@ var _chunkW6BCTQLUcjs = require('../chunk-W6BCTQLU.cjs');
 
 
 
-var _chunkLNYFU7SVcjs = require('../chunk-LNYFU7SV.cjs');
+var _chunk45UKIH2Ccjs = require('../chunk-45UKIH2C.cjs');
 require('../chunk-NJK5F5TF.cjs');
 
 // src/apis/app.ts
 var loadDefinition = () => {
   const mod = _chunkW6BCTQLUcjs.require_app_runtime.call(void 0, );
-  return _chunkLNYFU7SVcjs.expand.call(void 0, _nullishCoalesce(mod.default, () => ( mod)));
+  return _chunk45UKIH2Ccjs.expand.call(void 0, _nullishCoalesce(mod.default, () => ( mod)));
 };
 var _instance = null;
 var resolve = () => {
   if (!_instance) {
     const def = loadDefinition();
-    _instance = _chunkLNYFU7SVcjs.createApiClient.call(void 0, { definition: def, apiName: "app" });
+    _instance = _chunk45UKIH2Ccjs.createApiClient.call(void 0, { definition: def, apiName: "app" });
   }
   return _instance;
 };
-var _handle = _chunkLNYFU7SVcjs.createApiHandle.call(void 0, {
+var _handle = _chunk45UKIH2Ccjs.createApiHandle.call(void 0, {
   resolveClient: resolve,
-  createClient: () => _chunkLNYFU7SVcjs.createApiClient.call(void 0, { definition: loadDefinition(), apiName: "app" }),
+  createClient: () => _chunk45UKIH2Ccjs.createApiClient.call(void 0, { definition: loadDefinition(), apiName: "app" }),
   apiName: "app"
 });
 var getClient = _handle.getClient;
@@ -35,4 +35,4 @@ var app = _handle;
 
 
 
-exports.app = app; exports.authorize = _chunkLNYFU7SVcjs.authorize; exports.createClient = createClient; exports.getClient = getClient;
+exports.app = app; exports.authorize = _chunk45UKIH2Ccjs.authorize; exports.createClient = createClient; exports.getClient = getClient;