ente-cli 0.4.76 → 0.4.77

package/README.md

@@ -444,3 +444,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

@@ -614,3 +614,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.77";
 
 // ente/branding.ts
 var NPM_REGISTRY = "https://registry.npmjs.org";
@@ -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