periplon 0.2.0

Rust SDK for building multi-agent AI workflows and automation
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114

name: "Basic Task Groups Example"
version: "1.0.0"
description: |
  Demonstrates basic task group features:
  - Simple sequential groups
  - Parallel execution groups
  - Basic group properties

inputs:
  project_path:
    type: string
    required: true
    description: "Path to the project to analyze"

agents:
  analyzer:
    description: "Analyzes code quality and structure"
    tools: [Read, Grep, Glob]
    permissions:
      mode: "default"

  documenter:
    description: "Generates documentation"
    tools: [Read, Write]
    permissions:
      mode: "acceptEdits"

task_groups:
  # Sequential group - tasks run one after another
  sequential_analysis:
    description: "Run analysis tasks in sequence"
    execution_mode: "sequential"
    tasks:
      - check_syntax
      - check_structure
      - check_complexity

    # Group-level configuration
    on_error: "stop"  # Stop on first error
    timeout: 300      # 5 minute timeout for entire group

  # Parallel group - tasks run concurrently
  parallel_docs:
    description: "Generate documentation in parallel"
    execution_mode: "parallel"
    tasks:
      - gen_api_docs
      - gen_user_guide
      - gen_changelog

    on_error: "continue"  # Continue even if some tasks fail
    max_concurrency: 3    # Run up to 3 tasks at once

  # Mixed mode group
  mixed_workflow:
    description: "Mix of sequential and parallel execution"
    execution_mode: "auto"  # Auto-determine based on dependencies
    tasks:
      - prepare_environment
      - run_tests
      - generate_report

tasks:
  # Sequential analysis tasks
  check_syntax:
    description: "Check syntax errors in ${workflow.project_path}"
    agent: "analyzer"
    group: "sequential_analysis"

  check_structure:
    description: "Analyze code structure"
    agent: "analyzer"
    group: "sequential_analysis"
    depends_on: [check_syntax]

  check_complexity:
    description: "Calculate code complexity metrics"
    agent: "analyzer"
    group: "sequential_analysis"
    depends_on: [check_structure]

  # Parallel documentation tasks
  gen_api_docs:
    description: "Generate API documentation"
    agent: "documenter"
    group: "parallel_docs"

  gen_user_guide:
    description: "Generate user guide"
    agent: "documenter"
    group: "parallel_docs"

  gen_changelog:
    description: "Generate changelog from git history"
    agent: "documenter"
    group: "parallel_docs"

  # Mixed workflow tasks
  prepare_environment:
    description: "Set up test environment"
    agent: "analyzer"
    group: "mixed_workflow"

  run_tests:
    description: "Run test suite"
    agent: "analyzer"
    group: "mixed_workflow"
    depends_on: [prepare_environment]

  generate_report:
    description: "Generate final report"
    agent: "documenter"
    group: "mixed_workflow"
    depends_on: [run_tests]