ente-cli 0.4.76 → 0.4.78

package/README.md

@@ -107,8 +107,9 @@ ente entity rename "Lorey Georg" "Georg Lorey"
 ente task list --due today
 ente activity create --type note --title "Meeting notes" --entity "Alice" --space "Personal"
 ente activity get <activityId> --json # includes the body, nested agenda, messages/replies, entities, and attachments
-ente agenda create-point --meeting <meetingActivityId> --title "Decisions" --content="- Ship the smaller scope"
+ente agenda create-point --activity <activityId> --title "Decisions" --content="- Ship the smaller scope"
 ente agenda link-task --point <agendaPointId> --task "#12"
+# Agendas work on every activity type; --meeting remains an alias for --activity.
 ente activity message add <activityId> --content "Decision: ship the smaller scope first."
 ente activity content read <activityId> --json
 ente activity content edit <activityId> --expected-version 42 --operations-file edits.json --json
@@ -444,3 +445,5 @@ separate human-admin JWT surface and never serves as a fallback.
 Diagnostics is unavailable inside Ente-hosted chats, recordings and automations.
 Use the external operator command. Whole-history panel sharing does not grant
 access to diagnostics, and diagnostic reads do not append to chat history.
+
+Identify your connection with `ente agent set-icon fish` (or `--reset`), then find its icon in `/agents`. Requires write scope and always targets your own bound agent.

package/dist/SKILL.md

@@ -184,8 +184,9 @@ ente activity attachment upload <activityId> ./file.pdf [--name "Contract.pdf"]
 ente activity delete <activityId> [--json]
 ente activity restore <activityId> [--json]
 
-# Meeting agendas
-ente agenda create-point --meeting <meetingActivityId> --title "Decisions" [--content="…"] [--content-file ./decisions.md] [--parent <agendaPointId>] [--after <agendaPointId>] [--json]
+# 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]
 ente agenda link-task --point <agendaPointId> --task <activityId|#N> [--json]
 
 # Excalidraw Canvas HTML prototypes
@@ -614,3 +615,12 @@ No customer bodies, arbitrary account lookup, settings writes or mailbox retries
 Diagnostics is unavailable inside Ente-hosted chats, recordings and automations.
 Use the external operator command. Whole-history panel sharing does not grant
 access to diagnostics, and diagnostic reads do not append to chat history.
+
+
+### Identify this connection
+
+Use `ente agent set-icon fish` to change only this credential’s own Ente agent
+icon, then find it in `/agents`. Use `ente agent set-icon --reset` to restore the
+default. Run `ente agent set-icon --help` for curated IDs. Write scope is required;
+there is no agent-ID option. Connections shows last recorded external access,
+which can have historical gaps and excludes hosted/scheduled activity.

package/dist/cli.mjs

@@ -3800,7 +3800,7 @@ async function runCli(cli2, argv, context) {
 }
 
 // ente/version.ts
-var VERSION = "0.4.76";
+var VERSION = "0.4.78";
 
 // ente/branding.ts
 var NPM_REGISTRY = "https://registry.npmjs.org";
@@ -4246,7 +4246,7 @@ var EnteClient = class _EnteClient {
       ...spaceId ? { spaceId } : {}
     });
   }
-  // --- meeting agendas ---------------------------------------------------
+  // --- activity agendas ---------------------------------------------------
   createAgendaPoint(body) {
     return this.rest.post("/api/external/agenda-points", body);
   }
@@ -4285,6 +4285,9 @@ var EnteClient = class _EnteClient {
   getAuthContext() {
     return this.rest.get("/api/external/auth-context");
   }
+  setAgentIcon(icon) {
+    return this.rest.patch("/api/external/agent/icon", { icon });
+  }
   getAgentConfiguration() {
     return this.rest.get("/api/external/agent");
   }
@@ -15226,6 +15229,72 @@ var RECORDINGS_COMMANDS = [
   RecordingBackupJoinCommand
 ];
 
+// ../packages/shared/src/agent-icon.ts
+var entityCustomIconIds = [
+  "lightbulb",
+  "star",
+  "bookmark",
+  "target",
+  "flag",
+  "brain",
+  "book-open",
+  "puzzle",
+  "zap",
+  "compass",
+  "map",
+  "wrench",
+  "shield",
+  "heart-handshake",
+  "trophy",
+  "globe-2",
+  "network",
+  "landmark",
+  "leaf",
+  "route",
+  "binoculars",
+  "gem",
+  "crown",
+  "key",
+  "satellite",
+  "sun"
+];
+var activityCustomIconIds = [
+  "fish",
+  "bird",
+  "rabbit",
+  "turtle",
+  "squirrel",
+  "snail",
+  "bug",
+  "wand-sparkles",
+  "drama",
+  "music",
+  "dice-5",
+  "gift",
+  "flame",
+  "coffee",
+  "party-popper",
+  "rainbow",
+  "umbrella",
+  "anchor",
+  "sailboat",
+  "gamepad-2",
+  "ghost",
+  "bot",
+  "cloud",
+  "moon",
+  "smile"
+];
+var AGENT_ICON_IDS = [...entityCustomIconIds, ...activityCustomIconIds];
+function parseAgentIconInput(raw) {
+  if (!raw || typeof raw !== "object" || Array.isArray(raw)) throw new Error("Expected { icon: curated icon ID or null }");
+  const input = raw;
+  if (Object.keys(input).length !== 1 || !("icon" in input) || input.icon !== null && !AGENT_ICON_IDS.some((icon) => icon === input.icon)) {
+    throw new Error("Expected only icon: a curated icon ID or null; no agent ID is accepted");
+  }
+  return { icon: input.icon };
+}
+
 // ente/commands/agent.ts
 import { readFileSync as readFileSync11 } from "node:fs";
 import { randomUUID } from "node:crypto";
@@ -15594,6 +15663,18 @@ var AgentNew = class extends ClientCommand {
     throw new Error("This connection has no bound agent. Reconnect it in /agents.");
   }
 };
+var AgentSetIcon = class extends ClientCommand {
+  static paths = [["agent", "set-icon"]];
+  static usage = Command.Usage({ category: "Agent", description: "Change your own agent icon (curated ID, or --reset)", details: `Icons: ${AGENT_ICON_IDS.join(", ")}` });
+  icon = options_exports.String({ required: false });
+  reset = options_exports.Boolean("--reset", false);
+  async run() {
+    if (this.reset === (this.icon !== void 0)) throw new Error("Provide one icon ID or --reset.");
+    const { icon } = parseAgentIconInput({ icon: this.reset ? null : this.icon });
+    const result = await this.client().setAgentIcon(icon);
+    this.emitText(result, () => `Agent ${result.data.agentId}: ${result.data.icon ?? "default icon"}`);
+  }
+};
 var AgentConfigShow = class extends ClientCommand {
   static paths = [["agent", "config", "show"]];
   static usage = Command.Usage({
@@ -15650,6 +15731,7 @@ var AGENT_COMMANDS = [
   AgentSend,
   AgentNew,
   AgentAnalyze,
+  AgentSetIcon,
   AgentConfigShow,
   AgentConfigSetPrompt,
   AgentSchedulesConfigure
@@ -15660,12 +15742,12 @@ import { readFileSync as readFileSync12 } from "node:fs";
 var AgendaPointCreate = class extends ClientCommand {
   static paths = [["agenda", "create-point"]];
   static usage = Command.Usage({
-    category: "Meeting agenda",
+    category: "Activity agenda",
     description: "Create a titled agenda point with optional markdown content"
   });
-  meeting = options_exports.String("--meeting", {
+  activity = options_exports.String("--activity,--meeting", {
     required: true,
-    description: "Meeting activity ID"
+    description: "Activity ID of any type (--meeting is a compatibility alias)"
   });
   title = options_exports.String("--title", {
     required: true,
@@ -15688,7 +15770,7 @@ var AgendaPointCreate = class extends ClientCommand {
       throw new Error("Use either --content or --content-file, not both.");
     const contentMarkdown = this.content !== void 0 ? this.content : this.contentFile !== void 0 ? readFileSync12(this.contentFile, "utf8") : void 0;
     const result = await this.client().createAgendaPoint({
-      meetingActivityId: this.meeting,
+      meetingActivityId: this.activity,
       title: this.title,
       contentMarkdown,
       parentPointId: this.parent,
@@ -15701,7 +15783,7 @@ var AgendaPointCreate = class extends ClientCommand {
 var agendaPointDocumentId = (pointId) => `agenda-point:${pointId}`;
 var AgendaHtmlList = class extends ProfileCommand {
   static paths = [["agenda", "html", "list"]];
-  static usage = Command.Usage({ category: "Meeting agenda", description: "List interactive HTML blocks in an agenda point" });
+  static usage = Command.Usage({ category: "Activity agenda", description: "List interactive HTML blocks in an agenda point" });
   pointId = options_exports.String();
   async run() {
     const caller = await resolveCaller();
@@ -15712,7 +15794,7 @@ var AgendaHtmlList = class extends ProfileCommand {
 };
 var AgendaHtmlGet = class extends ProfileCommand {
   static paths = [["agenda", "html", "get"]];
-  static usage = Command.Usage({ category: "Meeting agenda", description: "Read one agenda-point HTML block including source" });
+  static usage = Command.Usage({ category: "Activity agenda", description: "Read one agenda-point HTML block including source" });
   pointId = options_exports.String();
   blockId = options_exports.String();
   async run() {
@@ -15725,7 +15807,7 @@ var AgendaHtmlGet = class extends ProfileCommand {
 };
 var AgendaHtmlAdd = class extends ProfileCommand {
   static paths = [["agenda", "html", "add"]];
-  static usage = Command.Usage({ category: "Meeting agenda", description: "Append an interactive HTML block to an agenda point" });
+  static usage = Command.Usage({ category: "Activity agenda", description: "Append an interactive HTML block to an agenda point" });
   pointId = options_exports.String();
   htmlFile = options_exports.String({ required: false, name: "htmlFile" });
   htmlFileFlag = options_exports.String("--html-file", { description: "Read HTML from a file; use - or omit for stdin" });
@@ -15750,7 +15832,7 @@ var AgendaHtmlAdd = class extends ProfileCommand {
 };
 var AgendaHtmlUpdate = class extends ProfileCommand {
   static paths = [["agenda", "html", "update"]];
-  static usage = Command.Usage({ category: "Meeting agenda", description: "Surgically update one agenda-point HTML block" });
+  static usage = Command.Usage({ category: "Activity agenda", description: "Surgically update one agenda-point HTML block" });
   pointId = options_exports.String();
   blockId = options_exports.String();
   htmlFile = options_exports.String("--html-file", { description: "Read HTML from a file; use - for stdin" });
@@ -16143,12 +16225,12 @@ Creating activities:
     --entity "Erik Stahl" --entity "Preclinics" --space "Preclinics" \\
     --content "Discussed QM system. Follow up on export feature."
 
-Meeting agendas:
+Activity agendas (all activity types; --meeting remains an alias):
   ente activity create --type meeting --title "QM system review" ...
-  ente agenda create-point --meeting <meeting-id> --title "Rollout" --content="- Decision ..."
+  ente agenda create-point --activity <activity-id> --title "Rollout" --content="- Decision ..."
   ente agenda link-task --point <point-id> --task "#12"
 
-  Prefer agenda points for structured meeting content when they add useful
+  Prefer agenda points for structured activity content when they add useful
   topic structure. Link meeting-derived tasks to the point they came from.
 
 Golden rule:
@@ -16223,7 +16305,7 @@ Tips:
   1. ente search "person name"         # find entity, check pins
   2. ente activity create --type meeting --title "..." \\
        --entity "person" --entity "their org" --space "..."
-  3. ente agenda create-point --meeting <meeting-id> --title "..." --content="..."
+  3. ente agenda create-point --activity <activity-id> --title "..." --content="..."
   4. If follow-ups: create each task, then:
      ente agenda link-task --point <point-id> --task <task-id|#N>