@ai-setting/roy-agent-cli 1.3.14 → 1.3.16

package/dist/cli/src/commands/workflow/commands/nodes.js

@@ -0,0 +1,465 @@
+/**
+ * @fileoverview Workflow Nodes Command
+ *
+ * List all built-in node types with their input/output descriptions
+ */
+import chalk from 'chalk';
+/**
+ * Common parameters supported by all node types
+ */
+const COMMON_PARAMS = [
+    {
+        name: 'depends_on',
+        type: 'string[]',
+        required: false,
+        description: 'List of node IDs that must complete before this node runs',
+    },
+    {
+        name: 'timeout',
+        type: 'number',
+        required: false,
+        description: 'Execution timeout in milliseconds (default: 30000)',
+    },
+    {
+        name: 'retry',
+        type: 'object',
+        required: false,
+        description: 'Retry config: {max_attempts, backoff: "fixed"|"exponential", initial_delay}',
+    },
+];
+/**
+ * Built-in node type definitions
+ */
+export const BUILT_IN_NODES = [
+    // =========================================================================
+    // Tool Node
+    // =========================================================================
+    {
+        name: 'ToolNode',
+        type: 'tool',
+        description: 'Execute a registered tool. Tools are atomic operations that perform specific tasks like bash, file operations, or API calls. Supports template resolution for input values.',
+        inputs: [
+            {
+                name: 'tool / toolName',
+                type: 'string',
+                required: true,
+                description: 'Name of the registered tool to execute (e.g., bash, read-file, web-search)',
+            },
+            {
+                name: 'input / args',
+                type: 'object',
+                required: false,
+                description: 'Key-value pairs passed to the tool (use input or args key). Supports template strings like {{nodes.nodeId.output}}',
+            },
+            {
+                name: 'command',
+                type: 'string',
+                required: false,
+                description: 'Single command string (for bash tool with {command: "..."} signature). Supports templates.',
+            },
+            {
+                name: 'message',
+                type: 'string',
+                required: false,
+                description: 'Single message string (for echo tool with {message: "..."} signature). Supports templates.',
+            },
+        ],
+        output: '{output: any, error?: Error, durationMs: number}',
+        example: `# Example 1: Execute bash command
+nodes:
+  run-tests:
+    type: tool
+    config:
+      tool: bash
+      input:
+        command: "npm test"
+
+# Example 2: Read file with template reference
+nodes:
+  read-config:
+    type: tool
+    config:
+      tool: read-file
+      input:
+        path: "{{input.configPath}}"
+
+# Example 3: Web search
+nodes:
+  search:
+    type: tool
+    config:
+      tool: web-search
+      input:
+        query: "AI news"
+        numResults: 5`,
+    },
+    // =========================================================================
+    // Skill Node
+    // =========================================================================
+    {
+        name: 'SkillNode',
+        type: 'skill',
+        description: 'Invoke a skill processor. Skills are higher-level operations that combine multiple tools and logic for complex tasks. Supports template resolution for input values.',
+        inputs: [
+            {
+                name: 'skill',
+                type: 'string',
+                required: true,
+                description: 'Name of the registered skill to invoke',
+            },
+            {
+                name: 'input',
+                type: 'object',
+                required: false,
+                description: 'Input parameters for the skill. Supports template strings like {{nodes.nodeId.output}}',
+            },
+        ],
+        output: '{output: any, error?: Error, durationMs: number}',
+        example: `# Example: Summarize text
+nodes:
+  summarize:
+    type: skill
+    config:
+      skill: text-summarizer
+      input:
+        content: "{{nodes.fetch.output}}"
+        maxLength: 200
+
+# Example: Code review
+nodes:
+  review:
+    type: skill
+    config:
+      skill: code-reviewer
+      input:
+        code: "{{input.code}}"
+        language: "{{input.language}}"`,
+    },
+    // =========================================================================
+    // Agent Node
+    // =========================================================================
+    {
+        name: 'AgentNode',
+        type: 'agent',
+        description: 'Run an AI agent with reasoning loop. Agents use LLM to reason, plan, and use tools for complex tasks. Supports workflow history for multi-agent collaboration. Prompt templates support {{input.key}} and {{nodes.nodeId.output}} interpolation.',
+        inputs: [
+            {
+                name: 'agent_type',
+                type: 'string',
+                required: true,
+                description: 'Agent type (e.g., general, research, coder, critic). Auto-registers if not found.',
+            },
+            {
+                name: 'prompt',
+                type: 'string',
+                required: true,
+                description: 'Prompt template (supports {{input.key}} and {{nodes.nodeId.output}} interpolation)',
+            },
+            {
+                name: 'options',
+                type: 'object',
+                required: false,
+                description: 'Execution options: {timeout?: number, model?: string}',
+            },
+            {
+                name: 'system_prompt / systemPrompt',
+                type: 'string',
+                required: false,
+                description: 'Custom system prompt for this agent (auto-generated if not provided)',
+            },
+        ],
+        output: '{result: any, metadata: {tokens?: number, duration?: number}, workflowHistory: [...]}',
+        example: `# Example: Research agent
+nodes:
+  analyze:
+    type: agent
+    config:
+      agent_type: research
+      prompt: |
+        Based on the data: {{nodes.fetch.output}}
+        Please analyze and provide insights.
+      options:
+        timeout: 60000
+        model: "minimax"
+
+# Example: Multi-agent with history
+nodes:
+  planner:
+    type: agent
+    config:
+      agent_type: general
+      prompt: "Plan the implementation for {{input.task}}"
+
+  executor:
+    type: agent
+    config:
+      agent_type: coder
+      prompt: "Implement the plan: {{nodes.planner.output}}"
+    depends_on:
+      - planner`,
+    },
+    // =========================================================================
+    // Workflow Node (Sub-workflow)
+    // =========================================================================
+    {
+        name: 'WorkflowNode',
+        type: 'workflow',
+        description: 'Execute a nested/sub workflow. Allows creating complex workflows by combining simpler ones. Supports template resolution for input values.',
+        inputs: [
+            {
+                name: 'workflow_name',
+                type: 'string',
+                required: true,
+                description: 'Name of the sub-workflow to execute',
+            },
+            {
+                name: 'input',
+                type: 'object',
+                required: false,
+                description: 'Input parameters for the sub-workflow. Supports template strings like {{nodes.nodeId.output}}',
+            },
+            {
+                name: 'wait_complete',
+                type: 'boolean',
+                required: false,
+                description: 'Whether to wait for sub-workflow completion (default: true)',
+            },
+        ],
+        output: '{success: boolean, output?: any, error?: string, duration: number}',
+        example: `# Example: Execute sub-workflow
+nodes:
+  data-process:
+    type: workflow
+    config:
+      workflow_name: data-processor
+      input:
+        data: "{{nodes.fetch.output}}"
+
+# Example: Sequential workflows
+nodes:
+  step1:
+    type: workflow
+    config:
+      workflow_name: preprocessing
+      input:
+        raw: "{{input.data}}"
+
+  step2:
+    type: workflow
+    config:
+      workflow_name: analysis
+      input:
+        cleaned: "{{nodes.step1.output}}"
+    depends_on:
+      - step1`,
+    },
+    // =========================================================================
+    // Condition Node
+    // =========================================================================
+    {
+        name: 'ConditionNode',
+        type: 'condition',
+        description: 'Evaluate a condition and decide workflow path. Supports boolean values, template expressions, and references to previous node outputs. Default to true if no condition specified.',
+        inputs: [
+            {
+                name: 'condition',
+                type: 'string | boolean',
+                required: false,
+                description: 'Condition to evaluate: boolean value, template {{nodeId.output.success}}, or template {{input.key}}. Defaults to true if not specified.',
+            },
+        ],
+        output: '{success: boolean, condition: resolved_value}',
+        example: `# Example: Check test results
+nodes:
+  run-tests:
+    type: tool
+    config:
+      tool: bash
+      input:
+        command: "npm test"
+
+  check-result:
+    type: condition
+    config:
+      condition: "{{run-tests.output.success}}"
+    depends_on:
+      - run-tests
+
+# Example: Check input value
+nodes:
+  validate:
+    type: condition
+    config:
+      condition: "{{input.validate}}"
+    depends_on: []`,
+    },
+    // =========================================================================
+    // Merge Node
+    // =========================================================================
+    {
+        name: 'MergeNode',
+        type: 'merge',
+        description: 'Collect and merge outputs from multiple dependency nodes. Supports strategies: collect (default), first, last, merge.',
+        inputs: [
+            {
+                name: 'strategy',
+                type: 'string',
+                required: false,
+                description: 'Merge strategy: collect (default, returns map), first (returns first output), last (returns last output), merge (deep merge objects)',
+            },
+        ],
+        output: '{strategy: string, results: any, count: number}',
+        example: `# Example: Collect parallel results
+nodes:
+  parallel-fetch:
+    type: merge
+    config:
+      strategy: collect
+    depends_on:
+      - fetch-user
+      - fetch-orders
+      - fetch-preferences
+
+# Example: Get first successful result
+nodes:
+  first-success:
+    type: merge
+    config:
+      strategy: first
+    depends_on:
+      - primary-source
+      - backup-source
+
+# Example: Merge objects
+nodes:
+  merge-data:
+    type: merge
+    config:
+      strategy: merge
+    depends_on:
+      - metadata
+      - content
+      - analytics`,
+    },
+    // =========================================================================
+    // Decorator Node
+    // =========================================================================
+    {
+        name: 'DecoratorNode',
+        type: 'decorator',
+        description: 'Execute a class method decorated with @Workflow or @NodeAs. Supports retry logic and timeout. Automatically extracts output from decorated methods.',
+        inputs: [
+            {
+                name: '_methodName',
+                type: 'string',
+                required: true,
+                description: 'Name of the decorated method to execute',
+            },
+            {
+                name: '_instance',
+                type: 'object',
+                required: true,
+                description: 'Class instance containing the decorated method',
+            },
+            {
+                name: 'retry',
+                type: 'object',
+                required: false,
+                description: 'Retry config: {max_attempts: number, backoff: "fixed"|"exponential", initial_delay: number}',
+            },
+        ],
+        output: '{success: boolean, output?: any, error?: string, duration: number, metadata: {methodName: string}}',
+        example: `# Example: Execute decorated method
+nodes:
+  process-data:
+    type: decorator
+    config:
+      _methodName: "processData"
+      _instance: "{{input.workflowInstance}}"
+      timeout: 30000
+      retry:
+        max_attempts: 3
+        backoff: exponential
+        initial_delay: 1000
+    depends_on:
+      - fetch-data`,
+    },
+];
+/**
+ * Render node types table
+ */
+function renderNodeTypesTable(nodes) {
+    const lines = [];
+    lines.push(chalk.bold('\n📦 Built-in Node Types\n'));
+    lines.push('┌────────────┬────────────────────┬─────────────────────────────────────────────────────────────┐');
+    lines.push('│ Type       │ Name                │ Description                                               │');
+    lines.push('├────────────┼────────────────────┼─────────────────────────────────────────────────────────────┤');
+    for (const node of nodes) {
+        const type = node.type.padEnd(10);
+        const name = node.name.padEnd(18);
+        const desc = node.description.substring(0, 59).padEnd(59);
+        lines.push(`│ ${type} │ ${name} │ ${desc} │`);
+    }
+    lines.push('└────────────┴────────────────────┴─────────────────────────────────────────────────────────────┘');
+    return lines.join('\n');
+}
+/**
+ * Render detailed node information
+ */
+function renderNodeDetail(node) {
+    const lines = [];
+    lines.push(chalk.bold(`\n[${node.type}] ${node.name}`));
+    lines.push(chalk.dim('─'.repeat(60)) + '\n');
+    lines.push(chalk.bold('Description:'));
+    lines.push(`  ${node.description}\n`);
+    lines.push(chalk.bold('Configuration:'));
+    lines.push('  type: "' + node.type + '"');
+    lines.push('  config:');
+    for (const input of node.inputs) {
+        const required = input.required ? chalk.red('*') : ' ';
+        lines.push(`    ${input.name} (${input.type})${required}`);
+        lines.push(`      ${input.description}`);
+    }
+    lines.push(`\n${chalk.bold('Output:')} ${node.output}`);
+    if (node.example) {
+        lines.push(chalk.bold('\nExample:'));
+        lines.push(chalk.gray('```yaml'));
+        lines.push(node.example);
+        lines.push(chalk.gray('```'));
+    }
+    return lines.join('\n');
+}
+/**
+ * WorkflowNodesCommand - List built-in node types
+ */
+export const WorkflowNodesCommand = {
+    command: 'nodes [type]',
+    describe: '列出所有内置节点类型及其配置说明',
+    builder: (yargs) => yargs.positional('type', {
+        describe: '节点类型 (tool/skill/agent/workflow/condition/merge/decorator/end)',
+        type: 'string',
+    }),
+    async handler(args) {
+        const nodeType = args.type?.toLowerCase();
+        // List all node types
+        if (!nodeType) {
+            console.log(renderNodeTypesTable(BUILT_IN_NODES));
+            console.log(chalk.gray('\nUse ') +
+                chalk.cyan('roy workflow nodes <type>') +
+                chalk.gray(' for detailed information'));
+            console.log(chalk.gray('Available types: ') +
+                chalk.yellow(BUILT_IN_NODES.map((n) => n.type).join(', ')));
+            return;
+        }
+        // Show specific node type
+        const node = BUILT_IN_NODES.find((n) => n.type === nodeType);
+        if (!node) {
+            console.log(chalk.red(`\n❌ Unknown node type: ${nodeType}`));
+            console.log(chalk.gray('Available types: ') +
+                chalk.yellow(BUILT_IN_NODES.map((n) => n.type).join(', ')));
+            process.exit(1);
+        }
+        console.log(renderNodeDetail(node));
+    },
+};
+//# sourceMappingURL=nodes.js.map

package/dist/cli/src/commands/workflow/commands/remove.d.ts

@@ -0,0 +1,16 @@
+/**
+ * @fileoverview Workflow Remove Command
+ *
+ * Delete a workflow
+ */
+import { CommandModule } from 'yargs';
+export interface WorkflowRemoveOptions {
+    name: string;
+    force?: boolean;
+    config?: string;
+}
+/**
+ * WorkflowRemoveCommand - Delete a workflow
+ */
+export declare const WorkflowRemoveCommand: CommandModule<object, WorkflowRemoveOptions>;
+//# sourceMappingURL=remove.d.ts.map

package/dist/cli/src/commands/workflow/commands/remove.js

@@ -0,0 +1,77 @@
+/**
+ * @fileoverview Workflow Remove Command
+ *
+ * Delete a workflow
+ */
+import { EnvironmentService } from "../../../services/environment.service.js";
+import { OutputService } from "../../../services/output.service.js";
+import { renderWorkflowDeleted } from "../renderers.js";
+import chalk from 'chalk';
+/**
+ * WorkflowRemoveCommand - Delete a workflow
+ */
+export const WorkflowRemoveCommand = {
+    command: 'remove <name>',
+    describe: '删除 Workflow',
+    builder: (yargs) => yargs
+        .positional('name', {
+        describe: 'Workflow 名称',
+        type: 'string',
+        demandOption: true,
+    })
+        .option('force', {
+        alias: 'f',
+        describe: '强制删除（不确认）',
+        type: 'boolean',
+        default: false,
+    })
+        .option('config', {
+        describe: '配置文件路径',
+        type: 'string',
+    }),
+    async handler(args) {
+        const output = new OutputService();
+        const envService = new EnvironmentService(output);
+        try {
+            await envService.create({ configPath: args.config });
+            const env = envService.getEnvironment();
+            if (!env) {
+                output.error("Failed to create environment");
+                process.exit(1);
+            }
+            const workflowComponent = env.getComponent('workflow');
+            if (!workflowComponent) {
+                output.error('WorkflowComponent not available');
+                process.exit(1);
+            }
+            const service = workflowComponent.getService();
+            // Check if workflow exists
+            const existing = service.getWorkflow(args.name);
+            if (!existing) {
+                output.error(`Workflow not found: ${args.name}`);
+                process.exit(1);
+            }
+            // Confirm deletion if not forced
+            if (!args.force) {
+                output.log(chalk.yellow(`Are you sure you want to delete workflow '${args.name}'?`));
+                output.log(chalk.gray('Use --force to skip confirmation'));
+                process.exit(1);
+            }
+            // Delete workflow
+            const deleted = await service.deleteWorkflow(args.name);
+            if (!deleted) {
+                output.error(`Failed to delete workflow: ${args.name}`);
+                process.exit(1);
+            }
+            output.log(renderWorkflowDeleted(args.name));
+        }
+        catch (error) {
+            output.error(`Failed to delete workflow: ${error}`);
+            process.exit(1);
+        }
+        finally {
+            await envService.dispose();
+        }
+    },
+};
+//# sourceMappingURL=remove.js.map

package/dist/cli/src/commands/workflow/commands/run.d.ts

@@ -0,0 +1,32 @@
+/**
+ * @fileoverview Workflow Run Command
+ *
+ * Run a workflow from file or by name
+ *
+ * Workflow execution model:
+ * - run starts the workflow
+ * - if ask_user is triggered, workflow stops with status='paused'
+ * - resume with: workflow run -s <sessionId> --input "response"
+ *
+ * OpenTelemetry W3C TraceContext Support:
+ * - Supports TRACEPARENT environment variable for trace context propagation
+ * - When running via bash tool from interactive mode, TRACEPARENT is passed
+ * - The traceId and parentSpanId are extracted from TRACEPARENT
+ */
+import { CommandModule } from 'yargs';
+export interface WorkflowRunOptions {
+    identifier: string;
+    debug?: boolean;
+    input?: string;
+    parallelLimit?: number;
+    timeout?: number;
+    watch?: boolean;
+    file?: boolean;
+    name?: string;
+    registerOnly?: boolean;
+    config?: string;
+    /** Resume from existing session */
+    sessionId?: string;
+}
+export declare const WorkflowRunCommand: CommandModule<object, WorkflowRunOptions>;
+//# sourceMappingURL=run.d.ts.map