@epilot/cli 0.1.151 → 0.1.152

package/README.md

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

package/definitions/file.json

@@ -124,6 +124,9 @@
           "401": {
             "$ref": "#/components/responses/UnauthorizedError"
           },
+          "422": {
+            "$ref": "#/components/responses/UnprocessableEntityError"
+          },
           "500": {
             "$ref": "#/components/responses/InternalServerError"
           }
@@ -281,6 +284,9 @@
           "404": {
             "$ref": "#/components/responses/NotFoundError"
           },
+          "422": {
+            "$ref": "#/components/responses/UnprocessableEntityError"
+          },
           "500": {
             "$ref": "#/components/responses/InternalServerError"
           }
@@ -366,6 +372,9 @@
           "401": {
             "$ref": "#/components/responses/UnauthorizedError"
           },
+          "422": {
+            "$ref": "#/components/responses/UnprocessableEntityError"
+          },
           "500": {
             "$ref": "#/components/responses/InternalServerError"
           }
@@ -431,6 +440,9 @@
           "401": {
             "$ref": "#/components/responses/UnauthorizedError"
           },
+          "422": {
+            "$ref": "#/components/responses/UnprocessableEntityError"
+          },
           "500": {
             "$ref": "#/components/responses/InternalServerError"
           }
@@ -1297,6 +1309,73 @@
         }
       }
     },
+    "/v1/files/validations": {
+      "post": {
+        "operationId": "validateFile",
+        "summary": "validateFile",
+        "description": "Validate an uploaded file against one or more document validation rules\n(validation-rules-api rules with `input_type: document`).\n\nThe file is referenced either by its file entity id or, for an upload that has not been\nsaved as an entity yet (e.g. a journey upload in the temporary prefix), by its S3 reference.\nThe service collects an observation of the file - deterministic facts such as the sniffed\nmime type, size, page count, image resolution, blank and password-protection detection -\nand evaluates every rule against it with the shared validation rules engine.\n\nThe response carries one result per rule with a per-condition outcome (`pass`, `fail`,\n`uncertain`, `skipped`), plus the observation the results were derived from. `status` is\n`completed` for checks that finish synchronously; `pending` is reserved for check levels\nthat need asynchronous content extraction.\n",
+        "tags": [
+          "File"
+        ],
+        "requestBody": {
+          "required": true,
+          "content": {
+            "application/json": {
+              "schema": {
+                "$ref": "#/components/schemas/FileValidationRequest"
+              }
+            }
+          }
+        },
+        "responses": {
+          "200": {
+            "description": "The validation result",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/FileValidation"
+                }
+              }
+            }
+          },
+          "400": {
+            "$ref": "#/components/responses/BadRequestError"
+          },
+          "401": {
+            "$ref": "#/components/responses/UnauthorizedError"
+          },
+          "403": {
+            "$ref": "#/components/responses/ForbiddenError"
+          },
+          "404": {
+            "$ref": "#/components/responses/NotFoundError"
+          },
+          "413": {
+            "description": "The file is too large to validate",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ErrorObject"
+                }
+              }
+            }
+          },
+          "422": {
+            "description": "The file could not be read",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ErrorObject"
+                }
+              }
+            }
+          },
+          "500": {
+            "$ref": "#/components/responses/InternalServerError"
+          }
+        }
+      }
+    },
     "/v1/files/{id}/preview": {
       "get": {
         "operationId": "previewFile",
@@ -2090,6 +2169,9 @@
           "400": {
             "$ref": "#/components/responses/BadRequestError"
           },
+          "422": {
+            "$ref": "#/components/responses/UnprocessableEntityError"
+          },
           "500": {
             "$ref": "#/components/responses/InternalServerError"
           }
@@ -2806,6 +2888,296 @@
         ],
         "readOnly": true
       },
+      "FileValidationRequest": {
+        "type": "object",
+        "required": [
+          "file",
+          "rule_ids"
+        ],
+        "additionalProperties": false,
+        "properties": {
+          "file": {
+            "$ref": "#/components/schemas/FileValidationFileReference"
+          },
+          "rule_ids": {
+            "type": "array",
+            "description": "Document validation rules to evaluate. Rules of another input type are rejected.",
+            "minItems": 1,
+            "maxItems": 10,
+            "uniqueItems": true,
+            "items": {
+              "type": "string",
+              "minLength": 1
+            }
+          }
+        }
+      },
+      "FileValidationFileReference": {
+        "description": "The file to validate - a saved file entity, or an uploaded object not saved as an entity yet.",
+        "oneOf": [
+          {
+            "type": "object",
+            "required": [
+              "entity_id"
+            ],
+            "additionalProperties": false,
+            "properties": {
+              "entity_id": {
+                "$ref": "#/components/schemas/FileEntityId"
+              }
+            }
+          },
+          {
+            "type": "object",
+            "required": [
+              "s3ref"
+            ],
+            "additionalProperties": false,
+            "properties": {
+              "s3ref": {
+                "$ref": "#/components/schemas/S3Ref"
+              }
+            }
+          }
+        ]
+      },
+      "FileValidation": {
+        "type": "object",
+        "required": [
+          "id",
+          "status",
+          "file",
+          "observation",
+          "results",
+          "created_at"
+        ],
+        "properties": {
+          "id": {
+            "type": "string",
+            "description": "Identifier of this validation run."
+          },
+          "status": {
+            "type": "string",
+            "enum": [
+              "completed",
+              "pending",
+              "failed"
+            ],
+            "description": "`completed` when every rule was evaluated. `pending` is reserved for check levels that\nneed asynchronous content extraction; `failed` when the observation could not be produced.\n"
+          },
+          "file": {
+            "$ref": "#/components/schemas/FileValidationFile"
+          },
+          "observation": {
+            "$ref": "#/components/schemas/FileValidationObservation"
+          },
+          "results": {
+            "type": "array",
+            "items": {
+              "$ref": "#/components/schemas/FileValidationRuleResult"
+            }
+          },
+          "created_at": {
+            "type": "string",
+            "format": "date-time"
+          }
+        }
+      },
+      "FileValidationFile": {
+        "type": "object",
+        "description": "The file that was validated, with the identity facts collected from its content.",
+        "properties": {
+          "entity_id": {
+            "$ref": "#/components/schemas/FileEntityId"
+          },
+          "s3ref": {
+            "$ref": "#/components/schemas/S3Ref"
+          },
+          "filename": {
+            "type": "string"
+          },
+          "mime_type": {
+            "type": "string",
+            "description": "Mime type detected from the file content, falling back to the declared type."
+          },
+          "size_bytes": {
+            "type": "integer"
+          }
+        }
+      },
+      "FileValidationObservation": {
+        "type": "object",
+        "description": "Everything observed about the file, as passed to the validation rules engine.",
+        "required": [
+          "facts"
+        ],
+        "properties": {
+          "facts": {
+            "$ref": "#/components/schemas/FileValidationFacts"
+          },
+          "judgements": {
+            "type": "object",
+            "description": "Content judgements keyed by condition id, produced by the document requirements\ncheck for `meetsCriteria` conditions at the `standard` and `advanced` levels.\nAbsent when no content check ran (basic level, unsupported file, or the check\ndid not finish within its budget).\n",
+            "additionalProperties": {
+              "$ref": "#/components/schemas/FileValidationJudgement"
+            }
+          },
+          "document_type": {
+            "type": "object",
+            "description": "Document type detected by the content check, when it ran.",
+            "properties": {
+              "slug": {
+                "type": "string"
+              },
+              "confidence": {
+                "type": "number"
+              }
+            }
+          }
+        }
+      },
+      "FileValidationJudgement": {
+        "type": "object",
+        "required": [
+          "result"
+        ],
+        "properties": {
+          "result": {
+            "type": "string",
+            "enum": [
+              "pass",
+              "fail",
+              "uncertain"
+            ]
+          },
+          "confidence": {
+            "type": "number"
+          },
+          "evidence": {
+            "type": "string"
+          },
+          "explanation": {
+            "type": "string"
+          }
+        }
+      },
+      "FileValidationFacts": {
+        "type": "object",
+        "description": "Deterministic properties of the file. A property that is absent could not be determined\n(for example the resolution of an image the service cannot decode); conditions that need it\nare skipped rather than failed.\n",
+        "properties": {
+          "mime_type": {
+            "type": "string"
+          },
+          "size_bytes": {
+            "type": "integer"
+          },
+          "page_count": {
+            "type": "integer",
+            "description": "Pages of a PDF; 1 for images."
+          },
+          "longer_edge_px": {
+            "type": "integer",
+            "description": "Longer edge of an image in pixels."
+          },
+          "is_blank": {
+            "type": "boolean"
+          },
+          "is_password_protected": {
+            "type": "boolean"
+          }
+        }
+      },
+      "FileValidationRuleResult": {
+        "type": "object",
+        "required": [
+          "rule_id",
+          "level",
+          "is_valid",
+          "conditions"
+        ],
+        "properties": {
+          "rule_id": {
+            "type": "string"
+          },
+          "rule_title": {
+            "type": "string"
+          },
+          "level": {
+            "type": "string",
+            "enum": [
+              "basic",
+              "standard",
+              "advanced"
+            ],
+            "description": "The rule's check level."
+          },
+          "is_valid": {
+            "type": "boolean",
+            "description": "True when every blocking condition passed or was skipped."
+          },
+          "failed_parts": {
+            "type": "array",
+            "description": "Error messages of blocking conditions that failed.",
+            "items": {
+              "type": "string"
+            }
+          },
+          "warnings": {
+            "type": "array",
+            "description": "Error messages of advisory conditions that failed and of uncertain judgements.",
+            "items": {
+              "type": "string"
+            }
+          },
+          "conditions": {
+            "type": "array",
+            "items": {
+              "$ref": "#/components/schemas/FileValidationConditionResult"
+            }
+          }
+        }
+      },
+      "FileValidationConditionResult": {
+        "type": "object",
+        "required": [
+          "id",
+          "operator",
+          "outcome",
+          "blocking",
+          "message"
+        ],
+        "properties": {
+          "id": {
+            "type": "string"
+          },
+          "operator": {
+            "type": "string"
+          },
+          "outcome": {
+            "type": "string",
+            "enum": [
+              "pass",
+              "fail",
+              "uncertain",
+              "skipped"
+            ]
+          },
+          "blocking": {
+            "type": "boolean",
+            "description": "True when this outcome makes the file invalid."
+          },
+          "message": {
+            "type": "string",
+            "description": "The condition's configured error message."
+          },
+          "evidence": {
+            "type": "string"
+          },
+          "explanation": {
+            "type": "string"
+          }
+        }
+      },
       "FileText": {
         "type": "object",
         "properties": {
@@ -3795,6 +4167,26 @@
           }
         }
       },
+      "UnprocessableEntityError": {
+        "description": "The request was well-formed but the file's type or content is not acceptable",
+        "content": {
+          "application/json": {
+            "schema": {
+              "allOf": [
+                {
+                  "$ref": "#/components/schemas/ErrorObject"
+                },
+                {
+                  "example": {
+                    "status": 422,
+                    "error": "File type not allowed"
+                  }
+                }
+              ]
+            }
+          }
+        }
+      },
       "UnauthorizedError": {
         "description": "Authentication required or invalid credentials",
         "content": {

package/definitions/journey.json

@@ -3,7 +3,7 @@
   "info": {
     "title": "Journey API",
     "description": "API to configure journeys",
-    "version": "1.4.3"
+    "version": "1.5.0"
   },
   "security": [
     {
@@ -117,7 +117,7 @@
           {
             "name": "version",
             "in": "query",
-            "description": "DynamoDB version to fetch. `0` (default) is the live row; positive integers are historical snapshots created on each save. Note: this is distinct from the `revisions` counter on the row body.\n",
+            "description": "Revision row to read. `0` (default) is the journey record, the published version every customer receives; a positive integer `n` reads revision row `n` (used by config-engine for history reads). Distinct from the `revisions` counter on the body, which is the legacy change counter of the published version. Versioning metadata is only available via `publish-state`.\n",
             "required": false,
             "schema": {
               "type": "integer",
@@ -207,6 +207,309 @@
         }
       }
     },
+    "/v1/journey/configuration/{id}/revisions": {
+      "post": {
+        "operationId": "createJourneyRevision",
+        "summary": "createJourneyRevision",
+        "description": "Creates a revision: an immutable copy of the complete journey configuration, identified by `revision_id`. Nothing customers receive changes; the revision only becomes the published version when it is published. The payload is complete and is not merged against the journey record or the previous revision. The entity datasource set of the revision is stored separately through the datasources API under the same `revision_id`.\n\nOnly available for organizations with journey versioning enabled; returns `404` otherwise.\n",
+        "tags": [
+          "Journeys"
+        ],
+        "security": [
+          {
+            "EpilotAuth": []
+          }
+        ],
+        "parameters": [
+          {
+            "name": "id",
+            "in": "path",
+            "description": "Journey ID",
+            "required": true,
+            "schema": {
+              "type": "string",
+              "format": "uuid",
+              "example": "509cdffe-424f-457a-95c2-9708c304ce77"
+            }
+          }
+        ],
+        "requestBody": {
+          "description": "Complete journey configuration for the revision",
+          "required": true,
+          "content": {
+            "application/json": {
+              "schema": {
+                "$ref": "#/components/schemas/JourneyRevisionRequest"
+              }
+            }
+          }
+        },
+        "responses": {
+          "201": {
+            "description": "Revision created",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/JourneyRevisionSummary"
+                }
+              }
+            }
+          },
+          "400": {
+            "description": "Invalid payload"
+          },
+          "403": {
+            "description": "No permission to edit the journey"
+          },
+          "404": {
+            "description": "Journey versioning not enabled for the organization, or journey not found"
+          },
+          "409": {
+            "description": "`parent_revision_id` is not the latest revision: the journey was saved since the editor loaded it. The body carries the current latest revision.\n",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/JourneyRevisionConflict"
+                }
+              }
+            }
+          }
+        }
+      },
+      "get": {
+        "operationId": "listJourneyRevisions",
+        "summary": "listJourneyRevisions",
+        "description": "Lists the journey's revision history, newest first. Metadata only, no configuration payload. `is_published` says whether a revision is the published version right now, which is a different question from `published_at`, which records the last time it was published.\n\nOnly available for organizations with journey versioning enabled; returns `404` otherwise.\n",
+        "tags": [
+          "Journeys"
+        ],
+        "security": [
+          {
+            "EpilotAuth": []
+          }
+        ],
+        "parameters": [
+          {
+            "name": "id",
+            "in": "path",
+            "description": "Journey ID",
+            "required": true,
+            "schema": {
+              "type": "string",
+              "format": "uuid",
+              "example": "509cdffe-424f-457a-95c2-9708c304ce77"
+            }
+          },
+          {
+            "name": "limit",
+            "in": "query",
+            "description": "Maximum number of revisions to return",
+            "required": false,
+            "schema": {
+              "type": "integer",
+              "minimum": 1,
+              "maximum": 100,
+              "default": 25
+            }
+          },
+          {
+            "name": "cursor",
+            "in": "query",
+            "description": "Opaque pagination cursor, taken from a previous response's `next_cursor`",
+            "required": false,
+            "schema": {
+              "type": "string"
+            }
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "Revision history",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/JourneyRevisionList"
+                }
+              }
+            }
+          },
+          "400": {
+            "description": "Invalid query parameters"
+          },
+          "403": {
+            "description": "No permission to edit the journey"
+          },
+          "404": {
+            "description": "Journey versioning not enabled for the organization, or journey not found"
+          }
+        }
+      }
+    },
+    "/v1/journey/configuration/{id}/revisions/{revision_id}": {
+      "get": {
+        "operationId": "getJourneyRevision",
+        "summary": "getJourneyRevision",
+        "description": "Returns one revision with its full configuration, in the shape the builder holds a journey in, so it can be loaded straight into the editor as unsaved changes. Reading a revision changes nothing; a client persists it, if at all, by posting it back to `POST .../revisions`.\n\nOnly available for organizations with journey versioning enabled; returns `404` otherwise.\n",
+        "tags": [
+          "Journeys"
+        ],
+        "security": [
+          {
+            "EpilotAuth": []
+          }
+        ],
+        "parameters": [
+          {
+            "name": "id",
+            "in": "path",
+            "description": "Journey ID",
+            "required": true,
+            "schema": {
+              "type": "string",
+              "format": "uuid",
+              "example": "509cdffe-424f-457a-95c2-9708c304ce77"
+            }
+          },
+          {
+            "name": "revision_id",
+            "in": "path",
+            "description": "Revision ID, as returned in a revision summary",
+            "required": true,
+            "schema": {
+              "type": "string",
+              "example": "42"
+            }
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "The revision with its configuration",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/JourneyRevision"
+                }
+              }
+            }
+          },
+          "403": {
+            "description": "No permission to edit the journey"
+          },
+          "404": {
+            "description": "Journey versioning not enabled for the organization, or journey or revision not found"
+          }
+        }
+      }
+    },
+    "/v1/journey/configuration/{id}/publish": {
+      "post": {
+        "operationId": "publishJourneyRevision",
+        "summary": "publishJourneyRevision",
+        "description": "Makes one revision the published version, the one customers receive, in a single transaction: the revision's configuration is copied onto the journey record, its datasource set onto the published datasources, and `name`, `description`, `published_at` and `published_by` are stamped onto the revision. Any revision can be published, old or new, so publishing an older revision is the rollback.\n\n`name` is generated server-side when omitted, so every published revision carries one; an omitted name never replaces a name a previous publish already set. `settings.isActive` is never changed by a publish.\n\nOnly available for organizations with journey versioning enabled; returns `404` otherwise.\n",
+        "tags": [
+          "Journeys"
+        ],
+        "security": [
+          {
+            "EpilotAuth": []
+          }
+        ],
+        "parameters": [
+          {
+            "name": "id",
+            "in": "path",
+            "description": "Journey ID",
+            "required": true,
+            "schema": {
+              "type": "string",
+              "format": "uuid",
+              "example": "509cdffe-424f-457a-95c2-9708c304ce77"
+            }
+          }
+        ],
+        "requestBody": {
+          "description": "The revision to publish",
+          "required": true,
+          "content": {
+            "application/json": {
+              "schema": {
+                "$ref": "#/components/schemas/PublishRevisionRequest"
+              }
+            }
+          }
+        },
+        "responses": {
+          "200": {
+            "description": "Revision published",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/PublishResult"
+                }
+              }
+            }
+          },
+          "400": {
+            "description": "Invalid payload"
+          },
+          "403": {
+            "description": "No permission to edit the journey"
+          },
+          "404": {
+            "description": "Journey versioning not enabled for the organization, or journey or revision not found"
+          },
+          "409": {
+            "description": "The journey record changed between read and publish, please try again"
+          }
+        }
+      }
+    },
+    "/v1/journey/configuration/{id}/publish-state": {
+      "get": {
+        "operationId": "getJourneyPublishState",
+        "summary": "getJourneyPublishState",
+        "description": "Answers which revision is the published version without paging through the history. A journey that has not adopted versioning yet returns `200` with `published_revision_id: null`, not `404`.\n\nOnly available for organizations with journey versioning enabled; returns `404` otherwise.\n",
+        "tags": [
+          "Journeys"
+        ],
+        "security": [
+          {
+            "EpilotAuth": []
+          }
+        ],
+        "parameters": [
+          {
+            "name": "id",
+            "in": "path",
+            "description": "Journey ID",
+            "required": true,
+            "schema": {
+              "type": "string",
+              "format": "uuid",
+              "example": "509cdffe-424f-457a-95c2-9708c304ce77"
+            }
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "Publish state",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/JourneyPublishState"
+                }
+              }
+            }
+          },
+          "403": {
+            "description": "No permission to edit the journey"
+          },
+          "404": {
+            "description": "Journey versioning not enabled for the organization, or journey not found"
+          }
+        }
+      }
+    },
     "/v1/journey/configuration/{id}/environment": {
       "get": {
         "operationId": "getJourneyEnvironment",
@@ -829,7 +1132,7 @@
           {
             "name": "version",
             "in": "query",
-            "description": "DynamoDB version to fetch. `0` (default) is the live row; positive integers are historical snapshots created on each save. Note: this is distinct from the `revisions` counter on the row body.\n",
+            "description": "Revision row to read. `0` (default) is the journey record, the published version every customer receives; a positive integer `n` reads revision row `n` (used by config-engine for history reads). Distinct from the `revisions` counter on the body, which is the legacy change counter of the published version. Versioning metadata is only available via `publish-state`.\n",
             "required": false,
             "schema": {
               "type": "integer",
@@ -2555,10 +2858,12 @@
             "type": "string"
           },
           "version": {
-            "type": "number"
+            "type": "number",
+            "description": "Revision row number of this item. `0` is the journey record, the published version.\n"
           },
           "revisions": {
-            "type": "number"
+            "type": "number",
+            "description": "Legacy change counter of the published version, kept for compatibility: bumped whenever the published version changes and used for optimistic concurrency on `PUT`, by submissions (`journey_context.journey_revision`) and by save-and-continue. Saving a revision never changes it. Versioning metadata is only available via `publish-state`.\n"
           }
         },
         "required": [
@@ -2568,6 +2873,219 @@
           "revisions"
         ]
       },
+      "JourneyRevisionRequest": {
+        "description": "The complete journey configuration a revision is created from, same shape as the `PUT` body. Server-managed attributes of the journey record (`revisions`, `version`, publish metadata) are ignored.\n",
+        "allOf": [
+          {
+            "$ref": "#/components/schemas/JourneyCreationRequest"
+          },
+          {
+            "type": "object",
+            "properties": {
+              "parent_revision_id": {
+                "type": "string",
+                "description": "The revision the editor started from. When present and not the latest revision the save is rejected with `409`; absent skips the check.\n",
+                "example": "41"
+              },
+              "based_on_revision_id": {
+                "type": "string",
+                "description": "Provenance, not configuration: the revision that was loaded into the editor before this save, when it was an older one.\n",
+                "example": "37"
+              },
+              "mapping_config_version": {
+                "type": "number",
+                "description": "Version of the entity-mapping config stored alongside this revision. Publishing the revision points the journey's automation at it.\n",
+                "example": 12
+              }
+            }
+          }
+        ]
+      },
+      "PublishRevisionRequest": {
+        "type": "object",
+        "required": [
+          "revision_id"
+        ],
+        "properties": {
+          "revision_id": {
+            "type": "string",
+            "example": "42"
+          },
+          "name": {
+            "type": "string",
+            "maxLength": 255,
+            "description": "Name stamped onto the revision being published. Optional: when omitted the server generates one, so every revision that has ever been published carries a name. An omitted name never replaces a name a previous publish already set; an explicit one does.\n",
+            "example": "Summer campaign"
+          },
+          "description": {
+            "type": "string",
+            "maxLength": 8000,
+            "description": "Optional description stamped onto the revision at publish time"
+          }
+        }
+      },
+      "JourneyRevisionSummary": {
+        "type": "object",
+        "required": [
+          "revision_id",
+          "created_at",
+          "is_published"
+        ],
+        "properties": {
+          "revision_id": {
+            "type": "string",
+            "description": "Opaque identifier of the revision. Moves on every save.",
+            "example": "42"
+          },
+          "created_at": {
+            "type": "string",
+            "format": "date-time"
+          },
+          "created_by": {
+            "type": "string",
+            "description": "User id of the author. Absent for revisions recorded from writes without a user, e.g. blueprint installs.\n"
+          },
+          "name": {
+            "type": "string",
+            "description": "Set at publish time only, so present if and only if this revision has been published at least once.\n",
+            "example": "Summer campaign"
+          },
+          "description": {
+            "type": "string"
+          },
+          "published_at": {
+            "type": "string",
+            "format": "date-time",
+            "description": "The last time this revision was published. Not the same question as `is_published`: a revision that was the published version yesterday still carries a `published_at`.\n"
+          },
+          "is_published": {
+            "type": "boolean",
+            "description": "Whether this revision is the published version right now."
+          },
+          "mapping_config_version": {
+            "type": "number",
+            "description": "Version of the entity-mapping config stored alongside this revision.",
+            "example": 12
+          }
+        }
+      },
+      "JourneyRevisionList": {
+        "type": "object",
+        "required": [
+          "results"
+        ],
+        "properties": {
+          "results": {
+            "type": "array",
+            "items": {
+              "$ref": "#/components/schemas/JourneyRevisionSummary"
+            }
+          },
+          "next_cursor": {
+            "type": "string",
+            "description": "Opaque cursor to pass back as `cursor` to fetch the next page. Absent when the client has reached the end of the history.\n"
+          }
+        }
+      },
+      "JourneyRevision": {
+        "allOf": [
+          {
+            "$ref": "#/components/schemas/JourneyRevisionSummary"
+          },
+          {
+            "type": "object",
+            "required": [
+              "configuration"
+            ],
+            "properties": {
+              "configuration": {
+                "description": "The journey configuration as it was saved in this revision, in the shape the builder holds a journey in.\n",
+                "allOf": [
+                  {
+                    "$ref": "#/components/schemas/Journey"
+                  }
+                ]
+              }
+            }
+          }
+        ]
+      },
+      "JourneyRevisionConflict": {
+        "type": "object",
+        "required": [
+          "message",
+          "latest_revision"
+        ],
+        "properties": {
+          "message": {
+            "type": "string",
+            "example": "The journey has been saved since your editor loaded it"
+          },
+          "latest_revision": {
+            "$ref": "#/components/schemas/JourneyRevisionSummary"
+          }
+        }
+      },
+      "JourneyPublishState": {
+        "type": "object",
+        "required": [
+          "journey_id",
+          "published_revision_id"
+        ],
+        "properties": {
+          "journey_id": {
+            "type": "string",
+            "format": "uuid"
+          },
+          "published_revision_id": {
+            "type": "string",
+            "nullable": true,
+            "description": "An explicit `null` means the journey has not adopted versioning yet: it exists, customers receive its journey record, and no revision is the published version.\n",
+            "example": "42"
+          },
+          "published_at": {
+            "type": "string",
+            "format": "date-time"
+          },
+          "published_by": {
+            "type": "string"
+          }
+        }
+      },
+      "PublishResult": {
+        "type": "object",
+        "required": [
+          "revision_id",
+          "name",
+          "published_at",
+          "post_publish_warnings"
+        ],
+        "properties": {
+          "revision_id": {
+            "type": "string",
+            "example": "42"
+          },
+          "name": {
+            "type": "string",
+            "description": "The name now on the revision: the one sent in the request, the one a previous publish set when this request omitted `name`, or the server-generated default.\n",
+            "example": "Summer campaign"
+          },
+          "published_at": {
+            "type": "string",
+            "format": "date-time"
+          },
+          "published_by": {
+            "type": "string"
+          },
+          "post_publish_warnings": {
+            "type": "array",
+            "description": "Names any best-effort side effect that failed after the publish itself succeeded, e.g. the journey entity sync, so a caller can say \"published, but the entity did not update\".\n",
+            "items": {
+              "type": "string"
+            }
+          }
+        }
+      },
       "JourneyValidationResponse": {
         "type": "object",
         "properties": {
@@ -3035,6 +3553,9 @@
   "servers": [
     {
       "url": "https://journey-config.sls.epilot.io"
+    },
+    {
+      "url": "https://journey-config.dev.sls.epilot.io"
     }
   ]
 }

package/dist/bin/epilot.js

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 import {
   API_LIST
-} from "../chunk-ZLLWCEDW.js";
+} from "../chunk-6FCRUOLP.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.151",
+    version: "0.1.152",
     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-3IL3RXHU.js").then((m) => m.default),
-    upgrade: () => import("../upgrade-S7CTZFQG.js").then((m) => m.default),
+    completion: () => import("../completion-SOFYT4C2.js").then((m) => m.default),
+    upgrade: () => import("../upgrade-PYTL3F44.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.151" : (await null).default.version;
+var VERSION = true ? "0.1.152" : (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-3IL3RXHU.js");
+  const { handleCompletions } = await import("../completion-SOFYT4C2.js");
   handleCompletions(args[completionsIdx + 1], args[completionsIdx + 2]);
   process.exit(0);
 }

package/dist/{chunk-ZLLWCEDW.js → chunk-6FCRUOLP.js}

@@ -833,7 +833,7 @@ var API_LIST = [
     kebabName: "file",
     title: "File API",
     serverUrl: "https://file.sls.epilot.io",
-    operationCount: 37,
+    operationCount: 38,
     operationIds: [
       "uploadFileV2",
       "saveFileV2",
@@ -854,6 +854,7 @@ var API_LIST = [
       "getFileSummaryJob",
       "generateFileSummary",
       "getFileText",
+      "validateFile",
       "previewFile",
       "previewS3FileGet",
       "previewS3File",
@@ -966,11 +967,16 @@ var API_LIST = [
     kebabName: "journey",
     title: "Journey API",
     serverUrl: "https://journey-config.sls.epilot.io",
-    operationCount: 18,
+    operationCount: 23,
     operationIds: [
       "getJourneysByOrgId",
       "getJourney",
       "removeJourney",
+      "listJourneyRevisions",
+      "createJourneyRevision",
+      "getJourneyRevision",
+      "publishJourneyRevision",
+      "getJourneyPublishState",
       "getJourneyEnvironment",
       "getJourneyEnvironmentVariables",
       "getJourneyProducts",

package/dist/{completion-3IL3RXHU.js → completion-SOFYT4C2.js}

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

package/dist/{upgrade-S7CTZFQG.js → upgrade-PYTL3F44.js}

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