plugin-agent-orchestrator 1.0.28 → 1.0.32

package/src/server/collections/agent-loop-steps.ts

@@ -1,144 +1,144 @@
-import { defineCollection } from '@nocobase/database';
-
-export default 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'],
-    },
-  ],
-});
+import { defineCollection } from '@nocobase/database';
+
+export default 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/src/server/collections/agent-memory-contexts.ts

@@ -0,0 +1,95 @@
+import { defineCollection } from '@nocobase/database';
+
+export default defineCollection({
+  name: 'agentMemoryContexts',
+  title: 'Agent Memory Contexts',
+  fields: [
+    {
+      name: 'id',
+      type: 'bigInt',
+      autoIncrement: true,
+      primaryKey: true,
+    },
+    {
+      name: 'scope',
+      type: 'string',
+      length: 30,
+      allowNull: false,
+      comment: 'public, user, or agent_user',
+    },
+    {
+      name: 'contextKey',
+      type: 'string',
+      length: 300,
+      allowNull: false,
+      comment: 'Normalized unique key: scope:userId:aiEmployeeUsername.',
+    },
+    {
+      name: 'userId',
+      type: 'bigInt',
+      comment: 'Null for public agent knowledge; required for user/private scopes.',
+    },
+    {
+      name: 'user',
+      type: 'belongsTo',
+      target: 'users',
+      targetKey: 'id',
+      foreignKey: 'userId',
+    },
+    {
+      name: 'aiEmployeeUsername',
+      type: 'string',
+      length: 100,
+      comment: 'Target AI employee username; null/empty means shared within the scope.',
+    },
+    {
+      name: 'contentMd',
+      type: 'text',
+      comment: 'Markdown facts, preferences, or operating notes for the agent context.',
+    },
+    {
+      name: 'graphMd',
+      type: 'text',
+      comment: 'Markdown graph or relationship notes for the agent context.',
+    },
+    {
+      name: 'enabled',
+      type: 'boolean',
+      defaultValue: true,
+    },
+    {
+      name: 'metadata',
+      type: 'json',
+      defaultValue: {},
+    },
+    {
+      name: 'createdAt',
+      type: 'date',
+    },
+    {
+      name: 'updatedAt',
+      type: 'date',
+    },
+  ],
+  indexes: [
+    {
+      unique: true,
+      fields: ['contextKey'],
+    },
+    {
+      fields: ['scope', 'userId', 'aiEmployeeUsername'],
+    },
+    {
+      fields: ['scope'],
+    },
+    {
+      fields: ['userId'],
+    },
+    {
+      fields: ['aiEmployeeUsername'],
+    },
+    {
+      fields: ['enabled'],
+    },
+  ],
+});

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

@@ -3,8 +3,8 @@ import { defineCollection } from '@nocobase/database';
 /**
  * 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.
+ * Legacy delegation events were logged to a dedicated table for observability.
+ * Native plugin-ai runs are now observed through agentExecutionSpans.
  */
 export default defineCollection({
   name: 'orchestratorLogs',
@@ -31,7 +31,7 @@ export default defineCollection({
     {
       name: 'toolName',
       type: 'string',
-      comment: 'The tool name used for delegation (e.g., delegate_pm_to_sql_expert)',
+      comment: 'Legacy delegation or native dispatch tool name',
     },
     {
       name: 'context',
@@ -79,7 +79,7 @@ export default defineCollection({
       name: 'messages',
       type: 'json',
       defaultValue: [],
-      comment: 'Serialized LangChain messages from the sub-agent run',
+      comment: 'Serialized message snapshots from the sub-agent run',
     },
     {
       name: 'userId',

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

@@ -1,51 +1,51 @@
-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',
-    },
+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}> }
@@ -58,71 +58,71 @@ export default {
       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;
+    {
+      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;