plugin-agent-orchestrator 1.0.21 → 1.0.22

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;

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