plugin-agent-orchestrator 1.0.6 → 1.0.14

package/src/server/collections/orchestrator-logs.ts

@@ -31,7 +31,12 @@ export default defineCollection({
     {
       name: 'toolName',
       type: 'string',
-      comment: 'The tool name used for delegation (e.g., delegate_to_sql_expert)',
+      comment: 'The tool name used for delegation (e.g., delegate_pm_to_sql_expert)',
+    },
+    {
+      name: 'context',
+      type: 'text',
+      comment: 'Optional context sent with the delegated task',
     },
     {
       name: 'task',
@@ -46,7 +51,7 @@ export default defineCollection({
     {
       name: 'status',
       type: 'string',
-      comment: 'success or error',
+      comment: 'running, success, or error',
     },
     {
       name: 'depth',
@@ -64,6 +69,18 @@ export default defineCollection({
       type: 'text',
       comment: 'Error message if status is error',
     },
+    {
+      name: 'trace',
+      type: 'json',
+      defaultValue: [],
+      comment: 'Structured timeline of sub-agent execution and tool calls',
+    },
+    {
+      name: 'messages',
+      type: 'json',
+      defaultValue: [],
+      comment: 'Serialized LangChain messages from the sub-agent run',
+    },
     {
       name: 'userId',
       type: 'bigInt',

package/src/server/collections/skill-definitions.ts

@@ -0,0 +1,128 @@
+import { CollectionOptions } from '@nocobase/database';
+
+export default {
+  name: 'skillDefinitions',
+  title: 'Skill Definitions',
+  fields: [
+    {
+      name: 'id',
+      type: 'bigInt',
+      autoIncrement: true,
+      primaryKey: true,
+    },
+    {
+      name: 'name',
+      type: 'string',
+      length: 100,
+      unique: true,
+    },
+    {
+      name: 'title',
+      type: 'string',
+      length: 200,
+    },
+    {
+      name: 'description',
+      type: 'text',
+    },
+    {
+      name: 'instructions',
+      type: 'text',
+    },
+    {
+      // 'node' | 'python'
+      name: 'language',
+      type: 'string',
+      length: 20,
+    },
+    {
+      // Code template with {{placeholder}} support
+      name: 'codeTemplate',
+      type: 'text',
+    },
+    {
+      // JSON Schema for input parameters (used by AI tool)
+      name: 'inputSchema',
+      type: 'text',
+    },
+    {
+      // Optional UI schema for human-in-the-loop interaction.
+      // Shape: { type: 'form'|'select'|'confirm', prompt: string,
+      //          options?: {label,value}[], fields?: Record<string, {type,title,required,enum}> }
+      name: 'interactionSchema',
+      type: 'text',
+    },
+    {
+      // Pre-installed packages reference (informational)
+      name: 'packages',
+      type: 'text',
+      defaultValue: null,
+    },
+    {
+      name: 'timeoutSeconds',
+      type: 'integer',
+      defaultValue: 60,
+    },
+    {
+      name: 'maxOutputSizeMb',
+      type: 'integer',
+      defaultValue: 50,
+    },
+    {
+      name: 'enabled',
+      type: 'boolean',
+      defaultValue: true,
+    },
+    {
+      // 'CUSTOM' | 'GENERAL' | 'SPECIFIED'
+      name: 'toolScope',
+      type: 'string',
+      length: 20,
+      defaultValue: 'CUSTOM',
+    },
+    {
+      name: 'autoCall',
+      type: 'boolean',
+      defaultValue: false,
+    },
+    {
+      // Which plugin registered this skill. null = built-in / user-created.
+      // Format: plugin package name, e.g. 'plugin-skill-pptx-advanced'
+      name: 'pluginSource',
+      type: 'string',
+      length: 200,
+      defaultValue: null,
+    },
+    {
+      name: 'storageType',
+      type: 'string',
+      length: 20,
+      defaultValue: 'database', // 'database', 'local', 's3', 'plugin'
+    },
+    {
+      name: 'storageUrl',
+      type: 'string',
+      length: 1000,
+    },
+    {
+      name: 'file',
+      type: 'belongsTo',
+      target: 'attachments',
+      foreignKey: 'fileId',
+    },
+    {
+      name: 'createdAt',
+      type: 'date',
+    },
+    {
+      name: 'updatedAt',
+      type: 'date',
+    },
+    {
+      name: 'createdBy',
+      type: 'belongsTo',
+      target: 'users',
+      foreignKey: 'createdById',
+    },
+  ],
+} as CollectionOptions;

package/src/server/collections/skill-executions.ts

@@ -0,0 +1,94 @@
+import { CollectionOptions } from '@nocobase/database';
+
+export default {
+  name: 'skillExecutions',
+  title: 'Skill Executions',
+  fields: [
+    {
+      name: 'id',
+      type: 'bigInt',
+      autoIncrement: true,
+      primaryKey: true,
+    },
+    {
+      name: 'skill',
+      type: 'belongsTo',
+      target: 'skillDefinitions',
+      foreignKey: 'skillId',
+    },
+    {
+      // 'pending' | 'running' | 'succeeded' | 'failed' | 'canceled' | 'timeout'
+      name: 'status',
+      type: 'string',
+      length: 20,
+      defaultValue: 'pending',
+    },
+    {
+      name: 'inputArgs',
+      type: 'text',
+    },
+    {
+      // Final code after template rendering
+      name: 'executedCode',
+      type: 'text',
+    },
+    {
+      name: 'stdout',
+      type: 'text',
+    },
+    {
+      name: 'stderr',
+      type: 'text',
+    },
+    {
+      // [{ name, size, mimeType }]
+      name: 'outputFiles',
+      type: 'text',
+      defaultValue: null,
+    },
+    {
+      name: 'durationMs',
+      type: 'integer',
+    },
+    {
+      name: 'sessionId',
+      type: 'string',
+      length: 100,
+      allowNull: true,
+    },
+    {
+      name: 'orchestratorRootRunId',
+      type: 'string',
+      length: 100,
+      allowNull: true,
+    },
+    {
+      name: 'orchestratorSpanId',
+      type: 'string',
+      length: 100,
+      allowNull: true,
+    },
+    {
+      name: 'orchestratorParentSpanId',
+      type: 'string',
+      length: 100,
+      allowNull: true,
+    },
+    {
+      name: 'orchestratorToolCallId',
+      type: 'string',
+      length: 100,
+      allowNull: true,
+    },
+    {
+      name: 'triggeredBy',
+      type: 'belongsTo',
+      target: 'users',
+      foreignKey: 'triggeredById',
+    },
+    {
+      name: 'createdAt',
+      type: 'date',
+    },
+  ],
+} as CollectionOptions;

package/src/server/collections/skill-worker-configs.ts

@@ -0,0 +1,86 @@
+import { CollectionOptions } from '@nocobase/database';
+
+export default {
+  name: 'skillWorkerConfigs',
+  title: 'Skill Worker Configs',
+  fields: [
+    {
+      name: 'id',
+      type: 'bigInt',
+      autoIncrement: true,
+      primaryKey: true,
+    },
+    {
+      name: 'retentionHours',
+      type: 'integer',
+      defaultValue: 24,
+    },
+    {
+      name: 'packageWhitelist',
+      type: 'text',
+      defaultValue: null,
+    },
+    {
+      name: 'customPackages',
+      type: 'text',
+      defaultValue: null,
+    },
+    {
+      name: 'npmRegistryUrl',
+      type: 'string',
+      length: 500,
+    },
+    {
+      name: 'npmAuthToken',
+      type: 'string',
+      length: 1000,
+    },
+    {
+      name: 'pypiIndexUrl',
+      type: 'string',
+      length: 500,
+    },
+    {
+      name: 'pypiTrustedHost',
+      type: 'string',
+      length: 255,
+    },
+    {
+      name: 'aptMirrorUrl',
+      type: 'string',
+      length: 500,
+    },
+    {
+      name: 'aptGpgKeyUrl',
+      type: 'string',
+      length: 500,
+    },
+    {
+      name: 'initStatus',
+      type: 'string',
+      length: 20,
+      defaultValue: 'idle',
+    },
+    {
+      name: 'lastInitLog',
+      type: 'text',
+    },
+    {
+      name: 'initProgressPercent',
+      type: 'integer',
+      defaultValue: 0,
+    },
+    {
+      name: 'initProgressLog',
+      type: 'text',
+    },
+    {
+      name: 'createdAt',
+      type: 'date',
+    },
+    {
+      name: 'updatedAt',
+      type: 'date',
+    },
+  ],
+} as CollectionOptions;

package/src/server/migrations/20260423000000-add-progress-fields.ts

@@ -0,0 +1,50 @@
+import { Migration } from '@nocobase/server';
+
+export default class AddProgressFieldsMigration extends Migration {
+  async up() {
+    const queryInterface = this.db.sequelize.getQueryInterface();
+    const tablePrefix = this.db.options.tablePrefix || '';
+    const tableName = `${tablePrefix}skillWorkerConfigs`;
+
+    try {
+      const tableExists = await queryInterface.tableExists(tableName);
+      if (!tableExists) return;
+
+      const tableDesc = await queryInterface.describeTable(tableName);
+
+      // Force NocoBase fields metadata to recognize the physical columns exists
+      // so it won't crash trying to ADD COLUMN during db.sync()
+      const fieldRepo = this.db.getRepository('fields');
+      const collectionName = 'skillWorkerConfigs';
+
+      const fieldsToSync = [
+        { name: 'initProgressPercent', type: 'integer', defaultValue: 0 },
+        { name: 'initProgressLog', type: 'text' }
+      ];
+
+      for (const f of fieldsToSync) {
+        const fieldMeta = await fieldRepo.findOne({
+          filter: { name: f.name, collectionName },
+        });
+
+        if (!fieldMeta && tableDesc[f.name]) {
+           // The physical column exists, but NocoBase metadata is missing it!
+           // Let's create the metadata right now BEFORE NocoBase's collection.sync() 
+           // runs and crashes on addColumn.
+           await fieldRepo.create({
+              values: {
+                 name: f.name,
+                 type: f.type,
+                 collectionName,
+                 // Avoid trying to physically add it because it already exists
+                 interface: f.type,
+              }
+           });
+           this.app.logger.info(`[skill-hub] Restored NocoBase metadata for preexisting column ${f.name}`);
+        }
+      }
+    } catch (error) {
+      this.app.logger.error(`[skill-hub] Failed to check progress fields: ${error.message}`);
+    }
+  }
+}

package/src/server/migrations/20260425000000-add-interaction-schema.ts

@@ -0,0 +1,35 @@
+import { Migration } from '@nocobase/server';
+
+export default class AddInteractionSchemaMigration extends Migration {
+  async up() {
+    const queryInterface = this.db.sequelize.getQueryInterface();
+    const tableName = `${this.db.options.tablePrefix || ''}skillDefinitions`;
+
+    try {
+      const tableExists = await queryInterface.tableExists(tableName);
+      if (!tableExists) return;
+
+      const tableDesc = await queryInterface.describeTable(tableName);
+      const fieldRepo = this.db.getRepository('fields');
+      const collectionName = 'skillDefinitions';
+
+      const fieldMeta = await fieldRepo.findOne({
+        filter: { name: 'interactionSchema', collectionName },
+      });
+
+      if (!fieldMeta && tableDesc.interactionSchema) {
+        await fieldRepo.create({
+          values: {
+            name: 'interactionSchema',
+            type: 'text',
+            collectionName,
+            interface: 'textarea',
+          },
+        });
+        this.app.logger.info('[skill-hub] Restored NocoBase metadata for preexisting column interactionSchema');
+      }
+    } catch (error) {
+      this.app.logger.error(`[skill-hub] Failed to check interactionSchema field: ${error.message}`);
+    }
+  }
+}

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

@@ -0,0 +1,41 @@
+import { Migration } from '@nocobase/server';
+
+export default class AddTracingDetailFieldsMigration extends Migration {
+  on = 'afterLoad';
+  appVersion = '<=2.x';
+
+  async up() {
+    const queryInterface = this.db.sequelize.getQueryInterface();
+    const DataTypes = this.db.sequelize.constructor['DataTypes'];
+    const tableName = `${this.db.options.tablePrefix || ''}orchestratorLogs`;
+
+    const tableExists = await queryInterface
+      .describeTable(tableName)
+      .then(() => true)
+      .catch(() => false);
+
+    if (!tableExists) {
+      return;
+    }
+
+    const columns = await queryInterface.describeTable(tableName);
+    const addIfMissing = async (name: string, definition: any) => {
+      if (!columns[name]) {
+        await queryInterface.addColumn(tableName, name, definition);
+      }
+    };
+
+    await addIfMissing('context', { type: DataTypes.TEXT, allowNull: true });
+    await addIfMissing('trace', { type: DataTypes.JSON, allowNull: true, defaultValue: [] });
+    await addIfMissing('messages', { type: DataTypes.JSON, allowNull: true, defaultValue: [] });
+  }
+
+  async down() {
+    const queryInterface = this.db.sequelize.getQueryInterface();
+    const tableName = `${this.db.options.tablePrefix || ''}orchestratorLogs`;
+
+    for (const column of ['context', 'trace', 'messages']) {
+      await queryInterface.removeColumn(tableName, column).catch(() => {});
+    }
+  }
+}

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

@@ -0,0 +1,47 @@
+import { Migration } from '@nocobase/server';
+
+export default class ChangePackagesToTextMigration extends Migration {
+  async up() {
+    const queryInterface = this.db.sequelize.getQueryInterface();
+    const tableName = `${this.db.options.tablePrefix || ''}skillDefinitions`;
+
+    try {
+      const tableExists = await queryInterface.tableExists(tableName);
+      if (!tableExists) return;
+
+      const tableDesc = await queryInterface.describeTable(tableName);
+      const columnsToChange = ['packages', 'inputSchema', 'interactionSchema'];
+      const fieldRepo = this.db.getRepository('fields');
+      const collectionName = 'skillDefinitions';
+
+      for (const col of columnsToChange) {
+        if (tableDesc[col]) {
+          // Change physical column type in Postgres if needed
+          const dialect = this.db.sequelize.getDialect();
+          if (dialect === 'postgres') {
+            await this.db.sequelize.query(`ALTER TABLE "${tableName}" ALTER COLUMN "${col}" TYPE text USING "${col}"::text;`);
+          } else {
+            await queryInterface.changeColumn(tableName, col, {
+              type: 'TEXT',
+            });
+          }
+          
+          // Also update NocoBase metadata
+          const fieldMeta = await fieldRepo.findOne({
+            filter: { name: col, collectionName },
+          });
+
+          if (fieldMeta) {
+            await fieldRepo.update({
+              filterByTk: fieldMeta.get('id'),
+              values: { type: 'text' },
+            });
+          }
+          this.app.logger.info(`[skill-hub] Changed ${col} column type to text to support markdown`);
+        }
+      }
+    } catch (error) {
+      this.app.logger.error(`[skill-hub] Failed to change packages field type: ${error.message}`);
+    }
+  }
+}

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

@@ -0,0 +1,57 @@
+import { Migration } from '@nocobase/server';
+
+export default class ChangeOtherJsonToTextMigration extends Migration {
+  async up() {
+    const queryInterface = this.db.sequelize.getQueryInterface();
+    const dialect = this.db.sequelize.getDialect();
+    const fieldRepo = this.db.getRepository('fields');
+
+    const tablePrefix = this.db.options.tablePrefix || '';
+    
+    // 1. skillWorkerConfigs
+    const workerTableName = `${tablePrefix}skillWorkerConfigs`;
+    try {
+      if (await queryInterface.tableExists(workerTableName)) {
+        const tableDesc = await queryInterface.describeTable(workerTableName);
+        const columns = ['packageWhitelist', 'customPackages'];
+        
+        for (const col of columns) {
+          if (tableDesc[col]) {
+            if (dialect === 'postgres') {
+              await this.db.sequelize.query(`ALTER TABLE "${workerTableName}" ALTER COLUMN "${col}" TYPE text USING "${col}"::text;`);
+            } else {
+              await queryInterface.changeColumn(workerTableName, col, { type: 'TEXT' });
+            }
+            const fieldMeta = await fieldRepo.findOne({ filter: { name: col, collectionName: 'skillWorkerConfigs' } });
+            if (fieldMeta) await fieldRepo.update({ filterByTk: fieldMeta.get('id'), values: { type: 'text' } });
+            this.app.logger.info(`[skill-hub] Changed ${col} in skillWorkerConfigs to text`);
+          }
+        }
+      }
+    } catch (e) {
+      this.app.logger.warn(`[skill-hub] Failed to migrate skillWorkerConfigs: ${e.message}`);
+    }
+
+    // 2. skillExecutions
+    const execTableName = `${tablePrefix}skillExecutions`;
+    try {
+      if (await queryInterface.tableExists(execTableName)) {
+        const tableDesc = await queryInterface.describeTable(execTableName);
+        const col = 'outputFiles';
+        
+        if (tableDesc[col]) {
+          if (dialect === 'postgres') {
+            await this.db.sequelize.query(`ALTER TABLE "${execTableName}" ALTER COLUMN "${col}" TYPE text USING "${col}"::text;`);
+          } else {
+            await queryInterface.changeColumn(execTableName, col, { type: 'TEXT' });
+          }
+          const fieldMeta = await fieldRepo.findOne({ filter: { name: col, collectionName: 'skillExecutions' } });
+          if (fieldMeta) await fieldRepo.update({ filterByTk: fieldMeta.get('id'), values: { type: 'text' } });
+          this.app.logger.info(`[skill-hub] Changed ${col} in skillExecutions to text`);
+        }
+      }
+    } catch (e) {
+      this.app.logger.warn(`[skill-hub] Failed to migrate skillExecutions: ${e.message}`);
+    }
+  }
+}

package/src/server/migrations/20260429000000-add-llm-fields.ts

@@ -0,0 +1,46 @@
+import { Migration } from '@nocobase/server';
+
+export default class AddLlmFieldsToOrchestratorConfig extends Migration {
+  on = 'afterLoad';
+  appVersion = '>=0.1.0';
+
+  async up() {
+    const queryInterface = this.db.sequelize.getQueryInterface();
+    const tablePrefix = this.db.options.tablePrefix || '';
+    const tableName = `${tablePrefix}orchestratorConfig`;
+
+    const tableExists = await queryInterface.tableExists(tableName);
+    if (!tableExists) return;
+
+    const tableDesc = await queryInterface.describeTable(tableName);
+
+    if (!tableDesc['llmService']) {
+      await queryInterface.addColumn(tableName, 'llmService', {
+        type: 'VARCHAR(255)',
+        allowNull: true,
+      });
+      console.log(`[AgentOrchestrator] Added llmService column to ${tableName}`);
+    }
+
+    if (!tableDesc['model']) {
+      await queryInterface.addColumn(tableName, 'model', {
+        type: 'VARCHAR(255)',
+        allowNull: true,
+      });
+      console.log(`[AgentOrchestrator] Added model column to ${tableName}`);
+    }
+
+    if (!tableDesc['recursionLimit']) {
+      await queryInterface.addColumn(tableName, 'recursionLimit', {
+        type: 'INTEGER',
+        allowNull: true,
+        defaultValue: 50,
+      });
+      console.log(`[AgentOrchestrator] Added recursionLimit column to ${tableName}`);
+    }
+  }
+
+  async down() {
+    // No rollback
+  }
+}

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

@@ -0,0 +1,38 @@
+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 = 'afterLoad';
+  appVersion = '>=0.1.0';
+
+  async up() {
+    const queryInterface = this.db.sequelize.getQueryInterface();
+
+    // Check current column type
+    const tableDesc = await queryInterface.describeTable('skillExecutions').catch(() => null);
+    if (!tableDesc) return;
+
+    const col = tableDesc['inputArgs'];
+    if (!col) return;
+
+    // Only migrate if still json type
+    if (col.type && col.type.toLowerCase().includes('json')) {
+      await this.db.sequelize.query(
+        `ALTER TABLE "skillExecutions" ALTER COLUMN "inputArgs" TYPE text USING "inputArgs"::text`,
+      );
+      console.log('[skill-hub] Migration: converted skillExecutions.inputArgs from json to text');
+    }
+  }
+
+  async down() {
+    // No rollback — keeping as text is safe; json is more restrictive
+  }
+}