@bpinhosilva/agent-orchestrator 1.0.0-alpha.25 → 1.0.0-alpha.27

package/CHANGELOG.md

@@ -1,3 +1,20 @@
+# [1.0.0-alpha.27](https://github.com/bpinhosilva/agent-orchestrator/compare/v1.0.0-alpha.26...v1.0.0-alpha.27) (2026-04-04)
+
+
+### Features
+
+* update default port to 15789 for production, enhance migration handling, and refactor env ([e59ba31](https://github.com/bpinhosilva/agent-orchestrator/commit/e59ba3105c5ce7367281bf3ee637bcc3bc124dcc))
+* update mascot image format and adjust display size in README ([6779313](https://github.com/bpinhosilva/agent-orchestrator/commit/6779313a26a6906ecb47a8819789dc8312f3d6fc))
+
+# [1.0.0-alpha.26](https://github.com/bpinhosilva/agent-orchestrator/compare/v1.0.0-alpha.25...v1.0.0-alpha.26) (2026-04-04)
+
+
+### Features
+
+* add AGENTS.md file ([51c706f](https://github.com/bpinhosilva/agent-orchestrator/commit/51c706f8784dd354280d853f605bb8c69e53175c))
+* implement containerization, add health check endpoint, and update RBAC ([17149d3](https://github.com/bpinhosilva/agent-orchestrator/commit/17149d32a623f532308ba0f415a4b2ba332ec794))
+* **refactor:** project terminology and update UI components ([47e5cb4](https://github.com/bpinhosilva/agent-orchestrator/commit/47e5cb4d45c05f893ebdd898f02ceeadcd213652))
+
 # [1.0.0-alpha.25](https://github.com/bpinhosilva/agent-orchestrator/compare/v1.0.0-alpha.24...v1.0.0-alpha.25) (2026-04-03)
 
 

package/README.md

@@ -1,289 +1,265 @@
 # 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)
-[![Socket Badge](https://socket.dev/api/badge/npm/package/@bpinhosilva/agent-orchestrator)](https://socket.dev/npm/package/@bpinhosilva/agent-orchestrator)
-
-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.
-- **Multi-Provider Support**: Google Gemini and Anthropic Claude providers.
-- **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.
-- **Role-Based Access Control**: Admin and member roles with project-level membership.
-- **TUI/CLI Tooling**: CLI executables to manage the installation and local agent configuration.
-
-## Architecture
-- **Backend Framework**: NestJS 11 + TypeScript 5
-- **Frontend SPA**: React (built separately, served as static files)
-- **Database**: PostgreSQL (production) / SQLite (development)
-- **Testing**: Jest (TDD Approach with Unit & E2E)
-- **Architecture**: 3-Tier (Controller → Service → Repository)
+<p align="center">
+  <img src="docs/assets/lupy-mascot.webp" alt="Lupy, the Agent Orchestrator mascot" width="500" />
+</p>
+
+<p align="center"><em>Lupy, the project mascot, inspired by Bruno's dog and companion of 10 years.</em></p>
+
+<p align="center">
+  <a href="https://github.com/bpinhosilva/agent-orchestrator/actions/workflows/ci.yml"><img src="https://github.com/bpinhosilva/agent-orchestrator/actions/workflows/ci.yml/badge.svg" alt="CI" /></a>
+  <a href="https://github.com/bpinhosilva/agent-orchestrator/actions/workflows/gitleaks.yml"><img src="https://github.com/bpinhosilva/agent-orchestrator/actions/workflows/gitleaks.yml/badge.svg" alt="Gitleaks" /></a>
+  <a href="https://socket.dev/npm/package/@bpinhosilva/agent-orchestrator"><img src="https://socket.dev/api/badge/npm/package/@bpinhosilva/agent-orchestrator" alt="Socket Badge" /></a>
+</p>
+
+Agent Orchestrator is an open-source platform for managing AI agents, tasks, and project-scoped automation across multiple model providers. It combines a NestJS API, a React dashboard, a packaged CLI/runtime, and Docker deployment options for both local use and production-style environments.
+
+## Current capabilities
+
+- Multi-provider agent execution with Google Gemini and Anthropic Claude
+- Agent profiles with provider/model selection
+- Project management with project membership and RBAC
+- Task execution plus recurring scheduling
+- File upload and artifact-backed task workflows
+- Packaged CLI/runtime for setup, run, status, logs, stop, and migrate
+- React dashboard served by the backend or packaged runtime
+
+## Planned direction
+
+- Richer workflow orchestration and agent chaining
+- Broader agent tool integrations
+- Expanded runtime and deployment ergonomics
+
+## Architecture at a glance
+
+| Area | Stack |
+| --- | --- |
+| Backend | NestJS 11 + TypeScript 5 |
+| Frontend | React SPA |
+| Database | PostgreSQL (production) / SQLite via `better-sqlite3` (local/runtime) |
+| ORM | TypeORM |
+| Auth | JWT access/refresh tokens via httpOnly cookies |
+| Packaging | npm package with bundled backend, CLI, and UI assets |
 
 ## Prerequisites
-- [Node.js](https://nodejs.org/) (v24+)
-- [Docker](https://www.docker.com/) and Docker Compose (optional, for PostgreSQL)
-- A [Google Gemini API Key](https://aistudio.google.com/) or [Anthropic API Key](https://console.anthropic.com/)
 
-## Quick Start
+- [Node.js](https://nodejs.org/) 24 or newer
+- npm
+- [Docker](https://www.docker.com/) and Docker Compose (optional)
+- At least one provider API key to execute agents:
+  - [Google Gemini API key](https://aistudio.google.com/)
+  - [Anthropic API key](https://console.anthropic.com/)
+
+## Quick start
 
-### 1. Choose an installation path
+Choose the path that matches how you want to use the project:
 
-**Option A: install the packaged CLI**
+- **Packaged CLI/runtime**: quickest way to run the app locally as an installed tool
+- **Source checkout**: best path for development and contributing
+
+### Option A: packaged CLI/runtime
 
 ```bash
 npm install -g @bpinhosilva/agent-orchestrator
-agent-orchestrator --help
+agent-orchestrator setup
+agent-orchestrator run
+agent-orchestrator status
 ```
 
-**Option B: run from a source checkout**
+`setup` can create the runtime `.env`, run migrations, and seed an admin user. The default runtime home is `~/.agent-orchestrator`, or `${AGENT_ORCHESTRATOR_HOME}` if you set it explicitly.
+
+For deeper CLI usage, see [docs/CLI.md](docs/CLI.md).
+
+### Option B: source checkout
 
 ```bash
-git clone <repo> && cd agent-orchestrator
+git clone https://github.com/bpinhosilva/agent-orchestrator.git
+cd agent-orchestrator
 npm install
 npm rebuild
 npm run build:all
 ```
 
-> **Note**: The project uses `ignore-scripts=true` in `.npmrc` for supply chain security. After installing dependencies from source, run `npm rebuild` to compile native modules (bcrypt, sqlite3).
+> **Note**: The repository uses `ignore-scripts=true` in `.npmrc` for supply-chain hardening. After `npm install`, run `npm rebuild --ignore-scripts=false` so native modules such as `bcrypt` and `better-sqlite3` are actually compiled.
 
-### 2. Configure the runtime
-
-**CLI-driven setup (recommended for local/runtime installs)**
+If you want to use the packaged CLI behavior from a source checkout, run the built entrypoint directly:
 
 ```bash
-agent-orchestrator setup
+node dist/cli/index.js --help
 ```
 
-The CLI writes `${AGENT_ORCHESTRATOR_HOME}/.env` with user-only permissions (`0600`), can run migrations, and can seed an admin user. It also supports non-interactive setup:
+## Configure the runtime
 
-```bash
-agent-orchestrator setup \
-  --yes \
-  --db-type postgres \
-  --database-url postgresql://orchestrator:orchestrator_password@localhost:5433/agent_orchestrator \
-  --provider gemini \
-  --gemini-key your-gemini-api-key \
-  --skip-admin-setup
-```
+The app loads configuration from:
 
-**Manual `.env` setup**
+- `${AGENT_ORCHESTRATOR_HOME}/.env` when `AGENT_ORCHESTRATOR_HOME` is set
+- `.env` in the project/package root otherwise
 
-Create a `.env` file in the project root (or set `AGENT_ORCHESTRATOR_HOME` to point to a directory containing `.env`):
+Example `.env`:
 
 ```bash
 # Required
-JWT_SECRET="at-least-32-characters-long-secret-key"
+JWT_SECRET="replace-with-a-secret-at-least-32-characters-long"
 
-# AI Providers (at least one required for agent functionality)
-GEMINI_API_KEY="your-gemini-api-key"
-ANTHROPIC_API_KEY="your-anthropic-api-key"
+# Provider keys (optional until you want to execute agents)
+GEMINI_API_KEY=""
+ANTHROPIC_API_KEY=""
 
-# Optional
-PORT=3000                           # Server port (default: 3000)
-NODE_ENV=development                # development | production | test
-DATABASE_URL=                       # PostgreSQL connection string (omit for SQLite)
+# Database
+DB_TYPE=sqlite
+DATABASE_URL=
+
+# Runtime
+PORT=15789
+NODE_ENV=production
 ALLOWED_ORIGINS=http://localhost:5173,http://localhost:3000
-SCHEDULER_ENABLED=true              # Enable/disable task scheduler CRON
-DB_LOGGING=false                    # Enable TypeORM query logging
+SCHEDULER_ENABLED=true
+DB_LOGGING=false
+SERVE_STATIC_UI=true
+CHECK_PENDING_MIGRATIONS_ON_STARTUP=false
 ```
 
-### 3. Set Up the Database
+## Database setup
 
-**Option A: SQLite (Development — zero config)**
+### SQLite
 
-SQLite is used automatically when `DATABASE_URL` is not set. The database file is created at `local.sqlite` in the project root (or `$AGENT_ORCHESTRATOR_HOME/local.sqlite`).
+SQLite is the default local/runtime option when `DATABASE_URL` is not set. The database file lives at:
 
-**Option B: PostgreSQL (Production)**
+- `local.sqlite` in the project/package root, or
+- `${AGENT_ORCHESTRATOR_HOME}/local.sqlite` when runtime home is set
 
-```bash
-# Start PostgreSQL via Docker Compose
-docker compose up -d
+### PostgreSQL
 
-# Set the connection string
+Use PostgreSQL by setting `DATABASE_URL` or `DB_TYPE=postgres`:
+
+```bash
 export DATABASE_URL="postgresql://orchestrator:orchestrator_password@localhost:5433/agent_orchestrator"
 ```
 
-Then run migrations and seed the admin user:
+### Initialize the schema
+
+Run migrations before the first app start:
 
 ```bash
-# Apply database migrations
 npm run migration:run
-
-# Create the initial admin user (interactive prompt)
-npm run seed:admin
 ```
 
-### 4. Run the Application
+Create the initial admin user if you want to sign in through the dashboard:
 
 ```bash
-# Packaged/runtime CLI
-agent-orchestrator run
-agent-orchestrator status
-agent-orchestrator logs --lines 50
-agent-orchestrator stop
-
-# Development (API + UI with hot reload)
-npm run dev
-
-# Or API only in watch mode
-npm run start:dev
-
-# Production build
-npm run build
-npm run start:prod
+npm run seed:admin
 ```
 
-The dashboard is available at `http://localhost:3000` and the API at `http://localhost:3000/api/v1/`.
-
-## Database Management
+If you use the packaged CLI, `agent-orchestrator setup` can perform both steps for you.
 
-The project uses [TypeORM](https://typeorm.io/) migrations to manage schema changes. **Never rely on `synchronize: true`** — it is disabled in all environments.
+## Run the application
 
-### Migration Commands
+### Local development
 
 ```bash
-# Generate a new migration from entity changes
-npm run typeorm -- migration:generate src/migrations/DescriptiveName
-
-# Apply all pending migrations
-npm run migration:run
-
-# Revert the last applied migration
-npm run migration:revert
-
-# Drop the entire database schema (use with caution!)
-npm run schema:drop
+npm run dev
 ```
 
-### Migration Workflow
+That starts:
 
-1. Modify your entity files in `src/`
-2. Generate a migration: `npm run typeorm -- migration:generate src/migrations/YourMigrationName`
-3. Review the generated file in `src/migrations/`
-4. Apply it: `npm run migration:run`
-5. Verify with tests: `npm run test:all`
+- UI dev server: `http://localhost:5173`
+- API: `http://localhost:3000/api/v1`
+- Swagger UI: `http://localhost:3000/api` (non-production only)
+- Health endpoint: `http://localhost:3000/health`
 
-### Seeding
+If you only want the API in watch mode:
 
 ```bash
-# Create the initial admin user
-npm run seed:admin
+npm run start:dev
 ```
 
-This creates a user with the `admin` role. All subsequent users registered via `POST /auth/register` (admin-only endpoint) default to `member` role.
-
-## Deployment
-
-### Production Checklist
-
-1. **Database**: Use PostgreSQL — set `DATABASE_URL` environment variable
-2. **Migrations**: Run `npm run migration:run` before starting the app
-3. **Environment**:
-   - `NODE_ENV=production` — disables Swagger UI and enables secure cookies
-   - `JWT_SECRET` — strong secret, minimum 32 characters
-   - `ALLOWED_ORIGINS` — comma-separated list of allowed CORS origins (required in production)
-4. **Build**: Run `npm run build` to compile TypeScript and bundle the UI
-5. **Start**: `npm run start:prod` (or `node dist/main.js`)
-
-### Docker
+### Packaged/runtime mode
 
 ```bash
-# Build and run with Docker Compose (includes PostgreSQL)
-docker compose up -d
+agent-orchestrator run
+agent-orchestrator status
+agent-orchestrator logs --lines 50
+agent-orchestrator stop
+```
 
-# Apply migrations
-DATABASE_URL="postgresql://orchestrator:orchestrator_password@localhost:5433/agent_orchestrator" \
-  npm run migration:run
+When running the packaged app or a production build with static UI enabled, the dashboard is served from `http://localhost:15789` by default.
 
-# Seed admin
-DATABASE_URL="postgresql://orchestrator:orchestrator_password@localhost:5433/agent_orchestrator" \
-  npm run seed:admin
-```
+## Docker
 
-### Updating an Existing Deployment
+The repository ships three Compose entrypoints:
 
-1. Pull the latest code
-2. Install dependencies: `npm ci && npm rebuild`
-3. Build: `npm run build`
-4. Run new migrations: `npm run migration:run`
-5. Restart the application
+| File | Purpose |
+| --- | --- |
+| `docker-compose.yml` | Production-style stack with PostgreSQL, API, and Caddy-served UI |
+| `docker-compose.dev.yml` | Development stack with API hot reload and Vite UI dev server |
+| `docker-compose-test.yml` | Integration stack for migration, CLI/runtime, API, and UI checks |
 
-## Testing
+### Production-style stack
 
 ```bash
-# Unit tests
-npm test
-
-# Unit tests in watch mode
-npm run test:watch
+npm run docker:up
+docker compose run --rm api dist/cli/index.js migrate --yes
+```
 
-# E2E tests
-npm run test:e2e
+Endpoints:
 
-# All tests (unit + UI + E2E)
-npm run test:all
+- UI: `https://localhost` or `https://agent-orchestrator.localhost`
+- API: `http://localhost:3000/api/v1`
 
-# Test coverage
-npm run test:cov
+In this stack the UI is served by **Caddy**, not by the Nest app. Docker explicitly sets `SERVE_STATIC_UI=false` so the backend only serves the API.
 
-# Run a single test file
-npm test -- src/auth/auth.service.spec.ts
+### Development stack
 
-# Run tests matching a name pattern
-npm test -- --testNamePattern="should validate email"
+```bash
+npm run docker:dev
 ```
 
-## Security
-
-### Authentication & Authorization
-
-- **JWT-based authentication** with httpOnly cookie transport (no tokens in response bodies)
-- **Role-Based Access Control (RBAC)**: `admin` and `member` roles
-  - **Admin**: Full access to all resources
-  - **Member**: Access scoped to projects they own or are members of
-- **Project membership**: Many-to-many model with `owner` and `member` roles per project
-- **Rate limiting**: 60 req/min globally, 5 req/min on auth endpoints
-- All routes protected by default — use `@Public()` decorator for public endpoints
+Endpoints:
 
-### Supply Chain Protection
+- UI: `http://localhost:5173`
+- API: `http://localhost:3000/api/v1`
+- PostgreSQL: `localhost:5433`
 
-- `.npmrc` hardened: registry pinned to `registry.npmjs.org`, install scripts disabled
-- `lockfile-lint` validates lockfile integrity in CI and pre-commit hooks
-- `npm audit signatures` checks package provenance in CI
-- [Socket.dev](https://socket.dev) monitors dependencies for supply chain risks
+### Integration stack
 
-### Additional Hardening
+Use `docker-compose-test.yml` when you want to exercise migration behavior, packaged CLI/runtime flows, API startup, and UI reachability together.
 
-- Helmet.js security headers with Content Security Policy
-- CORS restricted to `ALLOWED_ORIGINS` (deny-all in production without explicit config)
-- Swagger UI disabled in production
-- File upload validation: MIME type allowlist + 10MB size limit
-- Input length limits on all text fields via class-validator
+## Development workflow
 
-## API Usage
+| Task | Command |
+| --- | --- |
+| Start API + UI | `npm run dev` |
+| Start API only | `npm run start:dev` |
+| Lint API + UI | `npm run lint:all` |
+| Run API + UI + E2E tests | `npm run test:all` |
+| Run coverage | `npm run test:cov` |
+| Run E2E tests | `npm run test:e2e` |
+| Build backend + UI package output | `npm run build:all` |
+| Apply migrations | `npm run migration:run` |
 
-**Endpoint**: `POST /api/v1/agents/process`
-**Payload**:
-```json
-{
-  "input": "Write a short poem about automation."
-}
-```
-
-## Contributing
+## Auth and access model
 
-See [CONTRIBUTING.md](CONTRIBUTING.md) for guidelines.
+- Access and refresh tokens are issued by the auth service and transported via **httpOnly cookies**
+- System roles are **`admin`** and **`user`**
+- Project membership roles are **`owner`** and **`member`**
+- Routes are protected by default; use `@Public()` for public endpoints
+- Global throttling defaults to `60/min`, with stricter limits on auth endpoints
 
-## Additional Documentation
+## Useful docs
 
 - [CLI reference](docs/CLI.md)
 - [CI/CD pipeline](docs/CI_CD.md)
 - [Release process](docs/RELEASE.md)
+- [Contributing guide](CONTRIBUTING.md)
+
+## Troubleshooting
+
+- **Native module errors after install**: run `npm rebuild`
+- **`JWT_SECRET` rejected**: it must be at least 32 characters
+- **Agent execution fails immediately**: confirm `GEMINI_API_KEY` and/or `ANTHROPIC_API_KEY` are set
+- **Schema/startup issues**: run `npm run migration:run`
+- **Need to undo the latest migration**: run `npm run migration:revert`
 
 ## License
 
-See [LICENSE](LICENSE) for details.
+See [LICENSE](LICENSE).

package/dist/agents/agents.controller.js

@@ -114,4 +114,3 @@ exports.AgentsController = AgentsController = __decorate([
     (0, common_1.Controller)('agents'),
     __metadata("design:paramtypes", [agents_service_1.AgentsService])
 ], AgentsController);
-//# sourceMappingURL=agents.controller.js.map

package/dist/agents/agents.module.js

@@ -25,4 +25,3 @@ exports.AgentsModule = AgentsModule = __decorate([
         exports: [agents_service_1.AgentsService],
     })
 ], AgentsModule);
-//# sourceMappingURL=agents.module.js.map

package/dist/agents/agents.service.js

@@ -190,4 +190,3 @@ exports.AgentsService = AgentsService = AgentsService_1 = __decorate([
     __metadata("design:paramtypes", [typeorm_2.Repository,
         core_1.ModuleRef])
 ], AgentsService);
-//# sourceMappingURL=agents.service.js.map

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

@@ -31,4 +31,3 @@ __decorate([
     (0, class_validator_1.MaxLength)(50000),
     __metadata("design:type", String)
 ], AgentRequestDto.prototype, "input", void 0);
-//# sourceMappingURL=agent-request.dto.js.map

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

@@ -65,4 +65,3 @@ __decorate([
     (0, class_validator_1.IsNotEmpty)(),
     __metadata("design:type", String)
 ], CreateAgentDto.prototype, "providerId", void 0);
-//# sourceMappingURL=create-agent.dto.js.map

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

@@ -10,4 +10,3 @@ class UpdateAgentDto extends (0, mapped_types_1.PartialType)(create_agent_dto_1.
     }
 }
 exports.UpdateAgentDto = UpdateAgentDto;
-//# sourceMappingURL=update-agent.dto.js.map

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

@@ -84,4 +84,3 @@ __decorate([
 exports.AgentEntity = AgentEntity = __decorate([
     (0, typeorm_1.Entity)('agents')
 ], AgentEntity);
-//# sourceMappingURL=agent.entity.js.map

package/dist/agents/enums/provider.enum.js

@@ -6,4 +6,3 @@ var Provider;
     Provider["GOOGLE"] = "google";
     Provider["ANTHROPIC"] = "anthropic";
 })(Provider || (exports.Provider = Provider = {}));
-//# sourceMappingURL=provider.enum.js.map

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

@@ -145,4 +145,3 @@ exports.ClaudeAgent = ClaudeAgent = ClaudeAgent_1 = __decorate([
     __param(1, (0, common_1.Optional)()),
     __metadata("design:paramtypes", [config_1.ConfigService, String])
 ], ClaudeAgent);
-//# sourceMappingURL=claude.agent.js.map

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

@@ -191,4 +191,3 @@ exports.GeminiAgent = GeminiAgent = GeminiAgent_1 = __decorate([
     __param(1, (0, common_1.Optional)()),
     __metadata("design:paramtypes", [config_1.ConfigService, String])
 ], GeminiAgent);
-//# sourceMappingURL=gemini.agent.js.map

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

@@ -1,3 +1,2 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-//# sourceMappingURL=agent.interface.js.map

package/dist/agents/registry/agent.registry.js

@@ -12,4 +12,3 @@ function RegisterAgent(provider) {
 function getAgentImplementation(provider) {
     return exports.AGENT_REGISTRY.get(provider);
 }
-//# sourceMappingURL=agent.registry.js.map

package/dist/app.controller.d.ts

@@ -3,4 +3,7 @@ export declare class AppController {
     private readonly appService;
     constructor(appService: AppService);
     getHello(): string;
+    getHealth(): {
+        status: string;
+    };
 }

package/dist/app.controller.js

@@ -13,6 +13,7 @@ exports.AppController = void 0;
 const openapi = require("@nestjs/swagger");
 const common_1 = require("@nestjs/common");
 const app_service_1 = require("./app.service");
+const public_decorator_1 = require("./auth/decorators/public.decorator");
 let AppController = class AppController {
     appService;
     constructor(appService) {
@@ -21,6 +22,9 @@ let AppController = class AppController {
     getHello() {
         return this.appService.getHello();
     }
+    getHealth() {
+        return this.appService.getHealth();
+    }
 };
 exports.AppController = AppController;
 __decorate([
@@ -30,8 +34,15 @@ __decorate([
     __metadata("design:paramtypes", []),
     __metadata("design:returntype", String)
 ], AppController.prototype, "getHello", null);
+__decorate([
+    (0, public_decorator_1.Public)(),
+    (0, common_1.Get)('health'),
+    openapi.ApiResponse({ status: 200 }),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", []),
+    __metadata("design:returntype", Object)
+], AppController.prototype, "getHealth", null);
 exports.AppController = AppController = __decorate([
     (0, common_1.Controller)(),
     __metadata("design:paramtypes", [app_service_1.AppService])
 ], AppController);
-//# sourceMappingURL=app.controller.js.map

package/dist/app.module.js

@@ -30,8 +30,10 @@ 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 typeorm_2 = require("./config/typeorm");
-const APP_HOME = process.env.AGENT_ORCHESTRATOR_HOME;
-const ENV_PATH = APP_HOME ? (0, path_1.join)(APP_HOME, '.env') : '.env';
+const runtime_paths_1 = require("./config/runtime-paths");
+(0, runtime_paths_1.loadRuntimeEnv)();
+const ENV_PATH = (0, runtime_paths_1.getRuntimeEnvPath)();
+const shouldServeStaticUi = (0, runtime_paths_1.isEnvEnabled)('SERVE_STATIC_UI', true);
 let AppModule = class AppModule {
 };
 exports.AppModule = AppModule;
@@ -68,11 +70,15 @@ exports.AppModule = AppModule = __decorate([
                     };
                 },
             }),
-            serve_static_1.ServeStaticModule.forRoot({
-                rootPath: process.env.NODE_ENV === 'production'
-                    ? (0, path_1.join)(__dirname, 'ui')
-                    : (0, path_1.join)(__dirname, '..', 'ui', 'dist'),
-            }),
+            ...(shouldServeStaticUi
+                ? [
+                    serve_static_1.ServeStaticModule.forRoot({
+                        rootPath: process.env.NODE_ENV === 'production'
+                            ? (0, path_1.join)(__dirname, 'ui')
+                            : (0, path_1.join)(__dirname, '..', 'ui', 'dist'),
+                    }),
+                ]
+                : []),
             common_module_1.CommonModule,
             uploads_module_1.UploadsModule,
             agents_module_1.AgentsModule,
@@ -101,4 +107,3 @@ exports.AppModule = AppModule = __decorate([
         ],
     })
 ], AppModule);
-//# sourceMappingURL=app.module.js.map

package/dist/app.service.d.ts

@@ -1,3 +1,6 @@
 export declare class AppService {
     getHello(): string;
+    getHealth(): {
+        status: string;
+    };
 }