plugin-agent-orchestrator 1.0.0 → 1.0.5

package/dist/node_modules/zod/v4-mini/index.cjs

@@ -0,0 +1,17 @@
+"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 __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("../v4/mini/index.cjs"), exports);

package/dist/node_modules/zod/v4-mini/index.d.cts

@@ -0,0 +1 @@
+export * from "../v4/mini/index.cjs";

package/dist/node_modules/zod/v4-mini/index.d.ts

@@ -0,0 +1 @@
+export * from "../v4/mini/index.js";

package/dist/node_modules/zod/v4-mini/index.js

@@ -0,0 +1 @@
+export * from "../v4/mini/index.js";

package/dist/server/collections/orchestrator-config.d.ts

@@ -0,0 +1,2 @@
+declare const _default: import("@nocobase/database").CollectionOptions;
+export default _default;

package/dist/server/collections/orchestrator-config.js

@@ -0,0 +1,79 @@
+/**
+ * This file is part of the NocoBase (R) project.
+ * Copyright (c) 2020-2024 NocoBase Co., Ltd.
+ * Authors: NocoBase Team.
+ *
+ * This project is dual-licensed under AGPL-3.0 and NocoBase Commercial License.
+ * For more information, please refer to: https://www.nocobase.com/agreement.
+ */
+
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var orchestrator_config_exports = {};
+__export(orchestrator_config_exports, {
+  default: () => orchestrator_config_default
+});
+module.exports = __toCommonJS(orchestrator_config_exports);
+var import_database = require("@nocobase/database");
+var orchestrator_config_default = (0, import_database.defineCollection)({
+  name: "orchestratorConfig",
+  title: "Orchestrator Config",
+  fields: [
+    {
+      name: "id",
+      type: "bigInt",
+      autoIncrement: true,
+      primaryKey: true
+    },
+    {
+      name: "leaderUsername",
+      type: "string",
+      allowNull: false,
+      comment: "AI Employee username that acts as the Leader/Orchestrator"
+    },
+    {
+      name: "subAgentUsername",
+      type: "string",
+      allowNull: false,
+      comment: "AI Employee username that acts as the Sub-Agent"
+    },
+    {
+      name: "enabled",
+      type: "boolean",
+      defaultValue: true
+    },
+    {
+      name: "maxDepth",
+      type: "integer",
+      defaultValue: 1,
+      comment: "Maximum delegation depth (1 = leader can call sub, sub cannot call further)"
+    },
+    {
+      name: "timeout",
+      type: "integer",
+      defaultValue: 12e4,
+      comment: "Timeout in ms for sub-agent execution"
+    }
+  ],
+  indexes: [
+    {
+      unique: true,
+      fields: ["leaderUsername", "subAgentUsername"]
+    }
+  ]
+});

package/dist/server/collections/orchestrator-logs.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Stores delegation execution logs for Swarm Tracing (Phase 5).
+ *
+ * Since createReactAgent doesn't create aiConversation records,
+ * we log delegation events to a dedicated table for observability.
+ */
+declare const _default: import("@nocobase/database").CollectionOptions;
+export default _default;

package/dist/server/collections/orchestrator-logs.js

@@ -0,0 +1,123 @@
+/**
+ * This file is part of the NocoBase (R) project.
+ * Copyright (c) 2020-2024 NocoBase Co., Ltd.
+ * Authors: NocoBase Team.
+ *
+ * This project is dual-licensed under AGPL-3.0 and NocoBase Commercial License.
+ * For more information, please refer to: https://www.nocobase.com/agreement.
+ */
+
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var orchestrator_logs_exports = {};
+__export(orchestrator_logs_exports, {
+  default: () => orchestrator_logs_default
+});
+module.exports = __toCommonJS(orchestrator_logs_exports);
+var import_database = require("@nocobase/database");
+var orchestrator_logs_default = (0, import_database.defineCollection)({
+  name: "orchestratorLogs",
+  title: "Orchestrator Logs",
+  fields: [
+    {
+      name: "id",
+      type: "bigInt",
+      autoIncrement: true,
+      primaryKey: true
+    },
+    {
+      name: "leaderUsername",
+      type: "string",
+      allowNull: false,
+      comment: "The AI Employee that initiated the delegation"
+    },
+    {
+      name: "subAgentUsername",
+      type: "string",
+      allowNull: false,
+      comment: "The AI Employee that executed the delegated task"
+    },
+    {
+      name: "toolName",
+      type: "string",
+      comment: "The tool name used for delegation (e.g., delegate_to_sql_expert)"
+    },
+    {
+      name: "task",
+      type: "text",
+      comment: "The task description sent to the sub-agent"
+    },
+    {
+      name: "result",
+      type: "text",
+      comment: "The sub-agent result content"
+    },
+    {
+      name: "status",
+      type: "string",
+      comment: "success or error"
+    },
+    {
+      name: "depth",
+      type: "integer",
+      defaultValue: 0,
+      comment: "Delegation depth level (0 = first-level delegation)"
+    },
+    {
+      name: "durationMs",
+      type: "integer",
+      comment: "Execution duration in milliseconds"
+    },
+    {
+      name: "error",
+      type: "text",
+      comment: "Error message if status is error"
+    },
+    {
+      name: "userId",
+      type: "bigInt",
+      comment: "The user who triggered the leader conversation"
+    },
+    {
+      name: "createdAt",
+      type: "date",
+      interface: "createdAt",
+      field: "createdAt",
+      uiSchema: {
+        type: "datetime",
+        title: '{{t("Created at")}}',
+        "x-component": "DatePicker",
+        "x-component-props": { showTime: true },
+        "x-read-pretty": true
+      }
+    },
+    {
+      name: "updatedAt",
+      type: "date",
+      interface: "updatedAt",
+      field: "updatedAt",
+      uiSchema: {
+        type: "datetime",
+        title: '{{t("Updated at")}}',
+        "x-component": "DatePicker",
+        "x-component-props": { showTime: true },
+        "x-read-pretty": true
+      }
+    }
+  ]
+});

package/dist/server/index.d.ts

@@ -0,0 +1 @@
+export { default } from './plugin';

package/dist/server/index.js

@@ -1,8 +1,42 @@
-"use strict";
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
+/**
+ * This file is part of the NocoBase (R) project.
+ * Copyright (c) 2020-2024 NocoBase Co., Ltd.
+ * Authors: NocoBase Team.
+ *
+ * This project is dual-licensed under AGPL-3.0 and NocoBase Commercial License.
+ * For more information, please refer to: https://www.nocobase.com/agreement.
+ */
+
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
 };
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.default = void 0;
-var plugin_1 = require("./plugin");
-Object.defineProperty(exports, "default", { enumerable: true, get: function () { return __importDefault(plugin_1).default; } });
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var server_exports = {};
+__export(server_exports, {
+  default: () => import_plugin.default
+});
+module.exports = __toCommonJS(server_exports);
+var import_plugin = __toESM(require("./plugin"));

package/dist/server/plugin.d.ts

@@ -0,0 +1,11 @@
+import { Plugin } from '@nocobase/server';
+export declare class PluginAgentOrchestratorServer extends Plugin {
+    afterAdd(): Promise<void>;
+    beforeLoad(): Promise<void>;
+    load(): Promise<void>;
+    install(): Promise<void>;
+    afterEnable(): Promise<void>;
+    afterDisable(): Promise<void>;
+    remove(): Promise<void>;
+}
+export default PluginAgentOrchestratorServer;

package/dist/server/plugin.js

@@ -1,44 +1,75 @@
-"use strict";
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
+/**
+ * This file is part of the NocoBase (R) project.
+ * Copyright (c) 2020-2024 NocoBase Co., Ltd.
+ * Authors: NocoBase Team.
+ *
+ * This project is dual-licensed under AGPL-3.0 and NocoBase Commercial License.
+ * For more information, please refer to: https://www.nocobase.com/agreement.
+ */
+
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
 };
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.PluginAgentOrchestratorServer = void 0;
-const server_1 = require("@nocobase/server");
-const path_1 = __importDefault(require("path"));
-const delegate_task_1 = require("./tools/delegate-task");
-const tracing_1 = require("./resources/tracing");
-class PluginAgentOrchestratorServer extends server_1.Plugin {
-    async afterAdd() { }
-    async beforeLoad() {
-        // Import collection definitions
-        this.db.import({ directory: path_1.default.resolve(__dirname, 'collections') });
-    }
-    async load() {
-        // --- ACL ---
-        this.app.acl.registerSnippet({
-            name: `pm.${this.name}`,
-            actions: ['orchestratorConfig:*'],
-        });
-        // --- Register Dynamic Tools ---
-        // Each configured sub-agent becomes a callable tool for its leader.
-        // Uses createReactAgent (LangGraph public API) instead of private AIEmployee class.
-        // Tools are registered via app.aiManager.toolsManager (public API from @nocobase/ai core).
-        const toolsManager = this.app.aiManager.toolsManager;
-        toolsManager.registerDynamicTools((0, delegate_task_1.createDelegateToolsProvider)(this));
-        // --- Register Tracing Resource (Phase 5) ---
-        // Custom read-only resource for the Swarm Tracing admin page.
-        (0, tracing_1.registerTracingResource)(this);
-        // NOTE: The createReactAgent approach does NOT create aiConversation records,
-        // so there is no need for a middleware to hide "headless" conversations.
-        // If future versions need conversation logging, add it here.
-    }
-    async install() {
-        // No seed data needed on first install
-    }
-    async afterEnable() { }
-    async afterDisable() { }
-    async remove() { }
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var plugin_exports = {};
+__export(plugin_exports, {
+  PluginAgentOrchestratorServer: () => PluginAgentOrchestratorServer,
+  default: () => plugin_default
+});
+module.exports = __toCommonJS(plugin_exports);
+var import_server = require("@nocobase/server");
+var import_path = __toESM(require("path"));
+var import_delegate_task = require("./tools/delegate-task");
+var import_tracing = require("./resources/tracing");
+class PluginAgentOrchestratorServer extends import_server.Plugin {
+  async afterAdd() {
+  }
+  async beforeLoad() {
+    this.db.import({ directory: import_path.default.resolve(__dirname, "collections") });
+  }
+  async load() {
+    this.app.acl.registerSnippet({
+      name: `pm.${this.name}`,
+      actions: ["orchestratorConfig:*"]
+    });
+    const toolsManager = this.app.aiManager.toolsManager;
+    toolsManager.registerDynamicTools((0, import_delegate_task.createDelegateToolsProvider)(this));
+    (0, import_tracing.registerTracingResource)(this);
+  }
+  async install() {
+  }
+  async afterEnable() {
+  }
+  async afterDisable() {
+  }
+  async remove() {
+  }
 }
-exports.PluginAgentOrchestratorServer = PluginAgentOrchestratorServer;
-exports.default = PluginAgentOrchestratorServer;
+var plugin_default = PluginAgentOrchestratorServer;
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  PluginAgentOrchestratorServer
+});

package/dist/server/resources/tracing.d.ts

@@ -0,0 +1,7 @@
+import { Plugin } from '@nocobase/server';
+/**
+ * Custom resource for the Swarm Tracing admin UI (Phase 5).
+ * Queries the dedicated orchestratorLogs collection instead of
+ * filtering aiConversations by JSONB (P2 fix: DB-engine agnostic).
+ */
+export declare function registerTracingResource(plugin: Plugin): void;

package/dist/server/resources/tracing.js

@@ -1,85 +1,108 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.registerTracingResource = void 0;
 /**
- * Custom resource for the Swarm Tracing admin UI (Phase 5).
- * Queries the dedicated orchestratorLogs collection instead of
- * filtering aiConversations by JSONB (P2 fix: DB-engine agnostic).
+ * This file is part of the NocoBase (R) project.
+ * Copyright (c) 2020-2024 NocoBase Co., Ltd.
+ * Authors: NocoBase Team.
+ *
+ * This project is dual-licensed under AGPL-3.0 and NocoBase Commercial License.
+ * For more information, please refer to: https://www.nocobase.com/agreement.
  */
+
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var tracing_exports = {};
+__export(tracing_exports, {
+  registerTracingResource: () => registerTracingResource
+});
+module.exports = __toCommonJS(tracing_exports);
 function registerTracingResource(plugin) {
-    const app = plugin.app;
-    app.resource({
-        name: 'orchestratorTracing',
-        actions: {
-            /**
-             * List all delegation execution logs.
-             */
-            async list(ctx, next) {
-                const repo = ctx.db.getRepository('orchestratorLogs');
-                const { page = 1, pageSize = 50, sort = ['-createdAt'] } = ctx.action.params;
-                try {
-                    const [rows, count] = await repo.findAndCount({
-                        sort,
-                        offset: (Number(page) - 1) * Number(pageSize),
-                        limit: Number(pageSize),
-                    });
-                    ctx.body = {
-                        data: rows.map((row) => ({
-                            id: row.id,
-                            leaderUsername: row.leaderUsername,
-                            subAgentUsername: row.subAgentUsername,
-                            toolName: row.toolName,
-                            task: row.task,
-                            result: row.result,
-                            status: row.status,
-                            depth: row.depth,
-                            durationMs: row.durationMs,
-                            error: row.error,
-                            userId: row.userId,
-                            createdAt: row.createdAt,
-                        })),
-                        meta: {
-                            count,
-                            page: Number(page),
-                            pageSize: Number(pageSize),
-                            totalPage: Math.ceil(count / Number(pageSize)),
-                        },
-                    };
-                }
-                catch (e) {
-                    ctx.log.error('[AgentOrchestrator] Tracing list error', e);
-                    ctx.body = { data: [], meta: { count: 0 } };
-                }
-                await next();
-            },
-            /**
-             * Get a single delegation log by ID.
-             */
-            async get(ctx, next) {
-                const { filterByTk } = ctx.action.params;
-                if (!filterByTk) {
-                    ctx.throw(400, 'id is required');
-                    return;
-                }
-                try {
-                    const repo = ctx.db.getRepository('orchestratorLogs');
-                    const log = await repo.findOne({
-                        filter: { id: filterByTk },
-                    });
-                    ctx.body = { data: log };
-                }
-                catch (e) {
-                    ctx.log.error('[AgentOrchestrator] Tracing get error', e);
-                    ctx.body = { data: null };
-                }
-                await next();
-            },
-        },
-    });
-    // ACL: allow admin access to tracing endpoints
-    app.acl.registerSnippet({
-        name: `pm.${plugin.name}.tracing`,
-        actions: ['orchestratorTracing:list', 'orchestratorTracing:get'],
-    });
+  const app = plugin.app;
+  app.resource({
+    name: "orchestratorTracing",
+    actions: {
+      /**
+       * List all delegation execution logs.
+       */
+      async list(ctx, next) {
+        const repo = ctx.db.getRepository("orchestratorLogs");
+        const { page = 1, pageSize = 50, sort = ["-createdAt"] } = ctx.action.params;
+        try {
+          const [rows, count] = await repo.findAndCount({
+            sort,
+            offset: (Number(page) - 1) * Number(pageSize),
+            limit: Number(pageSize)
+          });
+          ctx.body = {
+            data: rows.map((row) => ({
+              id: row.id,
+              leaderUsername: row.leaderUsername,
+              subAgentUsername: row.subAgentUsername,
+              toolName: row.toolName,
+              task: row.task,
+              result: row.result,
+              status: row.status,
+              depth: row.depth,
+              durationMs: row.durationMs,
+              error: row.error,
+              userId: row.userId,
+              createdAt: row.createdAt
+            })),
+            meta: {
+              count,
+              page: Number(page),
+              pageSize: Number(pageSize),
+              totalPage: Math.ceil(count / Number(pageSize))
+            }
+          };
+        } catch (e) {
+          ctx.log.error("[AgentOrchestrator] Tracing list error", e);
+          ctx.body = { data: [], meta: { count: 0 } };
+        }
+        await next();
+      },
+      /**
+       * Get a single delegation log by ID.
+       */
+      async get(ctx, next) {
+        const { filterByTk } = ctx.action.params;
+        if (!filterByTk) {
+          ctx.throw(400, "id is required");
+          return;
+        }
+        try {
+          const repo = ctx.db.getRepository("orchestratorLogs");
+          const log = await repo.findOne({
+            filter: { id: filterByTk }
+          });
+          ctx.body = { data: log };
+        } catch (e) {
+          ctx.log.error("[AgentOrchestrator] Tracing get error", e);
+          ctx.body = { data: null };
+        }
+        await next();
+      }
+    }
+  });
+  app.acl.registerSnippet({
+    name: `pm.${plugin.name}.tracing`,
+    actions: ["orchestratorTracing:list", "orchestratorTracing:get"]
+  });
 }
-exports.registerTracingResource = registerTracingResource;
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  registerTracingResource
+});

package/dist/server/tools/delegate-task.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Creates one dynamic tool per configured sub-agent for a given leader.
+ * Uses Strategy B (Per-SubAgent Tool): each sub-agent becomes a separate tool
+ * with its own name and description, making LLM tool selection natural.
+ *
+ * Architecture:
+ * - Uses createReactAgent (public LangGraph API) for agent execution
+ * - Uses plugin-ai's getLLMService() for LLM model resolution
+ * - Uses core app.aiManager.toolsManager.listTools() for tool resolution
+ *   (same manager that AIEmployee uses — see ai-employee.ts:1286)
+ * - Depth enforcement via ctx metadata tracking
+ * - Per-leader scoping via invoke-time check (core ToolsOptions has no
+ *   leaderUsername field, so scoping is enforced in the invoke callback)
+ */
+export declare function createDelegateToolsProvider(plugin: any): (register: any) => Promise<void>;