plugin-agent-orchestrator 1.0.21 → 1.0.22

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

@@ -1,218 +0,0 @@
-import { AgentRegistryService } from './AgentRegistryService';
-import { AgentPlannerService } from './AgentPlannerService';
-import { AgentPlanValidator } from './AgentPlanValidator';
-import { AgentLoopRepository } from './AgentLoopRepository';
-import { AgentHarness } from './AgentHarness';
-import { AgentLoopPolicy, AgentLoopPlanStepInput, AgentLoopRunStatus } from './AgentLoopService';
-import { TokenTracker } from './TokenTracker';
-export declare class AgentLoopController {
-    private readonly registryService;
-    private readonly plannerService;
-    private readonly validator;
-    private readonly repository;
-    private readonly harness;
-    private readonly tokenTracker;
-    constructor(registryService: AgentRegistryService, plannerService: AgentPlannerService, validator: AgentPlanValidator, repository: AgentLoopRepository, harness: AgentHarness, tokenTracker?: TokenTracker | null);
-    createRun(options: {
-        goal: string;
-        leaderUsername?: string;
-        sessionId?: string;
-        messageId?: string;
-        userId?: string | number;
-        policy?: Partial<AgentLoopPolicy>;
-        metadata?: any;
-        plan?: AgentLoopPlanStepInput[];
-    }): Promise<{
-        run: any;
-        steps: any;
-        nextSteps: any[];
-    }>;
-    planGoal(options: {
-        goal: string;
-        leaderUsername?: string;
-        sessionId?: string;
-        messageId?: string;
-        userId?: string | number;
-        policy?: Partial<AgentLoopPolicy>;
-        metadata?: any;
-        plan?: AgentLoopPlanStepInput[];
-        planSource?: string;
-        plannerModel?: string;
-        harnessTag?: string;
-        targetAgent?: string;
-        runId?: string | number;
-    }): Promise<{
-        events: any;
-        spans: any;
-        skillExecutions: any;
-        run: any;
-        steps: any;
-        nextSteps: any[];
-    }>;
-    revisePlanGoal(runId: string | number, plan: AgentLoopPlanStepInput[], options?: {
-        goal?: string;
-        userId?: string | number;
-        metadata?: any;
-        planSource?: string;
-        plannerModel?: string;
-        harnessTag?: string;
-        harnessProfileId?: string | number;
-        harnessSettings?: any;
-    }): Promise<{
-        events: any;
-        spans: any;
-        skillExecutions: any;
-        run: any;
-        steps: any;
-        nextSteps: any[];
-    }>;
-    approvePlanAndExecute(runId: string | number, options?: {
-        userId?: string | number;
-        ctx?: any;
-        reason?: string;
-    }): Promise<{
-        run: any;
-        steps: any;
-        nextSteps: any[];
-    }>;
-    rejectPlan(runId: string | number, options?: {
-        userId?: string | number;
-        reason?: string;
-    }): Promise<{
-        run: any;
-        steps: any;
-        nextSteps: any[];
-    }>;
-    requestPlanChanges(runId: string | number, options?: {
-        userId?: string | number;
-        feedback?: string;
-    }): Promise<{
-        events: any;
-        spans: any;
-        skillExecutions: any;
-        run: any;
-        steps: any;
-        nextSteps: any[];
-    }>;
-    replacePlan(runId: string | number, plan: AgentLoopPlanStepInput[], options?: {
-        userId?: string | number;
-        mode?: 'append' | 'replace_pending';
-        reason?: string;
-        markRunning?: boolean;
-    }): Promise<any[]>;
-    replan(runId: string | number, plan: AgentLoopPlanStepInput[], options?: {
-        reason?: string;
-        mode?: 'append' | 'replace_pending';
-        userId?: string | number;
-    }): Promise<any[]>;
-    startStep(stepId: string | number, options?: {
-        userId?: string | number;
-        agentExecutionSpanId?: string | number;
-    }): Promise<{
-        run: any;
-        steps: any;
-        nextSteps: any[];
-    }>;
-    completeStep(stepId: string | number, output: any, options?: {
-        userId?: string | number;
-        skillExecutionId?: string | number;
-        agentExecutionSpanId?: string | number;
-        metadata?: any;
-    }): Promise<{
-        run: any;
-        steps: any;
-        nextSteps: any[];
-    }>;
-    failStep(stepId: string | number, error: string, options?: {
-        userId?: string | number;
-        metadata?: any;
-    }): Promise<{
-        run: any;
-        steps: any;
-        nextSteps: any[];
-    }>;
-    skipStep(stepId: string | number, reason?: string, options?: {
-        userId?: string | number;
-    }): Promise<{
-        run: any;
-        steps: any;
-        nextSteps: any[];
-    }>;
-    requestApproval(stepId: string | number, approval: any, options?: {
-        userId?: string | number;
-        reason?: string;
-    }): Promise<{
-        run: any;
-        steps: any;
-        nextSteps: any[];
-    }>;
-    resumeRun(runId: string | number, options: {
-        stepId?: string | number;
-        approved: boolean;
-        editedInput?: any;
-        userId?: string | number;
-        ctx?: any;
-    }): Promise<{
-        run: any;
-        steps: any;
-        nextSteps: any[];
-    }>;
-    retryStep(stepId: string | number, options?: {
-        userId?: string | number;
-    }): Promise<{
-        run: any;
-        steps: any;
-        nextSteps: any[];
-    }>;
-    finishRun(runId: string | number, finalAnswer: string, options?: {
-        status?: Extract<AgentLoopRunStatus, 'succeeded' | 'failed'>;
-        summary?: string;
-        evidence?: any;
-        userId?: string | number;
-    }): Promise<{
-        run: any;
-        steps: any;
-        nextSteps: any[];
-    }>;
-    stepFeedback(stepId: string | number, feedback: {
-        rating: 'positive' | 'negative';
-        comment?: string;
-        category?: string;
-    }, options?: {
-        userId?: string | number;
-    }): Promise<{
-        run: any;
-        steps: any;
-        nextSteps: any[];
-    }>;
-    cancelRun(runId: string | number, options?: {
-        userId?: string | number;
-        reason?: string;
-    }): Promise<{
-        run: any;
-        steps: any;
-        nextSteps: any[];
-    }>;
-    executeApprovedPlan(runId: string | number, options?: {
-        userId?: string | number;
-        ctx?: any;
-    }): Promise<{
-        run: any;
-        steps: any;
-        nextSteps: any[];
-    }>;
-    getRunSnapshot(runId: string | number): Promise<{
-        run: any;
-        steps: any;
-        nextSteps: any[];
-    }>;
-    getRunDetail(runId: string | number): Promise<{
-        events: any;
-        spans: any;
-        skillExecutions: any;
-        run: any;
-        steps: any;
-        nextSteps: any[];
-    }>;
-    pickNextSteps(steps: any[], runPolicy?: any): any[];
-}

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

@@ -1,20 +0,0 @@
-export declare class AgentLoopRepository {
-    private readonly plugin;
-    constructor(plugin: any);
-    get db(): any;
-    getRun(runId: string | number): Promise<any>;
-    requireRun(runId: string | number): Promise<any>;
-    createRun(values: any): Promise<any>;
-    updateRun(runId: string | number, values: any): Promise<void>;
-    getStep(stepId: string | number): Promise<any>;
-    requireStep(stepId: string | number): Promise<any>;
-    createStep(values: any): Promise<any>;
-    updateStep(stepId: string | number, values: any): Promise<void>;
-    getSteps(runId: string | number): Promise<any>;
-    createEvent(values: any): Promise<any>;
-    getEvents(runId: string | number): Promise<any>;
-    getLinkedSpans(runId: string | number, rootRunId?: string): Promise<any>;
-    getLinkedSkillExecutions(runId: string | number, steps: any[]): Promise<any>;
-    lockRun(runId: string | number, lockName: string, durationMs: number): Promise<boolean>;
-    unlockRun(runId: string | number): Promise<void>;
-}

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>;
-}