plugin-agent-orchestrator 1.0.15 → 1.0.17

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: any;
-export default _default;

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

@@ -1,2 +0,0 @@
-declare const _default: any;
-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: any;
-export default _default;

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

@@ -1,2 +0,0 @@
-declare const _default: CollectionOptions;
-export default _default;

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

@@ -1,2 +0,0 @@
-declare const _default: CollectionOptions;
-export default _default;

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

@@ -1,2 +0,0 @@
-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/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(args: Record<string, any>, options?: any): Promise<{
-        status: string;
-        content: string;
-    }>;
-};