ente-cli 0.4.80 → 0.4.82

package/README.md

@@ -135,6 +135,7 @@ Every command supports `--json`. Run `ente --help` or `ente <group> --help`.
 | `activity` | `list`, `create`, `search`, `get`, `transcript` (`--grep`, `--context`), `update`, `delete`, `restore`, `message add`, `attachment upload` |
 | `agenda` | `create-point`, `link-task` |
 | `task` | `list`, `get`, `create`, `update`, `done`, `assign`, `unassign`, `set-assignees`, `clear-assignees` |
+| `list` | `create` (`--column`, `--pin`), `add` (`--key` upsert), `update` (`--attr`, `--title`), `import` (JSONL upsert by `--key`, `--dry-run`), `show` (`--all`, `--cursor`, `--where`, `--view`), `column add`, `column remove` |
 | `pins` | `list` |
 | `space` | `members` |
 | `recording` | `list`, `show`, `inspect`, `rerun` (admin only) |
@@ -329,6 +330,25 @@ Never put secrets in chat, repositories, project `.env` files, or logs.
 
 ### Process a permitted user mailbox
 
+Use `recipients` with an explicit permitted Gmail/IMAP `connectionId` and a
+nonempty `query` to resolve a name or address fragment from cached non-draft
+From/To/Cc/Bcc headers. A call scans at most 800 metadata records and returns
+at most 20 address candidates with continuation. For example:
+
+```sh
+ente agent user-mailbox --request '{"operation":"recipients","connectionId":"<permitted-private-connection>","query":"Alex Morgan"}'
+```
+
+Follow every cursor. For name matches, repeat lookup with each candidate exact
+email and follow those cursors too: newer headers may omit the name. Combine
+exact-address results using maximum `lastContactAt` before preferring the most
+recently contacted match. Results exclude unsynced
+provider history and shared Ente inboxes. If `truncated` is true, refine the query;
+a bounded subset does not establish uniqueness. Disclose alternatives and the
+chosen address in the prepared draft. Ask for confirmation on ties or unresolved
+matches. Lookup never sends and never authorizes inventing an address.
+
+
 Existing provider drafts retain their attachments when edited or sent through
 `user-mailbox`, including the web composer's 25 MB combined raw-file budget
 (25,000,000 bytes, at most 24 files). The complete MIME message must fit 35 MiB;
@@ -461,3 +481,12 @@ the shipped skill for scope and citation details.
 Explicit vector modes report the selected provider, model, region, embedding identity and generation in `retrieval.vector`. Optional OpenAI embeddings use `text-embedding-3-small` at 512 dimensions. A provider/model/region change requires renewed account consent and a new empty generation; it does not select history or future activities. No automatic provider fallback runs. Omitted/lexical query remains zero-egress.
 
 Hybrid ordering uses RRF plus semantic branch coverage. Returned rank is authoritative; scores are not calibrated confidence or a pure sort contract.
+
+Recipient lookup may explicitly use `"source":"provider"` to read bounded
+native matching headers outside the synced cache. It imports no messages and
+reads no bodies. Continue provider cursors separately from cached cursors, then
+repeat each candidate exact address in the same source to rank actual dates.
+Gmail applies native word/operator matching; arbitrary mid-name/address substring
+and alias expansion are not guaranteed. IMAP applies native address-header
+substring matching with UIDVALIDITY-bound continuation. Neither source proves
+complete historical coverage; retain alternatives and ask on unresolved matches.

package/dist/SKILL.md

@@ -187,6 +187,14 @@ ente activity attachment upload <activityId> ./file.pdf [--name "Contract.pdf"]
 ente activity delete <activityId> [--json]
 ente activity restore <activityId> [--json]
 
+# Database lists (entity + typed columns; each row is a note/task activity; no date column type)
+ente list create "<name>" --space "<space>" [--column "key[=Label]:text|number|boolean|single-select|multi-select[:opt,opt]"] [--pin "<parent>" [--share-parents --parent-space-grant-fingerprint <token>]] [--json]
+ente list add "<list>" --title "…" [--attr k=v ...] [--key <textColumn>] [--content-file ./row.md] [--json]   # --key = upsert by that cell
+ente list update "<list>" <rowId> [--attr k=v ...] [--title "…"] [--json]      # empty value clears a cell
+ente list import "<list>" --file rows.jsonl --key <textColumn> [--dry-run] [--concurrency 4] [--json]   # {"title","attrs","content"} per line → created/updated/unchanged
+ente list show "<list>" [--all | --cursor <nextCursor>] [--limit 100] [--where k=v ...] [--view] [--json]   # all rows by default; --view = table's saved filters
+# Rows are activities: trash with `ente activity delete <rowId>`, promote with `ente activity update <rowId> --entity-add "<entity>"`. Guide: playbooks/database-list-sync.md
+
 # Activity agendas (all activity types)
 # --meeting remains a compatibility alias for --activity.
 ente agenda create-point --activity <activityId> --title "Decisions" [--content="…"] [--content-file ./decisions.md] [--parent <agendaPointId>] [--after <agendaPointId>] [--json]
@@ -493,6 +501,25 @@ Parent relationships are spaceless. Both entities must be accessible. Every acti
 
 ## User mailbox processing
 
+Use `recipients` with an explicit permitted Gmail/IMAP `connectionId` and a
+nonempty `query` to resolve a name or address fragment from cached non-draft
+From/To/Cc/Bcc headers. A call scans at most 800 metadata records and returns
+at most 20 address candidates with continuation. For example:
+
+```sh
+ente agent user-mailbox --request '{"operation":"recipients","connectionId":"<permitted-private-connection>","query":"Alex Morgan"}'
+```
+
+Follow every cursor. For name matches, repeat lookup with each candidate exact
+email and follow those cursors too: newer headers may omit the name. Combine
+exact-address results using maximum `lastContactAt` before preferring the most
+recently contacted match. Results exclude unsynced
+provider history and shared Ente inboxes. If `truncated` is true, refine the query;
+a bounded subset does not establish uniqueness. Disclose alternatives and the
+chosen address in the prepared draft. Ask for confirmation on ties or unresolved
+matches. Lookup never sends and never authorizes inventing an address.
+
+
 Existing provider drafts retain their attachments when edited or sent through
 `user-mailbox`, including the web composer's 25 MB combined raw-file budget
 (25,000,000 bytes, at most 24 files). The complete MIME message must fit 35 MiB;
@@ -656,3 +683,12 @@ accounts do not send data to the hosted embedding pilot.
 Explicit vector modes report the selected provider, model, region, embedding identity and generation in `retrieval.vector`. Optional OpenAI embeddings use `text-embedding-3-small` at 512 dimensions. A provider/model/region change requires renewed account consent and a new empty generation; it does not select history or future activities. No automatic provider fallback runs. Omitted/lexical query remains zero-egress.
 
 Hybrid ranking uses RRF plus early semantic branch coverage. Use returned `rank` for order; numeric scores are neither a pure sort contract nor calibrated confidence.
+
+For older recipient correspondence, `user-mailbox` operation `recipients` accepts
+`source: "provider"` for bounded native matching header reads without imports or
+bodies. Keep provider and cached cursors separate. Continue pages, then repeat
+candidate exact addresses in the same source before comparing actual dates.
+Gmail uses native word/operator matching, without guaranteed arbitrary substring
+or alias expansion. IMAP uses native address-header substring search and checks
+UIDVALIDITY on continuation. Never claim complete historical coverage or send
+from a recipient lookup; disclose choices and ask on unresolved alternatives.