@sftech/ng-orchestrator

Angular library for AI agent orchestration — admin interface for agents, prompts, and chat.

Installation

npm install @sftech/ng-orchestrator

Peer Dependencies

• @angular/common >= 19.0.0
• @angular/core >= 19.0.0
• @sftech/ng-shared >= 1.0.0
• @sftech/ng-auth >= 1.0.0
• PrimeNG >= 19.0.0
• ngx-markdown >= 19.0.0

Configuration

Add OrchestratorModule.forRoot() to your app.config.ts:

import { OrchestratorModule } from '@sftech/ng-orchestrator';
import { IAppConfig } from '@sftech/ng-shared';

export function appConfig(config: IAppConfig): ApplicationConfig {
    return {
        providers: [
            importProvidersFrom(OrchestratorModule.forRoot(config)),
        ],
    };
}

The library reads the following keys from IAppConfig:

| Key | Description | Default | |-----|-------------|---------| | ORCHESTRATOR_API_URL | Orchestrator API base URL | http://localhost:3010 | | ORCHESTRATOR_DB_API_URL | Orchestrator DB API base URL | http://localhost:3012 |

Routing

import { Route } from '@angular/router';

export const appRoutes: Route[] = [
    {
        path: 'orchestrator',
        loadChildren: () => import('@sftech/ng-orchestrator').then((m) => m.orchestratorRoutes),
    },
];

Route Structure

• /orchestrator/chats — Chat interface (protected by authenticationGuard)
• /orchestrator/admin/agents — Agent management (protected by adminGuard)
• /orchestrator/admin/prompts — Prompt management (protected by adminGuard)

Features

• Agent Management: CRUD for AI agents with LLM configuration (provider, model, temperature, timeout)
• Prompt Management: System prompt templates with history tracking
• Chat Interface: Real-time chat with AI agents, agent selection, message rendering with Markdown
• RAG Upload: Document upload for Retrieval-Augmented Generation per agent
• MCP Tools: Model Context Protocol tool management per agent

Key Services

• AgentService — Agent CRUD operations
• PromptService — Prompt CRUD operations
• PromptHistoryService — Prompt version history
• ChatService — Chat session management
• AgentRunService — Agent execution tracking
• OrchestratorService — Core orchestrator API (tools, chat execution)

Development

npx nx build ng-orchestrator
npx nx lint ng-orchestrator

License

MIT