Skip to content

SmythOS Studio: Open-Source Visual AI Agent Builder and deployable runtime stack from SmythOS. Start with an intuitive drag-and-drop workspace, extend with custom code, and deploy your agents anywhere — local, cloud, or edge — with full governance and control.

Implement avatar management features

Muhammad Hamza Khanab90f842a098
diff --git a/packages/app/src/backend/routes/api/page/agent-settings.ts b/packages/app/src/backend/routes/api/page/agent-settings.ts
index ced33b9f..8ae14de0 100644
--- a/packages/app/src/backend/routes/api/page/agent-settings.ts
+++ b/packages/app/src/backend/routes/api/page/agent-settings.ts
@@ -1,4 +1,5 @@
-import { assetStorage } from '@src/backend/services/storage';
+import { getRandomAvatarUrl } from '@src/backend/services/avatar-pool.service';
+import { assetStorage, StorageFactory } from '@src/backend/services/storage';
import { randomUUID } from 'crypto';
import express, { Request } from 'express';
import { rateLimit } from 'express-rate-limit';
@@ -188,24 +189,31 @@ router.post(
[includeTeamDetails, avatarGenRateLimiter],
async (req: Request, res) => {
try {
- const base64Image: string = await falai.generateImage({
- prompt: generateLinkedInAvatarPrompt(),
- });
-
- const key = posixPath('teams', md5Hash(req._team.id), `avatar-${randomUUID()}`);
- const uploaded = await assetStorage.saveContent({
- key,
- contentType: 'image/png',
- body: Buffer.from(base64Image, 'base64'),
- skipAclCheck: true,
- });
-
- if (!uploaded.success) {
- return res.status(500).json({ error: 'Internal Server Error' });
+ const isS3Storage = StorageFactory.determineAdapter() === 's3';
+ let publicUrl = '';
+
+ if (isS3Storage) {
+ publicUrl = await getRandomAvatarUrl();
+ } else {
+ const base64Image: string = await falai.generateImage({
+ prompt: generateLinkedInAvatarPrompt(),
+ });
+
+ const key = posixPath('teams', md5Hash(req._team.id), `avatar-${randomUUID()}`);
+ const uploaded = await assetStorage.saveContent({
+ key,
+ contentType: 'image/png',
+ body: Buffer.from(base64Image, 'base64'),
+ skipAclCheck: true,
+ });
+
+ if (!uploaded.success) {
+ return res.status(500).json({ error: 'Internal Server Error' });
+ }
+
+ publicUrl = uploaded.url;
}
- const publicUrl = uploaded.url;
-
// save the avatar in the agent settings
await smythAPIReq.put(
`/ai-agent/${req.params.agentId}/settings`,
diff --git a/packages/app/src/backend/services/avatar-pool.service.ts b/packages/app/src/backend/services/avatar-pool.service.ts
new file mode 100644
index 00000000..2f59200c
--- /dev/null
+++ b/packages/app/src/backend/services/avatar-pool.service.ts
@@ -0,0 +1,59 @@
+/**
+ * AvatarPoolService - Provides random avatar selection from existing S3 storage
+ * Uses in-memory caching to avoid hitting S3 on every request
+ */
+
+import { assetStorage } from './storage';
+
+/** Cache for avatar keys */
+let cachedAvatarKeys: string[] = [];
+let cacheTimestamp: number = 0;
+const CACHE_TTL_MS = 30 * 24 * 60 * 60 * 1000; // 30 days
+
+/**
+ * Refreshes the avatar keys cache from S3 storage
+ */
+async function refreshCache(): Promise<void> {
+ try {
+ // Cast to S3Storage to access listAvatarKeys method
+ const s3Storage = assetStorage as any;
+ if (typeof s3Storage.listAvatarKeys === 'function') {
+ cachedAvatarKeys = await s3Storage.listAvatarKeys();
+ cacheTimestamp = Date.now();
+ } else {
+ throw new Error('listAvatarKeys method not available on storage');
+ }
+ } catch (error) {
+ console.error('[AvatarPool] Failed to refresh cache:', error);
+ throw error;
+ }
+}
+
+/**
+ * Ensures cache is populated and not expired
+ */
+async function ensureCacheReady(): Promise<void> {
+ const now = Date.now();
+ const isExpired = now - cacheTimestamp > CACHE_TTL_MS;
+
+ if (cachedAvatarKeys.length === 0 || isExpired) {
+ await refreshCache();
+ }
+}
+
+/**
+ * Gets a random avatar URL from the cached pool
+ * @returns Promise resolving to a random avatar public URL
+ */
+export async function getRandomAvatarUrl(): Promise<string> {
+ await ensureCacheReady();
+
+ if (cachedAvatarKeys.length === 0) {
+ throw new Error('No avatars available in the pool');
+ }
+
+ const randomIndex = Math.floor(Math.random() * cachedAvatarKeys.length);
+ const randomKey = cachedAvatarKeys[randomIndex];
+
+ return assetStorage.getPublicUrl(randomKey);
+}
diff --git a/packages/app/src/backend/services/storage/S3Storage.class.ts b/packages/app/src/backend/services/storage/S3Storage.class.ts
index a6c1651d..bdabd6b7 100644
--- a/packages/app/src/backend/services/storage/S3Storage.class.ts
+++ b/packages/app/src/backend/services/storage/S3Storage.class.ts
@@ -3,6 +3,7 @@ import {
DeleteObjectCommandInput,
GetObjectCommand,
HeadObjectCommand,
+ ListObjectsV2Command,
PutObjectCommand,
PutObjectCommandInput,
S3Client,
@@ -207,4 +208,44 @@ export default class S3Storage implements StaticStorage {
);
return res.Body as NodeJS.ReadableStream;
}
+
+ public async listAvatarKeys(
+ prefix: string = 'teams/',
+ maxKeys: number = 2500,
+ ): Promise<string[]> {
+ const avatarKeys: string[] = [];
+ let continuationToken: string | undefined;
+ const avatarPattern = /avatar-/i;
+
+ try {
+ do {
+ const command = new ListObjectsV2Command({
+ Bucket: this.bucket,
+ Prefix: prefix,
+ MaxKeys: 1000,
+ ContinuationToken: continuationToken,
+ });
+
+ const response = await this.client.send(command);
+ const contents = response.Contents ?? [];
+
+ for (const obj of contents) {
+ if (obj.Key && avatarPattern.test(obj.Key)) {
+ avatarKeys.push(obj.Key);
+ if (avatarKeys.length >= maxKeys) {
+ break;
+ }
+ }
+ }
+
+ continuationToken = response.NextContinuationToken;
+ } while (continuationToken && avatarKeys.length < maxKeys);
+
+ logger.info(`Found ${avatarKeys.length} avatar keys`);
+ return avatarKeys;
+ } catch (error) {
+ logger.error(`Error listing avatar keys: `, error);
+ throw error;
+ }
+ }
}
diff --git a/packages/app/src/shared/state_stores/builder/slices/agent_operations.slice.ts b/packages/app/src/shared/state_stores/builder/slices/agent_operations.slice.ts
index 52b8dfa1..dca23daf 100644
--- a/packages/app/src/shared/state_stores/builder/slices/agent_operations.slice.ts
+++ b/packages/app/src/shared/state_stores/builder/slices/agent_operations.slice.ts
@@ -28,10 +28,8 @@ export const agentOperationsSlice: StateCreator<BuilderStore, [], [], AgentOpera
if (response.ok) {
const data = await response.json();
if (data.url && window.workspace?.agent) {
- const timeoutId = setTimeout(() => {
- window.workspace.agent.emit('AvatarUpdated', data.url);
- clearTimeout(timeoutId);
- }, 1000);
+ window.sessionStorage.setItem(`agent-avatar-${agentId}`, data.url);
+ window.workspace.agent.emit('AvatarUpdated', data.url);
}
return true;
}