@epilot/cli 0.1.71 → 0.1.73

package/README.md

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

package/definitions/customer-portal.json

@@ -5929,10 +5929,77 @@
           }
         }
       },
+      "patch": {
+        "operationId": "updateContract",
+        "summary": "updateContract",
+        "description": "Update a contract by id. Use getPortalUserEntity instead.",
+        "deprecated": true,
+        "tags": [
+          "ECP"
+        ],
+        "security": [
+          {
+            "PortalAuth": []
+          }
+        ],
+        "parameters": [
+          {
+            "in": "path",
+            "name": "id",
+            "schema": {
+              "$ref": "#/components/schemas/EntityId"
+            },
+            "required": true,
+            "description": "The ID of the contract"
+          }
+        ],
+        "requestBody": {
+          "description": "Requested contract body to update",
+          "required": true,
+          "content": {
+            "application/json": {
+              "schema": {
+                "$ref": "#/components/schemas/Entity"
+              }
+            }
+          }
+        },
+        "responses": {
+          "200": {
+            "description": "Updated the contract successfully.",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "type": "object",
+                  "properties": {
+                    "data": {
+                      "$ref": "#/components/schemas/Contract"
+                    }
+                  }
+                }
+              }
+            }
+          },
+          "401": {
+            "$ref": "#/components/responses/Unauthorized"
+          },
+          "403": {
+            "$ref": "#/components/responses/ForbiddenByRule"
+          },
+          "404": {
+            "$ref": "#/components/responses/NotFound"
+          },
+          "500": {
+            "$ref": "#/components/responses/InternalServerError"
+          }
+        }
+      }
+    },
+    "/v2/portal/contract/{id}/resolve-templates": {
       "post": {
         "operationId": "getContractWithTemplates",
         "summary": "getContractWithTemplates",
-        "description": "Get a contract by id, resolving the provided Handlebars templates against each related meter into templates_output. POST variant of getContract that accepts a request body; the GET remains as a fallback.",
+        "description": "Resolve Handlebars templates against a contract's related meters and return the contract with templates_output populated per meter. This is a read-only operation — it does not modify the contract. It uses POST only so the templates can be passed in the request body. Prefer getPortalUserEntity / getContract for reads that don't need templates.",
         "tags": [
           "ECP"
         ],
@@ -6047,71 +6114,6 @@
             "$ref": "#/components/responses/InternalServerError"
           }
         }
-      },
-      "patch": {
-        "operationId": "updateContract",
-        "summary": "updateContract",
-        "description": "Update a contract by id. Use getPortalUserEntity instead.",
-        "deprecated": true,
-        "tags": [
-          "ECP"
-        ],
-        "security": [
-          {
-            "PortalAuth": []
-          }
-        ],
-        "parameters": [
-          {
-            "in": "path",
-            "name": "id",
-            "schema": {
-              "$ref": "#/components/schemas/EntityId"
-            },
-            "required": true,
-            "description": "The ID of the contract"
-          }
-        ],
-        "requestBody": {
-          "description": "Requested contract body to update",
-          "required": true,
-          "content": {
-            "application/json": {
-              "schema": {
-                "$ref": "#/components/schemas/Entity"
-              }
-            }
-          }
-        },
-        "responses": {
-          "200": {
-            "description": "Updated the contract successfully.",
-            "content": {
-              "application/json": {
-                "schema": {
-                  "type": "object",
-                  "properties": {
-                    "data": {
-                      "$ref": "#/components/schemas/Contract"
-                    }
-                  }
-                }
-              }
-            }
-          },
-          "401": {
-            "$ref": "#/components/responses/Unauthorized"
-          },
-          "403": {
-            "$ref": "#/components/responses/ForbiddenByRule"
-          },
-          "404": {
-            "$ref": "#/components/responses/NotFound"
-          },
-          "500": {
-            "$ref": "#/components/responses/InternalServerError"
-          }
-        }
       }
     },
     "/v2/portal/contract/by-identifiers": {

package/definitions/file.json

@@ -2,7 +2,7 @@
   "openapi": "3.0.3",
   "info": {
     "title": "File API",
-    "version": "1.12.0",
+    "version": "1.13.0",
     "description": "The File API enables you to upload, store, manage, and share files within the epilot platform.\n\n## Key Features\n- **Upload files** to temporary storage and save them permanently as File entities\n- **Generate previews** (thumbnails) for images and documents\n- **Create public links** to share private files externally\n- **Organize files** into collections for better management\n- **Version control** with automatic file versioning on updates\n\n## File Upload Workflow\n1. Call `uploadFileV2` to get a pre-signed S3 URL\n2. Upload your file directly to S3 using the pre-signed URL (PUT request)\n3. Call `saveFileV2` with the S3 reference to create a permanent File entity\n\n## Changelog\n<a href=\"changelog\">View API Changelog</a>\n"
   },
   "tags": [
@@ -640,11 +640,11 @@
             "name": "s3_key",
             "in": "query",
             "required": true,
-            "description": "The S3 object key",
+            "description": "The S3 object key, as returned in `s3ref.key` of the file entity.\n\nNote: object keys store the filename segment percent-encoded. For example, a file named\n`Straße 1.pdf` is stored under the key `.../Stra%C3%9Fe%201.pdf`, and that is the value\n`s3ref.key` contains. Pass it exactly as returned by the API and make sure your HTTP client\nURL-encodes the query parameter value, so a literal `%` arrives encoded as `%25`.\n",
             "schema": {
               "type": "string"
             },
-            "example": "123/4d689aeb-1497-4410-a9fe-b36ca9ac4389/document.pdf"
+            "example": "123/4d689aeb-1497-4410-a9fe-b36ca9ac4389/Stra%C3%9Fe%201.pdf"
           },
           {
             "name": "s3_bucket",
@@ -691,6 +691,9 @@
           "401": {
             "$ref": "#/components/responses/UnauthorizedError"
           },
+          "403": {
+            "$ref": "#/components/responses/ForbiddenError"
+          },
           "404": {
             "$ref": "#/components/responses/NotFoundError"
           },
@@ -1125,6 +1128,54 @@
         }
       }
     },
+    "/v1/files/{id}/text": {
+      "get": {
+        "operationId": "getFileText",
+        "summary": "getFileText",
+        "description": "Get the plain-text representation of a file entity. Returns status `not_ready` while text is being prepared and `unsupported` when text is unavailable for the file or organization.",
+        "tags": [
+          "File"
+        ],
+        "parameters": [
+          {
+            "name": "id",
+            "in": "path",
+            "required": true,
+            "description": "The UUID of the file entity",
+            "schema": {
+              "$ref": "#/components/schemas/FileEntityId"
+            }
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "Text state for the file entity",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/FileText"
+                }
+              }
+            }
+          },
+          "400": {
+            "$ref": "#/components/responses/BadRequestError"
+          },
+          "401": {
+            "$ref": "#/components/responses/UnauthorizedError"
+          },
+          "403": {
+            "$ref": "#/components/responses/ForbiddenError"
+          },
+          "404": {
+            "$ref": "#/components/responses/NotFoundError"
+          },
+          "500": {
+            "$ref": "#/components/responses/InternalServerError"
+          }
+        }
+      }
+    },
     "/v1/files/{id}/preview": {
       "get": {
         "operationId": "previewFile",
@@ -1446,6 +1497,27 @@
               }
             }
           },
+          "204": {
+            "description": "No preview could be generated and no redirect target is available\n(the file has no public URL). No body is returned.\n"
+          },
+          "302": {
+            "description": "The preview could not be optimized (e.g. image dimensions above the input\npixel limit, an oversized file, or an unsupported/undecodable format).\nSince the file is public, the client is redirected to the original file,\nwhich the browser can render directly.\n",
+            "headers": {
+              "Location": {
+                "description": "URL of the original public file",
+                "schema": {
+                  "type": "string",
+                  "format": "uri"
+                }
+              },
+              "Cache-Control": {
+                "description": "Caching policy for the redirect",
+                "schema": {
+                  "type": "string"
+                }
+              }
+            }
+          },
           "304": {
             "description": "The preview is unchanged since the version identified by the `If-None-Match`\nrequest header. No body is returned; the cached copy should be reused.\n",
             "headers": {
@@ -2377,6 +2449,12 @@
             "description": "Human readable file size",
             "readOnly": true
           },
+          "etag": {
+            "type": "string",
+            "description": "Content hash (S3 ETag) of the latest file version. For single-part uploads this is the hex MD5 of the content and is stable across orgs, so identical content yields an identical etag. Used to detect real content changes without re-downloading the bytes.",
+            "example": "9bb58f26192e4ba00f01e2e7b136bbd8",
+            "readOnly": true
+          },
           "access_control": {
             "type": "string",
             "default": "private",
@@ -2523,6 +2601,109 @@
           }
         }
       },
+      "FileTextStatus": {
+        "type": "string",
+        "description": "Availability of the plain-text representation for a file entity.",
+        "enum": [
+          "ready",
+          "not_ready",
+          "unsupported"
+        ],
+        "readOnly": true
+      },
+      "FileText": {
+        "type": "object",
+        "properties": {
+          "status": {
+            "$ref": "#/components/schemas/FileTextStatus"
+          },
+          "text": {
+            "type": "string"
+          },
+          "truncated": {
+            "type": "boolean"
+          },
+          "total_chars": {
+            "type": "integer",
+            "minimum": 0
+          }
+        },
+        "required": [
+          "status"
+        ],
+        "oneOf": [
+          {
+            "$ref": "#/components/schemas/FileTextReady"
+          },
+          {
+            "$ref": "#/components/schemas/FileTextNotReady"
+          },
+          {
+            "$ref": "#/components/schemas/FileTextUnsupported"
+          }
+        ]
+      },
+      "FileTextReady": {
+        "type": "object",
+        "additionalProperties": false,
+        "properties": {
+          "status": {
+            "type": "string",
+            "enum": [
+              "ready"
+            ]
+          },
+          "text": {
+            "type": "string",
+            "description": "Plain-text representation, trimmed and truncated to a server-side limit of 50000 characters."
+          },
+          "truncated": {
+            "type": "boolean",
+            "description": "True when the returned text was cut off by the character limit."
+          },
+          "total_chars": {
+            "type": "integer",
+            "minimum": 0,
+            "description": "Length of the full text before truncation."
+          }
+        },
+        "required": [
+          "status",
+          "text",
+          "truncated",
+          "total_chars"
+        ]
+      },
+      "FileTextNotReady": {
+        "type": "object",
+        "additionalProperties": false,
+        "properties": {
+          "status": {
+            "type": "string",
+            "enum": [
+              "not_ready"
+            ]
+          }
+        },
+        "required": [
+          "status"
+        ]
+      },
+      "FileTextUnsupported": {
+        "type": "object",
+        "additionalProperties": false,
+        "properties": {
+          "status": {
+            "type": "string",
+            "enum": [
+              "unsupported"
+            ]
+          }
+        },
+        "required": [
+          "status"
+        ]
+      },
       "CustomDownloadUrl": {
         "description": "Custom external download url used for the file",
         "type": "string",
@@ -3094,6 +3275,11 @@
           "mime_type": {
             "type": "string",
             "example": "image/jpeg"
+          },
+          "etag": {
+            "type": "string",
+            "description": "Content hash (S3 ETag) of this file version",
+            "example": "9bb58f26192e4ba00f01e2e7b136bbd8"
           }
         }
       },

package/dist/bin/epilot.js

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 import {
   API_LIST
-} from "../chunk-HMUFGWB3.js";
+} from "../chunk-UI4BIEZG.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.71",
+    version: "0.1.73",
     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-L6M2AUJF.js").then((m) => m.default),
-    upgrade: () => import("../upgrade-ZLQXCBG5.js").then((m) => m.default),
+    completion: () => import("../completion-JJWJGP6Q.js").then((m) => m.default),
+    upgrade: () => import("../upgrade-ZCU6UKYR.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.71" : (await null).default.version;
+var VERSION = true ? "0.1.73" : (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-L6M2AUJF.js");
+  const { handleCompletions } = await import("../completion-JJWJGP6Q.js");
   handleCompletions(args[completionsIdx + 1], args[completionsIdx + 2]);
   process.exit(0);
 }

package/dist/{chunk-HMUFGWB3.js → chunk-UI4BIEZG.js}

@@ -363,8 +363,8 @@ var API_LIST = [
       "getAllRequests",
       "getAllContracts",
       "getContract",
-      "getContractWithTemplates",
       "updateContract",
+      "getContractWithTemplates",
       "addContractByIdentifiers",
       "getEntityIdentifiers",
       "getEntityActivityFeed",
@@ -732,7 +732,7 @@ var API_LIST = [
     kebabName: "file",
     title: "File API",
     serverUrl: "https://file.sls.epilot.io",
-    operationCount: 34,
+    operationCount: 35,
     operationIds: [
       "uploadFileV2",
       "saveFileV2",
@@ -750,6 +750,7 @@ var API_LIST = [
       "getCurrentFileSummaryJob",
       "getFileSummaryJob",
       "generateFileSummary",
+      "getFileText",
       "previewFile",
       "previewS3FileGet",
       "previewS3File",

package/dist/{completion-L6M2AUJF.js → completion-JJWJGP6Q.js}

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

package/dist/{upgrade-ZLQXCBG5.js → upgrade-ZCU6UKYR.js}

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