feat(odata): add SHOW/DESCRIBE CONTRACT commands to browse cached $metadata

Parse the Metadata XML field stored on consumed OData services to let users
browse available entities, properties, actions, and generate MDL from contracts
without network access.

New commands:
- SHOW CONTRACT ENTITIES FROM Module.Service
- SHOW CONTRACT ACTIONS FROM Module.Service
- DESCRIBE CONTRACT ENTITY Module.Service.Entity [FORMAT mdl]
- DESCRIBE CONTRACT ACTION Module.Service.Action [FORMAT mdl]

Implementation:
- Add Metadata, MetadataHash, and Catalog fields to ConsumedODataService model
- Add EDMX/CSDL XML parser (sdk/mpr/edmx.go) supporting OData3 and OData4
- Add CONTRACT token to lexer, grammar rules before ambiguous alternatives
- Add executor handlers with FORMAT mdl generating CREATE EXTERNAL ENTITY
- Update help topics, quick reference, docs-site, CLAUDE.md, skills, examples

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

Author: ako

.claude/skills/mendix/odata-data-sharing.md

@@ -511,8 +511,14 @@ DESCRIBE ODATA CLIENT ShopViewsClient.ShopViewsApiClient;
 
 -- See external entities and view entities
 SHOW ENTITIES IN ShopViewsClient;
-DESCRIBE ENTITY ShopViewsClient.ProductWithActivePricesEE;
-DESCRIBE ENTITY ShopViews.ProductWithActivePriceVE;
+SHOW EXTERNAL ENTITIES;
+SHOW EXTERNAL ACTIONS;
+
+-- Browse available assets from cached $metadata contract
+SHOW CONTRACT ENTITIES FROM ShopViewsClient.ShopViewsApiClient;
+SHOW CONTRACT ACTIONS FROM ShopViewsClient.ShopViewsApiClient;
+DESCRIBE CONTRACT ENTITY ShopViewsClient.ShopViewsApiClient.Product;
+DESCRIBE CONTRACT ENTITY ShopViewsClient.ShopViewsApiClient.Product FORMAT mdl;
 
 -- Check security setup
 SHOW ACCESS ON ODATA SERVICE ShopViews.ShopViewsApi;

CLAUDE.md

@@ -405,6 +405,9 @@ Full syntax tables for all MDL statements (microflows, pages, security, navigati
 - CREATE/DROP WORKFLOW with user tasks, decisions, parallel splits, and other activity types
 - CALCULATED BY microflow syntax for calculated attributes
 - Image collections (SHOW/DESCRIBE/CREATE/DROP)
+- OData contract browsing (SHOW/DESCRIBE CONTRACT ENTITIES/ACTIONS FROM cached $metadata)
+- SHOW EXTERNAL ACTIONS, SHOW PUBLISHED REST SERVICES
+- Integration catalog tables (rest_clients, rest_operations, published_rest_services, external_entities, external_actions, business_events)
 
 **Not Yet Implemented:**
 - 47 of 52 metamodel domains (REST, etc.)

cmd/mxcli/help_topics/odata.txt

@@ -13,6 +13,16 @@ SHOW COMMANDS
   SHOW EXTERNAL ACTIONS;              -- List external actions used in microflows
   SHOW EXTERNAL ACTIONS IN MyModule;  -- Filter by module
 
+CONTRACT COMMANDS (browse cached $metadata)
+--------------------------------------------
+
+  SHOW CONTRACT ENTITIES FROM MyModule.MyClient;   -- List entity types from $metadata
+  SHOW CONTRACT ACTIONS FROM MyModule.MyClient;    -- List actions/functions from $metadata
+
+  DESCRIBE CONTRACT ENTITY MyModule.MyClient.Product;             -- Properties and nav props
+  DESCRIBE CONTRACT ENTITY MyModule.MyClient.Product FORMAT mdl;  -- Generate CREATE EXTERNAL ENTITY
+  DESCRIBE CONTRACT ACTION MyModule.MyClient.CreateOrder;         -- Parameters and return type
+
 DESCRIBE COMMANDS
 -----------------
 

cmd/mxcli/lsp_completions_gen.go

@@ -91,9 +91,14 @@ CREATE CONSTANT MyModule.EnableLogging TYPE Boolean DEFAULT true;
 | Alter OData service | `ALTER ODATA SERVICE Module.Name SET Key = Value;` | |
 | Drop OData service | `DROP ODATA SERVICE Module.Name;` | |
 | Show external entities | `SHOW EXTERNAL ENTITIES [IN Module];` | OData-backed entities |
+| Show external actions | `SHOW EXTERNAL ACTIONS [IN Module];` | Actions used in microflows |
 | Create external entity | `CREATE [OR MODIFY] EXTERNAL ENTITY Module.Name FROM ODATA CLIENT Module.Client (...) (attrs);` | |
 | Grant OData access | `GRANT ACCESS ON ODATA SERVICE Module.Name TO Module.Role, ...;` | |
 | Revoke OData access | `REVOKE ACCESS ON ODATA SERVICE Module.Name FROM Module.Role, ...;` | |
+| Show contract entities | `SHOW CONTRACT ENTITIES FROM Module.Client;` | Browse cached $metadata |
+| Show contract actions | `SHOW CONTRACT ACTIONS FROM Module.Client;` | Browse cached $metadata |
+| Describe contract entity | `DESCRIBE CONTRACT ENTITY Module.Client.Entity [FORMAT mdl];` | Properties, types, keys |
+| Describe contract action | `DESCRIBE CONTRACT ACTION Module.Client.Action [FORMAT mdl];` | Parameters, return type |
 
 **OData Client Example:**
 ```sql

docs-site/src/appendixes/quick-reference.md

@@ -94,9 +94,14 @@ CREATE CONSTANT MyModule.EnableLogging TYPE Boolean DEFAULT true;
 | Alter OData service | `ALTER ODATA SERVICE Module.Name SET Key = Value;` | |
 | Drop OData service | `DROP ODATA SERVICE Module.Name;` | |
 | Show external entities | `SHOW EXTERNAL ENTITIES [IN Module];` | OData-backed entities |
+| Show external actions | `SHOW EXTERNAL ACTIONS [IN Module];` | Actions used in microflows |
 | Create external entity | `CREATE [OR MODIFY] EXTERNAL ENTITY Module.Name FROM ODATA CLIENT Module.Client (...) (attrs);` | |
 | Grant OData access | `GRANT ACCESS ON ODATA SERVICE Module.Name TO Module.Role, ...;` | |
 | Revoke OData access | `REVOKE ACCESS ON ODATA SERVICE Module.Name FROM Module.Role, ...;` | |
+| Show contract entities | `SHOW CONTRACT ENTITIES FROM Module.Client;` | Browse cached $metadata |
+| Show contract actions | `SHOW CONTRACT ACTIONS FROM Module.Client;` | Browse cached $metadata |
+| Describe contract entity | `DESCRIBE CONTRACT ENTITY Module.Client.Entity [FORMAT mdl];` | Properties, types, keys |
+| Describe contract action | `DESCRIBE CONTRACT ACTION Module.Client.Action [FORMAT mdl];` | Parameters, return type |
 
 **OData Client Example:**
 ```sql

docs/01-project/MDL_QUICK_REFERENCE.md

@@ -365,6 +365,40 @@ SHOW EXTERNAL ACTIONS;
 SHOW EXTERNAL ACTIONS IN OdTest;
 /
 
+-- ############################################################################
+-- LEVEL 10: CONTRACT BROWSING (cached $metadata)
+-- ############################################################################
+
+/**
+ * Level 10.1: Browse entity types from a consumed OData service's cached $metadata
+ */
+SHOW CONTRACT ENTITIES FROM OdTest.SalesforceAPI;
+/
+
+/**
+ * Level 10.2: Browse actions/functions from the contract
+ */
+SHOW CONTRACT ACTIONS FROM OdTest.SalesforceAPI;
+/
+
+/**
+ * Level 10.3: Describe a specific entity type from the contract
+ */
+DESCRIBE CONTRACT ENTITY OdTest.SalesforceAPI.Account;
+/
+
+/**
+ * Level 10.4: Generate CREATE EXTERNAL ENTITY from the contract
+ */
+DESCRIBE CONTRACT ENTITY OdTest.SalesforceAPI.Account FORMAT mdl;
+/
+
+/**
+ * Level 10.5: Describe a specific action from the contract
+ */
+DESCRIBE CONTRACT ACTION OdTest.SalesforceAPI.CreateOrder;
+/
+
 -- ############################################################################
 -- LEVEL 8.8: DROP (cleanup)
 -- ############################################################################

mdl-examples/doctype-tests/10-odata-examples.mdl

@@ -80,6 +80,8 @@ const (
 	ShowRestClients           // SHOW REST CLIENTS [IN module]
 	ShowPublishedRestServices // SHOW PUBLISHED REST SERVICES [IN module]
 	ShowConstantValues       // SHOW CONSTANT VALUES [IN module]
+	ShowContractEntities     // SHOW CONTRACT ENTITIES FROM Module.Service
+	ShowContractActions      // SHOW CONTRACT ACTIONS FROM Module.Service
 )
 
 // String returns the human-readable name of the show object type.
@@ -187,6 +189,10 @@ func (t ShowObjectType) String() string {
 		return "PUBLISHED REST SERVICES"
 	case ShowConstantValues:
 		return "CONSTANT VALUES"
+	case ShowContractEntities:
+		return "CONTRACT ENTITIES"
+	case ShowContractActions:
+		return "CONTRACT ACTIONS"
 	default:
 		return "UNKNOWN"
 	}
@@ -203,7 +209,8 @@ func (s *SelectStmt) isStatement() {}
 type DescribeStmt struct {
 	ObjectType DescribeObjectType
 	Name       QualifiedName
-	WithAll    bool // For DESCRIBE MODULE ... WITH ALL
+	WithAll    bool   // For DESCRIBE MODULE ... WITH ALL
+	Format     string // For DESCRIBE CONTRACT ... FORMAT mdl
 }
 
 func (s *DescribeStmt) isStatement() {}
@@ -238,6 +245,8 @@ const (
 	DescribeImageCollection      // DESCRIBE IMAGE COLLECTION Module.Name
 	DescribeRestClient           // DESCRIBE REST CLIENT Module.Name
 	DescribePublishedRestService // DESCRIBE PUBLISHED REST SERVICE Module.Name
+	DescribeContractEntity       // DESCRIBE CONTRACT ENTITY Service.EntityName [FORMAT mdl]
+	DescribeContractAction       // DESCRIBE CONTRACT ACTION Service.ActionName [FORMAT mdl]
 )
 
 // String returns the human-readable name of the describe object type.
@@ -295,6 +304,10 @@ func (t DescribeObjectType) String() string {
 		return "REST CLIENT"
 	case DescribePublishedRestService:
 		return "PUBLISHED REST SERVICE"
+	case DescribeContractEntity:
+		return "CONTRACT ENTITY"
+	case DescribeContractAction:
+		return "CONTRACT ACTION"
 	default:
 		return "UNKNOWN"
 	}