plano/config/README.md

# Envoy filter code for gateway

## Add toolchain

```sh
$ rustup target add wasm32-wasip1
```

## Building

```sh
$ cargo build --target wasm32-wasip1 --release
```

## Testing
```sh
$ cargo test
```

## Local development
- Build docker image for Plano. Note this needs to be built once.
  ```
  $ sh build_filter_image.sh
  ```

- Build filter binary,
  ```
  $ cargo build --target wasm32-wasip1 --release
  ```
- Start envoy with config.yaml and test,
  ```
  $ docker compose -f docker-compose.dev.yaml up plano
  ```
- dev version of docker-compose file uses following files that are mounted inside the container. That means no docker rebuild is needed if any of these files change. Just restart the container and chagne will be picked up,
  - envoy.template.yaml
  - intelligent_prompt_gateway.wasm
Add initial scaffolding Signed-off-by: José Ulises Niño Rivera <junr03@users.noreply.github.com> 2024-07-10 10:06:02 -07:00			`# Envoy filter code for gateway`

comments Signed-off-by: José Ulises Niño Rivera <junr03@users.noreply.github.com> 2024-07-10 13:47:26 -07:00			`## Add toolchain`

			```sh
update rust toolchain to 1.82 (#255) * update rust to 1.82 pin it, also update envoy to 1.32 and python to 3.13 * use python:3.12 2024-11-12 10:35:14 -08:00			`$ rustup target add wasm32-wasip1`
comments Signed-off-by: José Ulises Niño Rivera <junr03@users.noreply.github.com> 2024-07-10 13:47:26 -07:00			```

Add initial scaffolding Signed-off-by: José Ulises Niño Rivera <junr03@users.noreply.github.com> 2024-07-10 10:06:02 -07:00			`## Building`

			```sh
update rust toolchain to 1.82 (#255) * update rust to 1.82 pin it, also update envoy to 1.32 and python to 3.13 * use python:3.12 2024-11-12 10:35:14 -08:00			`$ cargo build --target wasm32-wasip1 --release`
Add initial scaffolding Signed-off-by: José Ulises Niño Rivera <junr03@users.noreply.github.com> 2024-07-10 10:06:02 -07:00			```

Add initial integration style tests (#20) Signed-off-by: José Ulises Niño Rivera <junr03@users.noreply.github.com> 2024-07-25 14:41:36 -07:00			`## Testing`
			```sh
			`$ cargo test`
			```

update readme for filter 2024-10-08 15:32:49 -07:00			`## Local development`
Adding support for wildcard models in the model_providers config (#696) * cleaning up plano cli commands * adding support for wildcard model providers * fixing compile errors * fixing bugs related to default model provider, provider hint and duplicates in the model provider list * fixed cargo fmt issues * updating tests to always include the model id * using default for the prompt_gateway path * fixed the model name, as gpt-5-mini-2025-08-07 wasn't in the config * making sure that all aliases and models match the config * fixed the config generator to allow for base_url providers LLMs to include wildcard models * re-ran the models list utility and added a shell script to run it * updating docs to mention wildcard model providers * updated provider_models.json to yaml, added that file to our docs for reference * updating the build docs to use the new root-based build --------- Co-authored-by: Salman Paracha <salmanparacha@MacBook-Pro-342.local> 2026-01-28 17:47:33 -08:00			`- Build docker image for Plano. Note this needs to be built once.`
update readme for filter 2024-10-08 15:32:49 -07:00			```
			`$ sh build_filter_image.sh`
			```

			`- Build filter binary,`
			```
update rust toolchain to 1.82 (#255) * update rust to 1.82 pin it, also update envoy to 1.32 and python to 3.13 * use python:3.12 2024-11-12 10:35:14 -08:00			`$ cargo build --target wasm32-wasip1 --release`
update readme for filter 2024-10-08 15:32:49 -07:00			```
Adding support for wildcard models in the model_providers config (#696) * cleaning up plano cli commands * adding support for wildcard model providers * fixing compile errors * fixing bugs related to default model provider, provider hint and duplicates in the model provider list * fixed cargo fmt issues * updating tests to always include the model id * using default for the prompt_gateway path * fixed the model name, as gpt-5-mini-2025-08-07 wasn't in the config * making sure that all aliases and models match the config * fixed the config generator to allow for base_url providers LLMs to include wildcard models * re-ran the models list utility and added a shell script to run it * updating docs to mention wildcard model providers * updated provider_models.json to yaml, added that file to our docs for reference * updating the build docs to use the new root-based build --------- Co-authored-by: Salman Paracha <salmanparacha@MacBook-Pro-342.local> 2026-01-28 17:47:33 -08:00			`- Start envoy with config.yaml and test,`
update readme for filter 2024-10-08 15:32:49 -07:00			```
Adding support for wildcard models in the model_providers config (#696) * cleaning up plano cli commands * adding support for wildcard model providers * fixing compile errors * fixing bugs related to default model provider, provider hint and duplicates in the model provider list * fixed cargo fmt issues * updating tests to always include the model id * using default for the prompt_gateway path * fixed the model name, as gpt-5-mini-2025-08-07 wasn't in the config * making sure that all aliases and models match the config * fixed the config generator to allow for base_url providers LLMs to include wildcard models * re-ran the models list utility and added a shell script to run it * updating docs to mention wildcard model providers * updated provider_models.json to yaml, added that file to our docs for reference * updating the build docs to use the new root-based build --------- Co-authored-by: Salman Paracha <salmanparacha@MacBook-Pro-342.local> 2026-01-28 17:47:33 -08:00			`$ docker compose -f docker-compose.dev.yaml up plano`
update readme for filter 2024-10-08 15:32:49 -07:00			```
			`- dev version of docker-compose file uses following files that are mounted inside the container. That means no docker rebuild is needed if any of these files change. Just restart the container and chagne will be picked up,`
Update README.md 2024-10-08 17:20:51 -07:00			`- envoy.template.yaml`
			`- intelligent_prompt_gateway.wasm`