ente-cli 0.4.104 → 0.4.105

package/README.md

@@ -192,7 +192,7 @@ Every command supports `--json`. Run `ente --help` or `ente <group> --help`.
 | `recording` | `list`, `show`, `inspect`, `rerun`, `orphans`, `backups` (platform key) |
 | `admin` | `tables`, `get`, `page` — read-only inspector over any table (platform key) |
 | `canvas` | `boards`, `html list`, `html get`, `html create`, `html update`, `html delete` |
-| `files` | `list`, `upload` (local file at most 10 MiB, or an activity attachment), `link`, `create-folder` — the entity's Nextcloud folder via your own connection; personal agent key only (MCP: `entity_files_list`, `entity_file_upload`, `entity_folder_link`, `entity_folder_create`) |
+| `files` | `list`, `search` (by name, all subfolders), `read` (text of a PDF, DOCX or plain-text file up to 10 MiB, in windows of 50,000 characters), `upload` (local file at most 10 MiB, or an activity attachment), `link`, `create-folder` — the entity's Nextcloud folder via your own connection; personal agent key only (MCP: `entity_files_list`, `entity_files_search`, `entity_file_read`, `entity_file_upload`, `entity_folder_link`, `entity_folder_create`) |
 | `notification` | `send` (emails only your own Ente account address; optional HTML, file attachments, and CID inline images) |
 | `agent` | `permissions`, `list`, `threads`, `show`, `new`, `send`, `config show`, `config set-prompt`, `schedules configure` |
 | `agent mail` | `address`, `threads`, `show`, `send`, `reply`, `mark` |

package/dist/SKILL.md

@@ -254,8 +254,10 @@ ente canvas html delete <boardId> <elementId> [--json]
 
 # Entity files: the entity's linked Nextcloud folder, through YOUR own Nextcloud
 # connection. Works only with your personal agent's key; shared agents are refused.
-# MCP/REST: entity_files_list, entity_file_upload, entity_folder_link, entity_folder_create.
+# MCP/REST: entity_files_list, entity_files_search, entity_file_read, entity_file_upload, entity_folder_link, entity_folder_create.
 ente files list <entityId> [--path "03 Unterlagen"] [--json]   # --json: linkedFolderPath = the linked folder's path from your Nextcloud root; join it with an item path for the exact file
+ente files search <entityId> "Mietvertrag" [--json]             # name search in all subfolders of the linked folder
+ente files read <entityId> "03 Unterlagen/Mietvertrag.pdf" [--offset N] [--max-characters N] [--json]   # text of a PDF (text layer), DOCX or plain-text file up to 100 MiB, 50,000 characters per call; a scan without text layer returns notice no_text_layer
 ente files upload <entityId> <local-file> [--folder "03 Unterlagen"] [--name "Vertrag.pdf"] [--mime-type application/pdf] [--json]   # at most 10 MiB
 ente files upload <entityId> --activity <activityId> --storage-id <storageId> --name "Vertrag.pdf" [--folder …] [--json]   # copy an activity attachment
 ente files link <entityId> "Mandate/2026-017 Zebrafink" [--space <spaceId>] [--json]

package/dist/cli.mjs

@@ -8055,7 +8055,7 @@ async function runCli(cli2, argv, context) {
 }
 
 // ente/version.ts
-var VERSION = "0.4.104";
+var VERSION = "0.4.105";
 
 // ente/branding.ts
 var NPM_REGISTRY = "https://registry.npmjs.org";
@@ -47336,11 +47336,51 @@ var entityFileListResultValidator = v.union(
   }),
   v.object({ status: v.union(...ENTITY_FILE_LIST_PROBLEM_STATUSES.map((status2) => v.literal(status2))) })
 );
+var problemStatusValidator = v.object({ status: v.union(...ENTITY_FILE_LIST_PROBLEM_STATUSES.map((status2) => v.literal(status2))) });
+var entityFileSearchResultValidator = v.union(
+  v.object({
+    status: v.literal("ok"),
+    /** The linked folder itself, relative to the caller's own Nextcloud root; read live, never stored. */
+    linkedFolderPath: v.string(),
+    items: v.array(entityFileItemValidator),
+    /** More hits exist than returned; narrow the query. */
+    truncated: v.boolean()
+  }),
+  problemStatusValidator
+);
+var entityFileReadResultValidator = v.union(
+  v.object({
+    status: v.literal("ok"),
+    /** The file, relative to the linked folder. */
+    path: v.string(),
+    name: v.string(),
+    mimeType: v.union(v.string(), v.null()),
+    size: v.union(v.number(), v.null()),
+    modifiedAt: v.union(v.number(), v.null()),
+    format: v.union(v.literal("text"), v.literal("pdf"), v.literal("docx")),
+    /** The returned window of the extracted text. */
+    text: v.string(),
+    /** Character offset of `text` in the whole extracted text. */
+    offset: v.number(),
+    totalCharacters: v.number(),
+    /** Text continues after this window; call again with offset + text.length. */
+    truncated: v.boolean(),
+    /**
+     * Set when a PDF has (almost) no text layer, typically a scan: the text is
+     * not the document's content. OCR in Nextcloud (e.g. workflow_ocr) may add
+     * a layer as a new file version shortly after upload.
+     */
+    notice: v.optional(v.object({ code: v.literal("no_text_layer"), message: v.string() }))
+  }),
+  problemStatusValidator
+);
 var entityFileUploadResultValidator = v.object({ fileId: v.string(), name: v.string(), path: v.string() });
 var entityFileResults = {
   createEntityFolder: entityFolderLinkResultValidator,
   linkEntityFolder: entityFolderLinkResultValidator,
   listEntityFiles: entityFileListResultValidator,
+  searchEntityFiles: entityFileSearchResultValidator,
+  readEntityFile: entityFileReadResultValidator,
   uploadEntityFile: entityFileUploadResultValidator
 };
 function parseEntityFileResult(operation, raw) {
@@ -47360,6 +47400,19 @@ var ENTITY_FILE_LIMITS = {
   uploadBytes: 20 * 1024 * 1024,
   /** A file the panel sends in parts (Nextcloud chunked upload v2); larger ones go into Nextcloud directly. */
   chunkedUploadBytes: 500 * 1024 * 1024,
+  /**
+   * Largest file readEntityFile extracts text from, set by the Node action's
+   * memory (512 MiB on Convex cloud). Measured 02.11.2026 in a local Convex
+   * backend (Node action, PDF.js 6.4, synthetic scan-like PDF with a 250 KB
+   * image and a text layer per page): 100 MB / 400 pages raised RSS from 306 to
+   * 499 MiB (+193 MiB, 5.6 s); 200 MB / 800 pages added 114 MiB more on a warm
+   * process (7.1 s). About 1.9 bytes per file byte on a ~306 MiB base gives
+   * (512 - 306) / 1.9 = ~106 MiB, hence 100 MiB. Before, bytes went to Node as
+   * an argument, which Convex caps at 5 MiB for Node actions.
+   */
+  readBytes: 100 * 1024 * 1024,
+  /** Characters readEntityFile returns per call; longer texts are read in windows. */
+  readCharacters: 5e4,
   nameCharacters: 250,
   pathCharacters: 4096,
   mimeTypeCharacters: 255
@@ -47393,6 +47446,16 @@ var entityFileInputs = {
     entityId: id17,
     path: path6("Folder inside the linked folder; omit or empty string for the linked folder itself.").optional()
   }),
+  searchEntityFiles: external_exports.strictObject({
+    entityId: id17,
+    query: external_exports.string().trim().min(2).max(200).describe("Part of a file or folder name, 2 to 200 characters; matched anywhere below the linked folder.")
+  }),
+  readEntityFile: external_exports.strictObject({
+    entityId: id17,
+    path: external_exports.string().min(1).max(ENTITY_FILE_LIMITS.pathCharacters).describe("File inside the linked folder, as entity_files_list or entity_files_search return it, for example 03 Unterlagen/Mietvertrag.pdf."),
+    offset: external_exports.number().int().min(0).optional().describe("Character offset to continue a truncated text; defaults to 0."),
+    maxCharacters: external_exports.number().int().min(1).max(ENTITY_FILE_LIMITS.readCharacters).optional().describe(`Characters to return, at most ${ENTITY_FILE_LIMITS.readCharacters}; defaults to that maximum.`)
+  }),
   uploadEntityFile: external_exports.strictObject({
     entityId: id17,
     folderPath: path6("Target folder inside the linked folder; defaults to the linked folder itself.").optional(),
@@ -47409,6 +47472,8 @@ var entityFileAliases = {
   entity_folder_create: "createEntityFolder",
   entity_folder_link: "linkEntityFolder",
   entity_files_list: "listEntityFiles",
+  entity_files_search: "searchEntityFiles",
+  entity_file_read: "readEntityFile",
   entity_file_upload: "uploadEntityFile"
 };
 function isEntityFileOperationName(value) {
@@ -47419,8 +47484,14 @@ var descriptions5 = {
   createEntityFolder: `Create a new folder in your Nextcloud below parentPath and link it as the entity's file folder. ${personalOnly}`,
   linkEntityFolder: `Link an existing folder of your Nextcloud, given by its path, as the entity's file folder. A folder can belong to one entity only. ${personalOnly}`,
   listEntityFiles: `List the files and folders in the entity's linked Nextcloud folder. status explains a missing link or connection instead of an empty list. Item paths are relative to the linked folder; linkedFolderPath is the linked folder's own path from your Nextcloud root, so join it with an item path to address that exact file in Nextcloud instead of searching by name. ${personalOnly}`,
+  searchEntityFiles: `Find files and folders by name anywhere below the entity's linked Nextcloud folder, also in subfolders. status explains a missing link or connection; truncated means more hits exist, so narrow the query. Item paths are relative to the linked folder and go unchanged into entity_file_read. ${personalOnly}`,
+  readEntityFile: `Read the text of one file in the entity's linked Nextcloud folder: PDF (text layer only), DOCX and plain-text formats such as TXT, MD, CSV, JSON or XML, up to ${ENTITY_FILE_LIMITS.readBytes / (1024 * 1024)} MiB. Other formats fail with unsupported_format. Long texts come in windows: when truncated is true, call again with offset set to offset plus the returned text's length. A PDF without a usable text layer (a scan) returns notice.code no_text_layer: its text is not the content; OCR in Nextcloud may add a layer shortly after upload, so read it again later instead of concluding the file is empty. ${personalOnly}`,
   uploadEntityFile: `Upload a file into the entity's linked Nextcloud folder; a taken name gets a numbered suffix. Send exactly one of base64Content (at most 10 MiB decoded) or activityAttachment (an existing Ente activity attachment). ${personalOnly}`
 };
+var READ_OPERATIONS = /* @__PURE__ */ new Set(["listEntityFiles", "searchEntityFiles", "readEntityFile"]);
+function isEntityFileReadOperation(operationName) {
+  return READ_OPERATIONS.has(operationName);
+}
 function definition3(operationName) {
   const schema = external_exports.toJSONSchema(entityFileInputs[operationName], { io: "input" });
   return {
@@ -47432,7 +47503,7 @@ function definition3(operationName) {
     errorSchema: operationErrorSchema,
     resultSchema: operationResultSchema(entityFileResults[operationName]),
     outputSchema: { type: "object", properties: { data: operationResultSchema(entityFileResults[operationName]) }, required: ["data"], additionalProperties: false },
-    capability: operationName === "listEntityFiles" ? "read" : "write",
+    capability: isEntityFileReadOperation(operationName) ? "read" : "write",
     executionProfile: "full",
     resultProjection: "full",
     environment: "content",
@@ -47459,6 +47530,12 @@ var linkFolderRef = makeFunctionReference2(
 var listRef = makeFunctionReference2(
   "entityFileOperations:list"
 );
+var searchRef = makeFunctionReference2(
+  "entityFileOperations:search"
+);
+var readRef = makeFunctionReference2(
+  "entityFileOperations:read"
+);
 var uploadRef = makeFunctionReference2(
   "entityFileOperations:upload"
 );
@@ -47474,6 +47551,14 @@ async function listEntityFiles(caller, input2) {
   const args = parseOperationInput("listEntityFiles", entityFileInputs.listEntityFiles, input2);
   return parseEntityFileResult("listEntityFiles", await caller.action(listRef, args));
 }
+async function searchEntityFiles(caller, input2) {
+  const args = parseOperationInput("searchEntityFiles", entityFileInputs.searchEntityFiles, input2);
+  return parseEntityFileResult("searchEntityFiles", await caller.action(searchRef, args));
+}
+async function readEntityFile(caller, input2) {
+  const args = parseOperationInput("readEntityFile", entityFileInputs.readEntityFile, input2);
+  return parseEntityFileResult("readEntityFile", await caller.action(readRef, args));
+}
 async function uploadEntityFile(caller, input2) {
   const args = parseOperationInput("uploadEntityFile", entityFileInputs.uploadEntityFile, input2);
   return parseEntityFileResult("uploadEntityFile", await caller.action(uploadRef, args));
@@ -47519,6 +47604,38 @@ var FilesListCmd = class extends ProfileCommand {
     this.emitText({ data }, () => data.status !== "ok" ? `Unavailable: ${data.status}` : [`Linked folder: ${data.linkedFolderPath}`, ...data.items.length ? data.items.map((item) => `${item.isFolder ? "dir " : "file"}  ${item.path}${item.size === null ? "" : `  ${item.size} B`}`) : ["Empty folder."]].join("\n"));
   }
 };
+var FilesSearchCmd = class extends ProfileCommand {
+  static paths = [["files", "search"]];
+  static usage = Command.Usage({ category: "Files", description: "Find files and folders by name anywhere below the entity's linked Nextcloud folder" });
+  entityId = options_exports.String({ required: true });
+  query = options_exports.String({ required: true });
+  async run() {
+    const data = await searchEntityFiles(await resolveCaller(), { entityId: this.entityId, query: this.query });
+    this.emitText({ data }, () => data.status !== "ok" ? `Unavailable: ${data.status}` : [
+      ...data.items.length ? data.items.map((item) => `${item.isFolder ? "dir " : "file"}  ${item.path}`) : ["No matches."],
+      ...data.truncated ? ["More matches exist; narrow the query."] : []
+    ].join("\n"));
+  }
+};
+var FilesReadCmd = class extends ProfileCommand {
+  static paths = [["files", "read"]];
+  static usage = Command.Usage({ category: "Files", description: "Print the text of a PDF, DOCX or plain-text file in the entity's linked Nextcloud folder" });
+  entityId = options_exports.String({ required: true });
+  filePath = options_exports.String({ required: true });
+  offset = options_exports.String("--offset", { description: "Character offset to continue a truncated text" });
+  maxCharacters = options_exports.String("--max-characters", { description: "Characters to return per call" });
+  async run() {
+    const data = await readEntityFile(await resolveCaller(), {
+      entityId: this.entityId,
+      path: this.filePath,
+      ...this.offset === void 0 ? {} : { offset: Number(this.offset) },
+      ...this.maxCharacters === void 0 ? {} : { maxCharacters: Number(this.maxCharacters) }
+    });
+    this.emitText({ data }, () => data.status !== "ok" ? `Unavailable: ${data.status}` : [...data.notice ? [`[${data.notice.code}] ${data.notice.message}
+`] : [], data.text, ...data.truncated ? [`
+[${data.offset + data.text.length} of ${data.totalCharacters} characters; continue with --offset ${data.offset + data.text.length}]`] : []].join("\n"));
+  }
+};
 var FilesUploadCmd = class extends ProfileCommand {
   static paths = [["files", "upload"]];
   static usage = Command.Usage({
@@ -47580,7 +47697,7 @@ var FilesCreateFolderCmd = class extends ProfileCommand {
     this.emitText({ data }, () => `Created and linked ${data.path}`);
   }
 };
-var FILES_COMMANDS = [FilesListCmd, FilesUploadCmd, FilesLinkCmd, FilesCreateFolderCmd];
+var FILES_COMMANDS = [FilesListCmd, FilesSearchCmd, FilesReadCmd, FilesUploadCmd, FilesLinkCmd, FilesCreateFolderCmd];
 
 // ente/commands/notification.ts
 import { readFileSync as readFileSync15 } from "node:fs";