plugin-agent-orchestrator 1.0.21 → 1.0.23

package/dist/client/hooks/useRunEventStream.d.ts

@@ -1,22 +0,0 @@
-export interface RunEvent {
-    id: string | number;
-    runId: string | number;
-    type: string;
-    title: string;
-    content?: string;
-    status?: string;
-    createdAt?: string;
-    payload?: any;
-}
-export interface UseRunEventStreamResult {
-    events: RunEvent[];
-    isConnected: boolean;
-    error: string | null;
-}
-/**
- * React hook that opens an SSE connection to receive real-time agent loop events.
- *
- * On reconnect (EventSource auto-reconnects), missed events should be fetched
- * from the REST endpoint by the caller if needed.
- */
-export declare function useRunEventStream(runId: string | number | undefined): UseRunEventStreamResult;

package/dist/client/index.d.ts

@@ -1,2 +0,0 @@
-export { default } from './plugin';
-export { useRunEventStream } from './hooks/useRunEventStream';

package/dist/client/plugin.d.ts

@@ -1,6 +0,0 @@
-import { Plugin } from '@nocobase/client';
-export declare class PluginAgentOrchestratorClient extends Plugin {
-    load(): Promise<void>;
-    private registerSkillUiCards;
-}
-export default PluginAgentOrchestratorClient;

package/dist/client/skill-hub/components/ExecutionHistory.d.ts

@@ -1,2 +0,0 @@
-import React from 'react';
-export declare const ExecutionHistory: React.FC;

package/dist/client/skill-hub/components/ExecutionProgress.d.ts

@@ -1,20 +0,0 @@
-import React from 'react';
-interface ExecutionProgressProps {
-    execId: string;
-    skillName: string;
-    percent: number;
-    log: string;
-}
-/**
- * Progress component rendered inside chat UI when receiving
- * SSE custom event: {action: "skillProgress", body: {...}}
- *
- * Usage in chat message renderer:
- * ```
- * if (event.action === 'skillProgress') {
- *   return <ExecutionProgress {...event.body} />;
- * }
- * ```
- */
-export declare const ExecutionProgress: React.FC<ExecutionProgressProps>;
-export {};

package/dist/client/skill-hub/components/GitSkillImport.d.ts

@@ -1,7 +0,0 @@
-import React from 'react';
-interface GitSkillImportProps {
-    open: boolean;
-    onClose: (synced?: boolean) => void;
-}
-export declare const GitSkillImport: React.FC<GitSkillImportProps>;
-export {};

package/dist/client/skill-hub/components/LoopSettings.d.ts

@@ -1,2 +0,0 @@
-import React from 'react';
-export declare const LoopSettings: React.FC;

package/dist/client/skill-hub/components/SkillEditor.d.ts

@@ -1,7 +0,0 @@
-import React from 'react';
-interface SkillEditorProps {
-    skill: any | null;
-    onClose: (saved?: boolean) => void;
-}
-export declare const SkillEditor: React.FC<SkillEditorProps>;
-export {};

package/dist/client/skill-hub/components/SkillManager.d.ts

@@ -1,2 +0,0 @@
-import React from 'react';
-export declare const SkillManager: React.FC;

package/dist/client/skill-hub/components/SkillMetrics.d.ts

@@ -1,2 +0,0 @@
-import React from 'react';
-export declare const SkillMetrics: React.FC;

package/dist/client/skill-hub/components/SkillTestPanel.d.ts

@@ -1,7 +0,0 @@
-import React from 'react';
-interface SkillTestPanelProps {
-    skill: any;
-    onClose: () => void;
-}
-export declare const SkillTestPanel: React.FC<SkillTestPanelProps>;
-export {};

package/dist/client/skill-hub/index.d.ts

@@ -1,11 +0,0 @@
-import { Plugin } from '@nocobase/client';
-import { SkillManager } from './components/SkillManager';
-import { ExecutionHistory } from './components/ExecutionHistory';
-import { SkillMetrics } from './components/SkillMetrics';
-import { LoopSettings } from './components/LoopSettings';
-export declare class PluginSkillHubClient extends Plugin {
-    load(): Promise<void>;
-    private registerSkillUiCards;
-}
-export { SkillManager, ExecutionHistory, SkillMetrics, LoopSettings };
-export default PluginSkillHubClient;

package/dist/client/skill-hub/locale.d.ts

@@ -1,3 +0,0 @@
-export declare const namespace = "plugin-agent-orchestrator";
-export declare function useT(): (str: string, options?: any) => string;
-export declare function tStr(key: string): string;

package/dist/client/skill-hub/tools/InteractionSchemasProvider.d.ts

@@ -1,6 +0,0 @@
-import React from 'react';
-import { InteractionSchema } from './loopTemplates';
-export declare const useInteractionSchemas: () => Map<string, InteractionSchema>;
-export declare const InteractionSchemasProvider: React.FC<{
-    children?: React.ReactNode;
-}>;

package/dist/client/skill-hub/tools/SkillHubCard.d.ts

@@ -1,3 +0,0 @@
-import React from 'react';
-import { ToolsUIProperties } from '@nocobase/client';
-export declare const SkillHubCard: React.FC<ToolsUIProperties>;

package/dist/client/skill-hub/tools/loopTemplates.d.ts

@@ -1,22 +0,0 @@
-export type InteractionSchema = {
-    type: 'form' | 'select' | 'confirm';
-    prompt: string;
-    options?: {
-        label: string;
-        value: string | number;
-    }[];
-    fields?: Record<string, {
-        type?: string;
-        title?: string;
-        required?: boolean;
-        enum?: any[];
-    }>;
-};
-export type LoopTemplate = {
-    key: string;
-    title: string;
-    description: string;
-    schema: InteractionSchema;
-};
-export declare const LOOP_TEMPLATES: LoopTemplate[];
-export declare function getLoopTemplate(key?: string): LoopTemplate;

package/dist/client/skill-hub/tools/registerSkillLoopCards.d.ts

@@ -1 +0,0 @@
-export declare function registerSkillLoopCards(app: any): Promise<void>;

package/dist/client/skill-hub/utils/jsonFields.d.ts

@@ -1,3 +0,0 @@
-export declare function parseJsonText<T = any>(value: any, fallback: T): T;
-export declare function formatJsonText(value: any, fallback?: any): string;
-export declare function stringifyJsonText(value: any, fallback?: any): string;

package/dist/client/tools/PlanApprovalCard.d.ts

@@ -1,3 +0,0 @@
-import React from 'react';
-import { ToolsUIProperties } from '@nocobase/client';
-export declare const PlanApprovalCard: React.FC<ToolsUIProperties>;

package/dist/client/tools/registerOrchestratorCards.d.ts

@@ -1 +0,0 @@
-export declare function registerOrchestratorCards(app: any): Promise<void>;

package/dist/index.d.ts

@@ -1,2 +0,0 @@
-export * from './server';
-export { default } from './server';

package/dist/server/collections/agent-execution-spans.d.ts

@@ -1,9 +0,0 @@
-/**
- * Unified execution graph for agent orchestration.
- *
- * A root run can contain sub-agent spans and child tool/skill spans. Skill Hub
- * keeps its own sandbox execution records; this collection stores the flow
- * relationship and links to those records when applicable.
- */
-declare const _default: import("@nocobase/database").CollectionOptions;
-export default _default;

package/dist/server/collections/agent-harness-profiles.d.ts

@@ -1,2 +0,0 @@
-declare const _default: import("@nocobase/database").CollectionOptions;
-export default _default;

package/dist/server/collections/agent-loop-events.d.ts

@@ -1,2 +0,0 @@
-declare const _default: import("@nocobase/database").CollectionOptions;
-export default _default;

package/dist/server/collections/agent-loop-runs.d.ts

@@ -1,2 +0,0 @@
-declare const _default: import("@nocobase/database").CollectionOptions;
-export default _default;

package/dist/server/collections/agent-loop-steps.d.ts

@@ -1,2 +0,0 @@
-declare const _default: import("@nocobase/database").CollectionOptions;
-export default _default;

package/dist/server/collections/orchestrator-config.d.ts

@@ -1,2 +0,0 @@
-declare const _default: import("@nocobase/database").CollectionOptions;
-export default _default;

package/dist/server/collections/orchestrator-logs.d.ts

@@ -1,8 +0,0 @@
-/**
- * Stores delegation execution logs for Swarm Tracing (Phase 5).
- *
- * Since createReactAgent doesn't create aiConversation records,
- * we log delegation events to a dedicated table for observability.
- */
-declare const _default: import("@nocobase/database").CollectionOptions;
-export default _default;

package/dist/server/collections/skill-definitions.d.ts

@@ -1,3 +0,0 @@
-import { CollectionOptions } from '@nocobase/database';
-declare const _default: CollectionOptions;
-export default _default;

package/dist/server/collections/skill-executions.d.ts

@@ -1,3 +0,0 @@
-import { CollectionOptions } from '@nocobase/database';
-declare const _default: CollectionOptions;
-export default _default;

package/dist/server/collections/skill-loop-configs.d.ts

@@ -1,3 +0,0 @@
-import { CollectionOptions } from '@nocobase/database';
-declare const _default: CollectionOptions;
-export default _default;

package/dist/server/collections/skill-worker-configs.d.ts

@@ -1,3 +0,0 @@
-import { CollectionOptions } from '@nocobase/database';
-declare const _default: CollectionOptions;
-export default _default;

package/dist/server/migrations/20260423000000-add-progress-fields.d.ts

@@ -1,4 +0,0 @@
-import { Migration } from '@nocobase/server';
-export default class AddProgressFieldsMigration extends Migration {
-    up(): Promise<void>;
-}

package/dist/server/migrations/20260425000000-add-interaction-schema.d.ts

@@ -1,4 +0,0 @@
-import { Migration } from '@nocobase/server';
-export default class AddInteractionSchemaMigration extends Migration {
-    up(): Promise<void>;
-}

package/dist/server/migrations/20260427000000-add-tracing-detail-fields.d.ts

@@ -1,7 +0,0 @@
-import { Migration } from '@nocobase/server';
-export default class AddTracingDetailFieldsMigration extends Migration {
-    on: string;
-    appVersion: string;
-    up(): Promise<void>;
-    down(): Promise<void>;
-}

package/dist/server/migrations/20260427000000-change-packages-to-text.d.ts

@@ -1,4 +0,0 @@
-import { Migration } from '@nocobase/server';
-export default class ChangePackagesToTextMigration extends Migration {
-    up(): Promise<void>;
-}

package/dist/server/migrations/20260427000001-change-other-json-to-text.d.ts

@@ -1,4 +0,0 @@
-import { Migration } from '@nocobase/server';
-export default class ChangeOtherJsonToTextMigration extends Migration {
-    up(): Promise<void>;
-}

package/dist/server/migrations/20260429000000-add-llm-fields.d.ts

@@ -1,7 +0,0 @@
-import { Migration } from '@nocobase/server';
-export default class AddLlmFieldsToOrchestratorConfig extends Migration {
-    on: string;
-    appVersion: string;
-    up(): Promise<void>;
-    down(): Promise<void>;
-}

package/dist/server/migrations/20260429000000-fix-inputargs-json-to-text.d.ts

@@ -1,16 +0,0 @@
-import { Migration } from '@nocobase/server';
-/**
- * Fix: inputArgs column in skillExecutions was json type but should be text.
- *
- * Root cause: The column was created as `json` from an older schema version,
- * but the collection defines it as `text`. The `stringifyJsonText()` utility
- * wraps values in markdown code fences (```json\n...\n```) which PostgreSQL
- * rejects as invalid JSON syntax, causing SequelizeDatabaseError on every
- * skill execution attempt.
- */
-export default class FixInputArgsJsonToText extends Migration {
-    on: string;
-    appVersion: string;
-    up(): Promise<void>;
-    down(): Promise<void>;
-}

package/dist/server/migrations/20260503000000-add-orchestrator-trace-fields.d.ts

@@ -1,7 +0,0 @@
-import { Migration } from '@nocobase/server';
-export default class AddOrchestratorTraceFieldsToSkillExecutions extends Migration {
-    on: string;
-    appVersion: string;
-    up(): Promise<void>;
-    down(): Promise<void>;
-}

package/dist/server/migrations/20260524000000-add-agent-loop-fields-to-skill-executions.d.ts

@@ -1,7 +0,0 @@
-import { Migration } from '@nocobase/server';
-export default class AddAgentLoopFieldsToSkillExecutions extends Migration {
-    on: string;
-    appVersion: string;
-    up(): Promise<void>;
-    down(): Promise<void>;
-}

package/dist/server/migrations/20260524001000-add-plan-approval-and-harness-profiles.d.ts

@@ -1,12 +0,0 @@
-import { Migration } from '@nocobase/server';
-export default class AddPlanApprovalAndHarnessProfiles extends Migration {
-    on: string;
-    appVersion: string;
-    up(): Promise<void>;
-    addRunColumns(queryInterface: any, tableName: string): Promise<void>;
-    addStepColumns(queryInterface: any, tableName: string): Promise<void>;
-    addConfigColumns(queryInterface: any, tableName: string): Promise<void>;
-    ensureHarnessProfiles(queryInterface: any, tableName: string): Promise<void>;
-    seedDefaultProfiles(): Promise<void>;
-    down(): Promise<void>;
-}

package/dist/server/migrations/20260601000000-add-token-fields.d.ts

@@ -1,7 +0,0 @@
-import { Migration } from '@nocobase/server';
-export default class AddTokenFieldsMigration extends Migration {
-    on: string;
-    appVersion: string;
-    up(): Promise<void>;
-    down(): Promise<void>;
-}

package/dist/server/plugin.d.ts

@@ -1,16 +0,0 @@
-import { Plugin } from '@nocobase/server';
-import SkillHubSubFeature from './skill-hub/plugin';
-import { AgentLoopService } from './services/AgentLoopService';
-export declare class PluginAgentOrchestratorServer extends Plugin {
-    skillHub: SkillHubSubFeature;
-    agentLoopService: AgentLoopService;
-    afterAdd(): Promise<void>;
-    beforeLoad(): Promise<void>;
-    load(): Promise<void>;
-    install(): Promise<void>;
-    afterEnable(): Promise<void>;
-    afterDisable(): Promise<void>;
-    remove(): Promise<void>;
-    beforeStop(): Promise<void>;
-}
-export default PluginAgentOrchestratorServer;

package/dist/server/resources/agent-loop.d.ts

@@ -1,3 +0,0 @@
-import { Plugin } from '@nocobase/server';
-import { AgentLoopService } from '../services/AgentLoopService';
-export declare function registerAgentLoopResource(plugin: Plugin, service: AgentLoopService): void;

package/dist/server/resources/tracing.d.ts

@@ -1,7 +0,0 @@
-import { Plugin } from '@nocobase/server';
-/**
- * Custom resource for the Swarm Tracing admin UI (Phase 5).
- * Queries the dedicated orchestratorLogs collection instead of
- * filtering aiConversations by JSONB (P2 fix: DB-engine agnostic).
- */
-export declare function registerTracingResource(plugin: Plugin): void;

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

@@ -1,44 +0,0 @@
-import { AgentRegistryService } from './AgentRegistryService';
-export declare class AgentHarness {
-    private readonly plugin;
-    private readonly registryService;
-    private readonly spanService;
-    private readonly tokenTracker;
-    private readonly contextAggregator;
-    constructor(plugin: any, registryService: AgentRegistryService);
-    get db(): any;
-    get app(): any;
-    executeStep(run: any, step: any, options?: {
-        userId?: string | number;
-        ctx?: any;
-    }): Promise<any>;
-    private invokeSubAgentStep;
-    private invokeNamedTool;
-    runSubAgent(ctx: any, options: {
-        leaderUsername: string;
-        subAgentUsername: string;
-        subAgentEmployee: any;
-        task: string;
-        context?: string;
-        currentDepth?: number;
-        currentPath?: string[];
-        maxDepth: number;
-        timeout: number;
-        toolCallId: string;
-        toolName: string;
-        llmService?: string;
-        model?: string;
-        recursionLimit?: number;
-        rootRunId?: string;
-        parentSpanId?: string;
-        agentLoopRunId?: string;
-        agentLoopStepId?: string;
-    }): Promise<{
-        status: "success";
-        content: string;
-    } | {
-        status: "error";
-        content: any;
-    }>;
-    private logDelegation;
-}

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