@bpinhosilva/agent-orchestrator 0.0.1

package/.github/ISSUE_TEMPLATE/bug_report.md

@@ -0,0 +1,25 @@
+---
+name: Bug Report
+about: Create a report to help us improve
+title: 'fix: '
+labels: bug
+assignees: ''
+
+---
+
+**Describe the bug**
+A clear and concise description of what the bug is.
+
+**To Reproduce**
+Steps to reproduce the behavior.
+
+**Expected behavior**
+A clear and concise description of what you expected to happen.
+
+**Environment details:**
+ - OS: [e.g. Ubuntu 22.04]
+ - Node.js version: [e.g. 20.x]
+ - Package version: [e.g. 1.0.0]
+
+**Additional context**
+Add any other context about the problem here.

package/.github/ISSUE_TEMPLATE/feature_request.md

@@ -0,0 +1,20 @@
+---
+name: Feature Request
+about: Suggest an idea for this project
+title: 'feat: '
+labels: enhancement
+assignees: ''
+
+---
+
+**Is your feature request related to a problem? Please describe.**
+A clear and concise description of what the problem is. Ex. I'm always frustrated when [...]
+
+**Describe the solution you'd like**
+A clear and concise description of what you want to happen.
+
+**Describe alternatives you've considered**
+A clear and concise description of any alternative solutions or features you've considered.
+
+**Additional context**
+Add any other context or screenshots about the feature request here.

package/.github/PULL_REQUEST_TEMPLATE.md

@@ -0,0 +1,18 @@
+## Description
+<!-- Please include a concise summary of the changes and the related issue. -->
+Resolves #
+
+## Type of change
+- [ ] Bug fix (non-breaking change which fixes an issue)
+- [ ] New feature (non-breaking change which adds functionality)
+- [ ] Breaking change (fix or feature that would cause existing functionality to not work as expected)
+- [ ] Documentation update
+
+## Checklist:
+- [ ] My code follows the Conventional Commits specification.
+- [ ] I have performed a self-review of my own code.
+- [ ] I have commented my code, particularly in hard-to-understand areas.
+- [ ] I have made corresponding changes to the documentation.
+- [ ] My changes generate no new warnings.
+- [ ] I have added tests that prove my fix is effective or that my feature works.
+- [ ] New and existing tests pass locally with my changes.

package/.github/workflows/ci.yml

@@ -0,0 +1,34 @@
+name: CI
+
+on:
+  push:
+    branches: [ "main" ]
+  pull_request:
+    branches: [ "main" ]
+
+jobs:
+  build-and-test:
+    runs-on: ubuntu-latest
+    steps:
+    - uses: actions/checkout@v5
+    
+    - name: Use Node.js 24.x
+      uses: actions/setup-node@v5
+      with:
+        node-version: '24.x'
+        cache: 'npm'
+        
+    - run: npm ci
+    
+    - name: Run npm audit
+      run: npm audit --audit-level=high
+      
+    - name: Run linter
+      run: npm run lint
+      
+    - name: Run unit tests
+      run: npm test
+
+    # Optional: Generate a coverage report
+    - name: Run tests with coverage
+      run: npm run test:cov

package/.github/workflows/gitleaks.yml

@@ -0,0 +1,22 @@
+name: gitleaks
+
+on:
+  push:
+    branches:
+      - main
+  pull_request:
+    branches:
+      - main
+
+jobs:
+  scan:
+    name: gitleaks
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v5
+        with:
+          fetch-depth: 0
+      - uses: gitleaks/gitleaks-action@v2
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+          FORCE_JAVASCRIPT_ACTIONS_TO_NODE24: true

package/.github/workflows/release.yml

@@ -0,0 +1,38 @@
+name: Release
+
+on:
+  push:
+    branches:
+      - main
+
+permissions:
+  contents: write # to be able to publish a GitHub release
+  issues: write # to be able to comment on released issues
+  pull-requests: write # to be able to comment on released pull requests
+  id-token: write # required for Trusted Publishing
+
+jobs:
+  release:
+    name: Release
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v5
+        with:
+          fetch-depth: 0
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v5
+        with:
+          node-version: '24'
+
+      - name: Install dependencies
+        run: npm ci
+
+      - name: Run tests
+        run: npm test
+
+      - name: Semantic Release
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+        run: npx semantic-release

package/.husky/commit-msg

@@ -0,0 +1 @@
+npx --no -- commitlint --edit "$1"

package/.husky/pre-commit

@@ -0,0 +1,6 @@
+npm run lint
+npm test
+
+
+# Note: Local gitleaks execution via npm is disabled because the executable isn't reliably available across environments.
+# The GitHub Action will still enforce secret scanning on all Pull Requests and pushes.

package/.prettierrc

@@ -0,0 +1,4 @@
+{
+  "singleQuote": true,
+  "trailingComma": "all"
+}

package/.releaserc.json

@@ -0,0 +1,31 @@
+{
+  "branches": [
+    "main",
+    {
+      "name": "alpha",
+      "prerelease": true
+    }
+  ],
+  "plugins": [
+    "@semantic-release/commit-analyzer",
+    "@semantic-release/release-notes-generator",
+    "@semantic-release/changelog",
+    [
+      "@semantic-release/npm",
+      {
+        "npmPublish": true
+      }
+    ],
+    "@semantic-release/github",
+    [
+      "@semantic-release/git",
+      {
+        "assets": [
+          "CHANGELOG.md",
+          "package.json"
+        ],
+        "message": "chore(release): ${nextRelease.version} [skip ci]\n\n${nextRelease.notes}"
+      }
+    ]
+  ]
+}

package/CONTRIBUTING.md

@@ -0,0 +1,64 @@
+# Contributing to Agent Orchestrator
+
+First off, thank you for considering contributing to this project!
+
+## 1. Local Development Setup
+
+To get your environment set up:
+
+1. **Clone the repository:**
+   ```bash
+   git clone <your-fork-url>
+   cd agent-orchestrator
+   ```
+
+2. **Install dependencies:**
+   ```bash
+   npm install
+   ```
+
+3. **Start the development server:**
+   ```bash
+   npm run start:dev
+   ```
+
+4. **Run tests:**
+   ```bash
+   npm test
+   ```
+
+## 2. Branching Strategy (GitHub Flow)
+
+We use exactly **one** long-lived branch: `main`.
+
+1. Always create a new branch from `main` for your work.
+   ```bash
+   git checkout -b feature/your-feature-name
+   ```
+2. Commit your changes locally.
+3. Push to your fork and submit a Pull Request against our `main` branch.
+
+## 3. Commit Message Conventions (Conventional Commits)
+
+We use [Conventional Commits](https://www.conventionalcommits.org/en/v1.0.0/). This project uses `husky` and `commitlint` to automatically enforce these rules when you commit.
+
+Your commit messages MUST follow this format:
+```
+<type>(<optional scope>): <description>
+
+[optional body]
+```
+
+* **`feat:`** A new feature
+* **`fix:`** A bug fix
+* **`docs:`** Documentation only changes
+* **`style:`** Changes that do not affect the meaning of the code (white-space, formatting, etc)
+* **`refactor:`** A code change that neither fixes a bug nor adds a feature
+* **`perf:`** A code change that improves performance
+* **`test:`** Adding missing tests or correcting existing tests
+* **`chore:`** Changes to the build process or auxiliary tools and libraries such as documentation generation
+
+**Example:**
+```
+feat(gemini): add support for gemini-2.5-flash-lite
+```

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Bruno Sampaio Pinho da Silva
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,75 @@
+# Agent Orchestrator
+
+[![CI](https://github.com/bpinhosilva/agent-orchestrator/actions/workflows/ci.yml/badge.svg)](https://github.com/bpinhosilva/agent-orchestrator/actions/workflows/ci.yml)
+[![Release](https://github.com/bpinhosilva/agent-orchestrator/actions/workflows/release.yml/badge.svg)](https://github.com/bpinhosilva/agent-orchestrator/actions/workflows/release.yml)
+[![Gitleaks](https://github.com/bpinhosilva/agent-orchestrator/actions/workflows/gitleaks.yml/badge.svg)](https://github.com/bpinhosilva/agent-orchestrator/actions/workflows/gitleaks.yml)
+
+Agent Orchestrator is an open-source project designed to manage and orchestrate AI agents using both back-end services and front-end applications. It provides an automated agentic execution environment where you can create multiple agent profiles (e.g., Head Agent, Researcher, CMO) and delegate tasks to them through automated workflows.
+
+## Features (In Progress & Planned)
+- **Agent Delegation**: Delegate tasks to specialized AI agents.
+- **Job Scheduler**: Create and schedule recurring agentic tasks.
+- **Workflow Engine**: Drag-and-drop workflow builder supporting triggers, agent chaining, and outputs.
+- **Agent Capabilities**: File reading/writing, web search, email capabilities, and image generation using NanoBanana.
+- **TUI/CLI Tooling**: CLI executables to manage the installation and local agent configuration.
+
+## Current Architecture
+- **Backend Framework**: NestJS + TypeScript
+- **Frontend SPA**: React (Currently served as a single placeholder HTML file by the backend for MVP)
+- **Database**: PostgreSQL (via Docker Compose)
+- **Testing**: Jest (TDD Approach with Unit & E2E)
+- **Architecture**: 3-Tier (Controller, Service, DAL/Adapter Interfaces)
+
+## Prerequisites
+- [Node.js](https://nodejs.org/) (v18+)
+- [Docker](https://www.docker.com/) and Docker Compose (Optional for local PostgreSQL deployment)
+- A [Google Gemini API Key](https://aistudio.google.com/)
+
+## Installation
+
+```bash
+$ npm install
+```
+
+## Running the app
+
+Before running the application, ensure you have set the `GEMINI_API_KEY` in your environment variables, as the default agent is the `GeminiAgent`.
+
+```bash
+# Start the PostgreSQL Database
+$ docker compose up -d
+
+# development
+$ GEMINI_API_KEY="your-api-key" npm run start
+
+# watch mode
+$ GEMINI_API_KEY="your-api-key" npm run start:dev
+
+# production mode
+$ GEMINI_API_KEY="your-api-key" npm run start:prod
+```
+
+Once running, you can access the frontend dashboard container URL at `http://localhost:3000`. The API endpoints are accessible via `http://localhost:3000/api/v1/`.
+
+## Testing
+
+```bash
+# unit tests
+$ npm run test
+
+# e2e tests
+$ npm run test:e2e
+
+# test coverage
+$ npm run test:cov
+```
+
+## API usage
+
+**Endpoint**: `POST /api/v1/agents/process`
+**Payload**:
+```json
+{
+  "input": "Write a short poem about automation."
+}
+```

package/TODO.md

@@ -0,0 +1,14 @@
+# Agent Orchestrator TODO List
+
+These are features and concepts to be discussed and implemented later:
+
+- [ ] **Database Schema:** Model schema for agents, agent profiles (head, researcher, etc.), tasks, and workflows.
+- [ ] **Authentication & Authorization:** Secure the API and frontend dashboard.
+- [ ] **Executable Creation:** Implement ability to run project as an executable using `npx` or `pnpm`.
+- [ ] **Release Management:** Set up semantic versioning (v0.x, v1.x) and branching strategies. (Standard today for OSS is GitHub Flow or Trunk-Based Development, rather than gitflow which is considered too heavy for most modern continuous delivery workflows).
+- [ ] **CI/CD Pipelines:** GitHub Actions for automated unit testing (Jest), deployment, and PR validations.
+- [ ] **Task & Job Execution:** Structure the database and execution flow for tasks assigned to agents.
+- [ ] **Agent Workflow Engine:** Build a drag-and-drop workflow system with node triggers, inputs, and outputs.
+- [ ] **Extended Capabilities:** Add "read file", "write file", "search web", "send e-mail", and image generation (NanoBanana).
+- [ ] **Full Frontend Application:** Replace static placeholder with the React administrative dashboard.
+- [ ] **Metrics:** Expose system metrics (e.g., Prometheus/Grafana) to monitor application health and performance.

package/commitlint.config.js

@@ -0,0 +1,3 @@
+module.exports = {
+  extends: ['@commitlint/config-conventional']
+};

package/dist/agents/agents.controller.d.ts

@@ -0,0 +1,8 @@
+import { AgentsService } from './agents.service';
+import { AgentRequestDto } from './dto/agent-request.dto';
+import { AgentResponse } from './interfaces/agent.interface';
+export declare class AgentsController {
+    private readonly agentsService;
+    constructor(agentsService: AgentsService);
+    processText(requestDto: AgentRequestDto): Promise<AgentResponse>;
+}

package/dist/agents/agents.controller.js

@@ -0,0 +1,39 @@
+"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);
+};
+var __param = (this && this.__param) || function (paramIndex, decorator) {
+    return function (target, key) { decorator(target, key, paramIndex); }
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AgentsController = void 0;
+const common_1 = require("@nestjs/common");
+const agents_service_1 = require("./agents.service");
+const agent_request_dto_1 = require("./dto/agent-request.dto");
+let AgentsController = class AgentsController {
+    constructor(agentsService) {
+        this.agentsService = agentsService;
+    }
+    async processText(requestDto) {
+        return this.agentsService.processRequest(requestDto);
+    }
+};
+exports.AgentsController = AgentsController;
+__decorate([
+    (0, common_1.Post)('process'),
+    (0, common_1.HttpCode)(common_1.HttpStatus.OK),
+    __param(0, (0, common_1.Body)()),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [agent_request_dto_1.AgentRequestDto]),
+    __metadata("design:returntype", Promise)
+], AgentsController.prototype, "processText", null);
+exports.AgentsController = AgentsController = __decorate([
+    (0, common_1.Controller)('agents'),
+    __metadata("design:paramtypes", [agents_service_1.AgentsService])
+], AgentsController);

package/dist/agents/agents.controller.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agents.controller.js","sourceRoot":"","sources":["../../src/agents/agents.controller.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;AAAA,2CAA8E;AAC9E,qDAAiD;AACjD,+DAA0D;AAInD,IAAM,gBAAgB,GAAtB,MAAM,gBAAgB;IACE;IAA7B,YAA6B,aAA4B;QAA5B,kBAAa,GAAb,aAAa,CAAe;IAAG,CAAC;IAIvD,AAAN,KAAK,CAAC,WAAW,CAAS,UAA2B;QACnD,OAAO,IAAI,CAAC,aAAa,CAAC,cAAc,CAAC,UAAU,CAAC,CAAC;IACvD,CAAC;CACF,CAAA;AARY,4CAAgB;AAKrB;IAFL,IAAA,aAAI,EAAC,SAAS,CAAC;IACf,IAAA,iBAAQ,EAAC,mBAAU,CAAC,EAAE,CAAC;IACL,WAAA,IAAA,aAAI,GAAE,CAAA;;qCAAa,mCAAe;;mDAEpD;2BAPU,gBAAgB;IAD5B,IAAA,mBAAU,EAAC,QAAQ,CAAC;qCAEyB,8BAAa;GAD9C,gBAAgB,CAQ5B"}

package/dist/agents/agents.module.d.ts

@@ -0,0 +1,2 @@
+export declare class AgentsModule {
+}

package/dist/agents/agents.module.js

@@ -0,0 +1,23 @@
+"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;
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AgentsModule = void 0;
+const common_1 = require("@nestjs/common");
+const agents_controller_1 = require("./agents.controller");
+const agents_service_1 = require("./agents.service");
+const gemini_agent_1 = require("./implementations/gemini.agent");
+let AgentsModule = class AgentsModule {
+};
+exports.AgentsModule = AgentsModule;
+exports.AgentsModule = AgentsModule = __decorate([
+    (0, common_1.Module)({
+        controllers: [agents_controller_1.AgentsController],
+        providers: [agents_service_1.AgentsService, gemini_agent_1.GeminiAgent],
+        exports: [agents_service_1.AgentsService],
+    })
+], AgentsModule);

package/dist/agents/agents.module.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agents.module.js","sourceRoot":"","sources":["../../src/agents/agents.module.ts"],"names":[],"mappings":";;;;;;;;;AAAA,2CAAwC;AACxC,2DAAuD;AACvD,qDAAiD;AACjD,iEAA6D;AAOtD,IAAM,YAAY,GAAlB,MAAM,YAAY;CAAG,CAAA;AAAf,oCAAY;uBAAZ,YAAY;IALxB,IAAA,eAAM,EAAC;QACN,WAAW,EAAE,CAAC,oCAAgB,CAAC;QAC/B,SAAS,EAAE,CAAC,8BAAa,EAAE,0BAAW,CAAC;QACvC,OAAO,EAAE,CAAC,8BAAa,CAAC;KACzB,CAAC;GACW,YAAY,CAAG"}

package/dist/agents/agents.service.d.ts

@@ -0,0 +1,10 @@
+import { GeminiAgent } from './implementations/gemini.agent';
+import { AgentResponse } from './interfaces/agent.interface';
+import { AgentRequestDto } from './dto/agent-request.dto';
+export declare class AgentsService {
+    private readonly geminiAgent;
+    private readonly logger;
+    private defaultAgent;
+    constructor(geminiAgent: GeminiAgent);
+    processRequest(requestDto: AgentRequestDto): Promise<AgentResponse>;
+}

package/dist/agents/agents.service.js

@@ -0,0 +1,33 @@
+"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);
+};
+var AgentsService_1;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AgentsService = void 0;
+const common_1 = require("@nestjs/common");
+const gemini_agent_1 = require("./implementations/gemini.agent");
+let AgentsService = AgentsService_1 = class AgentsService {
+    constructor(geminiAgent) {
+        this.geminiAgent = geminiAgent;
+        this.logger = new common_1.Logger(AgentsService_1.name);
+        this.defaultAgent = geminiAgent;
+        this.logger.log(`Initialized AgentsService with default agent: ${this.defaultAgent.getName()}`);
+    }
+    async processRequest(requestDto) {
+        this.logger.debug(`Processing input using default agent`);
+        // Eventually, logic to select agent based on user request/task could go here.
+        return this.defaultAgent.processText(requestDto.input);
+    }
+};
+exports.AgentsService = AgentsService;
+exports.AgentsService = AgentsService = AgentsService_1 = __decorate([
+    (0, common_1.Injectable)(),
+    __metadata("design:paramtypes", [gemini_agent_1.GeminiAgent])
+], AgentsService);

package/dist/agents/agents.service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agents.service.js","sourceRoot":"","sources":["../../src/agents/agents.service.ts"],"names":[],"mappings":";;;;;;;;;;;;;AAAA,2CAAoD;AACpD,iEAA6D;AAKtD,IAAM,aAAa,qBAAnB,MAAM,aAAa;IAIK;IAHZ,MAAM,GAAG,IAAI,eAAM,CAAC,eAAa,CAAC,IAAI,CAAC,CAAC;IACjD,YAAY,CAAQ;IAE5B,YAA6B,WAAwB;QAAxB,gBAAW,GAAX,WAAW,CAAa;QACnD,IAAI,CAAC,YAAY,GAAG,WAAW,CAAC;QAChC,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,iDAAiD,IAAI,CAAC,YAAY,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;IAClG,CAAC;IAED,KAAK,CAAC,cAAc,CAAC,UAA2B;QAC9C,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,sCAAsC,CAAC,CAAC;QAE1D,OAAO,IAAI,CAAC,YAAY,CAAC,WAAW,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC;IACzD,CAAC;CACF,CAAA;AAdY,sCAAa;wBAAb,aAAa;IADzB,IAAA,mBAAU,GAAE;qCAK+B,0BAAW;GAJ1C,aAAa,CAczB"}

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

@@ -0,0 +1,3 @@
+export declare class AgentRequestDto {
+    input: string;
+}

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

@@ -0,0 +1,21 @@
+"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.AgentRequestDto = void 0;
+const class_validator_1 = require("class-validator");
+class AgentRequestDto {
+}
+exports.AgentRequestDto = AgentRequestDto;
+__decorate([
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.IsNotEmpty)(),
+    __metadata("design:type", String)
+], AgentRequestDto.prototype, "input", void 0);

package/dist/agents/dto/agent-request.dto.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-request.dto.js","sourceRoot":"","sources":["../../../src/agents/dto/agent-request.dto.ts"],"names":[],"mappings":";;;;;;;;;;;;AAAA,qDAAuD;AAEvD,MAAa,eAAe;IAG1B,KAAK,CAAS;CACf;AAJD,0CAIC;AADC;IAFC,IAAA,0BAAQ,GAAE;IACV,IAAA,4BAAU,GAAE;;8CACC"}

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

@@ -0,0 +1,8 @@
+import { Agent, AgentResponse } from '../interfaces/agent.interface';
+export declare class GeminiAgent implements Agent {
+    private readonly logger;
+    private genAI;
+    constructor();
+    getName(): string;
+    processText(input: string): Promise<AgentResponse>;
+}

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

@@ -0,0 +1,59 @@
+"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);
+};
+var GeminiAgent_1;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.GeminiAgent = void 0;
+const generative_ai_1 = require("@google/generative-ai");
+const common_1 = require("@nestjs/common");
+let GeminiAgent = GeminiAgent_1 = class GeminiAgent {
+    constructor() {
+        this.logger = new common_1.Logger(GeminiAgent_1.name);
+        const apiKey = process.env.GEMINI_API_KEY;
+        if (!apiKey) {
+            this.logger.error('GEMINI_API_KEY environment variable is not set');
+            throw new Error('GEMINI_API_KEY is required to initialize GeminiAgent');
+        }
+        this.genAI = new generative_ai_1.GoogleGenerativeAI(apiKey);
+    }
+    getName() {
+        return 'GeminiAgent';
+    }
+    async processText(input) {
+        this.logger.debug(`Processing input with GeminiAgent`);
+        try {
+            const model = this.genAI.getGenerativeModel({
+                model: 'gemini-2.5-flash-lite',
+            });
+            const result = await model.generateContent(input);
+            const output = result.response.text();
+            return {
+                content: output,
+                metadata: {
+                    model: 'gemini-2.5-flash-lite',
+                },
+            };
+        }
+        catch (error) {
+            if (error instanceof Error) {
+                this.logger.error(`Error processing text: ${error.message}`, error.stack);
+            }
+            else {
+                this.logger.error(`Error processing text: ${String(error)}`);
+            }
+            throw error;
+        }
+    }
+};
+exports.GeminiAgent = GeminiAgent;
+exports.GeminiAgent = GeminiAgent = GeminiAgent_1 = __decorate([
+    (0, common_1.Injectable)(),
+    __metadata("design:paramtypes", [])
+], GeminiAgent);

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

@@ -0,0 +1 @@
+{"version":3,"file":"gemini.agent.js","sourceRoot":"","sources":["../../../src/agents/implementations/gemini.agent.ts"],"names":[],"mappings":";;;;;;;;;;;;;AAAA,yDAA2D;AAE3D,2CAAoD;AAG7C,IAAM,WAAW,mBAAjB,MAAM,WAAW;IACL,MAAM,GAAG,IAAI,eAAM,CAAC,aAAW,CAAC,IAAI,CAAC,CAAC;IAC/C,KAAK,CAAqB;IAElC;QACE,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC;QAC1C,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,gDAAgD,CAAC,CAAC;YACpE,MAAM,IAAI,KAAK,CAAC,sDAAsD,CAAC,CAAC;QAC1E,CAAC;QACD,IAAI,CAAC,KAAK,GAAG,IAAI,kCAAkB,CAAC,MAAM,CAAC,CAAC;IAC9C,CAAC;IAED,OAAO;QACL,OAAO,aAAa,CAAC;IACvB,CAAC;IAED,KAAK,CAAC,WAAW,CAAC,KAAa;QAC7B,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,mCAAmC,CAAC,CAAC;QACvD,IAAI,CAAC;YACH,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,kBAAkB,CAAC,EAAE,KAAK,EAAE,uBAAuB,EAAE,CAAC,CAAC;YAChF,MAAM,MAAM,GAAG,MAAM,KAAK,CAAC,eAAe,CAAC,KAAK,CAAC,CAAC;YAClD,MAAM,MAAM,GAAG,MAAM,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC;YAEtC,OAAO;gBACL,OAAO,EAAE,MAAM;gBACf,QAAQ,EAAE;oBACR,KAAK,EAAE,uBAAuB;iBAC/B;aACF,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,0BAA0B,KAAK,CAAC,OAAO,EAAE,EAAE,KAAK,CAAC,KAAK,CAAC,CAAC;YAC1E,MAAM,KAAK,CAAC;QACd,CAAC;IACH,CAAC;CACF,CAAA;AAnCY,kCAAW;sBAAX,WAAW;IADvB,IAAA,mBAAU,GAAE;;GACA,WAAW,CAmCvB"}

package/dist/agents/interfaces/agent.interface.d.ts

@@ -0,0 +1,8 @@
+export interface AgentResponse {
+    content: string;
+    metadata?: Record<string, any>;
+}
+export interface Agent {
+    getName(): string;
+    processText(input: string): Promise<AgentResponse>;
+}

package/dist/agents/interfaces/agent.interface.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/agents/interfaces/agent.interface.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent.interface.js","sourceRoot":"","sources":["../../../src/agents/interfaces/agent.interface.ts"],"names":[],"mappings":""}