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
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181

name: "Conditional Task Execution Demo"
version: "1.0.0"
dsl_version: "1.0.0"

# This workflow demonstrates various conditional task execution patterns

agents:
  analyzer:
    description: "Analyzes code and determines build requirements"
    model: "claude-sonnet-4-5"
    tools:
      - Read
      - Grep
    permissions:
      mode: "default"

  builder:
    description: "Builds the project"
    model: "claude-sonnet-4-5"
    tools:
      - Bash
    permissions:
      mode: "acceptEdits"

  tester:
    description: "Runs tests"
    model: "claude-sonnet-4-5"
    tools:
      - Bash
    permissions:
      mode: "default"

  deployer:
    description: "Deploys to production"
    model: "claude-sonnet-4-5"
    tools:
      - Bash
    permissions:
      mode: "plan"

tasks:
  # Always runs
  analyze_code:
    description: "Analyze code structure and dependencies"
    agent: "analyzer"
    priority: 0

  # Runs only if analyze_code completed successfully
  build_project:
    description: "Build the project"
    agent: "builder"
    depends_on:
      - "analyze_code"
    condition:
      type: "task_status"
      task: "analyze_code"
      status: "completed"

  # Runs only if build_project completed successfully
  run_tests:
    description: "Run test suite"
    agent: "tester"
    depends_on:
      - "build_project"
    condition:
      type: "task_status"
      task: "build_project"
      status: "completed"

  # Runs only if run_tests failed (emergency fix workflow)
  debug_tests:
    description: "Debug failing tests and apply fixes"
    agent: "tester"
    depends_on:
      - "run_tests"
    condition:
      type: "task_status"
      task: "run_tests"
      status: "failed"
    on_complete:
      notify: "Test debugging completed - review fixes"

  # Runs only if run_tests succeeded AND environment is production
  deploy_production:
    description: "Deploy to production environment"
    agent: "deployer"
    depends_on:
      - "run_tests"
    condition:
      and:
        - type: "task_status"
          task: "run_tests"
          status: "completed"
        - type: "state_equals"
          key: "environment"
          value: "production"
    on_complete:
      notify: "Production deployment completed"

  # Runs only if run_tests succeeded AND environment is NOT production
  deploy_staging:
    description: "Deploy to staging environment"
    agent: "deployer"
    depends_on:
      - "run_tests"
    condition:
      and:
        - type: "task_status"
          task: "run_tests"
          status: "completed"
        - not:
            type: "state_equals"
            key: "environment"
            value: "production"
    on_complete:
      notify: "Staging deployment completed"

  # Skipped task example - demonstrates a task that never runs
  experimental_feature:
    description: "Experimental feature - currently disabled"
    agent: "builder"
    condition:
      type: "never"

  # Complex conditional: runs if EITHER build failed OR tests failed
  send_failure_notification:
    description: "Send notification about build/test failures"
    agent: "deployer"
    depends_on:
      - "build_project"
      - "run_tests"
    condition:
      or:
        - type: "task_status"
          task: "build_project"
          status: "failed"
        - type: "task_status"
          task: "run_tests"
          status: "failed"
    on_complete:
      notify: "Failure notification sent to team"

workflows:
  ci_cd_pipeline:
    description: "CI/CD pipeline with conditional deployment"
    steps:
      - stage: "analysis"
        agents:
          - "analyzer"
        tasks:
          - analyze_code:
              description: "Analyze code structure"
              agent: "analyzer"

      - stage: "build_and_test"
        depends_on:
          - "analysis"
        agents:
          - "builder"
          - "tester"
        tasks:
          - build_project:
              description: "Build the project"
              agent: "builder"
          - run_tests:
              description: "Run tests"
              agent: "tester"

      - stage: "deploy"
        depends_on:
          - "build_and_test"
        agents:
          - "deployer"
        mode: "parallel"
        tasks:
          - deploy_production:
              description: "Deploy to production"
              agent: "deployer"
          - deploy_staging:
              description: "Deploy to staging"
              agent: "deployer"