plugin-agent-orchestrator 1.0.21 → 1.0.23

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

@@ -1,159 +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;
-    maxContextTokens?: number;
-    contextSummaryStrategy?: 'last_n' | 'all';
-    includeToolResults?: boolean;
-    includeStepOutputs?: boolean;
-    maxConcurrency?: number;
-};
-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;
-        nextSteps: any[];
-    }>;
-    planGoal(options: any): Promise<{
-        events: any;
-        spans: any;
-        skillExecutions: any;
-        run: any;
-        steps: any;
-        nextSteps: any[];
-    }>;
-    revisePlanGoal(runId: any, plan: any, options?: any): Promise<{
-        events: any;
-        spans: any;
-        skillExecutions: any;
-        run: any;
-        steps: any;
-        nextSteps: any[];
-    }>;
-    approvePlanAndExecute(runId: any, options?: any): Promise<{
-        run: any;
-        steps: any;
-        nextSteps: any[];
-    }>;
-    rejectPlan(runId: any, options?: any): Promise<{
-        run: any;
-        steps: any;
-        nextSteps: any[];
-    }>;
-    requestPlanChanges(runId: any, options?: any): Promise<{
-        events: any;
-        spans: any;
-        skillExecutions: any;
-        run: any;
-        steps: any;
-        nextSteps: 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;
-        nextSteps: any[];
-    }>;
-    completeStep(stepId: any, output: any, options?: any): Promise<{
-        run: any;
-        steps: any;
-        nextSteps: any[];
-    }>;
-    failStep(stepId: any, error: any, options?: any): Promise<{
-        run: any;
-        steps: any;
-        nextSteps: any[];
-    }>;
-    skipStep(stepId: any, reason?: any, options?: any): Promise<{
-        run: any;
-        steps: any;
-        nextSteps: any[];
-    }>;
-    requestApproval(stepId: any, approval: any, options?: any): Promise<{
-        run: any;
-        steps: any;
-        nextSteps: any[];
-    }>;
-    resumeRun(runId: any, options: any): Promise<{
-        run: any;
-        steps: any;
-        nextSteps: any[];
-    }>;
-    retryStep(stepId: any, options?: any): Promise<{
-        run: any;
-        steps: any;
-        nextSteps: any[];
-    }>;
-    stepFeedback(stepId: any, feedback: any, options?: any): Promise<{
-        run: any;
-        steps: any;
-        nextSteps: any[];
-    }>;
-    finishRun(runId: any, finalAnswer: any, options?: any): Promise<{
-        run: any;
-        steps: any;
-        nextSteps: any[];
-    }>;
-    cancelRun(runId: any, options?: any): Promise<{
-        run: any;
-        steps: any;
-        nextSteps: any[];
-    }>;
-    executeApprovedPlan(runId: any, options?: any): Promise<{
-        run: any;
-        steps: any;
-        nextSteps: any[];
-    }>;
-    getRunSnapshot(runId: any): Promise<{
-        run: any;
-        steps: any;
-        nextSteps: any[];
-    }>;
-    getRunDetail(runId: any): Promise<{
-        events: any;
-        spans: any;
-        skillExecutions: any;
-        run: any;
-        steps: any;
-        nextSteps: 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,21 +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;
-    }>;
-    /**
-     * Find alternative sub-agents for the same leader, excluding a specific one.
-     * Used by the smart retry feature to route around a failing sub-agent.
-     */
-    findAlternativeSubAgents(leaderUsername: string, excludeSubAgentUsername: string): Promise<{
-        username: string;
-        label: string;
-    }[]>;
-    isRegisteredDelegationTool(toolName: string): Promise<boolean>;
-}

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

@@ -1,40 +0,0 @@
-export interface CircuitState {
-    failures: number;
-    lastFailureTime: number;
-    state: 'closed' | 'open' | 'half-open';
-}
-/**
- * CircuitBreakerRegistry — prevents cascading failures by tracking per-key
- * failure rates and temporarily stopping calls when thresholds are exceeded.
- *
- * State machine: closed → open (after threshold failures) → half-open (after recoveryTimeout)
- * half-open: allows 1 probe request; success → closed, failure → open.
- */
-export declare class CircuitBreakerRegistry {
-    private readonly circuits;
-    readonly threshold: number;
-    readonly recoveryTimeout: number;
-    readonly halfOpenMaxRequests: number;
-    private readonly appLog;
-    constructor(options?: {
-        threshold?: number;
-        recoveryTimeout?: number;
-        halfOpenMaxRequests?: number;
-        appLog?: any;
-    });
-    private getOrCreate;
-    recordSuccess(key: string): void;
-    recordFailure(key: string): void;
-    isAllowed(key: string): boolean;
-    getState(key: string): CircuitState | null;
-    /** Reset a circuit back to closed state. */
-    reset(key: string): void;
-    /** Get all circuit state keys (for monitoring/diagnostics). */
-    getKeys(): string[];
-}
-export declare function getCircuitBreaker(options?: {
-    threshold?: number;
-    recoveryTimeout?: number;
-    halfOpenMaxRequests?: number;
-    appLog?: any;
-}): CircuitBreakerRegistry;

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/ContextAggregator.d.ts

@@ -1,45 +0,0 @@
-/**
- * ContextAggregator — builds structured step context for sub-agent system prompts.
- *
- * Responsibilities:
- * 1. Query completed steps of a run
- * 2. Format them as structured XML context
- * 3. Apply truncation/summarization based on policy
- * 4. Inject into sub-agent system prompt
- */
-export declare class ContextAggregator {
-    private readonly plugin;
-    constructor(plugin: any);
-    get db(): any;
-    get app(): any;
-    /**
-     * Build a structured context string from completed steps of a run.
-     *
-     * @param runId - agentLoopRuns.id
-     * @param maxTokens - Maximum tokens for the context output (default 4000)
-     * @param options - Strategy options
-     */
-    buildStepContext(runId: string | number, maxTokens?: number, options?: {
-        strategy?: 'last_n' | 'all';
-        includeToolResults?: boolean;
-        includeStepOutputs?: boolean;
-    }): Promise<string>;
-    /**
-     * Enrich a base system prompt with step context from the run.
-     * Fetches the run from DB to access policy settings (maxContextTokens, etc.).
-     *
-     * @param basePrompt - The original system prompt to enrich
-     * @param runId - agentLoopRuns.id
-     * @param _stepId - agentLoopSteps.id (reserved for future per-step context)
-     */
-    enrichSystemPrompt(basePrompt: string, runId: string | number, _stepId?: string | number, options?: {
-        maxContextTokens?: number;
-        contextSummaryStrategy?: 'last_n' | 'all';
-        includeToolResults?: boolean;
-        includeStepOutputs?: boolean;
-    }): Promise<string>;
-    private truncateToTokenLimit;
-    private splitStepBlocks;
-    private escapeXml;
-    private safeStringify;
-}

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/RunEventBus.d.ts

@@ -1,9 +0,0 @@
-type EventCallback = (event: any) => void;
-declare class RunEventBusImpl {
-    private listeners;
-    subscribe(runId: string | number, callback: EventCallback): () => void;
-    emit(runId: string | number, event: any): void;
-    listenerCount(runId: string | number): number;
-}
-export declare function getRunEventBus(): RunEventBusImpl;
-export {};

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/TokenTracker.d.ts

@@ -1,62 +0,0 @@
-export interface TokenUsage {
-    inputTokens: number;
-    outputTokens: number;
-    totalTokens: number;
-    cost: number;
-}
-export interface BudgetConfig {
-    budgetMaxTokens?: number;
-    budgetMaxCost?: number;
-}
-export interface BudgetCheckResult {
-    allowed: boolean;
-    reason?: string;
-}
-/**
- * Extract usage_metadata from the final state returned by createReactAgent.invoke().
- *
- * LangChain's createReactAgent returns a final state object with a `messages` array.
- * The last AIMessage in that array carries `usage_metadata` populated by the
- * LLM provider after the final generation step. This is the standard LangChain
- * approach — no private API access needed.
- *
- * Expected shape (from @langchain/core/messages/ai):
- *   AIMessage.usage_metadata = {
- *     input_tokens: number,
- *     output_tokens: number,
- *     total_tokens: number,
- *   }
- */
-export declare function extractTokenUsage(finalState: any): TokenUsage | null;
-/**
- * Service for tracking token consumption across agent runs and spans.
- *
- * Responsibilities:
- * 1. Parse token usage from LangGraph execution results
- * 2. Persist token counts to agentExecutionSpans
- * 3. Accumulate totals at the agentLoopRuns level
- * 4. Enforce budget limits (max tokens / max cost per run)
- */
-export declare class TokenTracker {
-    private readonly plugin;
-    constructor(plugin: any);
-    get db(): any;
-    get app(): any;
-    /**
-     * Track token usage for a single execution span.
-     * Updates the span record and accumulates into the parent run.
-     *
-     * @param spanId - The agentExecutionSpans.id to update
-     * @param usage - Parsed token usage from extractTokenUsage()
-     * @param runId - Optional agentLoopRuns.id to accumulate totals
-     */
-    trackSpan(spanId: string | number | undefined, usage: TokenUsage, runId?: string | number): Promise<void>;
-    /**
-     * Recalculate total token/cost for a run by summing all its spans.
-     */
-    accumulateToRun(runId: string | number): Promise<void>;
-    /**
-     * Check if a run has exceeded its budget limits.
-     */
-    checkBudget(runId: string | number): Promise<BudgetCheckResult>;
-}

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;