plugin-agent-orchestrator 1.0.17 → 1.0.18

package/dist/server/collections/agent-loop-steps.js

@@ -0,0 +1,174 @@
+/**
+ * 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 agent_loop_steps_exports = {};
+__export(agent_loop_steps_exports, {
+  default: () => agent_loop_steps_default
+});
+module.exports = __toCommonJS(agent_loop_steps_exports);
+var import_database = require("@nocobase/database");
+var agent_loop_steps_default = (0, import_database.defineCollection)({
+  name: "agentLoopSteps",
+  title: "Agent Loop Steps",
+  fields: [
+    {
+      name: "id",
+      type: "bigInt",
+      autoIncrement: true,
+      primaryKey: true
+    },
+    {
+      name: "run",
+      type: "belongsTo",
+      target: "agentLoopRuns",
+      foreignKey: "runId"
+    },
+    {
+      name: "parentStep",
+      type: "belongsTo",
+      target: "agentLoopSteps",
+      foreignKey: "parentStepId"
+    },
+    {
+      name: "planKey",
+      type: "string",
+      length: 100
+    },
+    {
+      name: "index",
+      type: "integer",
+      defaultValue: 0
+    },
+    {
+      name: "title",
+      type: "string",
+      length: 500
+    },
+    {
+      name: "description",
+      type: "text"
+    },
+    {
+      name: "type",
+      type: "string",
+      length: 30,
+      comment: "reasoning, skill, tool, sub_agent, verification"
+    },
+    {
+      name: "target",
+      type: "string",
+      length: 200
+    },
+    {
+      name: "input",
+      type: "json",
+      defaultValue: {}
+    },
+    {
+      name: "output",
+      type: "json",
+      defaultValue: {}
+    },
+    {
+      name: "status",
+      type: "string",
+      length: 30,
+      defaultValue: "pending",
+      comment: "pending, running, waiting_user, succeeded, failed, skipped"
+    },
+    {
+      name: "attempt",
+      type: "integer",
+      defaultValue: 0
+    },
+    {
+      name: "maxAttempts",
+      type: "integer",
+      defaultValue: 2
+    },
+    {
+      name: "dependsOn",
+      type: "json",
+      defaultValue: []
+    },
+    {
+      name: "dependencyPolicy",
+      type: "string",
+      length: 30,
+      defaultValue: "require_success",
+      comment: "require_success or allow_skipped"
+    },
+    {
+      name: "approval",
+      type: "json",
+      defaultValue: {}
+    },
+    {
+      name: "error",
+      type: "text"
+    },
+    {
+      name: "agentExecutionSpanId",
+      type: "bigInt"
+    },
+    {
+      name: "skillExecutionId",
+      type: "bigInt"
+    },
+    {
+      name: "metadata",
+      type: "json",
+      defaultValue: {}
+    },
+    {
+      name: "startedAt",
+      type: "date"
+    },
+    {
+      name: "endedAt",
+      type: "date"
+    },
+    {
+      name: "createdAt",
+      type: "date"
+    },
+    {
+      name: "updatedAt",
+      type: "date"
+    }
+  ],
+  indexes: [
+    {
+      fields: ["runId"]
+    },
+    {
+      fields: ["status"]
+    },
+    {
+      fields: ["planKey"]
+    }
+  ]
+});

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

@@ -75,6 +75,13 @@ var orchestrator_config_default = (0, import_database.defineCollection)({
       defaultValue: 50,
       comment: "Max LangGraph reasoning steps (tool-call + LLM-step iterations) per delegation. Lower = safer; higher = more complex multi-step tasks. Default 50."
     },
+    {
+      name: "harnessTag",
+      type: "string",
+      length: 100,
+      defaultValue: "default",
+      comment: "Harness profile tag used by the orchestrator controller and approval flow."
+    },
     {
       name: "llmService",
       type: "string",

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/skill-definitions.d.ts

@@ -0,0 +1,3 @@
+import { CollectionOptions } from '@nocobase/database';
+declare const _default: CollectionOptions;
+export default _default;

package/dist/server/collections/skill-executions.d.ts

@@ -0,0 +1,3 @@
+import { CollectionOptions } from '@nocobase/database';
+declare const _default: CollectionOptions;
+export default _default;

package/dist/server/collections/skill-executions.js

@@ -109,6 +109,18 @@ var skill_executions_default = {
       length: 100,
       allowNull: true
     },
+    {
+      name: "agentLoopRunId",
+      type: "string",
+      length: 100,
+      allowNull: true
+    },
+    {
+      name: "agentLoopStepId",
+      type: "string",
+      length: 100,
+      allowNull: true
+    },
     {
       name: "triggeredBy",
       type: "belongsTo",

package/dist/server/collections/skill-loop-configs.d.ts

@@ -0,0 +1,3 @@
+import { CollectionOptions } from '@nocobase/database';
+declare const _default: CollectionOptions;
+export default _default;

package/dist/server/collections/skill-loop-configs.js

@@ -0,0 +1,94 @@
+/**
+ * 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 skill_loop_configs_exports = {};
+__export(skill_loop_configs_exports, {
+  default: () => skill_loop_configs_default
+});
+module.exports = __toCommonJS(skill_loop_configs_exports);
+var skill_loop_configs_default = {
+  name: "skillLoopConfigs",
+  title: "Skill Loop Configs",
+  fields: [
+    {
+      name: "id",
+      type: "bigInt",
+      autoIncrement: true,
+      primaryKey: true
+    },
+    {
+      name: "skill",
+      type: "belongsTo",
+      target: "skillDefinitions",
+      foreignKey: "skillId"
+    },
+    {
+      name: "enabled",
+      type: "boolean",
+      defaultValue: true
+    },
+    {
+      name: "title",
+      type: "string",
+      length: 200
+    },
+    {
+      name: "templateKey",
+      type: "string",
+      length: 80,
+      defaultValue: "confirm"
+    },
+    {
+      name: "prompt",
+      type: "text"
+    },
+    {
+      // Resolved interaction schema consumed by the generic Skill Hub UI card.
+      name: "schema",
+      type: "text"
+    },
+    {
+      // Optional template-specific state for future loop renderers.
+      name: "config",
+      type: "text",
+      defaultValue: null
+    },
+    {
+      name: "createdAt",
+      type: "date"
+    },
+    {
+      name: "updatedAt",
+      type: "date"
+    },
+    {
+      name: "createdBy",
+      type: "belongsTo",
+      target: "users",
+      foreignKey: "createdById"
+    }
+  ]
+};

package/dist/server/collections/skill-worker-configs.d.ts

@@ -0,0 +1,3 @@
+import { CollectionOptions } from '@nocobase/database';
+declare const _default: CollectionOptions;
+export default _default;

package/dist/server/index.d.ts

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

package/dist/server/migrations/20260423000000-add-progress-fields.d.ts

@@ -0,0 +1,4 @@
+import { Migration } from '@nocobase/server';
+export default class AddProgressFieldsMigration extends Migration {
+    up(): Promise<void>;
+}

package/dist/server/migrations/20260425000000-add-interaction-schema.d.ts

@@ -0,0 +1,4 @@
+import { Migration } from '@nocobase/server';
+export default class AddInteractionSchemaMigration extends Migration {
+    up(): Promise<void>;
+}

package/dist/server/migrations/20260427000000-add-tracing-detail-fields.d.ts

@@ -0,0 +1,7 @@
+import { Migration } from '@nocobase/server';
+export default class AddTracingDetailFieldsMigration extends Migration {
+    on: string;
+    appVersion: string;
+    up(): Promise<void>;
+    down(): Promise<void>;
+}

package/dist/server/migrations/20260427000000-change-packages-to-text.d.ts

@@ -0,0 +1,4 @@
+import { Migration } from '@nocobase/server';
+export default class ChangePackagesToTextMigration extends Migration {
+    up(): Promise<void>;
+}

package/dist/server/migrations/20260427000001-change-other-json-to-text.d.ts

@@ -0,0 +1,4 @@
+import { Migration } from '@nocobase/server';
+export default class ChangeOtherJsonToTextMigration extends Migration {
+    up(): Promise<void>;
+}

package/dist/server/migrations/20260429000000-add-llm-fields.d.ts

@@ -0,0 +1,7 @@
+import { Migration } from '@nocobase/server';
+export default class AddLlmFieldsToOrchestratorConfig extends Migration {
+    on: string;
+    appVersion: string;
+    up(): Promise<void>;
+    down(): Promise<void>;
+}

package/dist/server/migrations/20260429000000-fix-inputargs-json-to-text.d.ts

@@ -0,0 +1,16 @@
+import { Migration } from '@nocobase/server';
+/**
+ * Fix: inputArgs column in skillExecutions was json type but should be text.
+ *
+ * Root cause: The column was created as `json` from an older schema version,
+ * but the collection defines it as `text`. The `stringifyJsonText()` utility
+ * wraps values in markdown code fences (```json\n...\n```) which PostgreSQL
+ * rejects as invalid JSON syntax, causing SequelizeDatabaseError on every
+ * skill execution attempt.
+ */
+export default class FixInputArgsJsonToText extends Migration {
+    on: string;
+    appVersion: string;
+    up(): Promise<void>;
+    down(): Promise<void>;
+}

package/dist/server/migrations/20260503000000-add-orchestrator-trace-fields.d.ts

@@ -0,0 +1,7 @@
+import { Migration } from '@nocobase/server';
+export default class AddOrchestratorTraceFieldsToSkillExecutions extends Migration {
+    on: string;
+    appVersion: string;
+    up(): Promise<void>;
+    down(): Promise<void>;
+}

package/dist/server/migrations/20260524000000-add-agent-loop-fields-to-skill-executions.d.ts

@@ -0,0 +1,7 @@
+import { Migration } from '@nocobase/server';
+export default class AddAgentLoopFieldsToSkillExecutions extends Migration {
+    on: string;
+    appVersion: string;
+    up(): Promise<void>;
+    down(): Promise<void>;
+}

package/dist/server/migrations/20260524000000-add-agent-loop-fields-to-skill-executions.js

@@ -0,0 +1,55 @@
+/**
+ * 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 add_agent_loop_fields_to_skill_executions_exports = {};
+__export(add_agent_loop_fields_to_skill_executions_exports, {
+  default: () => AddAgentLoopFieldsToSkillExecutions
+});
+module.exports = __toCommonJS(add_agent_loop_fields_to_skill_executions_exports);
+var import_server = require("@nocobase/server");
+class AddAgentLoopFieldsToSkillExecutions extends import_server.Migration {
+  on = "afterLoad";
+  appVersion = ">=0.1.0";
+  async up() {
+    const queryInterface = this.db.sequelize.getQueryInterface();
+    const tablePrefix = this.db.options.tablePrefix || "";
+    const tableName = `${tablePrefix}skillExecutions`;
+    const tableExists = await queryInterface.tableExists(tableName).catch(() => false);
+    if (!tableExists) return;
+    const tableDesc = await queryInterface.describeTable(tableName);
+    const addIfMissing = async (name) => {
+      if (tableDesc[name]) return;
+      await queryInterface.addColumn(tableName, name, {
+        type: "VARCHAR(100)",
+        allowNull: true
+      });
+    };
+    await addIfMissing("agentLoopRunId");
+    await addIfMissing("agentLoopStepId");
+  }
+  async down() {
+  }
+}

package/dist/server/migrations/20260524001000-add-plan-approval-and-harness-profiles.d.ts

@@ -0,0 +1,12 @@
+import { Migration } from '@nocobase/server';
+export default class AddPlanApprovalAndHarnessProfiles extends Migration {
+    on: string;
+    appVersion: string;
+    up(): Promise<void>;
+    addRunColumns(queryInterface: any, tableName: string): Promise<void>;
+    addStepColumns(queryInterface: any, tableName: string): Promise<void>;
+    addConfigColumns(queryInterface: any, tableName: string): Promise<void>;
+    ensureHarnessProfiles(queryInterface: any, tableName: string): Promise<void>;
+    seedDefaultProfiles(): Promise<void>;
+    down(): Promise<void>;
+}

package/dist/server/migrations/20260524001000-add-plan-approval-and-harness-profiles.js

@@ -0,0 +1,162 @@
+/**
+ * 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 add_plan_approval_and_harness_profiles_exports = {};
+__export(add_plan_approval_and_harness_profiles_exports, {
+  default: () => AddPlanApprovalAndHarnessProfiles
+});
+module.exports = __toCommonJS(add_plan_approval_and_harness_profiles_exports);
+var import_database = require("@nocobase/database");
+var import_server = require("@nocobase/server");
+class AddPlanApprovalAndHarnessProfiles extends import_server.Migration {
+  on = "afterLoad";
+  appVersion = ">=0.1.0";
+  async up() {
+    const db = this.db;
+    const queryInterface = db.sequelize.getQueryInterface();
+    const tablePrefix = db.options.tablePrefix || "";
+    await this.addRunColumns(queryInterface, `${tablePrefix}agentLoopRuns`);
+    await this.addStepColumns(queryInterface, `${tablePrefix}agentLoopSteps`);
+    await this.addConfigColumns(queryInterface, `${tablePrefix}orchestratorConfig`);
+    await this.ensureHarnessProfiles(queryInterface, `${tablePrefix}agentHarnessProfiles`);
+    await this.seedDefaultProfiles();
+  }
+  async addRunColumns(queryInterface, tableName) {
+    const tableExists = await queryInterface.tableExists(tableName).catch(() => false);
+    if (!tableExists) return;
+    const tableDesc = await queryInterface.describeTable(tableName);
+    const addIfMissing = async (name, spec) => {
+      if (tableDesc[name]) return;
+      await queryInterface.addColumn(tableName, name, spec);
+    };
+    await addIfMissing("approvalStatus", { type: import_database.DataTypes.STRING(30), allowNull: true, defaultValue: "none" });
+    await addIfMissing("approvedById", { type: import_database.DataTypes.BIGINT, allowNull: true });
+    await addIfMissing("approvedAt", { type: import_database.DataTypes.DATE, allowNull: true });
+    await addIfMissing("rejectionReason", { type: import_database.DataTypes.TEXT, allowNull: true });
+    await addIfMissing("changeRequest", { type: import_database.DataTypes.TEXT, allowNull: true });
+    await addIfMissing("planVersion", { type: import_database.DataTypes.INTEGER, allowNull: true, defaultValue: 1 });
+    await addIfMissing("planSource", { type: import_database.DataTypes.STRING(50), allowNull: true });
+    await addIfMissing("plannerModel", { type: import_database.DataTypes.STRING(100), allowNull: true });
+    await addIfMissing("lockedBy", { type: import_database.DataTypes.STRING(100), allowNull: true });
+    await addIfMissing("lockedUntil", { type: import_database.DataTypes.DATE, allowNull: true });
+  }
+  async addStepColumns(queryInterface, tableName) {
+    const tableExists = await queryInterface.tableExists(tableName).catch(() => false);
+    if (!tableExists) return;
+    const tableDesc = await queryInterface.describeTable(tableName);
+    if (!tableDesc.dependencyPolicy) {
+      await queryInterface.addColumn(tableName, "dependencyPolicy", {
+        type: import_database.DataTypes.STRING(30),
+        allowNull: true,
+        defaultValue: "require_success"
+      });
+    }
+  }
+  async addConfigColumns(queryInterface, tableName) {
+    const tableExists = await queryInterface.tableExists(tableName).catch(() => false);
+    if (!tableExists) return;
+    const tableDesc = await queryInterface.describeTable(tableName);
+    if (!tableDesc.harnessTag) {
+      await queryInterface.addColumn(tableName, "harnessTag", {
+        type: import_database.DataTypes.STRING(100),
+        allowNull: true,
+        defaultValue: "default"
+      });
+    }
+  }
+  async ensureHarnessProfiles(queryInterface, tableName) {
+    const tableExists = await queryInterface.tableExists(tableName).catch(() => false);
+    if (tableExists) return;
+    await queryInterface.createTable(tableName, {
+      id: { type: import_database.DataTypes.BIGINT, primaryKey: true, autoIncrement: true },
+      tag: { type: import_database.DataTypes.STRING(100), allowNull: false, unique: true },
+      title: { type: import_database.DataTypes.STRING(200), allowNull: true },
+      description: { type: import_database.DataTypes.TEXT, allowNull: true },
+      enabled: { type: import_database.DataTypes.BOOLEAN, allowNull: true, defaultValue: true },
+      settings: { type: import_database.DataTypes.JSON, allowNull: true, defaultValue: {} },
+      createdAt: { type: import_database.DataTypes.DATE, allowNull: true },
+      updatedAt: { type: import_database.DataTypes.DATE, allowNull: true }
+    });
+  }
+  async seedDefaultProfiles() {
+    const repo = this.db.getRepository("agentHarnessProfiles");
+    if (!repo) return;
+    const profiles = [
+      {
+        tag: "default",
+        title: "Default",
+        description: "Balanced profile for normal multi-agent work.",
+        settings: {
+          requirePlanApproval: true,
+          allowSubAgents: true,
+          allowToolCalls: true,
+          maxParallelSubAgents: 3,
+          maxControllerSteps: 100
+        }
+      },
+      {
+        tag: "safe",
+        title: "Safe",
+        description: "Strict approval-first profile for higher-risk work.",
+        settings: {
+          requirePlanApproval: true,
+          allowSubAgents: true,
+          allowToolCalls: true,
+          maxParallelSubAgents: 1,
+          maxControllerSteps: 50,
+          requireVerification: true
+        }
+      },
+      {
+        tag: "file-heavy",
+        title: "File Heavy",
+        description: "Profile for tasks that inspect or transform many attachments/files.",
+        settings: {
+          requirePlanApproval: true,
+          allowSubAgents: true,
+          allowToolCalls: true,
+          maxParallelSubAgents: 2,
+          maxControllerSteps: 120,
+          preferFileTools: true
+        }
+      }
+    ];
+    for (const profile of profiles) {
+      const existing = await repo.findOne({ filter: { tag: profile.tag } });
+      if (existing) continue;
+      await repo.create({
+        values: {
+          ...profile,
+          enabled: true,
+          createdAt: /* @__PURE__ */ new Date(),
+          updatedAt: /* @__PURE__ */ new Date()
+        }
+      });
+    }
+  }
+  async down() {
+  }
+}

package/dist/server/plugin.d.ts

@@ -0,0 +1,16 @@
+import { Plugin } from '@nocobase/server';
+import SkillHubSubFeature from './skill-hub/plugin';
+import { AgentLoopService } from './services/AgentLoopService';
+export declare class PluginAgentOrchestratorServer extends Plugin {
+    skillHub: SkillHubSubFeature;
+    agentLoopService: AgentLoopService;
+    afterAdd(): Promise<void>;
+    beforeLoad(): Promise<void>;
+    load(): Promise<void>;
+    install(): Promise<void>;
+    afterEnable(): Promise<void>;
+    afterDisable(): Promise<void>;
+    remove(): Promise<void>;
+    beforeStop(): Promise<void>;
+}
+export default PluginAgentOrchestratorServer;