@alfe.ai/openclaw 0.2.0 → 0.3.1

package/dist/plugin2.cjs

@@ -31,6 +31,7 @@ var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__ge
 }) : target, mod));
 //#endregion
 let node_path = require("node:path");
+let node_fs_promises = require("node:fs/promises");
 let node_os = require("node:os");
 let node_module = require("node:module");
 let _alfe_ai_config = require("@alfe.ai/config");
@@ -3096,6 +3097,22 @@ let ipcClient = null;
 * proxy. openclaw-chat hardcodes the same host for /__alfe/set-identity.
 */
 const LOCAL_AI_PROXY_URL = process.env.ALFE_AI_PROXY_URL ?? "http://127.0.0.1:18193";
+/** Max avatar upload size — mirrors the server-side finalize check. */
+const MAX_AVATAR_BYTES = 5 * 1024 * 1024;
+/** Image types the avatar presign/finalize flow accepts, keyed by file extension. */
+const AVATAR_MIME_BY_EXT = {
+	".png": "image/png",
+	".jpg": "image/jpeg",
+	".jpeg": "image/jpeg",
+	".webp": "image/webp"
+};
+/** Infer an avatar mime type from a file path, rejecting unsupported types. */
+function avatarMimeFromPath(path) {
+	const ext = (0, node_path.extname)(path).toLowerCase();
+	const mimeType = AVATAR_MIME_BY_EXT[ext];
+	if (!mimeType) throw new Error(`unsupported image type "${ext || path}" — set_avatar accepts .png, .jpg/.jpeg, or .webp`);
+	return mimeType;
+}
 function ok(result) {
 	return { content: [{
 		type: "text",
@@ -3225,6 +3242,45 @@ function buildVoiceTools(client) {
 				};
 			}
 		}),
+		defineTool({
+			name: "generate_avatar",
+			description: "Generate and set THIS agent's own profile picture / avatar from a text prompt (e.g. a character description). Updates the agent's real profile picture shown in the dashboard, chat, and apps. Use this — do NOT use `config set ui.assistant.avatar`, which has no effect on the real profile.",
+			parameters: Type.Object({ prompt: Type.String({ description: "Text description of the avatar to generate (e.g. a character or portrait description)." }) }),
+			handler: async (params) => {
+				const prompt = params.prompt;
+				return {
+					updated: true,
+					avatarUrl: (await client.generateAvatar({ prompt })).avatarUrl,
+					note: "This is now your live profile picture across the Alfe dashboard, chat, and apps. `config set ui.assistant.avatar` is NOT the way — it has no effect on the real profile."
+				};
+			}
+		}),
+		defineTool({
+			name: "set_avatar",
+			description: "Set THIS agent's own profile picture from a local image file you created or downloaded (png/jpeg/webp, <=5MB). Updates the real profile picture shown in the dashboard, chat, and apps. Use this — do NOT use `config set ui.assistant.avatar`, which has no effect on the real profile.",
+			parameters: Type.Object({ path: Type.String({ description: "Absolute path to a local image file (.png, .jpg/.jpeg, or .webp, <=5MB) to use as the avatar." }) }),
+			handler: async (params) => {
+				const path = params.path;
+				const mimeType = avatarMimeFromPath(path);
+				const bytes = await (0, node_fs_promises.readFile)(path);
+				if (bytes.length > MAX_AVATAR_BYTES) throw new Error(`image is ${String(bytes.length)} bytes — the avatar limit is ${String(MAX_AVATAR_BYTES)} bytes (5MB)`);
+				const { uploadUrl, s3Key } = await client.presignAvatar({
+					mimeType,
+					size: bytes.length
+				});
+				const putRes = await fetch(uploadUrl, {
+					method: "PUT",
+					headers: { "Content-Type": mimeType },
+					body: bytes
+				});
+				if (!putRes.ok) throw new Error(`failed to upload the avatar image (${String(putRes.status)})`);
+				return {
+					updated: true,
+					avatarUrl: (await client.finalizeAvatar(s3Key)).avatarUrl,
+					note: "This is now your live profile picture across the Alfe dashboard, chat, and apps. `config set ui.assistant.avatar` is NOT the way — it has no effect on the real profile."
+				};
+			}
+		}),
 		defineTool({
 			name: "generate_image",
 			description: "Generate an image from a text prompt. Returns a URL to the generated PNG. To show the image to the user, embed it in your reply as markdown: ![description](imageUrl). Optional `model` picks the image model (default gpt-image-1).",

package/dist/plugin2.js

@@ -1,5 +1,6 @@
 import { createRequire } from "node:module";
-import { join } from "node:path";
+import { extname, join } from "node:path";
+import { readFile } from "node:fs/promises";
 import { homedir } from "node:os";
 import { resolveConfig } from "@alfe.ai/config";
 import { AgentApiClient } from "@alfe.ai/agent-api-client";
@@ -3097,6 +3098,22 @@ let ipcClient = null;
 * proxy. openclaw-chat hardcodes the same host for /__alfe/set-identity.
 */
 const LOCAL_AI_PROXY_URL = process.env.ALFE_AI_PROXY_URL ?? "http://127.0.0.1:18193";
+/** Max avatar upload size — mirrors the server-side finalize check. */
+const MAX_AVATAR_BYTES = 5 * 1024 * 1024;
+/** Image types the avatar presign/finalize flow accepts, keyed by file extension. */
+const AVATAR_MIME_BY_EXT = {
+	".png": "image/png",
+	".jpg": "image/jpeg",
+	".jpeg": "image/jpeg",
+	".webp": "image/webp"
+};
+/** Infer an avatar mime type from a file path, rejecting unsupported types. */
+function avatarMimeFromPath(path) {
+	const ext = extname(path).toLowerCase();
+	const mimeType = AVATAR_MIME_BY_EXT[ext];
+	if (!mimeType) throw new Error(`unsupported image type "${ext || path}" — set_avatar accepts .png, .jpg/.jpeg, or .webp`);
+	return mimeType;
+}
 function ok(result) {
 	return { content: [{
 		type: "text",
@@ -3226,6 +3243,45 @@ function buildVoiceTools(client) {
 				};
 			}
 		}),
+		defineTool({
+			name: "generate_avatar",
+			description: "Generate and set THIS agent's own profile picture / avatar from a text prompt (e.g. a character description). Updates the agent's real profile picture shown in the dashboard, chat, and apps. Use this — do NOT use `config set ui.assistant.avatar`, which has no effect on the real profile.",
+			parameters: Type.Object({ prompt: Type.String({ description: "Text description of the avatar to generate (e.g. a character or portrait description)." }) }),
+			handler: async (params) => {
+				const prompt = params.prompt;
+				return {
+					updated: true,
+					avatarUrl: (await client.generateAvatar({ prompt })).avatarUrl,
+					note: "This is now your live profile picture across the Alfe dashboard, chat, and apps. `config set ui.assistant.avatar` is NOT the way — it has no effect on the real profile."
+				};
+			}
+		}),
+		defineTool({
+			name: "set_avatar",
+			description: "Set THIS agent's own profile picture from a local image file you created or downloaded (png/jpeg/webp, <=5MB). Updates the real profile picture shown in the dashboard, chat, and apps. Use this — do NOT use `config set ui.assistant.avatar`, which has no effect on the real profile.",
+			parameters: Type.Object({ path: Type.String({ description: "Absolute path to a local image file (.png, .jpg/.jpeg, or .webp, <=5MB) to use as the avatar." }) }),
+			handler: async (params) => {
+				const path = params.path;
+				const mimeType = avatarMimeFromPath(path);
+				const bytes = await readFile(path);
+				if (bytes.length > MAX_AVATAR_BYTES) throw new Error(`image is ${String(bytes.length)} bytes — the avatar limit is ${String(MAX_AVATAR_BYTES)} bytes (5MB)`);
+				const { uploadUrl, s3Key } = await client.presignAvatar({
+					mimeType,
+					size: bytes.length
+				});
+				const putRes = await fetch(uploadUrl, {
+					method: "PUT",
+					headers: { "Content-Type": mimeType },
+					body: bytes
+				});
+				if (!putRes.ok) throw new Error(`failed to upload the avatar image (${String(putRes.status)})`);
+				return {
+					updated: true,
+					avatarUrl: (await client.finalizeAvatar(s3Key)).avatarUrl,
+					note: "This is now your live profile picture across the Alfe dashboard, chat, and apps. `config set ui.assistant.avatar` is NOT the way — it has no effect on the real profile."
+				};
+			}
+		}),
 		defineTool({
 			name: "generate_image",
 			description: "Generate an image from a text prompt. Returns a URL to the generated PNG. To show the image to the user, embed it in your reply as markdown: ![description](imageUrl). Optional `model` picks the image model (default gpt-image-1).",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@alfe.ai/openclaw",
-  "version": "0.2.0",
+  "version": "0.3.1",
   "description": "OpenClaw plugin for Alfe — connects to local gateway daemon via IPC for integration management",
   "type": "module",
   "main": "./dist/index.js",
@@ -27,7 +27,7 @@
     "@sinclair/typebox": "^0.34.48",
     "zod": "^4.1.5",
     "@alfe.ai/agent-api-client": "^0.4.0",
-    "@alfe.ai/config": "^0.2.0"
+    "@alfe.ai/config": "^0.3.0"
   },
   "peerDependencies": {
     "openclaw": ">=2026.3.0"