plugin-agent-orchestrator 1.0.21 → 1.0.23

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

@@ -1,235 +0,0 @@
-import { z } from 'zod';
-import { AgentLoopService } from '../services/AgentLoopService';
-export declare function createAgentLoopTools(plugin: any, service: AgentLoopService): ({
-    scope: "CUSTOM";
-    execution: "backend";
-    defaultPermission: "ALLOW";
-    introduction: {
-        title: string;
-        about: string;
-    };
-    definition: {
-        name: string;
-        description: string;
-        schema: z.ZodObject<{
-            goal: z.ZodString;
-            leaderUsername: z.ZodOptional<z.ZodString>;
-            sessionId: z.ZodOptional<z.ZodString>;
-            messageId: z.ZodOptional<z.ZodString>;
-            policy: z.ZodOptional<z.ZodObject<{
-                maxIterations: z.ZodOptional<z.ZodNumber>;
-                maxStepAttempts: z.ZodOptional<z.ZodNumber>;
-                allowReplan: z.ZodOptional<z.ZodBoolean>;
-                requireVerification: z.ZodOptional<z.ZodBoolean>;
-                stopOnApprovalRequired: z.ZodOptional<z.ZodBoolean>;
-            }, "strip", z.ZodTypeAny, {
-                maxIterations?: number;
-                maxStepAttempts?: number;
-                allowReplan?: boolean;
-                requireVerification?: boolean;
-                stopOnApprovalRequired?: boolean;
-            }, {
-                maxIterations?: number;
-                maxStepAttempts?: number;
-                allowReplan?: boolean;
-                requireVerification?: boolean;
-                stopOnApprovalRequired?: boolean;
-            }>>;
-            metadata: z.ZodOptional<z.ZodAny>;
-            plan: z.ZodOptional<z.ZodArray<z.ZodObject<{
-                id: z.ZodOptional<z.ZodString>;
-                key: z.ZodOptional<z.ZodString>;
-                planKey: z.ZodOptional<z.ZodString>;
-                parentStepId: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodNumber]>>;
-                title: z.ZodOptional<z.ZodString>;
-                description: z.ZodOptional<z.ZodString>;
-                type: z.ZodOptional<z.ZodEnum<["reasoning", "skill", "tool", "sub_agent", "verification"]>>;
-                target: z.ZodOptional<z.ZodString>;
-                input: z.ZodOptional<z.ZodAny>;
-                dependsOn: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
-                maxAttempts: z.ZodOptional<z.ZodNumber>;
-                metadata: z.ZodOptional<z.ZodAny>;
-            }, "strip", z.ZodTypeAny, {
-                type?: "reasoning" | "skill" | "tool" | "sub_agent" | "verification";
-                key?: string;
-                title?: string;
-                description?: string;
-                metadata?: any;
-                input?: any;
-                id?: string;
-                planKey?: string;
-                target?: string;
-                dependsOn?: string[];
-                parentStepId?: string | number;
-                maxAttempts?: number;
-            }, {
-                type?: "reasoning" | "skill" | "tool" | "sub_agent" | "verification";
-                key?: string;
-                title?: string;
-                description?: string;
-                metadata?: any;
-                input?: any;
-                id?: string;
-                planKey?: string;
-                target?: string;
-                dependsOn?: string[];
-                parentStepId?: string | number;
-                maxAttempts?: number;
-            }>, "many">>;
-        }, "strip", z.ZodTypeAny, {
-            leaderUsername?: string;
-            metadata?: any;
-            sessionId?: string;
-            goal?: string;
-            messageId?: string;
-            policy?: {
-                maxIterations?: number;
-                maxStepAttempts?: number;
-                allowReplan?: boolean;
-                requireVerification?: boolean;
-                stopOnApprovalRequired?: boolean;
-            };
-            plan?: {
-                type?: "reasoning" | "skill" | "tool" | "sub_agent" | "verification";
-                key?: string;
-                title?: string;
-                description?: string;
-                metadata?: any;
-                input?: any;
-                id?: string;
-                planKey?: string;
-                target?: string;
-                dependsOn?: string[];
-                parentStepId?: string | number;
-                maxAttempts?: number;
-            }[];
-        }, {
-            leaderUsername?: string;
-            metadata?: any;
-            sessionId?: string;
-            goal?: string;
-            messageId?: string;
-            policy?: {
-                maxIterations?: number;
-                maxStepAttempts?: number;
-                allowReplan?: boolean;
-                requireVerification?: boolean;
-                stopOnApprovalRequired?: boolean;
-            };
-            plan?: {
-                type?: "reasoning" | "skill" | "tool" | "sub_agent" | "verification";
-                key?: string;
-                title?: string;
-                description?: string;
-                metadata?: any;
-                input?: any;
-                id?: string;
-                planKey?: string;
-                target?: string;
-                dependsOn?: string[];
-                parentStepId?: string | number;
-                maxAttempts?: number;
-            }[];
-        }>;
-    };
-    invoke: (ctx: any, args: any) => Promise<{
-        status: "success" | "error";
-        content: string;
-    }>;
-} | {
-    scope: "CUSTOM";
-    execution: "backend";
-    defaultPermission: "ALLOW";
-    introduction: {
-        title: string;
-        about: string;
-    };
-    definition: {
-        name: string;
-        description: string;
-        schema: z.ZodObject<{
-            runId: z.ZodUnion<[z.ZodString, z.ZodNumber]>;
-        }, "strip", z.ZodTypeAny, {
-            runId?: string | number;
-        }, {
-            runId?: string | number;
-        }>;
-    };
-    invoke: (ctx: any, args: any) => Promise<{
-        status: "success" | "error";
-        content: string;
-    }>;
-} | {
-    scope: "CUSTOM";
-    execution: "backend";
-    defaultPermission: "ALLOW";
-    introduction: {
-        title: string;
-        about: string;
-    };
-    definition: {
-        name: string;
-        description: string;
-        schema: z.ZodObject<{
-            stepId: z.ZodUnion<[z.ZodString, z.ZodNumber]>;
-            status: z.ZodEnum<["running", "succeeded", "failed", "skipped"]>;
-            output: z.ZodOptional<z.ZodAny>;
-            error: z.ZodOptional<z.ZodString>;
-            reason: z.ZodOptional<z.ZodString>;
-            skillExecutionId: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodNumber]>>;
-            agentExecutionSpanId: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodNumber]>>;
-            metadata: z.ZodOptional<z.ZodAny>;
-        }, "strip", z.ZodTypeAny, {
-            error?: string;
-            status?: "succeeded" | "failed" | "running" | "skipped";
-            reason?: string;
-            metadata?: any;
-            output?: any;
-            skillExecutionId?: string | number;
-            stepId?: string | number;
-            agentExecutionSpanId?: string | number;
-        }, {
-            error?: string;
-            status?: "succeeded" | "failed" | "running" | "skipped";
-            reason?: string;
-            metadata?: any;
-            output?: any;
-            skillExecutionId?: string | number;
-            stepId?: string | number;
-            agentExecutionSpanId?: string | number;
-        }>;
-    };
-    invoke: (ctx: any, args: any) => Promise<{
-        status: "success" | "error";
-        content: string;
-    }>;
-} | {
-    scope: "CUSTOM";
-    execution: "backend";
-    defaultPermission: "ALLOW";
-    introduction: {
-        title: string;
-        about: string;
-    };
-    definition: {
-        name: string;
-        description: string;
-        schema: z.ZodObject<{
-            stepId: z.ZodUnion<[z.ZodString, z.ZodNumber]>;
-            reason: z.ZodOptional<z.ZodString>;
-            approval: z.ZodOptional<z.ZodAny>;
-        }, "strip", z.ZodTypeAny, {
-            reason?: string;
-            stepId?: string | number;
-            approval?: any;
-        }, {
-            reason?: string;
-            stepId?: string | number;
-            approval?: any;
-        }>;
-    };
-    invoke: (ctx: any, args: any) => Promise<{
-        status: "success" | "error";
-        content: 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/orchestrator-plan.d.ts

@@ -1,205 +0,0 @@
-import { z } from 'zod';
-import { AgentLoopService } from '../services/AgentLoopService';
-export declare function createOrchestratorPlanTools(plugin: any, service: AgentLoopService): ({
-    scope: "CUSTOM";
-    execution: "backend";
-    defaultPermission: "ALLOW";
-    introduction: {
-        title: string;
-        about: string;
-    };
-    definition: {
-        name: string;
-        description: string;
-        schema: z.ZodObject<{
-            goal: z.ZodString;
-            runId: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodNumber]>>;
-            leaderUsername: z.ZodOptional<z.ZodString>;
-            sessionId: z.ZodOptional<z.ZodString>;
-            messageId: z.ZodOptional<z.ZodString>;
-            harnessTag: z.ZodDefault<z.ZodOptional<z.ZodString>>;
-            targetAgent: z.ZodOptional<z.ZodString>;
-            plannerModel: z.ZodOptional<z.ZodString>;
-            policy: z.ZodOptional<z.ZodObject<{
-                maxIterations: z.ZodOptional<z.ZodNumber>;
-                maxStepAttempts: z.ZodOptional<z.ZodNumber>;
-                allowReplan: z.ZodOptional<z.ZodBoolean>;
-                requireVerification: z.ZodOptional<z.ZodBoolean>;
-                stopOnApprovalRequired: z.ZodOptional<z.ZodBoolean>;
-            }, "strip", z.ZodTypeAny, {
-                maxIterations?: number;
-                maxStepAttempts?: number;
-                allowReplan?: boolean;
-                requireVerification?: boolean;
-                stopOnApprovalRequired?: boolean;
-            }, {
-                maxIterations?: number;
-                maxStepAttempts?: number;
-                allowReplan?: boolean;
-                requireVerification?: boolean;
-                stopOnApprovalRequired?: boolean;
-            }>>;
-            metadata: z.ZodOptional<z.ZodAny>;
-            plan: z.ZodOptional<z.ZodArray<z.ZodObject<{
-                id: z.ZodOptional<z.ZodString>;
-                key: z.ZodOptional<z.ZodString>;
-                planKey: z.ZodOptional<z.ZodString>;
-                parentStepId: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodNumber]>>;
-                title: z.ZodOptional<z.ZodString>;
-                description: z.ZodOptional<z.ZodString>;
-                type: z.ZodOptional<z.ZodEnum<["reasoning", "skill", "tool", "sub_agent", "verification"]>>;
-                target: z.ZodOptional<z.ZodString>;
-                input: z.ZodOptional<z.ZodAny>;
-                dependsOn: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
-                dependencyPolicy: z.ZodOptional<z.ZodEnum<["require_success", "allow_skipped"]>>;
-                maxAttempts: z.ZodOptional<z.ZodNumber>;
-                metadata: z.ZodOptional<z.ZodAny>;
-            }, "strip", z.ZodTypeAny, {
-                type?: "reasoning" | "skill" | "tool" | "sub_agent" | "verification";
-                key?: string;
-                title?: string;
-                description?: string;
-                metadata?: any;
-                input?: any;
-                id?: string;
-                planKey?: string;
-                target?: string;
-                dependsOn?: string[];
-                parentStepId?: string | number;
-                dependencyPolicy?: "require_success" | "allow_skipped";
-                maxAttempts?: number;
-            }, {
-                type?: "reasoning" | "skill" | "tool" | "sub_agent" | "verification";
-                key?: string;
-                title?: string;
-                description?: string;
-                metadata?: any;
-                input?: any;
-                id?: string;
-                planKey?: string;
-                target?: string;
-                dependsOn?: string[];
-                parentStepId?: string | number;
-                dependencyPolicy?: "require_success" | "allow_skipped";
-                maxAttempts?: number;
-            }>, "many">>;
-        }, "strip", z.ZodTypeAny, {
-            leaderUsername?: string;
-            metadata?: any;
-            runId?: string | number;
-            sessionId?: string;
-            goal?: string;
-            messageId?: string;
-            policy?: {
-                maxIterations?: number;
-                maxStepAttempts?: number;
-                allowReplan?: boolean;
-                requireVerification?: boolean;
-                stopOnApprovalRequired?: boolean;
-            };
-            harnessTag?: string;
-            targetAgent?: string;
-            plannerModel?: string;
-            plan?: {
-                type?: "reasoning" | "skill" | "tool" | "sub_agent" | "verification";
-                key?: string;
-                title?: string;
-                description?: string;
-                metadata?: any;
-                input?: any;
-                id?: string;
-                planKey?: string;
-                target?: string;
-                dependsOn?: string[];
-                parentStepId?: string | number;
-                dependencyPolicy?: "require_success" | "allow_skipped";
-                maxAttempts?: number;
-            }[];
-        }, {
-            leaderUsername?: string;
-            metadata?: any;
-            runId?: string | number;
-            sessionId?: string;
-            goal?: string;
-            messageId?: string;
-            policy?: {
-                maxIterations?: number;
-                maxStepAttempts?: number;
-                allowReplan?: boolean;
-                requireVerification?: boolean;
-                stopOnApprovalRequired?: boolean;
-            };
-            harnessTag?: string;
-            targetAgent?: string;
-            plannerModel?: string;
-            plan?: {
-                type?: "reasoning" | "skill" | "tool" | "sub_agent" | "verification";
-                key?: string;
-                title?: string;
-                description?: string;
-                metadata?: any;
-                input?: any;
-                id?: string;
-                planKey?: string;
-                target?: string;
-                dependsOn?: string[];
-                parentStepId?: string | number;
-                dependencyPolicy?: "require_success" | "allow_skipped";
-                maxAttempts?: number;
-            }[];
-        }>;
-    };
-    invoke: (ctx: any, args: any) => Promise<{
-        status: "success" | "error";
-        content: string;
-    }>;
-} | {
-    scope: "CUSTOM";
-    execution: "backend";
-    defaultPermission: "ALLOW";
-    introduction: {
-        title: string;
-        about: string;
-    };
-    definition: {
-        name: string;
-        description: string;
-        schema: z.ZodObject<{
-            runId: z.ZodUnion<[z.ZodString, z.ZodNumber]>;
-        }, "strip", z.ZodTypeAny, {
-            runId?: string | number;
-        }, {
-            runId?: string | number;
-        }>;
-    };
-    invoke: (_ctx: any, args: any) => Promise<{
-        status: "success" | "error";
-        content: string;
-    }>;
-} | {
-    scope: "CUSTOM";
-    execution: "backend";
-    defaultPermission: "ASK";
-    introduction: {
-        title: string;
-        about: string;
-    };
-    definition: {
-        name: string;
-        description: string;
-        schema: z.ZodObject<{
-            runId: z.ZodUnion<[z.ZodString, z.ZodNumber]>;
-            reason: z.ZodOptional<z.ZodString>;
-        }, "strip", z.ZodTypeAny, {
-            reason?: string;
-            runId?: string | number;
-        }, {
-            reason?: string;
-            runId?: string | number;
-        }>;
-    };
-    invoke: (ctx: any, args: any) => Promise<{
-        status: "success" | "error";
-        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;
-    }>;
-};

package/dist/server/types.d.ts

@@ -1,47 +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;
-}
-export interface CircuitState {
-    failures: number;
-    lastFailureTime: number;
-    state: 'closed' | 'open' | 'half-open';
-}
-export interface TraceEvent {
-    type: string;
-    at: string;
-    title: string;
-    content?: string;
-    toolName?: string;
-    args?: any;
-    status?: string;
-}
-export interface DelegationLogData {
-    id?: number | string;
-    leaderUsername: string;
-    subAgentUsername: string;
-    toolName: string;
-    task: string;
-    context?: string;
-    result: string;
-    status: string;
-    depth: number;
-    durationMs: number;
-    error?: string;
-    trace?: TraceEvent[];
-    messages?: any[];
-    userId?: number | string;
-}
-export type CtxSnapshot = {
-    userId?: number;
-};

package/dist/server/utils/ctx-utils.d.ts

@@ -1,30 +0,0 @@
-/** Normalize a record to a plain JS object. */
-export declare function toPlain(record: any): any;
-/** Coerce a value to a plain object (JSON parse if needed). */
-export declare function asObject(value: any): any;
-/** Coerce value to array. */
-export declare function asArray(value: any): any[];
-/** Trim text to max length with ellipsis suffix. */
-export declare function trimText(value: any, max?: number): string;
-/** Get the current user id from ctx. */
-export declare function currentUserId(ctx: any): any;
-/** Get action params values from ctx. */
-export declare function valuesFromCtx(ctx: any): any;
-/** Normalize raw employee username input (string | object → string | null). */
-export declare function normalizeEmployeeUsername(raw: any): any;
-/** Resolve session id from args or ctx. */
-export declare function resolveSessionId(ctx: any, args: any): any;
-/** Resolve message id from args or ctx. */
-export declare function resolveMessageId(ctx: any, args: any): any;
-/** Resolve leader employee username from args, ctx state, or conversation record. */
-export declare function resolveLeaderUsername(ctx: any, plugin: any, args: any): Promise<any>;
-/** Snapshot ctx user id for later use (avoids stale ctx). */
-export declare function captureCtxSnapshot(ctx: any): {
-    userId?: number;
-};
-/** Normalize step type to a known value. */
-export declare function normalizeStepType(value: any): any;
-/** Normalize plan key from step input. */
-export declare function normalizePlanKey(step: any, index: number): string;
-/** Now ISO string. */
-export declare function nowIso(): string;

package/dist/server/utils/logging.d.ts

@@ -1,6 +0,0 @@
-import { DelegationLogData } from '../types';
-/**
- * Log (or update) a delegation event in the orchestratorLogs collection.
- * Used by both delegate-task.ts and AgentHarness.ts.
- */
-export declare function logDelegation(ctx: any, plugin: any, data: DelegationLogData): Promise<any>;