plugin-agent-orchestrator 1.0.16 → 1.0.17

package/dist/externalVersion.js

@@ -9,14 +9,14 @@
 
 module.exports = {
   "react": "18.2.0",
-  "@nocobase/client": "2.0.49",
+  "@nocobase/client": "2.0.55",
   "antd": "5.24.2",
   "@ant-design/icons": "5.6.1",
-  "@nocobase/server": "2.0.49",
-  "@nocobase/database": "2.0.49",
-  "@nocobase/actions": "2.0.49",
+  "@nocobase/server": "2.0.55",
+  "@nocobase/database": "2.0.55",
+  "@nocobase/actions": "2.0.55",
   "@langchain/langgraph": "0.2.74",
   "@langchain/core": "0.3.80",
-  "@nocobase/plugin-ai": "2.0.49",
-  "@nocobase/ai": "2.0.49"
+  "@nocobase/plugin-ai": "2.0.55",
+  "@nocobase/ai": "2.0.55"
 };

package/dist/server/tools/delegate-task.js

@@ -37,6 +37,7 @@ var import_tools = require("@langchain/core/tools");
 var import_messages = require("@langchain/core/messages");
 var import_ExecutionSpanService = require("../services/ExecutionSpanService");
 const ORCHESTRATOR_DEPTH_KEY = "__orchestratorDepth";
+const ORCHESTRATOR_PATH_KEY = "__orchestratorPath";
 const MAX_DISPATCH_CONCURRENCY = 5;
 const MAX_DISPATCH_TASKS = 20;
 const MAX_TOOL_NAME_LENGTH = 64;
@@ -573,6 +574,27 @@ async function invokeDelegateTask(ctx, plugin, options) {
   } = options;
   const ctxSnapshot = captureCtxSnapshot(ctx);
   const currentDepth = ctx[ORCHESTRATOR_DEPTH_KEY] ?? 0;
+  const currentPath = ctx[ORCHESTRATOR_PATH_KEY] ?? [leaderUsername];
+  if (currentPath.includes(subAgentUsername)) {
+    const loopChain = [...currentPath, subAgentUsername].join(" -> ");
+    await logDelegation(ctx, plugin, {
+      leaderUsername,
+      subAgentUsername,
+      toolName,
+      task,
+      context,
+      result: "",
+      status: "error",
+      depth: currentDepth,
+      durationMs: 0,
+      error: `Circular delegation detected: ${loopChain}.`,
+      snapshot: ctxSnapshot
+    });
+    return {
+      status: "error",
+      content: `Circular delegation detected: ${loopChain}. Execution aborted to prevent infinite reasoning loops.`
+    };
+  }
   if (currentDepth >= maxDepth) {
     await logDelegation(ctx, plugin, {
       leaderUsername,
@@ -677,7 +699,7 @@ async function invokeDelegateTask(ctx, plugin, options) {
       const entryName = toolEntry.definition.name;
       if (!entryName) continue;
       const employeeSkill = employeeSkillMap.get(entryName);
-      if (!employeeSkill || isDelegateToolName(plugin, entryName) || employeeSkill.autoCall !== true || toolEntry.defaultPermission !== "ALLOW") {
+      if (!employeeSkill || isDelegateToolName(plugin, entryName) || employeeSkill.autoCall !== true) {
         continue;
       }
       langchainTools.push(
@@ -689,6 +711,12 @@ async function invokeDelegateTask(ctx, plugin, options) {
             var _a2;
             const invokeCtx = Object.create(ctx);
             invokeCtx[ORCHESTRATOR_DEPTH_KEY] = currentDepth + 1;
+            invokeCtx[ORCHESTRATOR_PATH_KEY] = [...currentPath, subAgentUsername];
+            invokeCtx._currentAIEmployee = subAgentUsername;
+            if (ctx.state) {
+              invokeCtx.state = Object.create(ctx.state);
+              invokeCtx.state.currentAIEmployee = subAgentUsername;
+            }
             const toolStartedAt = Date.now();
             const isSkillHubTool = entryName === "skill_hub_execute" || entryName.startsWith("skill_hub_");
             const toolSpan = await spanService.create({
@@ -887,9 +915,17 @@ ${context}` : `Task: ${task}`;
         traceCount: trace.length + 1
       }
     });
+    const diagnosticTrace = trace.filter((t) => t.type === "tool_error" || t.type === "error").map((t) => `[${t.toolName ? `Tool: ${t.toolName}` : "Sub-agent"}] Error: ${t.content || t.title}`).join("\n");
+    const formattedError = [
+      `Sub-agent "${subAgentUsername}" failed execution: ${e.message}`,
+      diagnosticTrace ? `
+Diagnostic Details of internal failures:
+${diagnosticTrace}` : "",
+      `Suggestion: Review the tool parameters above or try dividing the task into simpler independent tasks.`
+    ].filter(Boolean).join("\n");
     return {
       status: "error",
-      content: `Sub-agent "${subAgentUsername}" failed: ${e.message}`
+      content: formattedError
     };
   }
 }

package/package.json

@@ -4,7 +4,7 @@
   "displayName.zh-CN": "代理协调器",
   "displayName.vi-VN": "Điều phối Agent",
   "description": "Hierarchical Multi-Agent orchestration for NocoBase AI Employees. Enables Leader agents to delegate tasks to Sub-Agent employees without modifying core plugin-ai.",
-  "version": "1.0.16",
+  "version": "1.0.17",
   "license": "Apache-2.0",
   "main": "dist/server/index.js",
   "keywords": [
@@ -42,4 +42,4 @@
     "@nocobase/ai": "2.x",
     "@nocobase/plugin-ai": "2.x"
   }
-}
+}

package/src/server/tools/delegate-task.ts

@@ -18,6 +18,12 @@ import {
  * Used to prevent circular/recursive delegation chains.
  */
 const ORCHESTRATOR_DEPTH_KEY = '__orchestratorDepth';
+/**
+ * Context key for tracking the full delegation path.
+ * Used to detect and prevent circular delegation chains.
+ */
+const ORCHESTRATOR_PATH_KEY = '__orchestratorPath';
+
 
 /** Max sub-agents that the dispatch tool runs concurrently in one call. */
 const MAX_DISPATCH_CONCURRENCY = 5;
@@ -794,8 +800,31 @@ async function invokeDelegateTask(
   // Capturing the values once here keeps log/audit fields stable.
   const ctxSnapshot = captureCtxSnapshot(ctx);
 
-  // --- P1: Depth enforcement ---
+  // --- P1: Depth enforcement & Circular Delegation Detection ---
   const currentDepth: number = (ctx as any)[ORCHESTRATOR_DEPTH_KEY] ?? 0;
+  const currentPath: string[] = (ctx as any)[ORCHESTRATOR_PATH_KEY] ?? [leaderUsername];
+
+  if (currentPath.includes(subAgentUsername)) {
+    const loopChain = [...currentPath, subAgentUsername].join(' -> ');
+    await logDelegation(ctx, plugin, {
+      leaderUsername,
+      subAgentUsername,
+      toolName,
+      task,
+      context,
+      result: '',
+      status: 'error',
+      depth: currentDepth,
+      durationMs: 0,
+      error: `Circular delegation detected: ${loopChain}.`,
+      snapshot: ctxSnapshot,
+    });
+    return {
+      status: 'error' as const,
+      content: `Circular delegation detected: ${loopChain}. Execution aborted to prevent infinite reasoning loops.`,
+    };
+  }
+
   if (currentDepth >= maxDepth) {
     await logDelegation(ctx, plugin, {
       leaderUsername,
@@ -943,8 +972,7 @@ async function invokeDelegateTask(
       if (
         !employeeSkill ||
         isDelegateToolName(plugin, entryName) ||
-        employeeSkill.autoCall !== true ||
-        toolEntry.defaultPermission !== 'ALLOW'
+        employeeSkill.autoCall !== true
       ) {
         continue;
       }
@@ -955,9 +983,15 @@ async function invokeDelegateTask(
           description: toolEntry.definition.description || entryName,
           schema: (toolEntry.definition.schema || z.object({})) as any,
           func: async (toolArgs) => {
-            // Forward the invoke with depth tracking
+            // Forward the invoke with depth tracking, circular path tracking and identity overrides
             const invokeCtx = Object.create(ctx);
             (invokeCtx as any)[ORCHESTRATOR_DEPTH_KEY] = currentDepth + 1;
+            (invokeCtx as any)[ORCHESTRATOR_PATH_KEY] = [...currentPath, subAgentUsername];
+            (invokeCtx as any)._currentAIEmployee = subAgentUsername;
+            if (ctx.state) {
+              invokeCtx.state = Object.create(ctx.state);
+              invokeCtx.state.currentAIEmployee = subAgentUsername;
+            }
             const toolStartedAt = Date.now();
             const isSkillHubTool = entryName === 'skill_hub_execute' || entryName.startsWith('skill_hub_');
             const toolSpan = await spanService.create({
@@ -1183,9 +1217,22 @@ async function invokeDelegateTask(
       },
     });
 
+    const diagnosticTrace = trace
+      .filter((t) => t.type === 'tool_error' || t.type === 'error')
+      .map((t) => `[${t.toolName ? `Tool: ${t.toolName}` : 'Sub-agent'}] Error: ${t.content || t.title}`)
+      .join('\n');
+
+    const formattedError = [
+      `Sub-agent "${subAgentUsername}" failed execution: ${e.message}`,
+      diagnosticTrace ? `\nDiagnostic Details of internal failures:\n${diagnosticTrace}` : '',
+      `Suggestion: Review the tool parameters above or try dividing the task into simpler independent tasks.`,
+    ]
+      .filter(Boolean)
+      .join('\n');
+
     return {
       status: 'error' as const,
-      content: `Sub-agent "${subAgentUsername}" failed: ${e.message}`,
+      content: formattedError,
     };
   }
 }

package/dist/client/AIEmployeeSelect.d.ts

@@ -1,11 +0,0 @@
-import React from 'react';
-/**
- * Reusable Select component for AI Employees.
- * P3 FIX: Uses shared AIEmployeesContext instead of making its own API call.
- */
-export declare const AIEmployeeSelect: React.FC<{
-    value?: string;
-    onChange?: (value: string) => void;
-    exclude?: string;
-    placeholder?: string;
-}>;

package/dist/client/AIEmployeesContext.d.ts

@@ -1,30 +0,0 @@
-import React from 'react';
-interface AIEmployeeInfo {
-    username: string;
-    nickname: string;
-    about?: string;
-    skills: string[];
-}
-interface AIEmployeesContextType {
-    employees: AIEmployeeInfo[];
-    employeeMap: Map<string, string>;
-    skillsMap: Map<string, Set<string>>;
-    loading: boolean;
-    refresh: () => void;
-}
-/**
- * P3 FIX: Shared context provider that fetches aiEmployees once
- * and shares the data across RulesTab, TracingTab, and AIEmployeeSelect.
- *
- * Also exposes each employee's configured skills so RulesTab can warn when
- * a delegation rule exists but the leader hasn't added the corresponding
- * delegate_<leader>_to_<sub> tool to its skillSettings.
- */
-export declare const AIEmployeesProvider: React.FC<{
-    children: React.ReactNode;
-}>;
-/**
- * Hook to access shared AI employees data.
- */
-export declare const useAIEmployees: () => AIEmployeesContextType;
-export {};

package/dist/client/OrchestratorSettings.d.ts

@@ -1,3 +0,0 @@
-import React from 'react';
-declare const OrchestratorSettings: React.FC;
-export { OrchestratorSettings };

package/dist/client/RulesTab.d.ts

@@ -1,2 +0,0 @@
-import React from 'react';
-export declare const RulesTab: React.FC;

package/dist/client/TracingTab.d.ts

@@ -1,2 +0,0 @@
-import React from 'react';
-export declare const TracingTab: React.FC;

package/dist/client/index.d.ts

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

package/dist/client/plugin.d.ts

@@ -1,6 +0,0 @@
-import { Plugin } from '@nocobase/client';
-export declare class PluginAgentOrchestratorClient extends Plugin {
-    load(): Promise<void>;
-    private registerSkillUiCards;
-}
-export default PluginAgentOrchestratorClient;

package/dist/client/skill-hub/components/ExecutionHistory.d.ts

@@ -1,2 +0,0 @@
-import React from 'react';
-export declare const ExecutionHistory: React.FC;

package/dist/client/skill-hub/components/ExecutionProgress.d.ts

@@ -1,20 +0,0 @@
-import React from 'react';
-interface ExecutionProgressProps {
-    execId: string;
-    skillName: string;
-    percent: number;
-    log: string;
-}
-/**
- * Progress component rendered inside chat UI when receiving
- * SSE custom event: {action: "skillProgress", body: {...}}
- *
- * Usage in chat message renderer:
- * ```
- * if (event.action === 'skillProgress') {
- *   return <ExecutionProgress {...event.body} />;
- * }
- * ```
- */
-export declare const ExecutionProgress: React.FC<ExecutionProgressProps>;
-export {};

package/dist/client/skill-hub/components/GitSkillImport.d.ts

@@ -1,7 +0,0 @@
-import React from 'react';
-interface GitSkillImportProps {
-    open: boolean;
-    onClose: (synced?: boolean) => void;
-}
-export declare const GitSkillImport: React.FC<GitSkillImportProps>;
-export {};

package/dist/client/skill-hub/components/SkillEditor.d.ts

@@ -1,7 +0,0 @@
-import React from 'react';
-interface SkillEditorProps {
-    skill: any | null;
-    onClose: (saved?: boolean) => void;
-}
-export declare const SkillEditor: React.FC<SkillEditorProps>;
-export {};

package/dist/client/skill-hub/components/SkillManager.d.ts

@@ -1,2 +0,0 @@
-import React from 'react';
-export declare const SkillManager: React.FC;

package/dist/client/skill-hub/components/SkillMetrics.d.ts

@@ -1,2 +0,0 @@
-import React from 'react';
-export declare const SkillMetrics: React.FC;

package/dist/client/skill-hub/components/SkillTestPanel.d.ts

@@ -1,7 +0,0 @@
-import React from 'react';
-interface SkillTestPanelProps {
-    skill: any;
-    onClose: () => void;
-}
-export declare const SkillTestPanel: React.FC<SkillTestPanelProps>;
-export {};

package/dist/client/skill-hub/index.d.ts

@@ -1,10 +0,0 @@
-import { Plugin } from '@nocobase/client';
-import { SkillManager } from './components/SkillManager';
-import { ExecutionHistory } from './components/ExecutionHistory';
-import { SkillMetrics } from './components/SkillMetrics';
-export declare class PluginSkillHubClient extends Plugin {
-    load(): Promise<void>;
-    private registerSkillUiCards;
-}
-export { SkillManager, ExecutionHistory, SkillMetrics };
-export default PluginSkillHubClient;

package/dist/client/skill-hub/locale.d.ts

@@ -1,3 +0,0 @@
-export declare const namespace = "plugin-agent-orchestrator";
-export declare function useT(): (str: string, options?: any) => string;
-export declare function tStr(key: string): string;

package/dist/client/skill-hub/tools/InteractionSchemasProvider.d.ts

@@ -1,19 +0,0 @@
-import React from 'react';
-export type InteractionSchema = {
-    type: 'form' | 'select' | 'confirm';
-    prompt: string;
-    options?: {
-        label: string;
-        value: string | number;
-    }[];
-    fields?: Record<string, {
-        type?: string;
-        title?: string;
-        required?: boolean;
-        enum?: any[];
-    }>;
-};
-export declare const useInteractionSchemas: () => Map<string, InteractionSchema>;
-export declare const InteractionSchemasProvider: React.FC<{
-    children?: React.ReactNode;
-}>;

package/dist/client/skill-hub/tools/SkillHubCard.d.ts

@@ -1,3 +0,0 @@
-import React from 'react';
-import { ToolsUIProperties } from '@nocobase/client';
-export declare const SkillHubCard: React.FC<ToolsUIProperties>;

package/dist/client/skill-hub/utils/jsonFields.d.ts

@@ -1,3 +0,0 @@
-export declare function parseJsonText<T = any>(value: any, fallback: T): T;
-export declare function formatJsonText(value: any, fallback?: any): string;
-export declare function stringifyJsonText(value: any, fallback?: any): string;

package/dist/index.d.ts

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

package/dist/server/collections/agent-execution-spans.d.ts

@@ -1,9 +0,0 @@
-/**
- * Unified execution graph for agent orchestration.
- *
- * A root run can contain sub-agent spans and child tool/skill spans. Skill Hub
- * keeps its own sandbox execution records; this collection stores the flow
- * relationship and links to those records when applicable.
- */
-declare const _default: import("@nocobase/database").CollectionOptions;
-export default _default;

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

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

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

@@ -1,8 +0,0 @@
-/**
- * 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

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

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

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

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

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

package/dist/server/index.d.ts

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

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

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

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

@@ -1,4 +0,0 @@
-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

@@ -1,7 +0,0 @@
-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

@@ -1,4 +0,0 @@
-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

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

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

@@ -1,7 +0,0 @@
-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

@@ -1,16 +0,0 @@
-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

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

package/dist/server/plugin.d.ts

@@ -1,14 +0,0 @@
-import { Plugin } from '@nocobase/server';
-import SkillHubSubFeature from './skill-hub/plugin';
-export declare class PluginAgentOrchestratorServer extends Plugin {
-    skillHub: SkillHubSubFeature;
-    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;

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

@@ -1,7 +0,0 @@
-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/services/CodeValidator.d.ts

@@ -1,32 +0,0 @@
-export declare class CodeValidator {
-    /**
-     * Check code against forbidden patterns (dangerous modules/functions).
-     * @throws CodeValidationError if a forbidden pattern is found.
-     */
-    validate(code: string, language: 'node' | 'python'): void;
-    /**
-     * Validate that code only imports packages in the whitelist.
-     * Called after the basic forbidden pattern check.
-     * Skips validation if whitelist is empty (env not initialized yet).
-     *
-     * @param code - The code to validate
-     * @param language - 'node' or 'python'
-     * @param whitelist - Array of allowed package names (from skillWorkerConfigs.packageWhitelist)
-     */
-    validateImports(code: string, language: 'node' | 'python', whitelist: string[]): void;
-    /**
-     * Check Node.js require() calls against the whitelist.
-     * Built-in modules (fs, path, etc.) are always allowed.
-     */
-    private validateNodeImports;
-    /**
-     * Check Python import/from statements against the whitelist.
-     * Built-in modules (os, sys, json, etc.) are always allowed.
-     * Handles PyPI→import name mapping (e.g., python-docx → docx, Pillow → PIL).
-     */
-    private validatePythonImports;
-}
-export declare class CodeValidationError extends Error {
-    matchedPattern: string;
-    constructor(message: string, matchedPattern: string);
-}

package/dist/server/services/ExecutionSpanService.d.ts

@@ -1,44 +0,0 @@
-export declare const ORCHESTRATOR_TRACE_CONTEXT_KEY = "__orchestratorTraceContext";
-export type OrchestratorTraceContext = {
-    rootRunId: string;
-    spanId?: string;
-    parentSpanId?: string;
-    toolCallId?: string;
-    leaderUsername?: string;
-    employeeUsername?: string;
-    toolName?: string;
-};
-type SpanValues = {
-    rootRunId: string;
-    parentSpanId?: string;
-    type: string;
-    status: string;
-    leaderUsername?: string;
-    employeeUsername?: string;
-    toolName?: string;
-    title?: string;
-    input?: any;
-    output?: string;
-    error?: string;
-    durationMs?: number;
-    startedAt?: Date;
-    endedAt?: Date;
-    orchestratorLogId?: string | number;
-    skillExecutionId?: string | number;
-    metadata?: any;
-    userId?: string | number;
-};
-export declare class ExecutionSpanService {
-    private readonly plugin;
-    constructor(plugin: any);
-    create(values: SpanValues): Promise<any>;
-    update(spanId: string | number | undefined, values: Record<string, any>): Promise<{
-        id: string | number;
-    }>;
-    finish(spanId: string | number | undefined, status: 'success' | 'error' | 'canceled' | 'timeout', startedAt: number, values?: Record<string, any>): Promise<{
-        id: string | number;
-    }>;
-}
-export declare function getOrchestratorTraceContext(ctx: any): OrchestratorTraceContext | null;
-export declare function setOrchestratorTraceContext(ctx: any, traceContext: OrchestratorTraceContext): any;
-export {};

package/dist/server/services/FileManager.d.ts

@@ -1,28 +0,0 @@
-export interface OutputFileInfo {
-    name: string;
-    size: number;
-    mimeType: string;
-}
-export declare class FileManager {
-    private storagePath;
-    private executionsDir;
-    constructor(storagePath: string);
-    createExecDir(execId: string): string;
-    getExecDir(execId: string): string;
-    getOutputDir(execId: string): string;
-    /**
-     * Returns absolute path to an output file, or null if invalid/not found.
-     * Includes path traversal protection.
-     */
-    getOutputFilePath(execId: string, filename: string): string | null;
-    listOutputFiles(execId: string): OutputFileInfo[];
-    getTotalOutputSize(execId: string): number;
-    /**
-     * Remove a specific execution directory by execId.
-     */
-    removeExecDir(execId: string): void;
-    /**
-     * Remove execution directories older than maxAgeMs.
-     */
-    cleanupOlderThan(maxAgeMs: number): number;
-}

package/dist/server/services/SandboxRunner.d.ts

@@ -1,41 +0,0 @@
-import { FileManager, OutputFileInfo } from './FileManager';
-export interface ExecuteOptions {
-    language: 'node' | 'python';
-    code: string;
-    execId: string;
-    timeoutSeconds?: number;
-    maxOutputSizeMb?: number;
-    onProgress?: (progress: ProgressUpdate) => void;
-    /** AbortSignal — when aborted, the child process is killed */
-    signal?: {
-        addEventListener(event: string, listener: () => void): void;
-    };
-    /** Package whitelist for import validation (from skillWorkerConfigs) */
-    packageWhitelist?: string[];
-    /** Optional installed/copied skill package root exposed to the runtime as SKILL_DIR. */
-    skillDir?: string;
-}
-export interface ProgressUpdate {
-    percent: number;
-    log: string;
-}
-export interface ExecutionResult {
-    success: boolean;
-    stdout: string;
-    stderr: string;
-    files: OutputFileInfo[];
-    durationMs: number;
-    /** true if execution was canceled by user */
-    canceled?: boolean;
-    /** true if execution timed out */
-    timedOut?: boolean;
-}
-export declare class SandboxRunner {
-    private fileManager;
-    private logger;
-    private storagePath;
-    private validator;
-    private sandboxWorkspace;
-    constructor(fileManager: FileManager, logger: any, storagePath: string);
-    execute(options: ExecuteOptions): Promise<ExecutionResult>;
-}

package/dist/server/services/SkillManager.d.ts

@@ -1,6 +0,0 @@
-import { Database } from '@nocobase/database';
-export declare class SkillManager {
-    private db;
-    constructor(db: Database);
-    seedDefaults(): Promise<void>;
-}

package/dist/server/services/SkillRepositoryService.d.ts

@@ -1,22 +0,0 @@
-export interface SkillPackageMetadata {
-    path: string;
-    metadata: Record<string, any>;
-    instructions: string;
-    code: string | null;
-}
-export declare class SkillRepositoryService {
-    private baseDir;
-    constructor(storagePath: string);
-    /**
-     * Extract a zip file to the repository.
-     * Returns parsed metadata from SKILL.md / skill.yaml
-     */
-    extractSkillPackage(skillName: string, zipFilePath: string): Promise<SkillPackageMetadata>;
-    getSkillPath(skillName: string): string;
-    getSkillCode(skillName: string): string | null;
-    copySkillPackageTo(skillName: string, destDir: string): void;
-    readSkillPackage(packageDir: string): SkillPackageMetadata;
-    copyDirectoryTo(srcDir: string, destDir: string): void;
-    private getSkillCodeFromDir;
-    private aggregateOtherMarkdownFiles;
-}

package/dist/server/services/WorkerEnvManager.d.ts

@@ -1,26 +0,0 @@
-import Application from '@nocobase/server';
-import { Database } from '@nocobase/database';
-type WorkerEnvConfig = {
-    npmRegistryUrl?: string;
-    npmAuthToken?: string;
-    pypiIndexUrl?: string;
-    pypiTrustedHost?: string;
-    aptMirrorUrl?: string;
-    aptGpgKeyUrl?: string;
-    customPackages?: {
-        python?: string[];
-        node?: string[];
-        apt?: string[];
-    };
-};
-export declare class WorkerEnvManager {
-    private readonly app;
-    private readonly db;
-    private readonly storagePath;
-    constructor(app: Application, db: Database, storagePath: string);
-    getOrCreateConfig(): Promise<any>;
-    initEnvironment(config: WorkerEnvConfig): Promise<string>;
-    executeInit(payload: WorkerEnvConfig): Promise<void>;
-    parsePackageWhitelist(config: any): Record<"node" | "python" | "apt", string[]>;
-}
-export {};

package/dist/server/skill-hub/actions/git-import.d.ts

@@ -1,21 +0,0 @@
-import { Context } from '@nocobase/actions';
-/**
- * Git integration actions for skill-hub.
- *
- * Supported manifest shape:
- * {
- *   "skills": [
- *     { "folder": "my-skill", "name": "my-skill", "language": "python" },
- *     { "name": "pptx-advanced-export", "storageType": "plugin", "pluginSource": "pptx-advanced-export" }
- *   ]
- * }
- */
-export declare function gitListSkills(ctx: Context, next: () => Promise<void>): Promise<void>;
-/**
- * Sync selected skills from git into skillDefinitions.
- *
- * Code is optional. Regular git skills may provide code via codeTemplate,
- * codeFile, or conventional files under skills/<folder>. Plugin skills only
- * need storageType=plugin and pluginSource.
- */
-export declare function gitSyncSkills(ctx: Context, next: () => Promise<void>): Promise<void>;

package/dist/server/skill-hub/mcp/McpController.d.ts

@@ -1,15 +0,0 @@
-import type PluginSkillHubServer from '../plugin';
-export declare class McpController {
-    private plugin;
-    constructor(plugin: PluginSkillHubServer);
-    /**
-     * List all enabled skills in standard MCP format.
-     * Route: GET /api/skillHub:mcpListTools
-     */
-    listTools(ctx: any, next: any): Promise<void>;
-    /**
-     * Execute a skill in standard MCP format.
-     * Route: POST /api/skillHub:mcpCallTool
-     */
-    callTool(ctx: any, next: any): Promise<void>;
-}

package/dist/server/skill-hub/plugin.d.ts

@@ -1,58 +0,0 @@
-import { SandboxRunner } from '../services/SandboxRunner';
-import { FileManager } from '../services/FileManager';
-import { SkillManager } from '../services/SkillManager';
-import { WorkerEnvManager } from '../services/WorkerEnvManager';
-export declare class SkillHubSubFeature {
-    private plugin;
-    sandboxRunner: SandboxRunner;
-    fileManager: FileManager;
-    skillManager: SkillManager;
-    workerEnvManager: WorkerEnvManager;
-    private cleanupInterval;
-    private initEnvDoneCallback;
-    private initEnvProgressCallback;
-    private mcpController;
-    private skillRepoService;
-    private rateLimiter;
-    private skillTemplates;
-    constructor(plugin: any);
-    get app(): any;
-    get db(): any;
-    get name(): any;
-    load(): Promise<void>;
-    private onQueueTask;
-    /**
-     * Execute skill — called by both AI tool and REST test endpoint.
-     * Dispatches to worker via EventQueue, waits for result via PubSub.
-     * Pushes progress to SSE via runtime.writer (if within AI tool context).
-     * Includes rate limiting and graceful abort propagation.
-     */
-    executeSkill(skill: any, inputArgs: Record<string, any>, ctx?: any): Promise<any>;
-    private handleDownload;
-    private handleTest;
-    /**
-     * Handle Init Environment request from admin UI.
-     * Dispatches init task to all workers via EventQueue.
-     */
-    private handleInitEnv;
-    /**
-     * Subscribe to init-env done AND progress PubSub channels.
-     * When a worker finishes init, auto-update the DB with status.
-     */
-    private subscribeInitEnvDone;
-    private registerAITools;
-    private startCleanupInterval;
-    beforeStop(): Promise<void>;
-    private handleClearStorage;
-    private handleListTemplates;
-    /**
-     * Register a skill template into memory for UI importing.
-     */
-    registerSkillTemplate(pluginName: string, skillDef: any): void;
-    resolveSkillTemplate(templateName: string): any;
-    getSkillDescriptionForAI(skill: any): Promise<string>;
-    getSkillInstructions(skill: any): Promise<any>;
-    private hydrateSkillTemplate;
-    install(): Promise<void>;
-}
-export default SkillHubSubFeature;

package/dist/server/skill-hub/tasks/SkillExecutionTask.d.ts

@@ -1,16 +0,0 @@
-import Application from '@nocobase/server';
-import { SandboxRunner } from '../../services/SandboxRunner';
-import { FileManager } from '../../services/FileManager';
-import { SkillRepositoryService } from '../../services/SkillRepositoryService';
-export declare class SkillExecutionTask {
-    private execution;
-    private sandboxRunner;
-    private fileManager;
-    private skillRepoService;
-    private app;
-    constructor(execution: any, sandboxRunner: SandboxRunner, fileManager: FileManager, skillRepoService: SkillRepositoryService, app: Application);
-    run(): Promise<void>;
-    private renderTemplate;
-    private installGeneratedSkillIfRequested;
-    private validateGeneratedSkillPackages;
-}

package/dist/server/skill-hub/utils/json-fields.d.ts

@@ -1,7 +0,0 @@
-export declare function parseJsonText<T = any>(value: any, fallback: T): T;
-export declare function stringifyJsonText(value: any, fallback?: any): string;
-export declare function parseJsonLike(value: any, fallback: any): any;
-export declare function parseSkillMarkdown(markdown: string): {
-    metadata: Record<string, any>;
-    body: string;
-};

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

@@ -1,19 +0,0 @@
-/**
- * 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>;
-/**
- * Test/internal helper to drop the in-memory tool cache (e.g., from a CLI op).
- */
-export declare function invalidateDelegateToolsCache(): void;

package/dist/server/tools/external-rag-search.d.ts

@@ -1,42 +0,0 @@
-import { z } from 'zod';
-export declare function createExternalRagSearchTool(plugin: any): {
-    scope: "CUSTOM";
-    execution: "backend";
-    defaultPermission: "ALLOW";
-    introduction: {
-        title: string;
-        about: string;
-    };
-    definition: {
-        name: string;
-        description: string;
-        schema: z.ZodObject<{
-            query: z.ZodString;
-            knowledgeBaseIds: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
-            topK: z.ZodOptional<z.ZodNumber>;
-            scoreThreshold: z.ZodOptional<z.ZodNumber>;
-        }, "strip", z.ZodTypeAny, {
-            query?: string;
-            knowledgeBaseIds?: string[];
-            topK?: number;
-            scoreThreshold?: number;
-        }, {
-            query?: string;
-            knowledgeBaseIds?: string[];
-            topK?: number;
-            scoreThreshold?: number;
-        }>;
-    };
-    invoke: (ctx: any, args: {
-        query?: string;
-        knowledgeBaseIds?: string[];
-        topK?: number;
-        scoreThreshold?: number;
-    }) => Promise<{
-        status: "error";
-        content: string;
-    } | {
-        status: "success";
-        content: string;
-    }>;
-};

package/dist/server/tools/skill-execute.d.ts

@@ -1,36 +0,0 @@
-export declare function createSkillExecuteTool(plugin: any): {
-    scope: string;
-    execution: string;
-    defaultPermission: string;
-    introduction: {
-        title: string;
-        about: string;
-    };
-    definition: {
-        name: string;
-        description: string;
-        schema: {
-            type: string;
-            properties: {
-                action: {
-                    type: string;
-                    enum: string[];
-                    description: string;
-                };
-                skillName: {
-                    type: string;
-                    description: string;
-                };
-                input: {
-                    type: string;
-                    description: string;
-                };
-            };
-            required: string[];
-        };
-    };
-    invoke(ctx: any, args: Record<string, any>, _id?: string): Promise<{
-        status: string;
-        content: string;
-    }>;
-};