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

# Full-Stack Deployment - Complete application deployment workflow
name: "fullstack_deployment"
version: "1.0"

agents:
  frontend_agent:
    description: "Manages frontend deployment"
    model: "claude-sonnet-4-5"
    tools: ["Bash", "Read", "Write"]
    permissions:
      mode: "default"
      allowed_directories: ["/app/frontend"]
    max_turns: 12

  backend_agent:
    description: "Manages backend deployment"
    model: "claude-sonnet-4-5"
    tools: ["Bash", "Read", "Write"]
    permissions:
      mode: "default"
      allowed_directories: ["/app/backend"]
    max_turns: 12

  database_agent:
    description: "Manages database migrations"
    model: "claude-sonnet-4-5"
    tools: ["Bash", "Read", "Write"]
    permissions:
      mode: "default"
      allowed_directories: ["/app/db"]
    max_turns: 10

  integration_agent:
    description: "Runs integration tests"
    model: "claude-sonnet-4-5"
    tools: ["Bash", "Read"]
    permissions:
      mode: "default"
      allowed_directories: ["/app"]
    max_turns: 15

tasks:
  prepare_database:
    description: "Run database migrations and seed data"
    agent: "database_agent"
    priority: 1
    output: "db_migration.log"

  deploy_backend:
    description: "Deploy backend services"
    agent: "backend_agent"
    depends_on: ["prepare_database"]
    output: "backend_deploy.log"

  deploy_frontend:
    description: "Deploy frontend application"
    agent: "frontend_agent"
    depends_on: ["deploy_backend"]
    output: "frontend_deploy.log"

  run_integration_tests:
    description: "Execute integration test suite"
    agent: "integration_agent"
    depends_on: ["deploy_frontend"]
    output: "integration_tests.log"

  health_check:
    description: "Verify all services are healthy"
    agent: "integration_agent"
    depends_on: ["run_integration_tests"]
    output: "health_check.log"

workflows:
  full_deployment:
    description: "Multi-stage full-stack application deployment"
    steps:
      - stage: "database"
        agents: ["database_agent"]
        tasks:
          - prepare_database:
              description: "Run database migrations and seed data"
        mode: sequential

      - stage: "backend"
        agents: ["backend_agent"]
        tasks:
          - deploy_backend:
              description: "Deploy backend services"
        mode: sequential
        depends_on: ["database"]

      - stage: "frontend"
        agents: ["frontend_agent"]
        tasks:
          - deploy_frontend:
              description: "Deploy frontend application"
        mode: sequential
        depends_on: ["backend"]

      - stage: "verification"
        agents: ["integration_agent"]
        tasks:
          - run_integration_tests:
              description: "Execute integration test suite"
          - health_check:
              description: "Verify all services are healthy"
        mode: sequential
        depends_on: ["frontend"]

    hooks:
      pre_workflow:
        - "echo 'Starting full-stack deployment'"

      post_workflow:
        - "echo 'Deployment complete and verified'"

      on_stage_complete:
        - "echo 'Completed stage: $WORKFLOW_STAGE'"

tools:
  allowed: ["Bash", "Read", "Write"]