plugin-agent-orchestrator 1.0.20 → 1.0.22

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

@@ -1,149 +0,0 @@
-import { AgentRegistryService } from './AgentRegistryService';
-import { AgentPlannerService } from './AgentPlannerService';
-import { AgentPlanValidator } from './AgentPlanValidator';
-import { AgentLoopRepository } from './AgentLoopRepository';
-import { AgentHarness } from './AgentHarness';
-import { AgentLoopController } from './AgentLoopController';
-export type AgentLoopRunStatus = 'planning' | 'waiting_plan_approval' | 'approved' | 'running' | 'waiting_user' | 'needs_replan' | 'succeeded' | 'failed' | 'rejected' | 'canceled';
-export type AgentLoopStepStatus = 'pending' | 'running' | 'waiting_user' | 'succeeded' | 'failed' | 'skipped';
-export type AgentLoopStepType = 'reasoning' | 'skill' | 'tool' | 'sub_agent' | 'verification';
-export type AgentLoopStepDependencyPolicy = 'require_success' | 'allow_skipped';
-export type AgentLoopPolicy = {
-    maxIterations: number;
-    maxStepAttempts: number;
-    allowReplan: boolean;
-    requireVerification: boolean;
-    stopOnApprovalRequired: boolean;
-};
-export type AgentLoopPlanStepInput = {
-    id?: string;
-    key?: string;
-    planKey?: string;
-    parentStepId?: string | number;
-    title?: string;
-    description?: string;
-    type?: AgentLoopStepType;
-    target?: string;
-    input?: any;
-    dependsOn?: string[];
-    dependencyPolicy?: AgentLoopStepDependencyPolicy;
-    maxAttempts?: number;
-    metadata?: any;
-};
-export declare class AgentLoopService {
-    private readonly plugin;
-    readonly registryService: AgentRegistryService;
-    readonly plannerService: AgentPlannerService;
-    readonly validator: AgentPlanValidator;
-    readonly repository: AgentLoopRepository;
-    readonly harness: AgentHarness;
-    readonly controller: AgentLoopController;
-    constructor(plugin: any);
-    get db(): any;
-    get app(): any;
-    createRun(options: any): Promise<{
-        run: any;
-        steps: any;
-        nextStep: any;
-    }>;
-    planGoal(options: any): Promise<{
-        events: any;
-        spans: any;
-        skillExecutions: any;
-        run: any;
-        steps: any;
-        nextStep: any;
-    }>;
-    revisePlanGoal(runId: any, plan: any, options?: any): Promise<{
-        events: any;
-        spans: any;
-        skillExecutions: any;
-        run: any;
-        steps: any;
-        nextStep: any;
-    }>;
-    approvePlanAndExecute(runId: any, options?: any): Promise<{
-        run: any;
-        steps: any;
-        nextStep: any;
-    }>;
-    rejectPlan(runId: any, options?: any): Promise<{
-        run: any;
-        steps: any;
-        nextStep: any;
-    }>;
-    requestPlanChanges(runId: any, options?: any): Promise<{
-        events: any;
-        spans: any;
-        skillExecutions: any;
-        run: any;
-        steps: any;
-        nextStep: any;
-    }>;
-    replacePlan(runId: any, plan: any, options?: any): Promise<any[]>;
-    replan(runId: any, plan: any, options?: any): Promise<any[]>;
-    startStep(stepId: any, options?: any): Promise<{
-        run: any;
-        steps: any;
-        nextStep: any;
-    }>;
-    completeStep(stepId: any, output: any, options?: any): Promise<{
-        run: any;
-        steps: any;
-        nextStep: any;
-    }>;
-    failStep(stepId: any, error: any, options?: any): Promise<{
-        run: any;
-        steps: any;
-        nextStep: any;
-    }>;
-    skipStep(stepId: any, reason?: any, options?: any): Promise<{
-        run: any;
-        steps: any;
-        nextStep: any;
-    }>;
-    requestApproval(stepId: any, approval: any, options?: any): Promise<{
-        run: any;
-        steps: any;
-        nextStep: any;
-    }>;
-    resumeRun(runId: any, options: any): Promise<{
-        run: any;
-        steps: any;
-        nextStep: any;
-    }>;
-    retryStep(stepId: any, options?: any): Promise<{
-        run: any;
-        steps: any;
-        nextStep: any;
-    }>;
-    finishRun(runId: any, finalAnswer: any, options?: any): Promise<{
-        run: any;
-        steps: any;
-        nextStep: any;
-    }>;
-    cancelRun(runId: any, options?: any): Promise<{
-        run: any;
-        steps: any;
-        nextStep: any;
-    }>;
-    executeApprovedPlan(runId: any, options?: any): Promise<{
-        run: any;
-        steps: any;
-        nextStep: any;
-    }>;
-    getRunSnapshot(runId: any): Promise<{
-        run: any;
-        steps: any;
-        nextStep: any;
-    }>;
-    getRunDetail(runId: any): Promise<{
-        events: any;
-        spans: any;
-        skillExecutions: any;
-        run: any;
-        steps: any;
-        nextStep: any;
-    }>;
-    createEvent(values: any): Promise<any>;
-}

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

@@ -1,4 +0,0 @@
-import { AgentLoopPlanStepInput } from './AgentLoopService';
-export declare class AgentPlanValidator {
-    validate(plan: AgentLoopPlanStepInput[]): void;
-}

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

@@ -1,8 +0,0 @@
-import { AgentLoopPlanStepInput } from './AgentLoopService';
-export declare class AgentPlannerService {
-    buildPlan(goal: string, plan: AgentLoopPlanStepInput[] | undefined, options: {
-        targetAgent?: string;
-        harnessTag?: string;
-        metadata?: any;
-    }): AgentLoopPlanStepInput[];
-}

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

@@ -1,13 +0,0 @@
-export declare class AgentRegistryService {
-    private readonly plugin;
-    constructor(plugin: any);
-    get db(): any;
-    getHarnessProfile(tag: string): Promise<any>;
-    getOrchestratorConfig(leaderUsername: string, subAgentUsername: string): Promise<any>;
-    getAIEmployee(username: string): Promise<any>;
-    resolveModelSettings(subAgentUsername: string, leaderUsername?: string, dynamicValues?: any): Promise<{
-        llmService: string;
-        model: string;
-    }>;
-    isRegisteredDelegationTool(toolName: string): Promise<boolean>;
-}

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,46 +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;
-    agentLoopRunId?: string;
-    agentLoopStepId?: 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,61 +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 getSkillRecordId;
-    private resolveLoopInteractionSchema;
-    private getLoopConfigsBySkillId;
-    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;
-};