# mikegc-aws/jev-strands-video architecture

> Architecture diagram of the GitHub repository mikegc-aws/jev-strands-video, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-07). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/mikegc-aws/jev-strands-video
- Repository: https://github.com/mikegc-aws/jev-strands-video

## Overview

This repository is a collection of runnable Jev/Strands demonstrations, not a shared application runtime. The workflows show Jev producing typed classifications or probabilities, followed by ordinary Python policy; the main branches demonstrate tool-call gating, completion intervention, and model switching. The README documents these relationships, but no source excerpts were provided, so the graph omits unverified implementation details.

Main entry points: [`demos/completion_intervention/main.py`](https://github.com/mikegc-aws/jev-strands-video/blob/main/demos/completion_intervention/main.py) (Strands agent), [`demos/model_switching/main.py`](https://github.com/mikegc-aws/jev-strands-video/blob/main/demos/model_switching/main.py) (Conversation agent), [`demos/jev_basics/jev_basics.ipynb`](https://github.com/mikegc-aws/jev-strands-video/blob/main/demos/jev_basics/jev_basics.ipynb) (Typed questions), [`demos/tool_call_intervention/main.py`](https://github.com/mikegc-aws/jev-strands-video/blob/main/demos/tool_call_intervention/main.py) (Strands agent)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_basics["Jev Basics"]
  node_basics_questions["Typed questions<br/>[jev_basics.ipynb]"]
  node_basics_policy["Python decision<br/>[jev_basics.ipynb]"]
end

subgraph group_tool["Tool Intervention"]
  node_tool_agent["Strands agent<br/>[main.py]"]
  node_tool_hook["Tool intervention<br/>[main.py]"]
  node_tool_policy["Call policy<br/>[main.py]"]
  node_tool_run["Tool execution<br/>[main.py]"]
end

subgraph group_completion["Completion Intervention"]
  node_completion_agent["Strands agent<br/>[main.py]"]
  node_completion_hook["After-call hook<br/>[main.py]"]
  node_completion_policy["Completion policy<br/>[main.py]"]
end

subgraph group_switching["Model Switching"]
  node_switch_agent["Conversation agent<br/>[main.py]"]
  node_switch_choice["Size choice<br/>[main.py]"]
  node_switch_policy["Model selection<br/>[main.py]"]
end

node_user(("Demo user"))
node_jev["Jev classifier"]
node_strands["Strands SDK"]
node_bedrock["Bedrock models"]

node_user -->|"runs demo"| node_basics_questions
node_basics_questions -->|"asks questions"| node_jev
node_basics_questions -->|"provides probabilities"| node_basics_policy
node_basics_policy -->|"makes decision"| node_user
node_user -->|"runs demo"| node_tool_agent
node_tool_agent -->|"offers proposed call"| node_tool_hook
node_tool_hook -->|"classifies call"| node_jev
node_tool_hook -->|"passes classification"| node_tool_policy
node_tool_policy -->|"proceeds or guides"| node_tool_run
node_tool_agent -->|"uses interventions"| node_strands
node_user -->|"runs demo"| node_completion_agent
node_completion_agent -->|"calls after model"| node_completion_hook
node_completion_hook -->|"classifies completion"| node_jev
node_completion_hook -->|"passes classification"| node_completion_policy
node_completion_policy -->|"guides or proceeds"| node_completion_agent
node_completion_agent -->|"uses interventions"| node_strands
node_user -->|"runs demo"| node_switch_agent
node_switch_agent -->|"requests size choice"| node_switch_choice
node_switch_choice -->|"chooses size"| node_jev
node_switch_choice -->|"returns choice"| node_switch_policy
node_switch_policy -->|"reassigns model"| node_switch_agent
node_switch_agent -->|"uses models"| node_bedrock

click node_basics_questions "https://github.com/mikegc-aws/jev-strands-video/blob/main/demos/jev_basics/jev_basics.ipynb"
click node_basics_policy "https://github.com/mikegc-aws/jev-strands-video/blob/main/demos/jev_basics/jev_basics.ipynb"
click node_tool_agent "https://github.com/mikegc-aws/jev-strands-video/blob/main/demos/tool_call_intervention/main.py"
click node_tool_hook "https://github.com/mikegc-aws/jev-strands-video/blob/main/demos/tool_call_intervention/main.py"
click node_tool_policy "https://github.com/mikegc-aws/jev-strands-video/blob/main/demos/tool_call_intervention/main.py"
click node_tool_run "https://github.com/mikegc-aws/jev-strands-video/blob/main/demos/tool_call_intervention/main.py"
click node_completion_agent "https://github.com/mikegc-aws/jev-strands-video/blob/main/demos/completion_intervention/main.py"
click node_completion_hook "https://github.com/mikegc-aws/jev-strands-video/blob/main/demos/completion_intervention/main.py"
click node_completion_policy "https://github.com/mikegc-aws/jev-strands-video/blob/main/demos/completion_intervention/main.py"
click node_switch_agent "https://github.com/mikegc-aws/jev-strands-video/blob/main/demos/model_switching/main.py"
click node_switch_choice "https://github.com/mikegc-aws/jev-strands-video/blob/main/demos/model_switching/main.py"
click node_switch_policy "https://github.com/mikegc-aws/jev-strands-video/blob/main/demos/model_switching/main.py"

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_basics_questions,node_basics_policy,node_user toneBlue
class node_tool_agent,node_tool_hook,node_tool_policy,node_tool_run toneAmber
class node_completion_agent,node_completion_hook,node_completion_policy toneMint
class node_switch_agent,node_switch_choice,node_switch_policy toneRose
class node_jev,node_strands,node_bedrock toneIndigo
```

## Components

### Jev Basics

- [Typed questions](https://github.com/mikegc-aws/jev-strands-video/blob/main/demos/jev_basics/jev_basics.ipynb): `demos/jev_basics/jev_basics.ipynb`
- [Python decision](https://github.com/mikegc-aws/jev-strands-video/blob/main/demos/jev_basics/jev_basics.ipynb): `demos/jev_basics/jev_basics.ipynb`

### Tool Intervention

- [Strands agent](https://github.com/mikegc-aws/jev-strands-video/blob/main/demos/tool_call_intervention/main.py): `demos/tool_call_intervention/main.py`
- [Tool intervention](https://github.com/mikegc-aws/jev-strands-video/blob/main/demos/tool_call_intervention/main.py): `demos/tool_call_intervention/main.py`
- [Call policy](https://github.com/mikegc-aws/jev-strands-video/blob/main/demos/tool_call_intervention/main.py): `demos/tool_call_intervention/main.py`
- [Tool execution](https://github.com/mikegc-aws/jev-strands-video/blob/main/demos/tool_call_intervention/main.py): `demos/tool_call_intervention/main.py`

### Completion Intervention

- [Strands agent](https://github.com/mikegc-aws/jev-strands-video/blob/main/demos/completion_intervention/main.py): `demos/completion_intervention/main.py`
- [After-call hook](https://github.com/mikegc-aws/jev-strands-video/blob/main/demos/completion_intervention/main.py): `demos/completion_intervention/main.py`
- [Completion policy](https://github.com/mikegc-aws/jev-strands-video/blob/main/demos/completion_intervention/main.py): `demos/completion_intervention/main.py`

### Model Switching

- [Conversation agent](https://github.com/mikegc-aws/jev-strands-video/blob/main/demos/model_switching/main.py): `demos/model_switching/main.py`
- [Size choice](https://github.com/mikegc-aws/jev-strands-video/blob/main/demos/model_switching/main.py): `demos/model_switching/main.py`
- [Model selection](https://github.com/mikegc-aws/jev-strands-video/blob/main/demos/model_switching/main.py): `demos/model_switching/main.py`

### Other components

- **Demo user**
- **Jev classifier**
- **Strands SDK**
- **Bedrock models**

## Connections

- Demo user → Typed questions: runs demo (evidence: `README.md`)
- Typed questions → Jev classifier: asks questions (evidence: `README.md`)
- Typed questions → Python decision: provides probabilities (evidence: `README.md`)
- Python decision → Demo user: makes decision (evidence: `README.md`)
- Demo user → Strands agent: runs demo (evidence: `README.md`)
- Strands agent → Tool intervention: offers proposed call (evidence: `README.md`)
- Tool intervention → Jev classifier: classifies call (evidence: `README.md`)
- Tool intervention → Call policy: passes classification (evidence: `README.md`)
- Call policy → Tool execution: proceeds or guides (evidence: `README.md`)
- Strands agent → Strands SDK: uses interventions (evidence: `README.md`)
- Demo user → Strands agent: runs demo (evidence: `README.md`)
- Strands agent → After-call hook: calls after model (evidence: `README.md`)
- After-call hook → Jev classifier: classifies completion (evidence: `README.md`)
- After-call hook → Completion policy: passes classification (evidence: `README.md`)
- Completion policy → Strands agent: guides or proceeds (evidence: `README.md`)
- Strands agent → Strands SDK: uses interventions (evidence: `README.md`)
- Demo user → Conversation agent: runs demo (evidence: `README.md`)
- Conversation agent → Size choice: requests size choice (evidence: `README.md`)
- Size choice → Jev classifier: chooses size (evidence: `README.md`)
- Size choice → Model selection: returns choice (evidence: `README.md`)
- Model selection → Conversation agent: reassigns model (evidence: `README.md`)
- Conversation agent → Bedrock models: uses models (evidence: `README.md`)
