@bpinhosilva/agent-orchestrator 1.0.0-alpha.29 → 1.0.0-alpha.30

package/CHANGELOG.md

@@ -1,3 +1,12 @@
+# [1.0.0-alpha.30](https://github.com/bpinhosilva/agent-orchestrator/compare/v1.0.0-alpha.29...v1.0.0-alpha.30) (2026-04-05)
+
+
+### Features
+
+* add UsersPage component with user management features and tests ([bb46646](https://github.com/bpinhosilva/agent-orchestrator/commit/bb466468849b01dd30bc228e3c0375b6aea874e8))
+* integrate Personality Matrix component, refactor storage service ([2aa80d3](https://github.com/bpinhosilva/agent-orchestrator/commit/2aa80d3b64cd6431ba0113182dcb5d871075fcfd))
+* integrate wait-on for improved dev workflow ([af26318](https://github.com/bpinhosilva/agent-orchestrator/commit/af2631820f5fc95b7b85c9f6ec52157b7df74264))
+
 # [1.0.0-alpha.29](https://github.com/bpinhosilva/agent-orchestrator/compare/v1.0.0-alpha.28...v1.0.0-alpha.29) (2026-04-04)
 
 

package/dist/agents/agent-emoji.constants.d.ts

@@ -0,0 +1,5 @@
+export declare const AGENT_EMOJI_VALUES: readonly ["🧠", "🤖", "🧪", "🛠️", "📊", "🔍", "🧭", "📝", "⚙️", "🚀"];
+export type AgentEmojiValue = (typeof AGENT_EMOJI_VALUES)[number];
+export declare const DEFAULT_AGENT_EMOJI: AgentEmojiValue;
+export declare const isAgentEmojiValue: (value: unknown) => value is AgentEmojiValue;
+export declare const normalizeAgentEmoji: (value?: string | null) => AgentEmojiValue;

package/dist/agents/agent-emoji.constants.js

@@ -0,0 +1,21 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.normalizeAgentEmoji = exports.isAgentEmojiValue = exports.DEFAULT_AGENT_EMOJI = exports.AGENT_EMOJI_VALUES = void 0;
+exports.AGENT_EMOJI_VALUES = [
+    '🧠',
+    '🤖',
+    '🧪',
+    '🛠️',
+    '📊',
+    '🔍',
+    '🧭',
+    '📝',
+    '⚙️',
+    '🚀',
+];
+exports.DEFAULT_AGENT_EMOJI = '🧠';
+const isAgentEmojiValue = (value) => typeof value === 'string' &&
+    exports.AGENT_EMOJI_VALUES.includes(value);
+exports.isAgentEmojiValue = isAgentEmojiValue;
+const normalizeAgentEmoji = (value) => (0, exports.isAgentEmojiValue)(value) ? value : exports.DEFAULT_AGENT_EMOJI;
+exports.normalizeAgentEmoji = normalizeAgentEmoji;

package/dist/agents/agents.service.js

@@ -72,6 +72,7 @@ let AgentsService = AgentsService_1 = class AgentsService {
                 role: agentEntity.role,
                 provider: providerName,
                 model: agentEntity.model?.name,
+                attributes: agentEntity.attributes,
             });
             this.agentInstances.set(agentEntity.id, instance);
             this.logger.debug(`Synchronized agent instance #${agentEntity.id}`);

package/dist/agents/dto/agent-attributes.dto.d.ts

@@ -0,0 +1,14 @@
+export declare const ATTRIBUTES_MIN = 1;
+export declare const ATTRIBUTES_MAX = 5;
+export declare const BALANCED_ATTRIBUTES: {
+    readonly creativity: 3;
+    readonly strictness: 3.5;
+};
+export declare class AgentAttributesDto {
+    creativity?: number;
+    strictness?: number;
+}
+export interface AgentAttributes {
+    creativity?: number;
+    strictness?: number;
+}

package/dist/agents/dto/agent-attributes.dto.js

@@ -0,0 +1,42 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AgentAttributesDto = exports.BALANCED_ATTRIBUTES = exports.ATTRIBUTES_MAX = exports.ATTRIBUTES_MIN = void 0;
+const openapi = require("@nestjs/swagger");
+const class_validator_1 = require("class-validator");
+exports.ATTRIBUTES_MIN = 1;
+exports.ATTRIBUTES_MAX = 5;
+exports.BALANCED_ATTRIBUTES = {
+    creativity: 3.0,
+    strictness: 3.5,
+};
+class AgentAttributesDto {
+    creativity;
+    strictness;
+    static _OPENAPI_METADATA_FACTORY() {
+        return { creativity: { required: false, type: () => Number, minimum: exports.ATTRIBUTES_MIN, maximum: exports.ATTRIBUTES_MAX }, strictness: { required: false, type: () => Number, minimum: exports.ATTRIBUTES_MIN, maximum: exports.ATTRIBUTES_MAX } };
+    }
+}
+exports.AgentAttributesDto = AgentAttributesDto;
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsNumber)({ maxDecimalPlaces: 2 }),
+    (0, class_validator_1.Min)(exports.ATTRIBUTES_MIN),
+    (0, class_validator_1.Max)(exports.ATTRIBUTES_MAX),
+    __metadata("design:type", Number)
+], AgentAttributesDto.prototype, "creativity", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsNumber)({ maxDecimalPlaces: 2 }),
+    (0, class_validator_1.Min)(exports.ATTRIBUTES_MIN),
+    (0, class_validator_1.Max)(exports.ATTRIBUTES_MAX),
+    __metadata("design:type", Number)
+], AgentAttributesDto.prototype, "strictness", void 0);

package/dist/agents/dto/create-agent.dto.d.ts

@@ -1,3 +1,5 @@
+import { type AgentEmojiValue } from '../agent-emoji.constants';
+import { AgentAttributesDto } from './agent-attributes.dto';
 export declare class CreateAgentDto {
     name: string;
     description?: string;
@@ -5,5 +7,7 @@ export declare class CreateAgentDto {
     systemInstructions?: string;
     modelId: string;
     status?: string;
+    emoji?: AgentEmojiValue;
     providerId: string;
+    attributes?: AgentAttributesDto;
 }

package/dist/agents/dto/create-agent.dto.js

@@ -12,6 +12,9 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.CreateAgentDto = void 0;
 const openapi = require("@nestjs/swagger");
 const class_validator_1 = require("class-validator");
+const class_transformer_1 = require("class-transformer");
+const agent_emoji_constants_1 = require("../agent-emoji.constants");
+const agent_attributes_dto_1 = require("./agent-attributes.dto");
 class CreateAgentDto {
     name;
     description;
@@ -19,9 +22,11 @@ class CreateAgentDto {
     systemInstructions;
     modelId;
     status;
+    emoji;
     providerId;
+    attributes;
     static _OPENAPI_METADATA_FACTORY() {
-        return { name: { required: true, type: () => String, maxLength: 200 }, description: { required: false, type: () => String, maxLength: 2000 }, role: { required: false, type: () => String, maxLength: 200 }, systemInstructions: { required: false, type: () => String, maxLength: 10000 }, modelId: { required: true, type: () => String }, status: { required: false, type: () => String, enum: ['active', 'inactive'] }, providerId: { required: true, type: () => String, format: "uuid" } };
+        return { name: { required: true, type: () => String, maxLength: 200 }, description: { required: false, type: () => String, maxLength: 2000 }, role: { required: false, type: () => String, maxLength: 200 }, systemInstructions: { required: false, type: () => String, maxLength: 10000 }, modelId: { required: true, type: () => String }, status: { required: false, type: () => String, enum: ['active', 'inactive'] }, emoji: { required: false, type: () => Object, enum: agent_emoji_constants_1.AGENT_EMOJI_VALUES }, providerId: { required: true, type: () => String, format: "uuid" }, attributes: { required: false, type: () => require("./agent-attributes.dto").AgentAttributesDto } };
     }
 }
 exports.CreateAgentDto = CreateAgentDto;
@@ -60,8 +65,20 @@ __decorate([
     (0, class_validator_1.IsIn)(['active', 'inactive']),
     __metadata("design:type", String)
 ], CreateAgentDto.prototype, "status", void 0);
+__decorate([
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsIn)(agent_emoji_constants_1.AGENT_EMOJI_VALUES),
+    __metadata("design:type", String)
+], CreateAgentDto.prototype, "emoji", void 0);
 __decorate([
     (0, class_validator_1.IsUUID)(),
     (0, class_validator_1.IsNotEmpty)(),
     __metadata("design:type", String)
 ], CreateAgentDto.prototype, "providerId", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.ValidateNested)(),
+    (0, class_transformer_1.Type)(() => agent_attributes_dto_1.AgentAttributesDto),
+    __metadata("design:type", agent_attributes_dto_1.AgentAttributesDto)
+], CreateAgentDto.prototype, "attributes", void 0);

package/dist/agents/entities/agent.entity.d.ts

@@ -1,5 +1,7 @@
 import { Model } from '../../models/entities/model.entity';
 import { Provider } from '../../providers/entities/provider.entity';
+import { type AgentEmojiValue } from '../agent-emoji.constants';
+import { type AgentAttributes } from '../dto/agent-attributes.dto';
 export declare class AgentEntity {
     id: string;
     name: string;
@@ -7,6 +9,8 @@ export declare class AgentEntity {
     systemInstructions: string;
     role: string | null;
     status: string | null;
+    emoji: AgentEmojiValue;
+    attributes: AgentAttributes | null;
     provider: Provider | null;
     model: Model | null;
     createdAt: Date;

package/dist/agents/entities/agent.entity.js

@@ -14,6 +14,7 @@ const openapi = require("@nestjs/swagger");
 const typeorm_1 = require("typeorm");
 const model_entity_1 = require("../../models/entities/model.entity");
 const provider_entity_1 = require("../../providers/entities/provider.entity");
+const agent_emoji_constants_1 = require("../agent-emoji.constants");
 let AgentEntity = class AgentEntity {
     id;
     name;
@@ -21,12 +22,14 @@ let AgentEntity = class AgentEntity {
     systemInstructions;
     role;
     status;
+    emoji;
+    attributes;
     provider;
     model;
     createdAt;
     updatedAt;
     static _OPENAPI_METADATA_FACTORY() {
-        return { id: { required: true, type: () => String }, name: { required: true, type: () => String }, description: { required: true, type: () => String }, systemInstructions: { required: true, type: () => String }, role: { required: true, type: () => String, nullable: true }, status: { required: true, type: () => String, nullable: true }, provider: { required: true, type: () => require("../../providers/entities/provider.entity").Provider, nullable: true }, model: { required: true, type: () => require("../../models/entities/model.entity").Model, nullable: true }, createdAt: { required: true, type: () => Date }, updatedAt: { required: true, type: () => Date } };
+        return { id: { required: true, type: () => String }, name: { required: true, type: () => String }, description: { required: true, type: () => String }, systemInstructions: { required: true, type: () => String }, role: { required: true, type: () => String, nullable: true }, status: { required: true, type: () => String, nullable: true }, emoji: { required: true, type: () => Object }, attributes: { required: true, type: () => Object, nullable: true }, provider: { required: true, type: () => require("../../providers/entities/provider.entity").Provider, nullable: true }, model: { required: true, type: () => require("../../models/entities/model.entity").Model, nullable: true }, createdAt: { required: true, type: () => Date }, updatedAt: { required: true, type: () => Date } };
     }
 };
 exports.AgentEntity = AgentEntity;
@@ -54,6 +57,14 @@ __decorate([
     (0, typeorm_1.Column)({ type: 'text', nullable: true }),
     __metadata("design:type", Object)
 ], AgentEntity.prototype, "status", void 0);
+__decorate([
+    (0, typeorm_1.Column)({ type: 'text', default: agent_emoji_constants_1.DEFAULT_AGENT_EMOJI }),
+    __metadata("design:type", String)
+], AgentEntity.prototype, "emoji", void 0);
+__decorate([
+    (0, typeorm_1.Column)({ type: 'simple-json', nullable: true }),
+    __metadata("design:type", Object)
+], AgentEntity.prototype, "attributes", void 0);
 __decorate([
     (0, typeorm_1.Index)(),
     (0, typeorm_1.ManyToOne)(() => provider_entity_1.Provider, {

package/dist/agents/implementations/claude.agent.d.ts

@@ -11,6 +11,7 @@ export declare class ClaudeAgent implements Agent {
     private role?;
     private provider;
     private model;
+    private attributes?;
     constructor(configService: ConfigService, model?: string);
     private validateApiKey;
     getName(): string;

package/dist/agents/implementations/claude.agent.js

@@ -19,6 +19,7 @@ const common_1 = require("@nestjs/common");
 const config_1 = require("@nestjs/config");
 const default_provider_models_1 = require("../default-provider-models");
 const agent_registry_1 = require("../registry/agent.registry");
+const personality_util_1 = require("../personality.util");
 let ClaudeAgent = ClaudeAgent_1 = class ClaudeAgent {
     configService;
     logger = new common_1.Logger(ClaudeAgent_1.name);
@@ -28,6 +29,7 @@ let ClaudeAgent = ClaudeAgent_1 = class ClaudeAgent {
     role;
     provider = 'anthropic';
     model;
+    attributes;
     constructor(configService, model = default_provider_models_1.DEFAULT_MODEL_BY_PROVIDER.anthropic) {
         this.configService = configService;
         this.model = model;
@@ -71,6 +73,8 @@ let ClaudeAgent = ClaudeAgent_1 = class ClaudeAgent {
             this.provider = config['provider'];
         if (config['model'])
             this.model = config['model'];
+        if ('attributes' in config)
+            this.attributes = config['attributes'];
     }
     buildSystemPrompt() {
         return [
@@ -80,6 +84,7 @@ let ClaudeAgent = ClaudeAgent_1 = class ClaudeAgent {
             this.systemInstructions
                 ? `Instructions:\n${this.systemInstructions}`
                 : '',
+            (0, personality_util_1.buildPersonalitySection)(this.attributes),
         ]
             .filter(Boolean)
             .join('\n');

package/dist/agents/implementations/gemini.agent.d.ts

@@ -13,6 +13,7 @@ export declare class GeminiAgent implements Agent {
     private provider;
     private model;
     private enableGrounding;
+    private attributes?;
     constructor(configService: ConfigService, model?: string);
     private getGenAI;
     getName(): string;

package/dist/agents/implementations/gemini.agent.js

@@ -19,6 +19,7 @@ const common_1 = require("@nestjs/common");
 const config_1 = require("@nestjs/config");
 const default_provider_models_1 = require("../default-provider-models");
 const agent_registry_1 = require("../registry/agent.registry");
+const personality_util_1 = require("../personality.util");
 let GeminiAgent = GeminiAgent_1 = class GeminiAgent {
     configService;
     logger = new common_1.Logger(GeminiAgent_1.name);
@@ -30,6 +31,7 @@ let GeminiAgent = GeminiAgent_1 = class GeminiAgent {
     provider = 'google';
     model;
     enableGrounding = true;
+    attributes;
     constructor(configService, model = default_provider_models_1.DEFAULT_MODEL_BY_PROVIDER.google) {
         this.configService = configService;
         this.model = model;
@@ -78,6 +80,8 @@ let GeminiAgent = GeminiAgent_1 = class GeminiAgent {
             this.model = config['model'];
         if (config['enableGrounding'] !== undefined)
             this.enableGrounding = !!config['enableGrounding'];
+        if ('attributes' in config)
+            this.attributes = config['attributes'];
     }
     async processText(input) {
         const isGrounded = this.isGroundingSupported();
@@ -102,6 +106,7 @@ let GeminiAgent = GeminiAgent_1 = class GeminiAgent {
                         this.systemInstructions
                             ? `Instructions:\n${this.systemInstructions}`
                             : '',
+                        (0, personality_util_1.buildPersonalitySection)(this.attributes),
                     ]
                         .filter(Boolean)
                         .join('\n'),

package/dist/agents/personality.util.d.ts

@@ -0,0 +1,8 @@
+import type { AgentAttributes } from './dto/agent-attributes.dto';
+export interface PersonalityDescriptor {
+    label: string;
+    directive: string;
+}
+export declare function getCreativityDescriptor(value: number): PersonalityDescriptor;
+export declare function getStrictnessDescriptor(value: number): PersonalityDescriptor;
+export declare function buildPersonalitySection(attributes: AgentAttributes | null | undefined): string;

package/dist/agents/personality.util.js

@@ -0,0 +1,81 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getCreativityDescriptor = getCreativityDescriptor;
+exports.getStrictnessDescriptor = getStrictnessDescriptor;
+exports.buildPersonalitySection = buildPersonalitySection;
+function getCreativityDescriptor(value) {
+    if (value < 2.0) {
+        return {
+            label: 'Analytical',
+            directive: 'Prioritize verifiable facts and established methods. Avoid speculation, metaphors, or novel framings. Deliver direct, evidence-based answers.',
+        };
+    }
+    if (value < 3.0) {
+        return {
+            label: 'Conservative',
+            directive: 'Stick to proven approaches and well-established patterns. Introduce creative elements only when they provide clear, demonstrable value.',
+        };
+    }
+    if (value < 4.0) {
+        return {
+            label: 'Balanced',
+            directive: 'Mix analytical precision with creative insight. Use examples, analogies, and varied perspectives where they add clarity or engagement.',
+        };
+    }
+    if (value < 5.0) {
+        return {
+            label: 'Inventive',
+            directive: 'Actively explore novel approaches and generate multiple perspectives. Use vivid analogies, thought experiments, and lateral thinking to enrich responses.',
+        };
+    }
+    return {
+        label: 'Imaginative',
+        directive: 'Embrace unconventional thinking and maximum creative exploration. Freely use thought experiments, metaphors, and imaginative reframings to inspire and surprise.',
+    };
+}
+function getStrictnessDescriptor(value) {
+    if (value < 2.0) {
+        return {
+            label: 'Flexible',
+            directive: 'Adapt tone and structure freely to the context. Allow ambiguity, be conversational, and interpret requests generously.',
+        };
+    }
+    if (value < 3.0) {
+        return {
+            label: 'Relaxed',
+            directive: 'Maintain a loose but coherent structure. Respond naturally and informally when appropriate; precision is secondary to clarity.',
+        };
+    }
+    if (value < 4.0) {
+        return {
+            label: 'Structured',
+            directive: 'Organize all responses clearly and follow instructions precisely. Balance thoroughness with approachability.',
+        };
+    }
+    if (value < 5.0) {
+        return {
+            label: 'Rigorous',
+            directive: 'Apply strict formatting and boundary adherence in every response. Minimize deviation from stated constraints; flag any ambiguities before proceeding.',
+        };
+    }
+    return {
+        label: 'Exacting',
+        directive: 'Enforce all rules and constraints absolutely. Use precise, formal language. Never deviate from defined parameters; reject or escalate any out-of-scope requests.',
+    };
+}
+function buildPersonalitySection(attributes) {
+    if (!attributes)
+        return '';
+    const lines = [];
+    if (attributes.creativity !== undefined) {
+        const { label, directive } = getCreativityDescriptor(attributes.creativity);
+        lines.push(`- Creativity: ${attributes.creativity.toFixed(2)}/5 (${label}) — ${directive}`);
+    }
+    if (attributes.strictness !== undefined) {
+        const { label, directive } = getStrictnessDescriptor(attributes.strictness);
+        lines.push(`- Strictness: ${attributes.strictness.toFixed(2)}/5 (${label}) — ${directive}`);
+    }
+    if (lines.length === 0)
+        return '';
+    return ['[PERSONALITY MATRIX]', ...lines].join('\n');
+}

package/dist/app.module.js

@@ -29,6 +29,7 @@ const core_1 = require("@nestjs/core");
 const auth_module_1 = require("./auth/auth.module");
 const jwt_auth_guard_1 = require("./auth/guards/jwt-auth.guard");
 const roles_guard_1 = require("./auth/guards/roles.guard");
+const system_settings_module_1 = require("./system-settings/system-settings.module");
 const typeorm_2 = require("./config/typeorm");
 const runtime_paths_1 = require("./config/runtime-paths");
 (0, runtime_paths_1.loadRuntimeEnv)();
@@ -88,6 +89,7 @@ exports.AppModule = AppModule = __decorate([
             projects_module_1.ProjectsModule,
             users_module_1.UsersModule,
             auth_module_1.AuthModule,
+            system_settings_module_1.SystemSettingsModule,
         ],
         controllers: [app_controller_1.AppController],
         providers: [

package/dist/auth/guards/roles.guard.js

@@ -39,7 +39,7 @@ let RolesGuard = class RolesGuard {
             throw new common_1.ForbiddenException('Insufficient permissions');
         }
         if (!requiredRoles.includes(user.role)) {
-            throw new common_1.ForbiddenException('Insufficient permissions');
+            throw new common_1.ForbiddenException(`Insufficient permissions. Role '${user.role}' not found in allowed roles: [${requiredRoles.join(', ')}]`);
         }
         return true;
     }

package/dist/common/common.module.js

@@ -9,13 +9,21 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.CommonModule = void 0;
 const common_1 = require("@nestjs/common");
 const storage_service_1 = require("./storage.service");
+const filesystem_storage_service_1 = require("./filesystem-storage.service");
+const storage_path_helper_1 = require("./storage-path.helper");
 let CommonModule = class CommonModule {
 };
 exports.CommonModule = CommonModule;
 exports.CommonModule = CommonModule = __decorate([
     (0, common_1.Global)(),
     (0, common_1.Module)({
-        providers: [storage_service_1.StorageService],
-        exports: [storage_service_1.StorageService],
+        providers: [
+            {
+                provide: storage_service_1.StorageService,
+                useClass: filesystem_storage_service_1.FileSystemStorageService,
+            },
+            storage_path_helper_1.StoragePathHelper,
+        ],
+        exports: [storage_service_1.StorageService, storage_path_helper_1.StoragePathHelper],
     })
 ], CommonModule);

package/dist/common/filesystem-storage.service.d.ts

@@ -0,0 +1,17 @@
+import { StorageService } from './storage.service';
+export declare class FileSystemStorageService extends StorageService {
+    private readonly logger;
+    private readonly baseDir;
+    private readonly defaultBucket;
+    constructor();
+    getBucketPath(bucket: string): string;
+    getFullPath(relativePath: string, bucket?: string): string;
+    saveBase64(base64: string, mimeType: string, filePath: string, bucket?: string): Promise<void>;
+    save(buffer: Buffer, mimeType: string, filePath: string, bucket?: string): Promise<void>;
+    delete(relativePath: string, bucket?: string): Promise<void>;
+    private ensureDir;
+    private normalizeLegacyPath;
+    private assertSafePath;
+    private validateMimeType;
+    private validateFileSize;
+}

package/dist/common/filesystem-storage.service.js

@@ -0,0 +1,131 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+var FileSystemStorageService_1;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FileSystemStorageService = void 0;
+const common_1 = require("@nestjs/common");
+const path = __importStar(require("path"));
+const fs = __importStar(require("fs"));
+const promises_1 = require("fs/promises");
+const storage_service_1 = require("./storage.service");
+const storage_path_helper_1 = require("./storage-path.helper");
+const MAX_FILE_SIZE_BYTES = 10 * 1024 * 1024;
+let FileSystemStorageService = FileSystemStorageService_1 = class FileSystemStorageService extends storage_service_1.StorageService {
+    logger = new common_1.Logger(FileSystemStorageService_1.name);
+    baseDir;
+    defaultBucket = 'artifacts';
+    constructor() {
+        super();
+        this.baseDir =
+            process.env.AGENT_ORCHESTRATOR_HOME ||
+                path.join(process.cwd(), '.agent-orchestrator');
+        this.ensureDir(this.baseDir);
+        this.ensureDir(path.join(this.baseDir, this.defaultBucket));
+    }
+    getBucketPath(bucket) {
+        return path.join(this.baseDir, bucket);
+    }
+    getFullPath(relativePath, bucket = this.defaultBucket) {
+        return path.join(this.getBucketPath(bucket), relativePath);
+    }
+    async saveBase64(base64, mimeType, filePath, bucket) {
+        this.validateMimeType(mimeType);
+        const buffer = Buffer.from(base64, 'base64');
+        return this.save(buffer, mimeType, filePath, bucket);
+    }
+    async save(buffer, mimeType, filePath, bucket = this.defaultBucket) {
+        this.validateMimeType(mimeType);
+        this.validateFileSize(buffer.length);
+        this.assertSafePath(filePath);
+        const fullDir = path.join(this.getBucketPath(bucket), path.dirname(filePath));
+        const filename = path.basename(filePath);
+        this.ensureDir(fullDir);
+        await (0, promises_1.writeFile)(path.join(fullDir, filename), buffer);
+        this.logger.debug(`Saved artifact: bucket=${bucket} path=${filePath}`);
+    }
+    async delete(relativePath, bucket = this.defaultBucket) {
+        const normalized = this.normalizeLegacyPath(relativePath);
+        this.assertSafePath(normalized);
+        const fullPath = this.getFullPath(normalized, bucket);
+        if (fs.existsSync(fullPath)) {
+            await (0, promises_1.unlink)(fullPath);
+            this.logger.debug(`Deleted artifact file: ${fullPath}`);
+        }
+    }
+    ensureDir(dir) {
+        if (!fs.existsSync(dir)) {
+            fs.mkdirSync(dir, { recursive: true });
+            this.logger.log(`Created directory: ${dir}`);
+        }
+    }
+    normalizeLegacyPath(relativePath) {
+        const legacyPrefix = `uploads/${this.defaultBucket}/`;
+        if (relativePath.startsWith(legacyPrefix)) {
+            return path.basename(relativePath);
+        }
+        return relativePath;
+    }
+    assertSafePath(inputPath) {
+        const normalized = path.normalize(inputPath);
+        if (path.isAbsolute(normalized) ||
+            normalized.split(path.sep).includes('..')) {
+            throw new common_1.BadRequestException(`Invalid path: ${inputPath}`);
+        }
+    }
+    validateMimeType(mimeType) {
+        if (!storage_path_helper_1.ALLOWED_MIME_TYPES.has(mimeType)) {
+            throw new common_1.BadRequestException(`File type '${mimeType}' is not allowed. Allowed types: ${[...storage_path_helper_1.ALLOWED_MIME_TYPES].join(', ')}`);
+        }
+    }
+    validateFileSize(sizeInBytes) {
+        if (sizeInBytes > MAX_FILE_SIZE_BYTES) {
+            throw new common_1.BadRequestException(`File size (${Math.round(sizeInBytes / 1024 / 1024)}MB) exceeds the maximum allowed size of ${MAX_FILE_SIZE_BYTES / 1024 / 1024}MB`);
+        }
+    }
+};
+exports.FileSystemStorageService = FileSystemStorageService;
+exports.FileSystemStorageService = FileSystemStorageService = FileSystemStorageService_1 = __decorate([
+    (0, common_1.Injectable)(),
+    __metadata("design:paramtypes", [])
+], FileSystemStorageService);

package/dist/common/storage-path.helper.d.ts

@@ -0,0 +1,21 @@
+export declare enum StorageContext {
+    TASKS = "tasks",
+    AGENTS = "agents",
+    COMMENTS = "comments"
+}
+export interface StorageObjectPath {
+    id: string;
+    filePath: string;
+    originalName: string;
+    mimeType: string;
+}
+export declare const ALLOWED_MIME_TYPES: Set<string>;
+export interface GenerateOptions {
+    context: StorageContext;
+    contextId: string;
+    mimeType: string;
+    originalName: string;
+}
+export declare class StoragePathHelper {
+    generate(options: GenerateOptions): StorageObjectPath;
+}