# officialboomi/boomi-agentstudio architecture

> Architecture diagram of the GitHub repository officialboomi/boomi-agentstudio, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-19). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/officialboomi/boomi-agentstudio
- Repository: https://github.com/officialboomi/boomi-agentstudio

## Overview

boomi-agentstudio is a Boomi Companion skill implemented as shell scripts for Agentstudio and Agent Control Tower operations. The documented workflow is to configure workspace credentials, verify them, then use the relevant command for deployment/environment operations, ACT access, or agent sessions. The tree also includes agent, tool, and source scripts, but no source excerpts were provided, so their internal call relationships cannot be established; edges below are limited to relationships documented in the README.

Main entry points: [`scripts/agentstudio-session.sh`](https://github.com/officialboomi/boomi-agentstudio/blob/main/scripts/agentstudio-session.sh) (Agent session), [`scripts/agentstudio-env-check.sh`](https://github.com/officialboomi/boomi-agentstudio/blob/main/scripts/agentstudio-env-check.sh) (Environment check), [`scripts/agentstudio-deployment.sh`](https://github.com/officialboomi/boomi-agentstudio/blob/main/scripts/agentstudio-deployment.sh) (Deployment operations), [`scripts/agentstudio-act.sh`](https://github.com/officialboomi/boomi-agentstudio/blob/main/scripts/agentstudio-act.sh) (ACT operations)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_setup["Setup and checks"]
  node_envcheck["Environment check"]
end

subgraph group_agentstudio["Agentstudio operations"]
  node_agent["Agent operations"]
  node_source["Source operations"]
  node_tool["Tool operations"]
  node_deployment["Deployment operations"]
  node_session["Agent session"]
end

subgraph group_act["Control Tower"]
  node_actcli["ACT operations<br/>[agentstudio-act.sh]"]
  node_registry["ACT registry<br/>[act_registry.md]"]
  node_metrics["ACT metrics<br/>[act_metric.md]"]
end

subgraph group_shared["Shared scripts"]
  node_common["Shared helpers"]
end

node_user(("Developer"))
node_execute{{"Execute API"}}
node_design{{"Design API"}}

node_user -->|"verifies setup"| node_envcheck
node_user -->|"lists environments"| node_deployment
node_user -->|"checks access"| node_actcli
node_user -->|"starts session"| node_session
node_session -->|"calls API"| node_execute

click node_envcheck "https://github.com/officialboomi/boomi-agentstudio/blob/main/scripts/agentstudio-env-check.sh"
click node_common "https://github.com/officialboomi/boomi-agentstudio/blob/main/scripts/agentstudio-common.sh"
click node_agent "https://github.com/officialboomi/boomi-agentstudio/blob/main/scripts/agentstudio-agent.sh"
click node_source "https://github.com/officialboomi/boomi-agentstudio/blob/main/scripts/agentstudio-source.sh"
click node_tool "https://github.com/officialboomi/boomi-agentstudio/blob/main/scripts/agentstudio-tool.sh"
click node_deployment "https://github.com/officialboomi/boomi-agentstudio/blob/main/scripts/agentstudio-deployment.sh"
click node_session "https://github.com/officialboomi/boomi-agentstudio/blob/main/scripts/agentstudio-session.sh"
click node_actcli "https://github.com/officialboomi/boomi-agentstudio/blob/main/scripts/agentstudio-act.sh"
click node_registry "https://github.com/officialboomi/boomi-agentstudio/blob/main/references/act_registry.md"
click node_metrics "https://github.com/officialboomi/boomi-agentstudio/blob/main/references/act_metric.md"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_envcheck toneBlue
class node_agent,node_source,node_tool,node_deployment,node_session toneAmber
class node_actcli,node_registry,node_metrics,node_execute,node_design toneMint
class node_common toneRose
class node_user toneIndigo
```

## Components

### Setup and checks

- [Environment check](https://github.com/officialboomi/boomi-agentstudio/blob/main/scripts/agentstudio-env-check.sh): `scripts/agentstudio-env-check.sh`

### Agentstudio operations

- [Agent operations](https://github.com/officialboomi/boomi-agentstudio/blob/main/scripts/agentstudio-agent.sh): `scripts/agentstudio-agent.sh`
- [Source operations](https://github.com/officialboomi/boomi-agentstudio/blob/main/scripts/agentstudio-source.sh): `scripts/agentstudio-source.sh`
- [Tool operations](https://github.com/officialboomi/boomi-agentstudio/blob/main/scripts/agentstudio-tool.sh): `scripts/agentstudio-tool.sh`
- [Deployment operations](https://github.com/officialboomi/boomi-agentstudio/blob/main/scripts/agentstudio-deployment.sh): `scripts/agentstudio-deployment.sh`
- [Agent session](https://github.com/officialboomi/boomi-agentstudio/blob/main/scripts/agentstudio-session.sh): `scripts/agentstudio-session.sh`

### Control Tower

- [ACT operations](https://github.com/officialboomi/boomi-agentstudio/blob/main/scripts/agentstudio-act.sh): `scripts/agentstudio-act.sh`
- [ACT registry](https://github.com/officialboomi/boomi-agentstudio/blob/main/references/act_registry.md): `references/act_registry.md`
- [ACT metrics](https://github.com/officialboomi/boomi-agentstudio/blob/main/references/act_metric.md): `references/act_metric.md`

### Shared scripts

- [Shared helpers](https://github.com/officialboomi/boomi-agentstudio/blob/main/scripts/agentstudio-common.sh): `scripts/agentstudio-common.sh`

### Other components

- **Developer**
- **Execute API**
- **Design API**

## Connections

- Developer → Environment check: verifies setup (evidence: `README.md`)
- Developer → Deployment operations: lists environments (evidence: `README.md`)
- Developer → ACT operations: checks access (evidence: `README.md`)
- Developer → Agent session: starts session (evidence: `README.md`)
- Agent session → Execute API: calls API (evidence: `README.md`)
