@epilot/cli 0.1.67 → 0.1.68

package/README.md

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

package/definitions/event-catalog.json

@@ -593,6 +593,23 @@
             "description": "Whether this event can be explicitly triggered by automations.\nWhen true, the event will appear in the automation builder as a\n\"Trigger Event\" action option.\nDefaults to false if not specified.\n",
             "default": false,
             "example": true
+          },
+          "success_criteria": {
+            "type": "array",
+            "description": "Org-defined success criteria for this event: the entity attributes that an\norganization considers must be captured for an event change request to be\ntreated as complete (e.g. for telephony / self-service flows).\n\nAdvisory metadata — event-catalog does NOT require an org to define any and\ndoes NOT enforce them when an event is triggered or published. The org may\ndefine none (empty array or omitted). When provided, each entry is validated\nfor well-formedness on write (see SuccessCriterion).\n",
+            "items": {
+              "$ref": "#/components/schemas/SuccessCriterion"
+            },
+            "example": [
+              {
+                "entity_schema": "contract",
+                "attribute": "installment_amount"
+              },
+              {
+                "entity_schema": "billing_account",
+                "attribute": "due_date"
+              }
+            ]
           }
         }
       },
@@ -613,7 +630,7 @@
         ]
       },
       "UpdateEventPayload": {
-        "description": "Payload for updating an event configuration.\nAccepts the same fields as EventConfig (all optional for PATCH).\nCurrently `enabled` and `auto_trigger` fields are processed.\n",
+        "description": "Payload for updating an event configuration.\nAccepts the same fields as EventConfig (all optional for PATCH).\nCurrently `enabled`, `auto_trigger` and `success_criteria` fields are processed.\n",
         "allOf": [
           {
             "$ref": "#/components/schemas/EventConfigBase"
@@ -696,6 +713,26 @@
           }
         ]
       },
+      "SuccessCriterion": {
+        "type": "object",
+        "description": "A single org-defined success criterion: an entity attribute that must be captured\nfor this event's change request to be considered complete.\n\nIdentity is the entity schema plus the attribute name — mirroring the\nEntityOperationTrigger `schema`/`attribute` vocabulary. On write (PATCH), both\n`attribute` and `entity_schema` are required and `entity_schema` must match the\n`schema` of a node in the event's `entity_graph` (else the request is rejected) —\nthis prevents unsatisfiable criteria. The criteria themselves are advisory and are\nnever enforced when an event is triggered or published.\n",
+        "properties": {
+          "entity_schema": {
+            "type": "string",
+            "description": "Entity schema slug the attribute belongs to (matches a node schema in the event's entity_graph).",
+            "example": "contract"
+          },
+          "attribute": {
+            "type": "string",
+            "description": "Attribute name on the entity schema.",
+            "example": "installment_amount"
+          }
+        },
+        "required": [
+          "entity_schema",
+          "attribute"
+        ]
+      },
       "CommonEventMetadata": {
         "type": "object",
         "description": "Common metadata fields present in all event payloads",
@@ -878,6 +915,24 @@
           ]
         }
       },
+      "InlineDowngradeStep": {
+        "type": "object",
+        "description": "One step of an event's inline `_downgrades` chain. Maps the current-version payload to the previous version via a JSONata expression. Stamped by Event Catalog at publish time; executed by consumers during walk-back, never by EC itself.",
+        "properties": {
+          "to": {
+            "type": "string",
+            "description": "Version label this step downgrades to (the previous version)."
+          },
+          "jsonata": {
+            "type": "string",
+            "description": "JSONata expression mapping the current-shape payload to the previous-shape payload."
+          }
+        },
+        "required": [
+          "to",
+          "jsonata"
+        ]
+      },
       "Event": {
         "type": "object",
         "description": "An event instance in the event history",
@@ -920,6 +975,13 @@
           "_ack_id": {
             "type": "string",
             "description": "Unique acknowledgment tracking ID for the event.\nUsed to track event delivery and processing status.\n"
+          },
+          "_downgrades": {
+            "type": "array",
+            "description": "Inline downgrade chain stamped by Event Catalog at publish time, ordered newest-to-oldest. Present ONLY on multi-version events. Internal versioning transport: consumers (e.g. svc-webhooks) walk the payload back to a pinned version using these JSONata steps, then strip the field before delivery -- end customers never receive it.",
+            "items": {
+              "$ref": "#/components/schemas/InlineDowngradeStep"
+            }
           }
         },
         "required": [

package/definitions/integration-toolkit.json

@@ -2,7 +2,7 @@
   "openapi": "3.0.3",
   "info": {
     "title": "Integration Toolkit API",
-    "version": "1.5.3",
+    "version": "1.5.5",
     "description": "API for integrating with external systems in a standardised way."
   },
   "tags": [
@@ -1876,11 +1876,10 @@
             "name": "limit",
             "in": "query",
             "required": false,
-            "description": "Maximum number of items to return (clamped to 100).",
+            "description": "Requested number of items to return. Values above 100 are accepted and clamped server-side to 100 (the enforcement point is the handler, not this schema), so a large value never 400s at the contract layer.",
             "schema": {
               "type": "integer",
               "minimum": 1,
-              "maximum": 100,
               "default": 50
             }
           },
@@ -4645,16 +4644,15 @@
       },
       "NotificationRule": {
         "type": "object",
-        "description": "A single notification rule. Only the params relevant to a given type are set. The id is a server-minted ULID, preserved across edits.",
+        "description": "A single notification rule. Only the params relevant to a given type are set. The id is optional on write: the server mints a ULID when omitted and preserves a supplied id verbatim (a stable id keeps a rule's AlertState across config saves).",
         "required": [
-          "id",
           "type",
           "enabled"
         ],
         "properties": {
           "id": {
             "type": "string",
-            "description": "Stable server-minted ULID. AlertState + baseline key."
+            "description": "Stable AlertState + baseline key. Optional on write — the server mints a ULID when omitted; a supplied id is preserved verbatim."
           },
           "name": {
             "type": "string",
@@ -4662,20 +4660,14 @@
           },
           "type": {
             "type": "string",
-            "description": "Rule trigger type. V1 produces the first six; the remaining values are deferred (V2) catalog types accepted by the data model but not produced by any V1 producer.",
+            "description": "Rule trigger type. These are the only supported types; each is produced by a real alerter.",
             "enum": [
               "critical_error",
               "error_threshold",
               "warning_threshold",
               "success_rate_drop",
               "recovery",
-              "silence",
-              "consecutive_failures",
-              "first_error",
-              "new_error_code",
-              "auth_expiry",
-              "ack_timeout",
-              "validation_surge"
+              "silence"
             ]
           },
           "enabled": {
@@ -4726,10 +4718,6 @@
             "type": "integer",
             "description": "success_rate_drop minimum sample size guard."
           },
-          "consecutive": {
-            "type": "integer",
-            "description": "consecutive_failures count."
-          },
           "quietPeriod": {
             "type": "string",
             "description": "silence quiet period, e.g. '12h'."
@@ -7082,6 +7070,11 @@
           },
           "response": {
             "$ref": "#/components/schemas/FileProxyResponseConfig"
+          },
+          "prevent_indirect_serving": {
+            "type": "boolean",
+            "default": false,
+            "description": "When `true`, files that are too large to be served directly in the proxy response\n(and would otherwise be served indirectly via a temporary S3 redirect) are not served.\nInstead the proxy responds with an error and logs a warning. Use this when files must\nnever transit epilot's temporary S3 storage. Defaults to `false` (large files are\ntransparently served via S3).\n"
           }
         }
       },
@@ -9366,7 +9359,21 @@
               "managed_call",
               "secure_proxy"
             ],
-            "description": "Filter stats by use case type"
+            "description": "Filter stats by a single use case type"
+          },
+          "use_case_types": {
+            "type": "array",
+            "items": {
+              "type": "string",
+              "enum": [
+                "inbound",
+                "outbound",
+                "file_proxy",
+                "managed_call",
+                "secure_proxy"
+              ]
+            },
+            "description": "Filter stats to this set of use case types (matches any). Takes precedence over `use_case_type` when both are present. Used by the notification producers to scope alerts/digests to the integration's `monitoredUseCases`."
           },
           "group_by": {
             "type": "string",

package/definitions/metering.json

@@ -2,7 +2,7 @@
   "openapi": "3.0.3",
   "info": {
     "title": "Metering API",
-    "version": "1.0.0",
+    "version": "1.1.0",
     "description": "The Metering API manages smart meter data, meter counters, and meter readings for epilot customers and administrators.\n\nIt supports two audiences:\n- **ECP (End Customer Portal)**: Portal users can view their meters, counters, and submit readings via the customer portal.\n- **ECP Admin**: Internal epilot users and ERP integrations can create, update, and bulk-manage meter readings.\n\nKey capabilities:\n- Retrieve meters and counters associated with a customer or contract\n- Submit individual or bulk meter readings (with optional validation skip)\n- Batch upsert/delete readings using the v2 endpoint\n- Query historical readings by date interval with cumulative or relative consumption modes\n- Retrieve allowed reading ranges to guide end customers entering readings\n"
   },
   "tags": [
@@ -554,6 +554,9 @@
           },
           {
             "$ref": "#/components/parameters/DirectQueryParam"
+          },
+          {
+            "$ref": "#/components/parameters/CreateTicketQueryParam"
           }
         ],
         "requestBody": {
@@ -722,6 +725,9 @@
           },
           {
             "$ref": "#/components/parameters/DirectQueryParam"
+          },
+          {
+            "$ref": "#/components/parameters/CreateTicketQueryParam"
           }
         ],
         "requestBody": {
@@ -2969,6 +2975,16 @@
           "$ref": "#/components/schemas/ActivityId"
         }
       },
+      "CreateTicketQueryParam": {
+        "name": "create_ticket",
+        "in": "query",
+        "required": false,
+        "description": "Controls whether a manual-intervention (\"Übermittlung Zählerstand\") ticket is created for the\nwritten readings. Defaults to true, preserving portal/journey behaviour (readings with\nsource ECP or journey-submission mint a review ticket).\n\nSet to false for authoritative, system-driven writes — e.g. the ERP inbound integration\npipeline — whose readings arrive already confirmed and must not spawn a review ticket. This\nalso prevents the ticket-triggered `ServiceMeterReadingAdded` echo back to the ERP.\n",
+        "schema": {
+          "type": "boolean",
+          "default": true
+        }
+      },
       "SkipValidationQueryParam": {
         "name": "skip_validation",
         "in": "query",
@@ -2981,5 +2997,9 @@
       }
     }
   },
-  "servers": []
+  "servers": [
+    {
+      "url": "https://metering.sls.epilot.io"
+    }
+  ]
 }

package/definitions/notification.json

@@ -1013,6 +1013,20 @@
                 "in_app": false
               }
             }
+          },
+          "allowed_channels": {
+            "description": "Optional delivery-channel ceiling. When present, delivery is restricted to the intersection of this set and each recipient's own notification preferences — it can only NARROW delivery, never force a channel on. Absent means no restriction (recipient preferences and per-type defaults apply as before). An empty array suppresses all channels.",
+            "type": "array",
+            "items": {
+              "type": "string",
+              "enum": [
+                "email",
+                "in_app"
+              ]
+            },
+            "example": [
+              "in_app"
+            ]
           }
         },
         "required": [

package/dist/bin/epilot.js

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 import {
   API_LIST
-} from "../chunk-6TKZSKWB.js";
+} from "../chunk-HIU6WP36.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.67",
+    version: "0.1.68",
     description: "CLI for epilot APIs"
   },
   args: {
@@ -30,8 +30,8 @@ var main = defineCommand({
     auth: () => import("../auth-4HG7B2GC.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-BZQQTKHB.js").then((m) => m.default),
-    upgrade: () => import("../upgrade-3AUH2MLE.js").then((m) => m.default),
+    completion: () => import("../completion-7FZ4RKFG.js").then((m) => m.default),
+    upgrade: () => import("../upgrade-M6TGNG6M.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.67" : (await null).default.version;
+var VERSION = true ? "0.1.68" : (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-BZQQTKHB.js");
+  const { handleCompletions } = await import("../completion-7FZ4RKFG.js");
   handleCompletions(args[completionsIdx + 1], args[completionsIdx + 2]);
   process.exit(0);
 }

package/dist/{chunk-6TKZSKWB.js → chunk-HIU6WP36.js}

@@ -944,7 +944,7 @@ var API_LIST = [
     apiName: "metering",
     kebabName: "metering",
     title: "Metering API",
-    serverUrl: "",
+    serverUrl: "https://metering.sls.epilot.io",
     operationCount: 20,
     operationIds: [
       "getCustomerMeters",

package/dist/{completion-BZQQTKHB.js → completion-7FZ4RKFG.js}

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

package/dist/{upgrade-3AUH2MLE.js → upgrade-M6TGNG6M.js}

@@ -72,7 +72,7 @@ ${GREEN}${BOLD}Upgraded to @epilot/cli@${latest}${RESET}
   }
 });
 var getCurrentVersion = () => {
-  if (true) return "0.1.67";
+  if (true) return "0.1.68";
   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.67",
+  "version": "0.1.68",
   "description": "CLI for epilot APIs",
   "type": "module",
   "bin": {