ibm-watsonx-orchestrate 1.10.0b1__tar.gz → 1.11.0b0__tar.gz

{ibm_watsonx_orchestrate-1.10.0b1 → ibm_watsonx_orchestrate-1.11.0b0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: ibm-watsonx-orchestrate
-Version: 1.10.0b1
+Version: 1.11.0b0
 Summary: IBM watsonx.orchestrate SDK
 Author-email: IBM <support@ibm.com>
 License: MIT License

{ibm_watsonx_orchestrate-1.10.0b1 → ibm_watsonx_orchestrate-1.11.0b0}/src/ibm_watsonx_orchestrate/__init__.py

@@ -5,9 +5,7 @@
 
 pkg_name = "ibm-watsonx-orchestrate"
 
-__version__ = "1.10.0b1"
-
-
+__version__ = "1.11.0b0"
 
 
 from ibm_watsonx_orchestrate.utils.logging.logger import setup_logging

{ibm_watsonx_orchestrate-1.10.0b1 → ibm_watsonx_orchestrate-1.11.0b0}/src/ibm_watsonx_orchestrate/agent_builder/connections/types.py

@@ -165,6 +165,53 @@ class ConnectionConfiguration(BaseModel):
             raise ValueError("Connection of type 'key_value' cannot be configured at the 'member' level. Key value connections must be of type 'team'")
         return self
 
+class ConnectionCredentialsEntryLocation(str, Enum):
+    BODY = 'body'
+    HEADER = 'header',
+    QUERY = 'query'
+
+    def __str__(self):
+        return self.value
+
+class ConnectionCredentialsEntry(BaseModel):
+    key: str
+    value: str
+    location: ConnectionCredentialsEntryLocation
+
+    def __str__(self):
+        return f"<ConnectionCredentialsEntry: {self.location}:{self.key}={self.value}>"
+
+class BaseOAuthCredentials(BaseModel):
+    custom_token_query: Optional[dict] = None
+    custom_token_header: Optional[dict] = None
+    custom_token_body: Optional[dict] = None
+    custom_auth_query: Optional[dict] = None
+
+class ConnectionCredentialsCustomFields(BaseOAuthCredentials):
+    def add_field(self, entry: ConnectionCredentialsEntry, is_token:bool=True) -> None:
+        match entry.location:
+            case ConnectionCredentialsEntryLocation.HEADER:
+                if not is_token:
+                    return
+                attribute = "custom_token_header"
+            case ConnectionCredentialsEntryLocation.BODY:
+                if not is_token:
+                    return
+                attribute = "custom_token_body"
+            case ConnectionCredentialsEntryLocation.QUERY:
+                if is_token:
+                     attribute = "custom_token_query"
+                else:
+                    attribute = "custom_auth_query"
+            case _:
+                return
+        
+        fields = getattr(self, attribute)
+        if not fields:
+            setattr(self, attribute, {})
+            fields = getattr(self, attribute)
+        fields[entry.key] = entry.value
+
 class BasicAuthCredentials(BaseModel):
     username: str
     password: str
@@ -182,7 +229,7 @@ class OAuth2TokenCredentials(BaseModel):
     access_token: str
     url: Optional[str] = None
 
-class OAuth2AuthCodeCredentials(BaseModel):
+class OAuth2AuthCodeCredentials(BaseOAuthCredentials):
     client_id: str
     client_secret: str
     token_url: str
@@ -193,7 +240,7 @@ class OAuth2AuthCodeCredentials(BaseModel):
 #     client_id: str
 #     authorization_url: str
 
-class OAuth2PasswordCredentials(BaseModel):
+class OAuth2PasswordCredentials(BaseOAuthCredentials):
     username: str
     password: str
     client_id: str
@@ -203,7 +250,7 @@ class OAuth2PasswordCredentials(BaseModel):
     grant_type: str = "password"
     
 
-class OAuth2ClientCredentials(BaseModel):
+class OAuth2ClientCredentials(BaseOAuthCredentials):
     client_id: str
     client_secret: str
     token_url: str
@@ -211,7 +258,7 @@ class OAuth2ClientCredentials(BaseModel):
     send_via: ConnectionSendVia = ConnectionSendVia.HEADER
     grant_type: str = "client_credentials"
 
-class OAuthOnBehalfOfCredentials(BaseModel):
+class OAuthOnBehalfOfCredentials(BaseOAuthCredentials):
     client_id: str
     access_token_url: str
     grant_type: str
@@ -267,7 +314,7 @@ CONNECTION_TYPE_CREDENTIAL_MAPPING = {
     ConnectionSecurityScheme.KEY_VALUE: KeyValueConnectionCredentials,
 }
 
-class IdentityProviderCredentials(BaseModel):
+class IdentityProviderCredentials(BaseOAuthCredentials):
     idp_url: str = Field(validation_alias=AliasChoices('idp_url', 'url'), serialization_alias='idp_url')
     client_id: str
     client_secret: str
@@ -276,4 +323,4 @@ class IdentityProviderCredentials(BaseModel):
 
 class ExpectedCredentials(BaseModel):
     app_id: str
-    type: ConnectionType | List[ConnectionType]
+    type: ConnectionType | List[ConnectionType]

{ibm_watsonx_orchestrate-1.10.0b1 → ibm_watsonx_orchestrate-1.11.0b0}/src/ibm_watsonx_orchestrate/cli/commands/connections/connections_command.py

@@ -1,6 +1,6 @@
 import typer
 from typing_extensions import Annotated, List
-from ibm_watsonx_orchestrate.agent_builder.connections.types import ConnectionEnvironment, ConnectionPreference, ConnectionKind
+from ibm_watsonx_orchestrate.agent_builder.connections.types import ConnectionEnvironment, ConnectionPreference, ConnectionKind, ConnectionCredentialsEntry
 from ibm_watsonx_orchestrate.cli.commands.connections.connections_controller import (
     add_connection,
     remove_connection,
@@ -8,7 +8,9 @@ from ibm_watsonx_orchestrate.cli.commands.connections.connections_controller imp
     import_connection,
     configure_connection,
     set_credentials_connection,
-    set_identity_provider_connection
+    set_identity_provider_connection,
+    token_entry_connection_credentials_parse,
+    auth_entry_connection_credentials_parse
 )
 
 connections_app = typer.Typer(no_args_is_help=True)
@@ -244,6 +246,22 @@ def set_credentials_connection_command(
             help="For key_value, a key value pair in the form '<key>=<value>'. Multiple values can be passed using `-e key1=value1 -e key2=value2`"
         )
     ] = None,
+    token_entries: Annotated[
+        List[ConnectionCredentialsEntry],
+        typer.Option(
+            '--token-entries', "-t",
+            parser=token_entry_connection_credentials_parse,
+            help="Custom field options for oauth types token request, a key value location option in the form 'location:<key>=<value>' or '<key>=<value>' with location defaulting to 'header'. Multiple values can be passed using `-t key1=value1 -t location:key2=value2`"
+        )
+    ] = None,
+    auth_entries: Annotated[
+        List[ConnectionCredentialsEntry],
+        typer.Option(
+            '--auth-entries',
+            parser=auth_entry_connection_credentials_parse,
+            help="Custom field options for oauth_auth_code_flow auth server request, a key value location option in the form 'location:<key>=<value>' or '<key>=<value>' with location defaulting to 'query'. Note only 'query' is a valid location. Multiple values can be passed using `--auth-entries key1=value1 --auth-entries location:key2=value2`"
+        )
+    ] = None,
 ):
     set_credentials_connection(
         app_id=app_id,
@@ -259,7 +277,9 @@ def set_credentials_connection_command(
         auth_url=auth_url,
         grant_type=grant_type,
         scope=scope,
-        entries=entries
+        entries=entries,
+        token_entries=token_entries,
+        auth_entries=auth_entries
     )
 
 @connections_app.command(name="set-identity-provider")
@@ -311,6 +331,14 @@ def set_identity_provider_connection_command(
             help='The grant-type of the the identity provider'
         )
     ],
+    token_entries: Annotated[
+        List[ConnectionCredentialsEntry],
+        typer.Option(
+            '--token-entries', "-t",
+            parser=token_entry_connection_credentials_parse,
+            help="Custom field options for oauth types token request, a key value location option in the form 'location:<key>=<value>' or '<key>=<value>' with location defaulting to 'header'. Multiple values can be passed using `-t key1=value1 -t location:key2=value2`"
+        )
+    ] = None,
 ):
     set_identity_provider_connection(
         app_id=app_id,
@@ -319,5 +347,6 @@ def set_identity_provider_connection_command(
         client_id=client_id,
         client_secret=client_secret,
         scope=scope,
-        grant_type=grant_type
+        grant_type=grant_type,
+        token_entries=token_entries
     )

{ibm_watsonx_orchestrate-1.10.0b1 → ibm_watsonx_orchestrate-1.11.0b0}/src/ibm_watsonx_orchestrate/cli/commands/connections/connections_controller.py

@@ -27,7 +27,10 @@ from ibm_watsonx_orchestrate.agent_builder.connections.types import (
     KeyValueConnectionCredentials,
     CREDENTIALS,
     IdentityProviderCredentials,
-    OAUTH_CONNECTION_TYPES
+    OAUTH_CONNECTION_TYPES,
+    ConnectionCredentialsEntryLocation,
+    ConnectionCredentialsEntry,
+    ConnectionCredentialsCustomFields
 
 )
 
@@ -167,6 +170,13 @@ def _validate_connection_params(type: ConnectionType, **args) -> None:
             f"Missing flags --grant-type is required for type {type}"
         )
     
+    if type != ConnectionType.OAUTH2_AUTH_CODE and (
+        args.get('auth_entries')
+    ):
+        raise typer.BadParameter(
+            f"The flag --auth-entries is only supported by type {type}"
+        )
+    
 
 def _parse_entry(entry: str) -> dict[str,str]:
     split_entry = entry.split('=', 1)
@@ -176,6 +186,19 @@ def _parse_entry(entry: str) -> dict[str,str]:
         exit(1)
     return {split_entry[0]: split_entry[1]}
 
+def _get_oauth_custom_fields(token_entries: List[ConnectionCredentialsEntry] | None, auth_entries: List[ConnectionCredentialsEntry] | None) -> dict:
+    custom_fields = ConnectionCredentialsCustomFields()
+
+    if token_entries:
+        for entry in token_entries:
+            custom_fields.add_field(entry, is_token=True)
+    
+    if auth_entries:
+        for entry in auth_entries:
+            custom_fields.add_field(entry, is_token=False)
+    
+    return custom_fields.model_dump(exclude_none=True)
+
 def _get_credentials(type: ConnectionType, **kwargs):
     match type:
         case ConnectionType.BASIC_AUTH:
@@ -192,18 +215,21 @@ def _get_credentials(type: ConnectionType, **kwargs):
                 api_key=kwargs.get("api_key")
             )
         case ConnectionType.OAUTH2_AUTH_CODE:
+            custom_fields = _get_oauth_custom_fields(kwargs.get("token_entries"), kwargs.get("auth_entries"))
             return OAuth2AuthCodeCredentials(
                 authorization_url=kwargs.get("auth_url"),
                 client_id=kwargs.get("client_id"),
                 client_secret=kwargs.get("client_secret"),
                 token_url=kwargs.get("token_url"),
-                scope=kwargs.get("scope")
+                scope=kwargs.get("scope"),
+                **custom_fields
             )
         case ConnectionType.OAUTH2_CLIENT_CREDS:
             # using filtered args as default values will not be set if 'None' is passed, causing validation errors
             keys = ["client_id","client_secret","token_url","grant_type","send_via", "scope"]
             filtered_args = { key_name: kwargs[key_name] for key_name in keys if kwargs.get(key_name) }
-            return OAuth2ClientCredentials(**filtered_args)
+            custom_fields = _get_oauth_custom_fields(kwargs.get("token_entries"), kwargs.get("auth_entries"))
+            return OAuth2ClientCredentials(**filtered_args, **custom_fields)
         # case ConnectionType.OAUTH2_IMPLICIT:
         #     return OAuth2ImplicitCredentials(
         #         authorization_url=kwargs.get("auth_url"),
@@ -212,13 +238,16 @@ def _get_credentials(type: ConnectionType, **kwargs):
         case ConnectionType.OAUTH2_PASSWORD:
             keys = ["username", "password", "client_id","client_secret","token_url","grant_type", "scope"]
             filtered_args = { key_name: kwargs[key_name] for key_name in keys if kwargs.get(key_name) }
-            return OAuth2PasswordCredentials(**filtered_args)
+            custom_fields = _get_oauth_custom_fields(kwargs.get("token_entries"), kwargs.get("auth_entries"))
+            return OAuth2PasswordCredentials(**filtered_args, **custom_fields)
         
         case ConnectionType.OAUTH_ON_BEHALF_OF_FLOW:
+            custom_fields = _get_oauth_custom_fields(kwargs.get("token_entries"), kwargs.get("auth_entries"))
             return OAuthOnBehalfOfCredentials(
                 client_id=kwargs.get("client_id"),
                 access_token_url=kwargs.get("token_url"),
-                grant_type=kwargs.get("grant_type")
+                grant_type=kwargs.get("grant_type"),
+                **custom_fields
             )
         case ConnectionType.KEY_VALUE:
             env = {}
@@ -231,6 +260,23 @@ def _get_credentials(type: ConnectionType, **kwargs):
         case _:
             raise ValueError(f"Invalid type '{type}' selected")
 
+def _connection_credentials_parse_entry(text: str, default_location: ConnectionCredentialsEntryLocation) -> ConnectionCredentialsEntry:
+    location_kv_pair = text.split(":", 1)
+    key_value = location_kv_pair[-1]
+    location = location_kv_pair[0] if len(location_kv_pair)>1 else default_location
+
+    valid_locations = [item.value for item in ConnectionCredentialsEntryLocation]
+    if location not in valid_locations:
+        raise typer.BadParameter(f"The provided location '{location}' is not in the allowed values {valid_locations}.")
+
+    key_value_pair = key_value.split('=', 1)
+    if len(key_value_pair) != 2:
+        message = f"The entry '{text}' is not in the expected form '<location>:<key>=<value>' or '<key>=<value>'"
+        raise typer.BadParameter(message)
+    key, value = key_value_pair[0], key_value_pair[1]
+    
+    return ConnectionCredentialsEntry(key=key, value=value, location=location)
+    
 
 def add_configuration(config: ConnectionConfiguration) -> None:
     client = get_connections_client()
@@ -524,5 +570,15 @@ def set_identity_provider_connection(
         logger.error(f"Cannot set Identity Provider when 'sso' is false in configuration. Please enable sso for connection '{app_id}' in environment '{environment}' and try again.")
         sys.exit(1)
 
-    idp = IdentityProviderCredentials.model_validate(kwargs)
+    custom_fields = _get_oauth_custom_fields(token_entries=kwargs.get("token_entries"), auth_entries=None)
+    idp = IdentityProviderCredentials(**kwargs, **custom_fields)
     add_identity_provider(app_id=app_id, environment=environment, idp=idp)
+
+def token_entry_connection_credentials_parse(text: str) -> ConnectionCredentialsEntry:
+    return _connection_credentials_parse_entry(text=text, default_location=ConnectionCredentialsEntryLocation.HEADER)
+    
+def auth_entry_connection_credentials_parse(text: str) -> ConnectionCredentialsEntry:
+    entry = _connection_credentials_parse_entry(text=text, default_location=ConnectionCredentialsEntryLocation.QUERY)
+    if entry.location != ConnectionCredentialsEntryLocation.QUERY:
+        raise typer.BadParameter(f"Only location '{ConnectionCredentialsEntryLocation.QUERY}' is supported for --auth-entry")
+    return entry

{ibm_watsonx_orchestrate-1.10.0b1 → ibm_watsonx_orchestrate-1.11.0b0}/src/ibm_watsonx_orchestrate/cli/commands/server/server_command.py

@@ -191,9 +191,6 @@ def get_default_registry_env_vars_by_dev_edition_source(default_env: dict, user_
             parsed = urlparse(wo_url)
             hostname = parsed.hostname
             
-            if not hostname or not hostname.startswith("api."):
-                raise ValueError(f"Invalid WO_INSTANCE URL: '{wo_url}'. It should starts with 'api.'")
-            
             registry_url = f"registry.{hostname[4:]}/cp/wxo-lite"
         else:
             raise ValueError(f"Unknown value for developer edition source: {source}. Must be one of ['internal', 'myibm', 'orchestrate'].")

{ibm_watsonx_orchestrate-1.10.0b1 → ibm_watsonx_orchestrate-1.11.0b0}/src/ibm_watsonx_orchestrate/cli/commands/server/types.py

@@ -1,5 +1,6 @@
 import logging
 import sys
+import uuid
 from enum import Enum
 from pydantic import BaseModel, model_validator, ConfigDict
 
@@ -43,9 +44,6 @@ class WatsonXAIEnvConfig(BaseModel):
         if not config.get("WATSONX_SPACE_ID") and not config.get("WATSONX_APIKEY"):
              raise ValueError("Missing configuration requirements 'WATSONX_SPACE_ID' and 'WATSONX_APIKEY'")
         
-        if config.get("WATSONX_SPACE_ID") and not config.get("WATSONX_APIKEY"):
-            logger.error("Cannot use env var 'WATSONX_SPACE_ID' without setting the corresponding 'WATSONX_APIKEY'")
-            sys.exit(1)
         
         if not config.get("WATSONX_SPACE_ID") and config.get("WATSONX_APIKEY"):
             logger.error("Cannot use env var 'WATSONX_APIKEY' without setting the corresponding 'WATSONX_SPACE_ID'")
@@ -54,6 +52,12 @@ class WatsonXAIEnvConfig(BaseModel):
         config["USE_SAAS_ML_TOOLS_RUNTIME"] = False
         return config
 
+def is_valid_uuid(value) -> bool:
+    try:
+        uuid.UUID(str(value))
+        return True
+    except (ValueError, TypeError, AttributeError):
+        return False
 
 class ModelGatewayEnvConfig(BaseModel):
     WO_API_KEY: str | None = None
@@ -84,7 +88,10 @@ class ModelGatewayEnvConfig(BaseModel):
         if not config.get("AUTHORIZATION_URL"):
             inferred_auth_url = AUTH_TYPE_DEFAULT_URL_MAPPING.get(auth_type)
             if not inferred_auth_url:
-                logger.error(f"No 'AUTHORIZATION_URL' found. Auth type '{auth_type}' does not support defaulting. Please set the 'AUTHORIZATION_URL' explictly")
+                if auth_type == WoAuthType.CPD:
+                    inferred_auth_url = config.get("WO_INSTANCE") + '/icp4d-api/v1/authorize'   
+                else: 
+                    logger.error(f"No 'AUTHORIZATION_URL' found. Auth type '{auth_type}' does not support defaulting. Please set the 'AUTHORIZATION_URL' explictly")
                 sys.exit(1)
             config["AUTHORIZATION_URL"] = inferred_auth_url
         
@@ -101,6 +108,7 @@ class ModelGatewayEnvConfig(BaseModel):
                 sys.exit(1)
         
         config["USE_SAAS_ML_TOOLS_RUNTIME"] = True
-        # Fake (but valid) UUIDv4 for knowledgebase check
-        config["WATSONX_SPACE_ID"] = "aaaaaaaa-aaaa-4aaa-aaaa-aaaaaaaaaaaa"
+        if not is_valid_uuid(config.get("WATSONX_SPACE_ID")):
+            # Fake (but valid) UUIDv4 for knowledgebase check
+            config["WATSONX_SPACE_ID"] = "aaaaaaaa-aaaa-4aaa-aaaa-aaaaaaaaaaaa"
         return config

{ibm_watsonx_orchestrate-1.10.0b1 → ibm_watsonx_orchestrate-1.11.0b0}/src/ibm_watsonx_orchestrate/docker/compose-lite.yml

@@ -62,6 +62,7 @@ services:
       WATSONX_API_KEY: ${WATSONX_APIKEY}
       WATSONX_URL: ${WATSONX_URL}
       WATSONX_SPACE_ID: ${WATSONX_SPACE_ID}
+      NODE_TLS_REJECT_UNAUTHORIZED: ${AI_GATEWAY_TLS_REJECT_UNAUTHORIZED}
 
   wxo-agent-gateway:
     image: ${AGENT_GATEWAY_REGISTRY:-us.icr.io/watson-orchestrate-private}/wxo-agent-gateway:${AGENT_GATEWAY_TAG:-latest}
@@ -327,6 +328,7 @@ services:
       ENABLE_WEBHOOKS: false
       DISABLE_JSON_LOG_CELERY: true
       WXO_DEPLOYMENT_PLATFORM: saas
+      CPD_VERIFY: ${CPD_VERIFY}
       CONNECTION_MANAGER_URL: http://wxo-server-connection-manager:3001
       CHANNEL_SESSION_REDIS_URL: redis://wxo-server-redis:6379/5
       WXO_MILVUS_URI: http://wxo-milvus-standalone:19530
@@ -446,6 +448,7 @@ services:
       IBM_TELEMETRY_TRACER_ENDPOINT: http://jaeger:4318/v1/traces
       USE_IBM_TELEMETRY: ${USE_IBM_TELEMETRY:-false}
       WXO_DEPLOYMENT_PLATFORM: saas
+      CPD_VERIFY: ${CPD_VERIFY}
       CALLBACK_HOST_URL: ${CALLBACK_HOST_URL:-http://wxo-server:4321}
       LANGFLOW_ENABLED: ${LANGFLOW_ENABLED:-false}
   
@@ -653,6 +656,7 @@ services:
       - WATSONX_URL=${WATSONX_URL}
       - PROXY_SERVER_URL=http://jaeger-proxy:9201
       - WXO_DEPLOYMENT_PLATFORM=saas
+      - CPD_VERIFY=${CPD_VERIFY}      
       - TENANT_API_KEY=${AGENTOPS_API_KEY}
       - TENANT_CONFIG_URL=http://wxo-server:4321
       - TENANT_DEFAULT_USERNAME=${ES_USERNAME}

{ibm_watsonx_orchestrate-1.10.0b1 → ibm_watsonx_orchestrate-1.11.0b0}/src/ibm_watsonx_orchestrate/docker/default.env

@@ -58,10 +58,10 @@ REGISTRY_URL=
 
 
 
-SERVER_TAG=20-08-2025-cf6e342
+SERVER_TAG=29-08-2025-59ef405
 SERVER_REGISTRY=
 
-WORKER_TAG=20-08-2025-cf6e342
+WORKER_TAG=29-08-2025-cf32b2d
 WORKER_REGISTRY=
 
 AI_GATEWAY_TAG=20-08-2025-9ed6d40
@@ -78,7 +78,7 @@ AMDDBTAG=29-07-2025-9f3661b
 ARM64DBTAG=29-07-2025-9f3661b
 
 UI_REGISTRY=
-UITAG=31-07-2025
+UITAG=29-08-2025
 
 CM_REGISTRY=
 CM_TAG=24-07-2025
@@ -86,13 +86,13 @@ CM_TAG=24-07-2025
 TRM_TAG=19-08-2025-fe105eb0b950ff304f712a1a5b9fa3cba92d09da
 TRM_REGISTRY=
 
-TR_TAG=19-08-2025-fe105eb0b950ff304f712a1a5b9fa3cba92d09da
+TR_TAG=25-08-2025-58ae475
 TR_REGISTRY=
 
-BUILDER_TAG=19-08-2025-1a79d34
+BUILDER_TAG=27-08-2025-7432aca
 BUILDER_REGISTRY=
 
-FLOW_RUNTIME_TAG=18-08-2025-v2
+FLOW_RUNTIME_TAG=26-08-2025-3b7f19e
 FLOW_RUMTIME_REGISTRY=
 
 
@@ -126,6 +126,8 @@ DOCPROC_REGISTRY=
 
 # END -- IMAGE REGISTRIES AND TAGS
 
+CPD_VERIFY=true
+AI_GATEWAY_TLS_REJECT_UNAUTHORIZED=1
 TAVILY_API_KEY=dummy_tavily_api_key
 PREFERRED_MODELS=meta-llama/llama-3-2-90b-vision-instruct,meta-llama/llama-3-405b-instruct
 INCOMPATIBLE_MODELS=flan,embedding,cross-encoder,tinytimemixers

{ibm_watsonx_orchestrate-1.10.0b1 → ibm_watsonx_orchestrate-1.11.0b0}/src/ibm_watsonx_orchestrate/flow_builder/data_map.py

@@ -12,7 +12,10 @@ class DataMap(BaseModel):
     def to_json(self) -> dict[str, Any]:
         model_spec = {}
         if self.maps and len(self.maps) > 0:
-            model_spec["maps"] = [assignment.model_dump() for assignment in self.maps]
+            model_spec["maps"] = []
+            for assignment in self.maps:
+                model_spec["maps"].append(assignment.model_dump())
+        return model_spec
 
     def add(self, line: Assignment) -> Self:
         self.maps.append(line)