plugin-agent-orchestrator 1.0.0

package/README.md

@@ -0,0 +1,291 @@
+# Plugin Agent Orchestrator
+
+**Hierarchical Multi-Agent Orchestration for NocoBase AI Employees**
+
+Plugin này cho phép các AI Employee trong NocoBase hoạt động theo mô hình **Leader ↔ Sub-Agent**: một AI Employee (Leader) có thể tự động ủy thác (delegate) nhiệm vụ cho các AI Employee khác (Sub-Agent) để xử lý các tác vụ chuyên biệt — tất cả mà không cần sửa đổi core `plugin-ai`.
+
+---
+
+## ✨ Tính năng chính
+
+### 🏗️ Hierarchical Delegation (Ủy thác phân cấp)
+- **Leader** nhận yêu cầu từ user → phân tích → gọi Sub-Agent phù hợp qua tool call
+- Mỗi Sub-Agent được đăng ký như một tool riêng (ví dụ: `delegate_to_sql_expert`)
+- LLM tự chọn Sub-Agent phù hợp nhất dựa trên mô tả của từng agent
+
+### 🔄 Depth Control (Kiểm soát độ sâu)
+- Giới hạn số lớp delegation (ví dụ: `maxDepth: 1` = Leader gọi Sub-Agent, Sub-Agent không được gọi tiếp)
+- Ngăn chặn vòng lặp vô hạn (circular delegation) — các tool `delegate_to_*` tự động bị loại khỏi Sub-Agent
+
+### ⏱️ Timeout & Abort
+- Mỗi rule cấu hình thời gian chờ tối đa (mặc định 120s)
+- Khi timeout, stream LLM bị hủy ngay lập tức qua `AbortController` — không tốn thêm token
+
+### 🛡️ Per-Leader Scoping
+- Chỉ Leader được cấu hình mới có thể gọi Sub-Agent tương ứng
+- Kiểm tra tại thời điểm invoke — không phụ thuộc vào core API
+
+### 📊 Swarm Tracing (Giám sát)
+- Ghi log mỗi lần delegation: ai gọi ai, task gì, kết quả ra sao, mất bao lâu
+- Trang admin trực quan để theo dõi và debug multi-agent flows
+
+### 🔌 Zero Core Modification
+- Chỉ sử dụng **public APIs** từ `@nocobase/ai` và `@nocobase/plugin-ai`
+- Không import private classes, không patch core code
+- Tương thích NocoBase 2.x — upgrade-safe
+
+---
+
+## 📐 Kiến trúc
+
+```
+┌──────────────────────────────────────────────────────────┐
+│  User Chat Session                                       │
+│  "Hãy phân tích doanh thu Q4 và tạo báo cáo"           │
+└─────────────────────┬────────────────────────────────────┘
+                      │
+                      ▼
+┌──────────────────────────────────────────────────────────┐
+│  Leader AI Employee (ví dụ: "Project Manager")           │
+│                                                          │
+│  Tools available:                                        │
+│  ├── delegate_to_sql_expert     ← plugin-agent-orch      │
+│  ├── delegate_to_report_writer  ← plugin-agent-orch      │
+│  └── other_skills               ← plugin-ai built-in     │
+└────┬─────────────────────┬───────────────────────────────┘
+     │ tool_call            │ tool_call
+     ▼                      ▼
+┌────────────────┐   ┌─────────────────┐
+│ SQL Expert     │   │ Report Writer   │
+│ (Sub-Agent)    │   │ (Sub-Agent)     │
+│                │   │                 │
+│ createReact    │   │ createReact     │
+│ Agent + tools  │   │ Agent + tools   │
+└───────┬────────┘   └────────┬────────┘
+        │ result              │ result
+        └─────────┬───────────┘
+                  ▼
+┌──────────────────────────────────────────────────────────┐
+│  Leader tổng hợp kết quả → trả lời user                 │
+└──────────────────────────────────────────────────────────┘
+```
+
+---
+
+## 🚀 Cài đặt & Kích hoạt
+
+### Yêu cầu
+- NocoBase `>= 2.0`
+- Plugin `@nocobase/plugin-ai` đã kích hoạt
+- Ít nhất 2 AI Employees đã được tạo (1 Leader, 1+ Sub-Agent)
+
+### Bước 1: Cài đặt plugin
+```bash
+# Trong monorepo NocoBase
+yarn build plugin-agent-orchestrator
+```
+
+### Bước 2: Kích hoạt
+Vào **Settings → Plugin Manager** → tìm "Agent Orchestrator" → **Enable**
+
+### Bước 3: Cấu hình
+Sau khi kích hoạt, vào **Settings → AI → Agent Orchestrator**
+
+---
+
+## 📖 Hướng dẫn sử dụng
+
+### Tab 1: Orchestration Rules
+
+Đây là nơi cấu hình quan hệ Leader ↔ Sub-Agent.
+
+#### Tạo rule mới
+1. Nhấn **New Rule**
+2. Chọn **Leader (Orchestrator)**: AI Employee đóng vai trò điều phối
+3. Chọn **Sub-Agent**: AI Employee sẽ nhận nhiệm vụ được ủy thác
+4. Cấu hình:
+   - **Max Delegation Depth**: Độ sâu tối đa (1-3)
+     - `1` = Leader gọi Sub-Agent, Sub-Agent chỉ dùng tool của mình
+     - `2` = Sub-Agent có thể gọi tiếp Sub-Agent khác (nếu được cấu hình)
+   - **Timeout (ms)**: Thời gian chờ tối đa
+     - `120000` (2 phút) — khuyến nghị cho tác vụ đơn giản
+     - `300000` (5 phút) — cho tác vụ phức tạp
+   - **Enabled**: Bật/tắt rule
+5. Nhấn **Save**
+
+#### Ví dụ cấu hình
+
+| Leader | Sub-Agent | Max Depth | Timeout | Mô tả |
+|--------|-----------|-----------|---------|-------|
+| PM Bot | SQL Expert | 1 | 120s | PM giao truy vấn DB cho SQL Expert |
+| PM Bot | Report Writer | 1 | 300s | PM giao viết báo cáo |
+| PM Bot | Code Reviewer | 1 | 180s | PM giao review code |
+
+> **Lưu ý**: Leader và Sub-Agent không được trùng nhau. Một Sub-Agent có thể phục vụ nhiều Leader.
+
+### Tab 2: Swarm Tracing
+
+Trang giám sát hiển thị log tất cả các lần delegation:
+
+| Cột | Mô tả |
+|-----|-------|
+| **Time** | Thời điểm thực thi |
+| **Sub-Agent** | Agent được gọi |
+| **Task** | Mô tả nhiệm vụ |
+| **Status** | ✅ success hoặc ❌ error |
+| **Duration** | Thời gian thực thi |
+| **Depth** | Độ sâu delegation (0 = cấp đầu tiên) |
+
+Nhấn **Detail** để xem chi tiết: task gốc, kết quả đầy đủ, lỗi (nếu có).
+
+---
+
+## 💡 Best Practices
+
+### 1. Thiết kế Agent hiệu quả
+
+```
+✅ NÊN: Mỗi Sub-Agent chuyên một lĩnh vực rõ ràng
+   - "SQL Query Expert" — chỉ chạy truy vấn
+   - "Document Writer" — chỉ viết tài liệu
+
+❌ KHÔNG NÊN: Sub-Agent làm quá nhiều việc
+   - "General Assistant" — quá rộng, Leader không biết khi nào nên gọi
+```
+
+### 2. System Prompt cho Leader
+
+Thêm hướng dẫn trong system prompt của Leader để nó biết khi nào nên delegate:
+
+```
+Bạn là Project Manager. Khi nhận yêu cầu:
+- Cần truy vấn database → delegate cho SQL Expert
+- Cần viết báo cáo → delegate cho Report Writer
+- Có thể tự trả lời → trả lời trực tiếp
+
+KHÔNG BAO GIỜ tự viết SQL. Luôn delegate cho SQL Expert.
+```
+
+### 3. Bio/About cho Sub-Agent
+
+Viết mô tả rõ ràng trong trường `About` của Sub-Agent — nội dung này được LLM đọc để quyết định có gọi agent đó không:
+
+```
+Chuyên gia truy vấn PostgreSQL. Có khả năng:
+- Viết và tối ưu SQL queries
+- Phân tích schema và index
+- Giải thích execution plan
+Không xử lý: tạo báo cáo, viết code ứng dụng.
+```
+
+### 4. Timeout hợp lý
+
+| Loại tác vụ | Timeout khuyến nghị |
+|-------------|---------------------|
+| Truy vấn DB đơn giản | 30s - 60s |
+| Phân tích dữ liệu | 120s |
+| Viết tài liệu dài | 300s |
+| Tác vụ phức tạp + tool calls | 300s - 600s |
+
+---
+
+## 🔧 Chi tiết kỹ thuật
+
+### Collections
+
+| Collection | Mục đích |
+|------------|----------|
+| `orchestratorConfig` | Lưu rules Leader ↔ Sub-Agent |
+| `orchestratorLogs` | Lưu log delegation (cho Tracing) |
+
+### APIs
+
+| Endpoint | Mô tả |
+|----------|-------|
+| `orchestratorConfig:list` | Danh sách rules |
+| `orchestratorConfig:create` | Tạo rule mới |
+| `orchestratorConfig:update` | Cập nhật rule |
+| `orchestratorConfig:destroy` | Xóa rule |
+| `orchestratorTracing:list` | Danh sách log delegation |
+| `orchestratorTracing:get` | Chi tiết một log |
+
+### Execution Flow
+
+```
+1. Plugin load
+   └─ registerDynamicTools() → đăng ký delegate_to_* tools vào core toolsManager
+
+2. User chat với Leader
+   └─ Leader LLM nhận tool list (bao gồm delegate_to_*)
+   └─ LLM quyết định gọi delegate_to_sql_expert({ task: "..." })
+
+3. Tool invoke
+   ├─ Check per-leader scoping (allowedLeaders)
+   ├─ Check depth limit (ORCHESTRATOR_DEPTH_KEY)
+   ├─ Resolve LLM model từ Sub-Agent's modelSettings
+   ├─ Resolve tools từ Sub-Agent's skillSettings
+   ├─ createReactAgent({ llm, tools })
+   ├─ executor.stream({ messages: [system, human] }, { signal })
+   ├─ Collect AI response chunks
+   ├─ Log to orchestratorLogs
+   └─ Return result to Leader
+
+4. Leader tổng hợp và trả lời user
+```
+
+### Dependencies
+
+| Package | Version | Mục đích |
+|---------|---------|----------|
+| `@langchain/core` | ^0.3.0 | DynamicStructuredTool, Messages |
+| `@langchain/langgraph` | ^0.2.0 | createReactAgent |
+| `zod` | ^3.23.0 | Tool schema validation |
+
+---
+
+## 📁 Cấu trúc project
+
+```
+plugin-agent-orchestrator/
+├── package.json
+├── README.md
+├── src/
+│   ├── index.ts
+│   ├── client/
+│   │   ├── index.tsx
+│   │   ├── plugin.tsx              # Đăng ký settings page
+│   │   ├── AIEmployeesContext.tsx   # Shared context (P3 optimization)
+│   │   ├── AIEmployeeSelect.tsx     # Reusable select component
+│   │   ├── OrchestratorSettings.tsx # Main settings page
+│   │   ├── RulesTab.tsx             # CRUD rules
+│   │   └── TracingTab.tsx           # Tracing dashboard
+│   ├── server/
+│   │   ├── index.ts
+│   │   ├── plugin.ts               # Main server plugin
+│   │   ├── collections/
+│   │   │   ├── orchestrator-config.ts
+│   │   │   └── orchestrator-logs.ts
+│   │   ├── resources/
+│   │   │   └── tracing.ts          # Custom read-only resource
+│   │   └── tools/
+│   │       └── delegate-task.ts     # Core delegation logic
+│   └── locale/
+│       ├── en-US.json
+│       └── vi-VN.json
+```
+
+---
+
+## ⚠️ Lưu ý quan trọng
+
+1. **Không sửa core plugin-ai**: Plugin này hoàn toàn standalone, chỉ dùng public APIs
+2. **Sub-Agent cần có LLM model**: Mỗi Sub-Agent phải được cấu hình `modelSettings` (llmService + model) trong AI Employee settings
+3. **Sub-Agent cần có skills**: Tools/skills được gán cho Sub-Agent trong `skillSettings` sẽ được cấp cho nó khi thực thi delegation
+4. **Circular prevention**: Các tool `delegate_to_*` tự động bị loại khỏi Sub-Agent → Sub-Agent không thể gọi lại Leader
+5. **Log retention**: `orchestratorLogs` tích lũy theo thời gian — cân nhắc cleanup định kỳ cho production
+
+---
+
+## 📜 License
+
+Apache-2.0

package/client.d.ts

@@ -0,0 +1,2 @@
+export * from './dist/client';
+export { default } from './dist/client';

package/client.js

@@ -0,0 +1 @@
+module.exports = require('./dist/client');

package/dist/client/AIEmployeeSelect.js

@@ -0,0 +1,29 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AIEmployeeSelect = void 0;
+const jsx_runtime_1 = require("react/jsx-runtime");
+const react_1 = __importDefault(require("react"));
+const antd_1 = require("antd");
+const AIEmployeesContext_1 = require("./AIEmployeesContext");
+/**
+ * Reusable Select component for AI Employees.
+ * P3 FIX: Uses shared AIEmployeesContext instead of making its own API call.
+ */
+const AIEmployeeSelect = ({ value, onChange, exclude, placeholder = 'Select AI Employee...' }) => {
+    const { employees, loading } = (0, AIEmployeesContext_1.useAIEmployees)();
+    const options = react_1.default.useMemo(() => {
+        return employees
+            .filter((emp) => !exclude || emp.username !== exclude)
+            .map((emp) => ({
+            label: emp.nickname,
+            value: emp.username,
+            description: emp.about,
+        }));
+    }, [employees, exclude]);
+    return ((0, jsx_runtime_1.jsx)(antd_1.Select, { loading: loading, options: options, value: value, onChange: onChange, placeholder: placeholder, showSearch: true, filterOption: (input, option) => (option?.label ?? '').toString().toLowerCase().includes(input.toLowerCase()) ||
+            (option?.value ?? '').toString().toLowerCase().includes(input.toLowerCase()), optionRender: (option) => ((0, jsx_runtime_1.jsxs)("div", { children: [(0, jsx_runtime_1.jsx)("div", { style: { fontWeight: 500 }, children: option.label }), option.data.description && ((0, jsx_runtime_1.jsx)("div", { style: { fontSize: 12, color: '#888' }, children: option.data.description }))] })) }));
+};
+exports.AIEmployeeSelect = AIEmployeeSelect;

package/dist/client/AIEmployeesContext.js

@@ -0,0 +1,64 @@
+"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 __importStar = (this && this.__importStar) || function (mod) {
+    if (mod && mod.__esModule) return mod;
+    var result = {};
+    if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
+    __setModuleDefault(result, mod);
+    return result;
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.useAIEmployees = exports.AIEmployeesProvider = void 0;
+const jsx_runtime_1 = require("react/jsx-runtime");
+const react_1 = __importStar(require("react"));
+const client_1 = require("@nocobase/client");
+const AIEmployeesContext = (0, react_1.createContext)({
+    employees: [],
+    employeeMap: new Map(),
+    loading: false,
+});
+/**
+ * P3 FIX: Shared context provider that fetches aiEmployees once
+ * and shares the data across RulesTab, TracingTab, and AIEmployeeSelect.
+ */
+const AIEmployeesProvider = ({ children }) => {
+    const { data, loading } = (0, client_1.useRequest)({
+        url: 'aiEmployees:list',
+        params: { pageSize: 200 },
+    });
+    const value = react_1.default.useMemo(() => {
+        const rawEmployees = data?.data || [];
+        const employees = rawEmployees.map((emp) => ({
+            username: emp.username,
+            nickname: emp.nickname || emp.username,
+            about: emp.about?.substring(0, 80),
+        }));
+        const employeeMap = new Map();
+        for (const emp of employees) {
+            employeeMap.set(emp.username, emp.nickname);
+        }
+        return { employees, employeeMap, loading };
+    }, [data, loading]);
+    return ((0, jsx_runtime_1.jsx)(AIEmployeesContext.Provider, { value: value, children: children }));
+};
+exports.AIEmployeesProvider = AIEmployeesProvider;
+/**
+ * Hook to access shared AI employees data.
+ */
+const useAIEmployees = () => (0, react_1.useContext)(AIEmployeesContext);
+exports.useAIEmployees = useAIEmployees;

package/dist/client/OrchestratorSettings.js

@@ -0,0 +1,32 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.OrchestratorSettings = void 0;
+const jsx_runtime_1 = require("react/jsx-runtime");
+const antd_1 = require("antd");
+const icons_1 = require("@ant-design/icons");
+const RulesTab_1 = require("./RulesTab");
+const TracingTab_1 = require("./TracingTab");
+const AIEmployeesContext_1 = require("./AIEmployeesContext");
+/**
+ * Main settings page for the Agent Orchestrator plugin.
+ * Contains two tabs:
+ * - Rules: Configure which AI Employees can delegate tasks to others
+ * - Tracing: View and debug delegation execution logs
+ *
+ * P3 FIX: Wraps with AIEmployeesProvider so both tabs share one API call.
+ */
+const OrchestratorSettings = () => {
+    return ((0, jsx_runtime_1.jsx)(AIEmployeesContext_1.AIEmployeesProvider, { children: (0, jsx_runtime_1.jsx)("div", { style: { padding: '0 24px 24px' }, children: (0, jsx_runtime_1.jsx)(antd_1.Tabs, { defaultActiveKey: "rules", items: [
+                    {
+                        key: 'rules',
+                        label: ((0, jsx_runtime_1.jsxs)("span", { children: [(0, jsx_runtime_1.jsx)(icons_1.ApartmentOutlined, {}), " Orchestration Rules"] })),
+                        children: (0, jsx_runtime_1.jsx)(RulesTab_1.RulesTab, {}),
+                    },
+                    {
+                        key: 'tracing',
+                        label: ((0, jsx_runtime_1.jsxs)("span", { children: [(0, jsx_runtime_1.jsx)(icons_1.MonitorOutlined, {}), " Swarm Tracing"] })),
+                        children: (0, jsx_runtime_1.jsx)(TracingTab_1.TracingTab, {}),
+                    },
+                ] }) }) }));
+};
+exports.OrchestratorSettings = OrchestratorSettings;

package/dist/client/RulesTab.js

@@ -0,0 +1,144 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RulesTab = void 0;
+const jsx_runtime_1 = require("react/jsx-runtime");
+const react_1 = require("react");
+const antd_1 = require("antd");
+const icons_1 = require("@ant-design/icons");
+const client_1 = require("@nocobase/client");
+const AIEmployeeSelect_1 = require("./AIEmployeeSelect");
+const AIEmployeesContext_1 = require("./AIEmployeesContext");
+const { Text } = antd_1.Typography;
+const RulesTab = () => {
+    const api = (0, client_1.useAPIClient)();
+    const [visible, setVisible] = (0, react_1.useState)(false);
+    const [editingRecord, setEditingRecord] = (0, react_1.useState)(null);
+    const [form] = antd_1.Form.useForm();
+    const { data, loading, refresh } = (0, client_1.useRequest)({
+        url: 'orchestratorConfig:list',
+        params: {
+            sort: ['-createdAt'],
+        },
+    });
+    // P3 FIX: Use shared context instead of duplicate API call
+    const { employeeMap } = (0, AIEmployeesContext_1.useAIEmployees)();
+    const handleOpen = (record) => {
+        setEditingRecord(record);
+        if (record) {
+            form.setFieldsValue(record);
+        }
+        else {
+            form.resetFields();
+            form.setFieldsValue({ enabled: true, maxDepth: 1, timeout: 120000 });
+        }
+        setVisible(true);
+    };
+    const handleClose = () => {
+        setVisible(false);
+        setEditingRecord(null);
+    };
+    const handleSave = async (values) => {
+        // Validate: leader !== subAgent
+        if (values.leaderUsername === values.subAgentUsername) {
+            antd_1.message.error('Leader and Sub-Agent cannot be the same employee.');
+            return;
+        }
+        try {
+            if (editingRecord) {
+                await api.request({
+                    url: 'orchestratorConfig:update',
+                    method: 'put',
+                    params: { filterByTk: editingRecord.id },
+                    data: values,
+                });
+                antd_1.message.success('Rule updated');
+            }
+            else {
+                await api.request({
+                    url: 'orchestratorConfig:create',
+                    method: 'post',
+                    data: values,
+                });
+                antd_1.message.success('Rule created');
+            }
+            handleClose();
+            refresh();
+        }
+        catch (e) {
+            const msg = e?.response?.data?.errors?.[0]?.message || e.message;
+            antd_1.message.error(`Save failed: ${msg}`);
+        }
+    };
+    const handleDelete = async (id) => {
+        try {
+            await api.request({
+                url: 'orchestratorConfig:destroy',
+                method: 'delete',
+                params: { filterByTk: id },
+            });
+            antd_1.message.success('Rule deleted');
+            refresh();
+        }
+        catch (e) {
+            antd_1.message.error(`Delete failed: ${e.message}`);
+        }
+    };
+    const columns = [
+        {
+            title: 'Leader (Orchestrator)',
+            dataIndex: 'leaderUsername',
+            key: 'leaderUsername',
+            render: (username) => ((0, jsx_runtime_1.jsx)(antd_1.Tag, { color: "blue", children: employeeMap.get(username) || username })),
+        },
+        {
+            title: '',
+            key: 'arrow',
+            width: 50,
+            render: () => (0, jsx_runtime_1.jsx)(icons_1.SwapRightOutlined, { style: { color: '#999', fontSize: 18 } }),
+        },
+        {
+            title: 'Sub-Agent',
+            dataIndex: 'subAgentUsername',
+            key: 'subAgentUsername',
+            render: (username) => ((0, jsx_runtime_1.jsx)(antd_1.Tag, { color: "green", children: employeeMap.get(username) || username })),
+        },
+        {
+            title: 'Max Depth',
+            dataIndex: 'maxDepth',
+            key: 'maxDepth',
+            width: 100,
+            render: (v) => v ?? 1,
+        },
+        {
+            title: 'Timeout',
+            dataIndex: 'timeout',
+            key: 'timeout',
+            width: 100,
+            render: (v) => `${((v ?? 120000) / 1000).toFixed(0)}s`,
+        },
+        {
+            title: 'Enabled',
+            dataIndex: 'enabled',
+            key: 'enabled',
+            width: 80,
+            render: (enabled, record) => ((0, jsx_runtime_1.jsx)(antd_1.Switch, { checked: enabled, size: "small", onChange: async (checked) => {
+                    await api.request({
+                        url: 'orchestratorConfig:update',
+                        method: 'put',
+                        params: { filterByTk: record.id },
+                        data: { enabled: checked },
+                    });
+                    refresh();
+                } })),
+        },
+        {
+            title: 'Actions',
+            key: 'actions',
+            width: 160,
+            render: (_, record) => ((0, jsx_runtime_1.jsxs)(antd_1.Space, { children: [(0, jsx_runtime_1.jsx)(antd_1.Button, { type: "link", size: "small", icon: (0, jsx_runtime_1.jsx)(icons_1.EditOutlined, {}), onClick: () => handleOpen(record), children: "Edit" }), (0, jsx_runtime_1.jsx)(antd_1.Popconfirm, { title: "Delete this rule?", onConfirm: () => handleDelete(record.id), children: (0, jsx_runtime_1.jsx)(antd_1.Button, { type: "link", size: "small", danger: true, icon: (0, jsx_runtime_1.jsx)(icons_1.DeleteOutlined, {}), children: "Delete" }) })] })),
+        },
+    ];
+    const leaderUsername = antd_1.Form.useWatch('leaderUsername', form);
+    return ((0, jsx_runtime_1.jsxs)("div", { children: [(0, jsx_runtime_1.jsx)(antd_1.Alert, { type: "info", showIcon: true, style: { marginBottom: 16 }, message: "Orchestration Rules", description: (0, jsx_runtime_1.jsx)(Text, { type: "secondary", children: "Configure which AI Employees can act as Leaders (Orchestrators) and which ones they can delegate tasks to. Each rule creates a callable tool for the Leader to invoke the Sub-Agent." }) }), (0, jsx_runtime_1.jsxs)(antd_1.Card, { bordered: false, children: [(0, jsx_runtime_1.jsx)("div", { style: { marginBottom: 16, display: 'flex', justifyContent: 'flex-end' }, children: (0, jsx_runtime_1.jsx)(antd_1.Button, { type: "primary", icon: (0, jsx_runtime_1.jsx)(icons_1.PlusOutlined, {}), onClick: () => handleOpen(), children: "New Rule" }) }), (0, jsx_runtime_1.jsx)(antd_1.Table, { rowKey: "id", loading: loading, dataSource: data?.data || [], columns: columns, pagination: { hideOnSinglePage: true, pageSize: 20 }, size: "middle" })] }), (0, jsx_runtime_1.jsx)(antd_1.Drawer, { title: editingRecord ? 'Edit Orchestration Rule' : 'New Orchestration Rule', width: 480, onClose: handleClose, open: visible, styles: { body: { paddingBottom: 80 } }, extra: (0, jsx_runtime_1.jsxs)(antd_1.Space, { children: [(0, jsx_runtime_1.jsx)(antd_1.Button, { onClick: handleClose, children: "Cancel" }), (0, jsx_runtime_1.jsx)(antd_1.Button, { onClick: () => form.submit(), type: "primary", children: "Save" })] }), children: (0, jsx_runtime_1.jsxs)(antd_1.Form, { form: form, layout: "vertical", onFinish: handleSave, children: [(0, jsx_runtime_1.jsx)(antd_1.Form.Item, { name: "leaderUsername", label: "Leader (Orchestrator)", rules: [{ required: true, message: 'Please select a Leader' }], tooltip: "The AI Employee that will be able to delegate tasks to the Sub-Agent", children: (0, jsx_runtime_1.jsx)(AIEmployeeSelect_1.AIEmployeeSelect, { placeholder: "Select Leader AI Employee..." }) }), (0, jsx_runtime_1.jsx)(antd_1.Form.Item, { name: "subAgentUsername", label: "Sub-Agent", rules: [{ required: true, message: 'Please select a Sub-Agent' }], tooltip: "The AI Employee that will receive delegated tasks", children: (0, jsx_runtime_1.jsx)(AIEmployeeSelect_1.AIEmployeeSelect, { placeholder: "Select Sub-Agent AI Employee...", exclude: leaderUsername }) }), (0, jsx_runtime_1.jsx)(antd_1.Form.Item, { name: "maxDepth", label: "Max Delegation Depth", tooltip: "How many layers of delegation are allowed (1 = leader calls sub-agent, sub-agent cannot delegate further)", children: (0, jsx_runtime_1.jsx)(antd_1.InputNumber, { min: 1, max: 3, style: { width: '100%' } }) }), (0, jsx_runtime_1.jsx)(antd_1.Form.Item, { name: "timeout", label: "Timeout (ms)", tooltip: "Maximum time in milliseconds for the sub-agent to complete its task", children: (0, jsx_runtime_1.jsx)(antd_1.InputNumber, { min: 10000, max: 600000, step: 10000, style: { width: '100%' } }) }), (0, jsx_runtime_1.jsx)(antd_1.Form.Item, { name: "enabled", label: "Enabled", valuePropName: "checked", children: (0, jsx_runtime_1.jsx)(antd_1.Switch, {}) })] }) })] }));
+};
+exports.RulesTab = RulesTab;

package/dist/client/TracingTab.js

@@ -0,0 +1,88 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TracingTab = void 0;
+const jsx_runtime_1 = require("react/jsx-runtime");
+const react_1 = require("react");
+const antd_1 = require("antd");
+const icons_1 = require("@ant-design/icons");
+const client_1 = require("@nocobase/client");
+const AIEmployeesContext_1 = require("./AIEmployeesContext");
+const { Text, Paragraph } = antd_1.Typography;
+/**
+ * Phase 5: Swarm Tracing page.
+ * Displays delegation execution logs from the orchestratorLogs collection.
+ */
+const TracingTab = () => {
+    const [selectedLog, setSelectedLog] = (0, react_1.useState)(null);
+    // Fetch delegation logs
+    const { data, loading, refresh } = (0, client_1.useRequest)({
+        url: 'orchestratorTracing:list',
+        params: {
+            sort: ['-createdAt'],
+            pageSize: 50,
+        },
+    });
+    // P3 FIX: Use shared context instead of duplicate API call
+    const { employeeMap } = (0, AIEmployeesContext_1.useAIEmployees)();
+    const columns = [
+        {
+            title: 'Time',
+            dataIndex: 'createdAt',
+            key: 'createdAt',
+            width: 170,
+            render: (v) => v ? new Date(v).toLocaleString() : '-',
+        },
+        {
+            title: 'Sub-Agent',
+            dataIndex: 'subAgentUsername',
+            key: 'subAgentUsername',
+            render: (username) => ((0, jsx_runtime_1.jsx)(antd_1.Tag, { color: "green", children: employeeMap.get(username) || username })),
+        },
+        {
+            title: 'Task',
+            dataIndex: 'task',
+            key: 'task',
+            render: (task) => ((0, jsx_runtime_1.jsx)(Text, { ellipsis: true, style: { maxWidth: 280 }, children: task?.substring(0, 100) || '-' })),
+        },
+        {
+            title: 'Status',
+            dataIndex: 'status',
+            key: 'status',
+            width: 90,
+            render: (status) => ((0, jsx_runtime_1.jsx)(antd_1.Tag, { icon: status === 'success' ? (0, jsx_runtime_1.jsx)(icons_1.CheckCircleOutlined, {}) : (0, jsx_runtime_1.jsx)(icons_1.CloseCircleOutlined, {}), color: status === 'success' ? 'success' : 'error', children: status })),
+        },
+        {
+            title: 'Duration',
+            dataIndex: 'durationMs',
+            key: 'durationMs',
+            width: 90,
+            render: (ms) => {
+                if (!ms)
+                    return '-';
+                return ms >= 1000 ? `${(ms / 1000).toFixed(1)}s` : `${ms}ms`;
+            },
+        },
+        {
+            title: 'Depth',
+            dataIndex: 'depth',
+            key: 'depth',
+            width: 60,
+            render: (v) => v ?? 0,
+        },
+        {
+            title: '',
+            key: 'actions',
+            width: 80,
+            render: (_, record) => ((0, jsx_runtime_1.jsx)(antd_1.Button, { type: "link", size: "small", icon: (0, jsx_runtime_1.jsx)(icons_1.EyeOutlined, {}), onClick: () => setSelectedLog(record), children: "Detail" })),
+        },
+    ];
+    return ((0, jsx_runtime_1.jsxs)("div", { children: [(0, jsx_runtime_1.jsx)(antd_1.Alert, { type: "info", showIcon: true, style: { marginBottom: 16 }, message: "Swarm Tracing", description: (0, jsx_runtime_1.jsx)(Text, { type: "secondary", children: "View delegation execution logs. Each row represents one sub-agent invocation triggered by a Leader's tool call." }) }), (0, jsx_runtime_1.jsxs)(antd_1.Card, { bordered: false, children: [(0, jsx_runtime_1.jsx)("div", { style: { marginBottom: 16, display: 'flex', justifyContent: 'flex-end' }, children: (0, jsx_runtime_1.jsx)(antd_1.Button, { onClick: refresh, children: "Refresh" }) }), (0, jsx_runtime_1.jsx)(antd_1.Table, { rowKey: "id", loading: loading, dataSource: data?.data || [], columns: columns, pagination: { hideOnSinglePage: true, pageSize: 20 }, size: "middle", locale: { emptyText: (0, jsx_runtime_1.jsx)(antd_1.Empty, { description: "No delegation executions yet" }) } })] }), (0, jsx_runtime_1.jsx)(antd_1.Drawer, { title: "Delegation Detail", width: 640, onClose: () => setSelectedLog(null), open: !!selectedLog, children: selectedLog && ((0, jsx_runtime_1.jsxs)(jsx_runtime_1.Fragment, { children: [(0, jsx_runtime_1.jsxs)(antd_1.Descriptions, { column: 1, bordered: true, size: "small", style: { marginBottom: 16 }, children: [(0, jsx_runtime_1.jsx)(antd_1.Descriptions.Item, { label: "Status", children: (0, jsx_runtime_1.jsx)(antd_1.Tag, { icon: selectedLog.status === 'success' ? (0, jsx_runtime_1.jsx)(icons_1.CheckCircleOutlined, {}) : (0, jsx_runtime_1.jsx)(icons_1.CloseCircleOutlined, {}), color: selectedLog.status === 'success' ? 'success' : 'error', children: selectedLog.status }) }), (0, jsx_runtime_1.jsx)(antd_1.Descriptions.Item, { label: "Sub-Agent", children: (0, jsx_runtime_1.jsx)(antd_1.Tag, { color: "green", children: employeeMap.get(selectedLog.subAgentUsername) || selectedLog.subAgentUsername }) }), (0, jsx_runtime_1.jsx)(antd_1.Descriptions.Item, { label: "Tool", children: (0, jsx_runtime_1.jsx)(Text, { code: true, children: selectedLog.toolName }) }), (0, jsx_runtime_1.jsx)(antd_1.Descriptions.Item, { label: "Depth", children: selectedLog.depth ?? 0 }), (0, jsx_runtime_1.jsx)(antd_1.Descriptions.Item, { label: "Duration", children: selectedLog.durationMs
+                                        ? selectedLog.durationMs >= 1000
+                                            ? `${(selectedLog.durationMs / 1000).toFixed(1)}s`
+                                            : `${selectedLog.durationMs}ms`
+                                        : '-' }), (0, jsx_runtime_1.jsx)(antd_1.Descriptions.Item, { label: "Time", children: selectedLog.createdAt ? new Date(selectedLog.createdAt).toLocaleString() : '-' })] }), (0, jsx_runtime_1.jsx)(antd_1.Card, { title: "Task", size: "small", style: { marginBottom: 16 }, children: (0, jsx_runtime_1.jsx)(Paragraph, { style: { whiteSpace: 'pre-wrap', margin: 0, fontSize: 13 }, children: selectedLog.task || 'No task description' }) }), (0, jsx_runtime_1.jsx)(antd_1.Card, { title: "Result", size: "small", style: {
+                                marginBottom: 16,
+                                borderColor: selectedLog.status === 'success' ? '#b7eb8f' : '#ffa39e',
+                            }, children: (0, jsx_runtime_1.jsx)(Paragraph, { style: { whiteSpace: 'pre-wrap', margin: 0, fontSize: 13 }, ellipsis: { rows: 20, expandable: true }, children: selectedLog.result || selectedLog.error || 'No result' }) }), selectedLog.error && ((0, jsx_runtime_1.jsx)(antd_1.Card, { title: "Error", size: "small", style: { borderColor: '#ffa39e' }, children: (0, jsx_runtime_1.jsx)(Paragraph, { type: "danger", style: { whiteSpace: 'pre-wrap', margin: 0, fontSize: 13 }, children: selectedLog.error }) }))] })) })] }));
+};
+exports.TracingTab = TracingTab;