[EAGLE-6237]: update code snippets for MCP/OpenAI and make env vars take precedence

[zeiler]

This pull request introduces enhancements to the configuration handling, URL generation, and client script generation in the Clarifai codebase. The changes improve flexibility by introducing new default values, methods for constructing URLs for specific endpoints, and updated logic for generating client scripts based on context and method signatures.

Configuration Enhancements:

• Added support for default fallback values (DEFAULT_UI and DEFAULT_BASE) in the Context class when environment variables are not set. This ensures a more robust configuration handling process.
• Updated __getattr__ in Context to prioritize environment variables over configuration values and provide detailed error messages for missing attributes.

URL Generation Improvements:

• Introduced mcp_api_url and openai_api_url methods in ClarifaiUrlHelper to generate URLs for MCP-hosted models and OpenAI-compatible models, respectively. These methods streamline URL creation for specific use cases.

Client Script Generation Updates:

• Enhanced generate_client_script to support context-based URL generation using Config and ClarifaiUrlHelper. This allows dynamic selection of API endpoints based on the context.
• Added logic to generate client scripts for OpenAI-compatible models, including an example script for interacting with OpenAI’s API.

Constants and Utilities:

• Added constants MCP_TRANSPORT_NAME and OPENAI_TRANSPORT_NAME to clarifai/utils/constants.py for identifying specific transport methods.
• Introduced a utility function has_signature_method to check for the existence of specific method signatures in a list.

These changes collectively enhance the configurability, extensibility, and usability of the Clarifai codebase.

[Copilot]

Pull Request Overview

This PR enhances configuration defaults, URL generation, and client script templates to support MCP-hosted and OpenAI-compatible models.

• Adds default UI/base fallbacks in Context and new transport constants.
• Introduces mcp_api_url and openai_api_url helpers.
• Updates generate_client_script to branch on transport signatures using context, and updates UI URL construction in model/CLI modules.

Reviewed Changes

Copilot reviewed 6 out of 6 changed files in this pull request and generated no comments.

Show a summary per file

File	Description
clarifai/utils/constants.py	Added MCP_TRANSPORT_NAME and OPENAI_TRANSPORT_NAME constants
clarifai/utils/config.py	Imported DEFAULT_UI/DEFAULT_BASE and extended fallback logic
clarifai/urls/helper.py	Added mcp_api_url and openai_api_url methods
clarifai/runners/utils/code_script.py	Added has_signature_method, context‐based script generation
clarifai/client/model.py	Updated URL template to use current.ui from context
clarifai/cli/model.py	Changed log to include full UI URL

Comments suppressed due to low confidence (4)

clarifai/runners/utils/code_script.py:13

• The List type is used here but not imported; add from typing import List at the top of the file to avoid a NameError.

name: str, method_signatures: List[resources_pb2.MethodSignature]

clarifai/runners/utils/code_script.py:7

• auth_obj isn't defined or exported from clarifai.urls.helper; ensure you import the correct auth helper (e.g. default_auth) or define auth_obj.

from clarifai.urls.helper import ClarifaiUrlHelper, auth_obj

clarifai/client/model.py:133

• current.ui already includes the protocol (e.g. "https://"); using f"https://{current.ui}/..." will double the prefix. Remove the hardcoded https:// or normalize current.ui to exclude it.

url = f"https://{current.ui}/{current.user_id}/{current.app_id}/models/{current.model_id}"

clarifai/urls/helper.py:100

• [nitpick] Fix typos: change "incldue" to "include" and "you an set" to "you can set" for clarity.

It also doesn't incldue the model which you an set as the model arg in an openAI client call

[github-actions]

Package	Line Rate	Health
clarifai	43%	❌
clarifai.cli	43%	❌
clarifai.client	71%	➖
clarifai.client.auth	74%	➖
clarifai.constants	100%	✔
clarifai.datasets	100%	✔
clarifai.datasets.export	80%	✔
clarifai.datasets.upload	75%	➖
clarifai.datasets.upload.loaders	37%	❌
clarifai.models	100%	✔
clarifai.modules	0%	❌
clarifai.rag	72%	➖
clarifai.runners	12%	❌
clarifai.runners.models	61%	➖
clarifai.runners.utils	61%	➖
clarifai.runners.utils.data_types	72%	➖
clarifai.schema	100%	✔
clarifai.urls	71%	➖
clarifai.utils	73%	➖
clarifai.utils.evaluation	67%	➖
clarifai.workflows	94%	✔
Summary	66% (6325 / 9625)	➖

Minimum allowed line rate is 50%

[mogith-pn]

LGTM.