@epilot/cli 0.1.95 → 0.1.97

package/README.md

@@ -29,7 +29,7 @@ npm install -g @epilot/cli
 
 <!-- usage-help -->
 ```
-epilot v0.1.95 — CLI for epilot APIs
+epilot v0.1.97 — CLI for epilot APIs
 
 USAGE
   epilot <api> <operationId> [params...] [flags]

package/definitions/deduplication.json

@@ -132,6 +132,35 @@
         }
       }
     },
+    "/v1/duplicates/dismiss": {
+      "post": {
+        "operationId": "dismissDuplicates",
+        "summary": "dismissDuplicates",
+        "description": "Confirms entities as NOT duplicates: clears the internal duplicate-detection flags (_matching_entities) on each given entity, so they stop appearing as open duplicate sets. The records themselves are not modified otherwise.",
+        "tags": [],
+        "requestBody": {
+          "content": {
+            "application/json": {
+              "schema": {
+                "$ref": "#/components/schemas/DismissDuplicatesRequestBody"
+              }
+            }
+          }
+        },
+        "responses": {
+          "200": {
+            "description": "Flags cleared",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/DismissDuplicatesResponse"
+                }
+              }
+            }
+          }
+        }
+      }
+    },
     "/v1/uniqueness-criteria": {
       "get": {
         "operationId": "listUniquenessCriteria",
@@ -329,10 +358,19 @@
         "minItems": 1
       },
       "DeduplicateRequestResponse": {
-        "type": "array",
-        "items": {
-          "$ref": "#/components/schemas/Entity"
-        }
+        "type": "object",
+        "properties": {
+          "deduplicatedEntities": {
+            "type": "array",
+            "items": {
+              "$ref": "#/components/schemas/Entity"
+            },
+            "description": "The merged survivor entity of each processed set"
+          }
+        },
+        "required": [
+          "deduplicatedEntities"
+        ]
       },
       "Entity": {
         "type": "object",
@@ -557,6 +595,44 @@
           "matched_attributes"
         ]
       },
+      "DismissDuplicatesRequestBody": {
+        "type": "object",
+        "properties": {
+          "schema": {
+            "type": "string",
+            "minLength": 1
+          },
+          "entityIds": {
+            "type": "array",
+            "items": {
+              "type": "string",
+              "minLength": 1
+            },
+            "minItems": 1,
+            "maxItems": 100,
+            "description": "Entities whose duplicate flags (_matching_entities) are cleared — the records are confirmed as NOT duplicates and stay separate"
+          }
+        },
+        "required": [
+          "schema",
+          "entityIds"
+        ]
+      },
+      "DismissDuplicatesResponse": {
+        "type": "object",
+        "properties": {
+          "dismissed": {
+            "type": "array",
+            "items": {
+              "type": "string"
+            },
+            "description": "Entity ids whose duplicate flags were cleared"
+          }
+        },
+        "required": [
+          "dismissed"
+        ]
+      },
       "UniquenessCriteriaListResponse": {
         "type": "object",
         "properties": {

package/definitions/design.json

@@ -302,6 +302,71 @@
         }
       }
     },
+    "/v1/designs/{designId}/duplicate": {
+      "post": {
+        "operationId": "duplicateDesign",
+        "summary": "duplicateDesign",
+        "description": "Duplicate an existing design owned by the user organization. The copy carries over the style, custom CSS and name (marked as a copy) but does NOT carry over journey/portal relations, so the new design starts with 0 consumers, exactly like a freshly created design.",
+        "tags": [
+          "design-builder"
+        ],
+        "parameters": [
+          {
+            "in": "path",
+            "name": "designId",
+            "required": true,
+            "schema": {
+              "$ref": "#/components/schemas/DesignId"
+            }
+          }
+        ],
+        "responses": {
+          "201": {
+            "description": "Success - design duplicated with success.",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/AddDesignRes"
+                }
+              }
+            }
+          },
+          "400": {
+            "description": "Validation Errors",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ErrorResp"
+                }
+              }
+            }
+          },
+          "401": {
+            "description": "Authentication Errors",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ErrorResp"
+                }
+              }
+            }
+          },
+          "404": {
+            "description": "No design found"
+          },
+          "500": {
+            "description": "Other errors",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ErrorResp"
+                }
+              }
+            }
+          }
+        }
+      }
+    },
     "/v1/designs/{designId}/parse": {
       "get": {
         "operationId": "getThemeFromDesign",

package/definitions/integration-toolkit.json

@@ -2,7 +2,7 @@
   "openapi": "3.0.3",
   "info": {
     "title": "Integration Toolkit API",
-    "version": "1.7.0",
+    "version": "1.8.0",
     "description": "API for integrating with external systems in a standardised way."
   },
   "tags": [
@@ -2075,7 +2075,7 @@
     "/v2/integrations/{integrationId}/use-cases/{useCaseId}/secure-proxy-whitelist": {
       "get": {
         "operationId": "getSecureProxyWhitelist",
-        "summary": "Get secure_proxy whitelist (admin portal only)",
+        "summary": "getSecureProxyWhitelist",
         "description": "Returns the current allowed_domains, allowed_ips, and vpc_mode for a secure_proxy use case.\nStaff-only — gated by internal-auth issuer AND admin-portal Cognito user pool membership.\nRejects Login-As tokens.\n",
         "tags": [
           "integrations",
@@ -2135,7 +2135,7 @@
       },
       "put": {
         "operationId": "updateSecureProxyWhitelist",
-        "summary": "Update secure_proxy whitelist (admin portal only)",
+        "summary": "updateSecureProxyWhitelist",
         "description": "Replaces allowed_domains and/or allowed_ips on a secure_proxy use case.\nAt least one of the two fields is required. Validation mirrors the CLI's\n`validateDomainPatterns` / `validateCidrs`. Writes a USECASE_HISTORY row\nwith the admin user's email as `changed_by`.\n\nUpdate semantics per field:\n  - **omitted** — field is not modified; the stored value is preserved.\n  - **non-empty array** — the stored value is replaced with the supplied list.\n  - **empty array (`[]`)** — the list is cleared (stored as `[]`). This is\n    the canonical way to remove all entries. `null` is not accepted.\n\nStaff-only — same auth gates as GET.\n",
         "tags": [
           "integrations",
@@ -2207,7 +2207,7 @@
     "/v2/integrations/{integrationId}/use-cases/{useCaseId}/secure-proxy-whitelist/history": {
       "get": {
         "operationId": "listSecureProxyWhitelistHistory",
-        "summary": "List secure_proxy whitelist change history (admin portal only)",
+        "summary": "listSecureProxyWhitelistHistory",
         "description": "Returns the most recent USECASE_HISTORY entries for a secure_proxy use case,\nin reverse chronological order (newest first). Each entry includes the\nactor email (`changed_by`), the ISO-8601 timestamp (`history_created_at`),\nthe `change_description` (free-text action), and the full `configuration`\nsnapshot — from which UI-08 computes a before/after diff between consecutive\nentries.\n\nStaff-only — gated by internal-auth issuer AND admin-portal Cognito user pool\nmembership. Rejects Login-As tokens (same auth gate as the GET / PUT\nsecure-proxy-whitelist operations).\n\nThin wrapper over the service-layer `listUseCaseHistory` that powers\n`GET /v1/integrations/{integrationId}/use-cases/{useCaseId}/history` — the\nseparate path exists because the /v1 variant is tenant-gated and admin-portal\ninternal-auth tokens do not carry tenant permissions.\n",
         "tags": [
           "integrations",
@@ -3357,7 +3357,7 @@
     "/v1/integrations/secure-proxies": {
       "get": {
         "operationId": "listSecureProxies",
-        "summary": "List all secure proxy use cases",
+        "summary": "listSecureProxies",
         "description": "Lists all secure_proxy use cases across all integrations for the authenticated organization.\nReturns minimal data suitable for dropdowns and selection UIs.\n",
         "tags": [
           "integrations"
@@ -3401,7 +3401,7 @@
     "/v1/secure-proxy": {
       "post": {
         "operationId": "secureProxy",
-        "summary": "Proxy HTTP request through secure VPC",
+        "summary": "secureProxy",
         "description": "Routes an HTTP request through a VPC with either static IP egress or VPN secure link access.\nThe VPC mode is determined by the referenced secure_proxy use case configuration.\nFor secure_link mode, the target URL must match the use case's allowed_domains whitelist.\n",
         "tags": [
           "proxy"
@@ -3484,7 +3484,7 @@
     "/v1/managed-call/{slug}/execute": {
       "post": {
         "operationId": "managedCallExecute",
-        "summary": "Execute a managed call operation",
+        "summary": "managedCallExecute",
         "description": "Execute a managed call operation synchronously. The slug in the path acts as the RPC method name.\nCalls an external partner API with JSONata mapping on both request and response.\n",
         "tags": [
           "managed-call"
@@ -3573,7 +3573,7 @@
     "/v1/integrations/{integrationId}/generate-types-preview": {
       "post": {
         "operationId": "generateTypesPreview",
-        "summary": "Preview scaffolded types for a connector integration",
+        "summary": "generateTypesPreview",
         "description": "Analyses the JSONata mappings of all managed-call use cases in the integration and returns scaffolded type descriptors. The frontend uses these to show the type editor modal where developers fill in leaf types.\n",
         "tags": [
           "integrations"
@@ -3623,7 +3623,7 @@
     "/v1/integrations/{integrationId}/generate-types": {
       "post": {
         "operationId": "generateTypes",
-        "summary": "Generate a TypeScript npm package for a connector integration",
+        "summary": "generateTypes",
         "description": "Generates a complete TypeScript npm package with typed interfaces for all managed-call use cases. This is a stateless operation that does not persist any changes. Use the commit-types endpoint to lock configurations after review.\n",
         "tags": [
           "integrations"
@@ -3683,7 +3683,7 @@
     "/v1/integrations/{integrationId}/commit-types": {
       "post": {
         "operationId": "commitTypes",
-        "summary": "Commit generated types and lock use case configurations",
+        "summary": "commitTypes",
         "description": "Commits the generated types by locking use case configurations and updating version tracking. Should be called after the user reviews and downloads the generated package.\n",
         "tags": [
           "integrations"
@@ -6214,7 +6214,11 @@
           "change_description": {
             "type": "string",
             "maxLength": 2000,
-            "description": "Description of the last change made to this use case"
+            "description": "Reason given for the update that produced the current version. Absent when the update supplied none — it is not inherited from the previous version.\n"
+          },
+          "changed_by": {
+            "type": "string",
+            "description": "User ID recorded for the update that produced the current version. Absent when the update had no user context, e.g. an automated sync.\n"
           },
           "created_at": {
             "type": "string",
@@ -7928,6 +7932,20 @@
               "$ref": "#/components/schemas/MeterReadingUpdate"
             }
           },
+          "prune_scope_updates": {
+            "type": "array",
+            "description": "Resolved prune scopes produced by entity mappings using `upsert-prune-scope-purge` / `upsert-prune-scope-delete`. Each entry describes the entities that would be deleted at runtime because they exist in scope but were not part of this payload.",
+            "items": {
+              "$ref": "#/components/schemas/EntityPruneScopeUpdate"
+            }
+          },
+          "meter_readings_prune_scope_updates": {
+            "type": "array",
+            "description": "Resolved prune scopes produced by meter reading mappings using `upsert-prune-scope`. Each entry describes the readings that would be deleted at runtime for a meter (+ counter) because they were not part of this payload.",
+            "items": {
+              "$ref": "#/components/schemas/MeterReadingPruneScopeUpdate"
+            }
+          },
           "warnings": {
             "type": "array",
             "description": "Validation warnings about the configuration (e.g., unique_ids referencing non-indexed fields)",
@@ -7964,7 +7982,8 @@
         "required": [
           "entity_slug",
           "unique_identifiers",
-          "attributes"
+          "attributes",
+          "mode"
         ],
         "properties": {
           "entity_slug": {
@@ -7980,6 +7999,38 @@
             "type": "object",
             "description": "Mapped attribute values",
             "additionalProperties": true
+          },
+          "pricing": {
+            "type": "object",
+            "description": "Present when the entity mapping has a `pricing` block. Echoes the pricing configuration and the data extracted for it, so mapping authors can see what would be sent to the pricing service.",
+            "required": [
+              "config",
+              "data"
+            ],
+            "properties": {
+              "config": {
+                "type": "object",
+                "additionalProperties": true,
+                "description": "The pricing configuration from the entity mapping"
+              },
+              "data": {
+                "type": "array",
+                "description": "The pricing input data extracted from the payload",
+                "items": {
+                  "type": "object",
+                  "additionalProperties": true
+                }
+              }
+            }
+          },
+          "mode": {
+            "type": "string",
+            "enum": [
+              "upsert",
+              "delete",
+              "purge"
+            ],
+            "description": "Effective operation mode applied to this entity at runtime. `upsert-prune-scope-purge` / `upsert-prune-scope-delete` configurations report `upsert` here, because the individual entities in the payload are upserted — the destructive part of those modes is reported separately in `prune_scope_updates`. For `delete` / `purge`, `attributes` are still mapped and returned but ignored at runtime: only `unique_identifiers` are used to locate the entity to remove."
           }
         }
       },
@@ -7987,7 +8038,8 @@
         "type": "object",
         "required": [
           "meter",
-          "attributes"
+          "attributes",
+          "mode"
         ],
         "properties": {
           "meter": {
@@ -8017,6 +8069,121 @@
             "type": "object",
             "additionalProperties": true,
             "description": "Meter reading attributes. Required: external_id, timestamp, source, value. `timestamp` must be ISO 8601 — either `YYYY-MM-DD` or `YYYY-MM-DDTHH:mm:ss` (with optional fractional seconds and optional `Z` / `±HH:mm` timezone offset); non-ISO formats (e.g. `DD.MM.YYYY` or epoch numbers) are rejected and must be converted upstream via a `jsonataExpression` (e.g. `$fromMillis(...)`). Date-only values are normalized to midnight UTC and offset-less date-times are anchored to UTC before being forwarded to the metering API. `source` must be one of: ECP, ERP, 360, journey-submission. `reason` (optional) must be one of: regular, irregular, last, first, meter_change, contract_change, meter_adjustment (or empty/null)."
+          },
+          "mode": {
+            "type": "string",
+            "enum": [
+              "upsert",
+              "delete"
+            ],
+            "description": "Effective operation mode applied to this reading at runtime. `upsert-prune-scope` configurations report `upsert` here — their destructive part is reported separately in `meter_readings_prune_scope_updates`."
+          }
+        }
+      },
+      "EntityPruneScopeUpdate": {
+        "type": "object",
+        "description": "A resolved entity prune scope. At runtime, entities of `entity_slug` found within `scope` whose unique identifiers are not listed in `keep_unique_ids` are removed using `deletion_mode`.",
+        "required": [
+          "entity_slug",
+          "scope",
+          "keep_unique_ids",
+          "deletion_mode"
+        ],
+        "properties": {
+          "entity_slug": {
+            "type": "string",
+            "description": "The entity type that would be pruned"
+          },
+          "scope": {
+            "type": "object",
+            "description": "The scope configuration resolved against the payload",
+            "required": [
+              "scope_mode"
+            ],
+            "properties": {
+              "scope_mode": {
+                "type": "string",
+                "enum": [
+                  "relations",
+                  "query"
+                ],
+                "description": "How the entities in scope are found"
+              },
+              "schema": {
+                "type": "string",
+                "description": "Schema of the related entity defining the scope (`relations` scope_mode only)"
+              },
+              "unique_ids": {
+                "type": "object",
+                "additionalProperties": true,
+                "description": "Resolved unique identifiers of the related scope entity (`relations` scope_mode only)"
+              },
+              "query": {
+                "type": "object",
+                "additionalProperties": true,
+                "description": "Resolved query parameters used to find entities in scope (`query` scope_mode only)"
+              }
+            }
+          },
+          "keep_unique_ids": {
+            "type": "array",
+            "description": "Unique identifiers of the entities upserted by this payload. Everything else found in scope would be deleted.",
+            "items": {
+              "type": "object",
+              "additionalProperties": true
+            }
+          },
+          "deletion_mode": {
+            "type": "string",
+            "enum": [
+              "delete",
+              "purge"
+            ],
+            "description": "`delete` soft deletes the pruned entities, `purge` removes them permanently"
+          }
+        }
+      },
+      "MeterReadingPruneScopeUpdate": {
+        "type": "object",
+        "description": "A resolved meter reading prune scope. At runtime, readings of the given meter (+ counter) whose external ids are not listed in `keep_external_ids` are deleted.",
+        "required": [
+          "meter",
+          "keep_external_ids"
+        ],
+        "properties": {
+          "meter": {
+            "type": "object",
+            "required": [
+              "$entity_unique_ids"
+            ],
+            "properties": {
+              "$entity_unique_ids": {
+                "type": "object",
+                "additionalProperties": true,
+                "description": "Unique identifiers for the meter"
+              }
+            }
+          },
+          "meter_counter": {
+            "type": "object",
+            "properties": {
+              "$entity_unique_ids": {
+                "type": "object",
+                "additionalProperties": true,
+                "description": "Unique identifiers for the meter counter"
+              }
+            }
+          },
+          "keep_external_ids": {
+            "type": "array",
+            "description": "External ids of the readings present in this payload. All other readings in scope would be deleted. An empty array means every reading in scope would be deleted.",
+            "items": {
+              "type": "string"
+            }
+          },
+          "source": {
+            "type": "string",
+            "description": "When set, only readings with this source are eligible for pruning (e.g. `ERP`)"
           }
         }
       },

package/dist/bin/epilot.js

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 import {
   API_LIST
-} from "../chunk-SOTT5WKJ.js";
+} from "../chunk-6BGA56QC.js";
 
 // bin/epilot.ts
 import { runMain } from "citty";
@@ -11,7 +11,7 @@ import { defineCommand } from "citty";
 var main = defineCommand({
   meta: {
     name: "epilot",
-    version: "0.1.95",
+    version: "0.1.97",
     description: "CLI for epilot APIs"
   },
   args: {
@@ -30,8 +30,8 @@ var main = defineCommand({
     auth: () => import("../auth-WMXFMPWE.js").then((m) => m.default),
     profile: () => import("../profile-OZJL5ZPT.js").then((m) => m.default),
     config: () => import("../config-DGZIMLZK.js").then((m) => m.default),
-    completion: () => import("../completion-IGVIBAFM.js").then((m) => m.default),
-    upgrade: () => import("../upgrade-W43OKEIV.js").then((m) => m.default),
+    completion: () => import("../completion-6JGII43G.js").then((m) => m.default),
+    upgrade: () => import("../upgrade-3IF3ARUQ.js").then((m) => m.default),
     "access-token": () => import("../access-token-WWE6BDJH.js").then((m) => m.default),
     address: () => import("../address-EH3C4CVB.js").then((m) => m.default),
     "address-suggestions": () => import("../address-suggestions-RRSLOBFW.js").then((m) => m.default),
@@ -134,13 +134,13 @@ process.stderr.on("error", (err) => {
   if (err.code === "EPIPE") process.exit(0);
   throw err;
 });
-var VERSION = true ? "0.1.95" : (await null).default.version;
+var VERSION = true ? "0.1.97" : (await null).default.version;
 var reorderedArgv = hoistFlagsAfterSubcommand(process.argv.slice(2));
 process.argv = [process.argv[0], process.argv[1], ...reorderedArgv];
 var args = process.argv.slice(2);
 var completionsIdx = args.indexOf("--_completions");
 if (completionsIdx >= 0) {
-  const { handleCompletions } = await import("../completion-IGVIBAFM.js");
+  const { handleCompletions } = await import("../completion-6JGII43G.js");
   handleCompletions(args[completionsIdx + 1], args[completionsIdx + 2]);
   process.exit(0);
 }

package/dist/{chunk-SOTT5WKJ.js → chunk-6BGA56QC.js}

@@ -519,12 +519,13 @@ var API_LIST = [
     kebabName: "deduplication",
     title: "Deduplication API",
     serverUrl: "https://deduplication.sls.epilot.io",
-    operationCount: 9,
+    operationCount: 10,
     operationIds: [
       "deduplicate",
       "deduplicateAsync",
       "getDeduplicationJob",
       "detectDuplicates",
+      "dismissDuplicates",
       "listUniquenessCriteria",
       "createUniquenessCriteria",
       "getUniquenessCriteria",
@@ -537,13 +538,14 @@ var API_LIST = [
     kebabName: "design",
     title: "Design Builder API v2",
     serverUrl: "https://design-builder-api.sls.epilot.io",
-    operationCount: 13,
+    operationCount: 14,
     operationIds: [
       "getAllDesigns",
       "addDesign",
       "getDesign",
       "updateDesign",
       "deleteDesign",
+      "duplicateDesign",
       "getThemeFromDesign",
       "getFiles",
       "uploadFile",

package/dist/{completion-IGVIBAFM.js → completion-6JGII43G.js}

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 import {
   API_LIST
-} from "./chunk-SOTT5WKJ.js";
+} from "./chunk-6BGA56QC.js";
 import {
   DIM,
   GREEN,

package/dist/{upgrade-W43OKEIV.js → upgrade-3IF3ARUQ.js}

@@ -72,7 +72,7 @@ ${GREEN}${BOLD}Upgraded to @epilot/cli@${latest}${RESET}
   }
 });
 var getCurrentVersion = () => {
-  if (true) return "0.1.95";
+  if (true) return "0.1.97";
   try {
     const output = execSync("npm ls -g @epilot/cli --depth=0 --json 2>/dev/null", {
       encoding: "utf-8",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@epilot/cli",
-  "version": "0.1.95",
+  "version": "0.1.97",
   "description": "CLI for epilot APIs",
   "type": "module",
   "bin": {