Skip to content

TIPCommon update: Gitsync#515

Open
gnishant-gupta wants to merge 27 commits intomainfrom
tipcommon_gitsync_1p
Open

TIPCommon update: Gitsync#515
gnishant-gupta wants to merge 27 commits intomainfrom
tipcommon_gitsync_1p

Conversation

@gnishant-gupta
Copy link
Copy Markdown
Contributor

@gnishant-gupta gnishant-gupta commented Jan 28, 2026

Checklist:

Please ensure you have completed the following items before submitting your PR.
This helps us review your contribution faster and more efficiently.

General Checks:

  • I have read and followed the project's contributing.md guide.
  • My code follows the project's coding style guidelines.
  • I have performed a self-review of my own code.
  • My changes do not introduce any new warnings.
  • My changes pass all existing tests.
  • I have added new tests where appropriate to cover my changes. (If applicable)
  • I have updated the documentation where necessary (e.g., README, API docs). (If applicable)

Open-Source Specific Checks:

  • My changes do not introduce any Personally Identifiable Information (PII) or sensitive customer data.
  • My changes do not expose any internal-only code examples, configurations, or URLs.
  • All code examples, comments, and messages are generic and suitable for a public repository.
  • I understand that any internal context or sensitive details related to this work are handled separately in internal systems (Buganizer for Google team members).

For Google Team Members and Reviewers Only:

  • I have included the Buganizer ID in the PR title or description (e.g., "Internal Buganizer ID: 123456789" or "Related Buganizer: go/buganizer/123456789").
  • I have ensured that all internal discussions and PII related to this work remain in Buganizer.
  • I have tagged the PR with one or more labels that reflect the pull request purpose.

Note

Medium Risk
Large surface-area change adding many new SOAR client endpoints and response parsers across both legacy and 1P clients; risk is mainly runtime breakage from API shape/URL differences and inconsistent response types.

Overview
Expands TIPCommon’s Chronicle SOAR API surface by adding many new wrappers in rest/soar_api.py for system/settings, environments, integrations (install/export/import/configure), playbooks, case metadata (tags/stages/close reasons), networks/custom lists/blocklists, ontology/visual families/mapping rules, and simulated cases.

Adds/updates data models in data_models.py to normalize legacy vs 1P JSON shapes (notably new Environment, IntegrationSetting, VisualFamily, OntologyRecord, CaseTag, Domain, CaseStage, CaseCloseReasons, CustomList, Blacklist, Network, SlaDefinition, SoarBlockEntity, SimulatedCases, BlockRecord) and makes parsing more defensive (InstalledIntegrationInstance, DynamicParameter).

Updates platform clients (api_client_factory.py, legacy_soar_api.py, one_platform_soar_api.py) with the corresponding new API methods and adds URL rewriting in BaseSoarApi._make_request to handle 1P download/export path differences; bumps package version to 2.3.6.

Reviewed by Cursor Bugbot for commit 5f59817. Bugbot is set up for automated code reviews on this repo. Configure here.

@gemini-code-assist
Copy link
Copy Markdown
Contributor

Summary of Changes

Hello @gnishant-gupta, I'm Gemini Code Assist1! I'm currently reviewing this pull request and will post my feedback shortly. In the meantime, here's a summary to help you and other reviewers quickly get up to speed!

This pull request introduces several updates and enhancements to the TIPCommon package. It includes version updates, new data models for representing SOAR entities, and updates to the API clients for interacting with various SOAR endpoints. These changes aim to improve the functionality and usability of the TIPCommon package.

Highlights

  • Version Update: The TIPCommon package version has been updated from 2.3.0 to 2.3.2 in pyproject.toml.
  • Data Model Enhancements: The IntegrationEnvironment data model now includes instance_description and is_configured attributes. The DynamicParameter data model now handles cases where key is missing, defaulting to dynamicParameterId, and provides to_json method.
  • New Data Models: Added new data models including Environment, IntegrationSetting, VisualFamily, OntologyRecord, CaseTag, Domain, CaseStage, CaseCloseReasons, CustomList, Blacklist, Network, SlaDefinition, SoarBlockEntity, and SimulatedCases to represent various system entities.
  • API Client Updates: The LegacySoarApi and OnePlatformSoarApi clients have been updated with new methods for interacting with various SOAR endpoints, including those for managing environments, integrations, cases, and settings.
  • SOAR API Enhancements: Added new functions to soar_api.py for retrieving and managing various SOAR entities, such as email templates, dynamic parameters, integration instances, domains, environments, cases, networks, custom lists, and more.

🧠 New Feature in Public Preview: You can now enable Memory to help Gemini Code Assist learn from your team's feedback. This makes future code reviews more consistent and personalized to your project's style. Click here to enable Memory in your admin console.

Using Gemini Code Assist

The full guide for Gemini Code Assist can be found on our documentation page, here are some quick tips.

Invoking Gemini

You can request assistance from Gemini at any point by creating a comment using either /gemini <command> or @gemini-code-assist <command>. Below is a summary of the supported commands on the current page.

Feature Command Description
Code Review /gemini review Performs a code review for the current pull request in its current state.
Pull Request Summary /gemini summary Provides a summary of the current pull request in its current state.
Comment @gemini-code-assist Responds in comments when explicitly tagged, both in pull request comments and review comments.
Help /gemini help Displays a list of available commands.

Customization

To customize Gemini Code Assist for GitHub experience, repository maintainers can create a configuration file and/or provide a custom code review style guide (such as PEP-8 for Python) by creating and adding files to a .gemini/ folder in the base of the repository. Detailed instructions can be found here.

Limitations & Feedback

Gemini Code Assist may make mistakes. Please leave feedback on any instances where its feedback is incorrect or counter productive. You can react with 👍 and 👎 on @gemini-code-assist comments. If you're interested in giving your feedback about your experience with Gemini Code Assist for Github and other Google products, sign up here.

You can also get AI-powered code generation, chat, as well as code reviews directly in the IDE at no cost with the Gemini Code Assist IDE Extension.

Footnotes

  1. Review the Privacy Notices, Generative AI Prohibited Use Policy, Terms of Service, and learn how to configure Gemini Code Assist in GitHub here. Gemini can make mistakes, so double check it and use code with caution.

Copy link
Copy Markdown
Contributor

@gemini-code-assist gemini-code-assist bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Code Review

This pull request significantly expands the functionality of TIPCommon by adding numerous data models and API client methods. The changes are a positive step, particularly the move towards safer dictionary access using .get(). However, there are several areas that could be improved for robustness and maintainability. My review focuses on improving error handling by replacing broad except Exception blocks with more specific ones, correcting type hint mismatches, and addressing potential runtime errors to enhance code correctness. Addressing these points will make the new additions more reliable.

Comment thread packages/tipcommon/TIPCommon/src/TIPCommon/data_models.py Outdated
Comment thread packages/tipcommon/TIPCommon/src/TIPCommon/data_models.py Outdated
Comment thread packages/tipcommon/TIPCommon/src/TIPCommon/rest/soar_api.py Outdated
Comment thread packages/tipcommon/TIPCommon/src/TIPCommon/rest/soar_api.py Outdated
Comment thread packages/tipcommon/TIPCommon/src/TIPCommon/rest/soar_api.py Outdated
Comment thread packages/tipcommon/TIPCommon/src/TIPCommon/rest/soar_api.py Outdated
@github-actions github-actions bot added the Stale label Feb 20, 2026
gnishant-gupta and others added 2 commits February 25, 2026 07:55
Signed-off-by: gnishant <106644073+gnishant-gupta@users.noreply.github.com>
@github-actions github-actions bot removed the Stale label Feb 26, 2026
Comment thread packages/tipcommon/TIPCommon/src/TIPCommon/rest/soar_api.py Outdated
Comment thread packages/tipcommon/TIPCommon/src/TIPCommon/rest/soar_api.py Outdated
@gnishant-gupta gnishant-gupta marked this pull request as draft March 12, 2026 08:36
@gnishant-gupta gnishant-gupta marked this pull request as ready for review March 12, 2026 09:45
Copy link
Copy Markdown

@cursor cursor bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Cursor Bugbot has reviewed your changes and found 4 potential issues.

Fix All in Cursor

❌ Bugbot Autofix is OFF. To automatically fix reported issues with cloud agents, enable autofix in the Cursor dashboard.

Reviewed by Cursor Bugbot for commit 5f59817. Configure here.

) -> SingleJson:
"""Add or update company logo."""
api_client = get_soar_client(chronicle_soar)
api_client.params.company_logo = company_logo
Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Attribute mismatch: company_logo vs logo_data param name

High Severity

The add_or_update_company_logo function sets api_client.params.company_logo, but both the legacy and 1P API implementations read self.params.logo_data. This means the logo payload is never sent — logo_data will be unset on the Container, resulting in None or an AttributeError at runtime.

Additional Locations (2)
Fix in Cursor Fix in Web

Reviewed by Cursor Bugbot for commit 5f59817. Configure here.

response = api_client.update_blocklist()
try:
response = validate_response(response, validate_json=False)
return response
Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

validate_response returns None, assigned and returned as response

High Severity

In update_blocklist, validate_response returns None (it has no return value), but its result is reassigned to response and then returned. This means on success, the function always returns None instead of a meaningful response dict, breaking the SingleJson return type contract.

Fix in Cursor Fix in Web

Reviewed by Cursor Bugbot for commit 5f59817. Configure here.


def get_all_model_block_records(self) -> requests.Response:
"""Get all model block records."""
endpoint: str = "settings/GetAllModelBlockRecords"
Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Missing leading slash in legacy endpoint paths

High Severity

The endpoints for get_all_model_block_records ("settings/GetAllModelBlockRecords") and get_company_logo ("settings/GetCompanyLogo") are missing their leading /. Every other endpoint in this file uses a leading slash. This causes the endpoint to be concatenated directly to the base URL without a path separator, producing a malformed URL that will fail.

Additional Locations (1)
Fix in Cursor Fix in Web

Reviewed by Cursor Bugbot for commit 5f59817. Configure here.

payload = {
"id": self.params.id,
"name": self.params.name,
"type": self.params.type,
Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Legacy add_dynamic_env_param uses wrong parameter name for type

Medium Severity

The legacy add_dynamic_env_param builds the payload with "type": self.params.type, but the caller in soar_api.py sets api_client.params.parameter_type (not params.type). This means the type field in the payload will be unset or None, and the actual parameter type value is lost.

Fix in Cursor Fix in Web

Reviewed by Cursor Bugbot for commit 5f59817. Configure here.

@cursor
Copy link
Copy Markdown

cursor bot commented Apr 10, 2026

You have used all of your free Bugbot PR reviews.

To receive reviews on all of your PRs, visit the Cursor dashboard to activate Pro and start your 14-day free trial.

@cursor
Copy link
Copy Markdown

cursor bot commented Apr 10, 2026

You have used all of your free Bugbot PR reviews.

To receive reviews on all of your PRs, visit the Cursor dashboard to activate Pro and start your 14-day free trial.

@cursor
Copy link
Copy Markdown

cursor bot commented Apr 16, 2026

You have used all of your free Bugbot PR reviews.

To receive reviews on all of your PRs, visit the Cursor dashboard to activate Pro and start your 14-day free trial.

@cursor
Copy link
Copy Markdown

cursor bot commented Apr 16, 2026

You have used all of your free Bugbot PR reviews.

To receive reviews on all of your PRs, visit the Cursor dashboard to activate Pro and start your 14-day free trial.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

4 participants