agent-starter-pack 0.7.0__py3-none-any.whl → 0.7.1__py3-none-any.whl

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -1,6 +1,6 @@
1
1
  Metadata-Version: 2.4
2
2
  Name: agent-starter-pack
3
- Version: 0.7.0
3
+ Version: 0.7.1
4
4
  Summary: CLI to bootstrap production-ready Google Cloud GenAI agent projects from templates.
5
5
  Author-email: Google LLC <agent-starter-pack@google.com>
6
6
  License: Apache-2.0
@@ -40,11 +40,11 @@ agents/live_api/template/.templateconfig.yaml,sha256=DD_hihMsuqmd5VWS18vVGZ3ZGVV
40
40
  agents/live_api/tests/integration/test_server_e2e.py,sha256=D2VETDIyTD2fQyQ6DXwLr-POSYyVzzzcpIFLt5Ppyx4,8398
41
41
  agents/live_api/tests/load_test/load_test.py,sha256=HHZyfC4gqiQtZVF_CbbxENGgWQccMLpwMv0IdoQ6cbQ,1275
42
42
  agents/live_api/tests/unit/test_server.py,sha256=_TjlgQgNkjerIaBGnu8P8_KB8ZlSolDcivALpUOn_Rw,4786
43
- llm.txt,sha256=cZkWdzV2hRPIcV57E5J2zjnEiRntM6MrisFLstE4iYY,12140
44
- src/base_template/.gitignore,sha256=bM9stR1IiKW5RVcryDyXj8ZgmKbN3x-3OCneDsmRZUg,2589
43
+ llm.txt,sha256=695MseB6y34Cr3n6du3G2SdwKKa48JGq9KNMp0APHW4,13148
44
+ src/base_template/.gitignore,sha256=Fq0w34x4sfbwP4RqDqh6hdHNYRUEsFNI-9XONzLWBIs,2580
45
45
  src/base_template/GEMINI.md,sha256=WzscHWlQeYkKORZ-453P8KM9IHuj1kAxW-69c7Ytuwk,133
46
46
  src/base_template/Makefile,sha256=037wvhexHIZyWW451D4vkvNnldTznxDFZ0sleUvl8jU,6115
47
- src/base_template/README.md,sha256=d9vGHGZzpgbcgu-J-9gHr3NOV7nuRzgFzdSxSzwY3xs,10694
47
+ src/base_template/README.md,sha256=GrXssaJK-5Dm3C7-S_mvyPiiYEzQwRTbhbKYg1-Jdxw,10892
48
48
  src/base_template/pyproject.toml,sha256=B7pnk8dhEWLEqPYQ0wqbbRGAVPZSjnPPP1imoFnilJw,2840
49
49
  src/base_template/app/__init__.py,sha256=UyAgc2l8nkVIUPUzL9hKR7EgzCsc2jSYcOcjHNNmpMU,59
50
50
  src/base_template/app/utils/gcs.py,sha256=jKblaWOGQEigw3esaawcfX178shhZi2Fyk0fJSA4T68,1501
@@ -76,11 +76,11 @@ src/cli/main.py,sha256=pMsSlNwkrFqHUHHA5U-WMZ4QRquaI_F7OXQt6yxuugE,1688
76
76
  src/cli/commands/create.py,sha256=DuUtLsX4ltRhIgInjkLJ1ixIkfqgT9wBuI807M_KLIs,24766
77
77
  src/cli/commands/setup_cicd.py,sha256=Lr0wLeKlRxROsRVFLAI3ygfIh_sTavvgQckDkzFEKMQ,31705
78
78
  src/cli/utils/__init__.py,sha256=_cTmsXGPqOtK0q8UW5164QTltbJRJFR_Efxq_BRL1-o,1311
79
- src/cli/utils/cicd.py,sha256=m2BxwV39323rVzJCjJjB37IPdSNQdxVgXGrgnhdbb84,26040
79
+ src/cli/utils/cicd.py,sha256=YTEuyNCdiCHSsNK_EdU-bdlt8mzIOb4_NCAP2FLrvu8,26197
80
80
  src/cli/utils/datastores.py,sha256=gv1V6eDcOEKx4MRNG5C3Y-VfixYq1AzQuaYMLp8QRNo,1058
81
81
  src/cli/utils/gcp.py,sha256=cnuCyN144eiyYc9aJNEK9JnyWN66rdevugoMdDYC1UU,4032
82
82
  src/cli/utils/logging.py,sha256=0lHe4EPi1A8sOx9xkA7gS4UNl0GsIyp2ahydkkuCzLY,1570
83
- src/cli/utils/template.py,sha256=rb3QoP-5AxEXYImsSR6wJhcF8bZRo-PzU1H6uNMsrk0,29709
83
+ src/cli/utils/template.py,sha256=FsWs9fd96Qi1S6Pi4LQ4eMZeYTKPAcASsJ1BejywQT4,29300
84
84
  src/cli/utils/version.py,sha256=F4udQmzniPStqWZFIgnv3Qg3l9non4mfy2An-Oveqmc,2916
85
85
  src/data_ingestion/README.md,sha256=LNxSQoJW9JozK-TbyGQLj5L_MGWNwrfLk6V6RmQ2oBQ,4032
86
86
  src/data_ingestion/pyproject.toml,sha256=-1Mf2QB8K70ICQV5UPZDpf-fN3UwEQLVzQyxfakCSTY,445
@@ -197,8 +197,8 @@ src/resources/setup_cicd/providers.tf,sha256=Km4z6IJt7x7PLaa0kyZbBrO2m3lpuIJZFD5
197
197
  src/utils/generate_locks.py,sha256=6V1B8V2BEuevWnXUsxZVTrLjXwFRII8UfsIGrQqZxVs,4320
198
198
  src/utils/lock_utils.py,sha256=RSE6n3hBkH64xNm3Q5wrR0Pqbeo-oc7xaTOhA9yzHjk,2275
199
199
  src/utils/watch_and_rebuild.py,sha256=vP4yIiA7E_lj5sfQdJUl8TXas6V7msDg8XWUutAC05Q,6679
200
- agent_starter_pack-0.7.0.dist-info/METADATA,sha256=0Op9EZV9jjK0MPZ1SJ5rpATz_-cdMjEIxkwFy0KiGII,11146
201
- agent_starter_pack-0.7.0.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
202
- agent_starter_pack-0.7.0.dist-info/entry_points.txt,sha256=U7uCxR7YulIhZ0L8R8Hui0Bsy6J7oyESBeDYJYMrQjA,56
203
- agent_starter_pack-0.7.0.dist-info/licenses/LICENSE,sha256=xx0jnfkXJvxRnG63LTGOxlggYnIysveWIZ6H3PNdCrQ,11357
204
- agent_starter_pack-0.7.0.dist-info/RECORD,,
200
+ agent_starter_pack-0.7.1.dist-info/METADATA,sha256=aXLTLLtk8pTjy7V52_Cw0_VOcqTd7H4ETnluJyMW4DM,11146
201
+ agent_starter_pack-0.7.1.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
202
+ agent_starter_pack-0.7.1.dist-info/entry_points.txt,sha256=U7uCxR7YulIhZ0L8R8Hui0Bsy6J7oyESBeDYJYMrQjA,56
203
+ agent_starter_pack-0.7.1.dist-info/licenses/LICENSE,sha256=xx0jnfkXJvxRnG63LTGOxlggYnIysveWIZ6H3PNdCrQ,11357
204
+ agent_starter_pack-0.7.1.dist-info/RECORD,,
llm.txt CHANGED
@@ -204,21 +204,27 @@ uvx agent-starter-pack setup-cicd [OPTIONS]
204
204
  ```
205
205
  **Prerequisites:** Run from the project root. `uv`, `gh` CLI, `gcloud` CLI, and `terraform` must be installed and authenticated. Requires `Owner` role on the GCP projects.
206
206
 
207
- **Key Automation Options:**
208
- * `--staging-project`, `--prod-project`, `--cicd-project`, `--dev-project`
209
- * `--region`, `--repository-name`, `--repository-owner`
210
- * `--auto-approve`: **Crucial for automation.** Skips all interactive prompts.
207
+ **Automated CI/CD Setup Options:**
208
+ * `--staging-project`: (REQUIRED) The Google Cloud Project ID for your staging environment.
209
+ * `--prod-project`: (REQUIRED) The Google Cloud Project ID for your production environment.
210
+ * `--repository-name`: (REQUIRED) The name for the new GitHub repository that will be created.
211
+ * `--repository-owner`: (REQUIRED) Your GitHub username or organization where the repo will be created.
212
+ * `--git-provider`: (REQUIRED) The Git provider to use (github, gitlab, etc.). Only "github" is supported.
213
+ * `--auto-approve`: Skips all interactive confirmation prompts.
214
+
211
215
 
212
216
  **Automated Example:**
213
217
  ```bash
214
218
  uvx agent-starter-pack setup-cicd \
215
- --staging-project t-starter-staging \
216
- --prod-project t-starter-prod \
217
- --repository-name my-adk-project-repo \
218
- --repository-owner eliasecchig \
219
+ --staging-project the-user-staging-project \
220
+ --prod-project the-user-prod-project \
221
+ --repository-name the-user-repo-name \
222
+ --repository-owner the-username \
223
+ --git-provider github \
219
224
  --auto-approve
220
225
  ```
221
-
226
+ * Note: As a coding agent, you must run this command non-interactively. Before executing, you must ask the user to provide the following required flags: `--staging-project`, `--prod-project`, `--repository-name`, `--repository-owner`, and `--git-provider`. Once you have these values, you can construct and run the command with the `--auto-approve` flag.
227
+ * Note: If the user tells that `setup-cicd` is not a viable option or it wants to use a different git provider, you must not use this command. Instead, you should look at the `deployment/README.md` to get instructions on how to manually deploy the agent.
222
228
  ---
223
229
  ### Section 6: Operational Guidelines for Coding Agents
224
230
 
@@ -195,4 +195,3 @@ my_env.tfvars
195
195
  .saved_chats
196
196
  .env
197
197
  .requirements.txt
198
- GEMINI.md
@@ -21,6 +21,7 @@ This project is organized as follows:
21
21
  ├── notebooks/ # Jupyter notebooks for prototyping and evaluation
22
22
  ├── tests/ # Unit, integration, and load tests
23
23
  ├── Makefile # Makefile for common commands
24
+ ├── GEMINI.md # AI-assisted development guide
24
25
  └── pyproject.toml # Project dependencies and configuration
25
26
  ```
26
27
 
@@ -160,6 +161,8 @@ This template follows a "bring your own agent" approach - you focus on your busi
160
161
  3. **Test:** Explore your agent functionality using the Streamlit playground with `make playground`. The playground offers features like chat history, user feedback, and various input types, and automatically reloads your agent on code changes.
161
162
  4. **Deploy:** Set up and initiate the CI/CD pipelines, customizing tests as necessary. Refer to the [deployment section](#deployment) for comprehensive instructions. For streamlined infrastructure deployment, simply run `uvx agent-starter-pack setup-cicd`. Check out the [`agent-starter-pack setup-cicd` CLI command](https://googlecloudplatform.github.io/agent-starter-pack/cli/setup_cicd.html). Currently only supporting Github.
162
163
  5. **Monitor:** Track performance and gather insights using Cloud Logging, Tracing, and the Looker Studio dashboard to iterate on your application.
164
+
165
+ The project includes a `GEMINI.md` file that provides context for AI tools like Gemini CLI when asking questions about your template.
163
166
  {% endif %}
164
167
 
165
168
  ## Deployment
src/cli/utils/cicd.py CHANGED
@@ -212,7 +212,10 @@ def create_github_connection(
212
212
  return secret_id, app_installation_id
213
213
  elif status == "PENDING_USER_OAUTH" or status == "PENDING_INSTALL_APP":
214
214
  if attempt < max_retries - 1: # Don't print waiting on last attempt
215
- console.print("⏳ Waiting for GitHub authorization...")
215
+ console.print("⏳ Waiting for authorization...")
216
+ print(
217
+ f"Console: https://console.cloud.google.com/cloud-build/repositories?project={project_id}"
218
+ )
216
219
  # Extract and print the action URI for user authentication
217
220
  try:
218
221
  action_uri = (
src/cli/utils/template.py CHANGED
@@ -467,15 +467,6 @@ def process_template(
467
467
  agent_folder, project_folder, agent_name, overwrite=True
468
468
  )
469
469
 
470
- # Copy agent README.md if it exists
471
- agent_readme = agent_path / "README.md"
472
- if agent_readme.exists():
473
- agent_readme_dest = project_template / "agent_README.md"
474
- shutil.copy2(agent_readme, agent_readme_dest)
475
- logging.debug(
476
- f"Copied agent README from {agent_readme} to {agent_readme_dest}"
477
- )
478
-
479
470
  # Load and validate template config first
480
471
  template_path = pathlib.Path(template_dir)
481
472
  config = load_template_config(template_path)