feat: add read support for agent-editor Model documents (SHOW/DESCRIBE MODEL)

First step of agent-editor document support. Adds the generic
CustomBlobDocument parser framework (shared by all four agent-editor
document types) and implements the MODEL handler end-to-end.

Implements:
- sdk/agenteditor package with Model, Agent, KnowledgeBase, and
  ConsumedMCPService type definitions (Model fully wired; others
  scaffolded for later phases)
- sdk/mpr/parser_customblob.go — generic wrapper decoder plus Model
  Contents JSON decoder (dispatches by CustomDocumentType)
- Reader.ListAgentEditorModels() returns all agenteditor.model docs
- MDL keywords: MODEL, MODELS (added to lexer and keyword rule)
- SHOW MODELS [IN module] grammar/AST/visitor/executor — lists models
  with qualified name, provider, and key constant reference
- DESCRIBE MODEL Module.Name grammar/AST/visitor/executor — emits
  round-trippable CREATE MODEL MDL. User-set fields (Provider, Key)
  come first; Portal-populated fields (DisplayName, KeyName, etc.)
  only emitted when non-empty

Verified against test3 project:
- SHOW MODELS correctly shows Agents.MyFirstModel with provider
  MxCloudGenAI and key Agents.LLMKey
- DESCRIBE MODEL Agents.MyFirstModel produces valid CREATE MODEL MDL
- SHOW MODELS IN <module> filter works (shows/hides by module match)
- DESCRIBE MODEL <non-existent> returns actionable error

Test coverage: existing test suites pass. No new tests in this commit
— will add round-trip test when CREATE MODEL lands so there is a
document to write then read back.

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

Author: ako

cmd/mxcli/lsp_completions_gen.go

@@ -89,6 +89,7 @@ const (
 	ShowJsonStructures        // SHOW JSON STRUCTURES [IN module]
 	ShowImportMappings        // SHOW IMPORT MAPPINGS [IN module]
 	ShowExportMappings        // SHOW EXPORT MAPPINGS [IN module]
+	ShowModels                // SHOW MODELS [IN module] (agent-editor Model documents)
 )
 
 // String returns the human-readable name of the show object type.
@@ -214,6 +215,8 @@ func (t ShowObjectType) String() string {
 		return "IMPORT MAPPINGS"
 	case ShowExportMappings:
 		return "EXPORT MAPPINGS"
+	case ShowModels:
+		return "MODELS"
 	default:
 		return "UNKNOWN"
 	}
@@ -291,6 +294,7 @@ const (
 	DescribeNanoflow             // DESCRIBE NANOFLOW Module.Name
 	DescribeImportMapping        // DESCRIBE IMPORT MAPPING Module.Name
 	DescribeExportMapping        // DESCRIBE EXPORT MAPPING Module.Name
+	DescribeModel                // DESCRIBE MODEL Module.Name (agent-editor Model document)
 )
 
 // String returns the human-readable name of the describe object type.
@@ -364,6 +368,8 @@ func (t DescribeObjectType) String() string {
 		return "IMPORT MAPPING"
 	case DescribeExportMapping:
 		return "EXPORT MAPPING"
+	case DescribeModel:
+		return "MODEL"
 	default:
 		return "UNKNOWN"
 	}

mdl/ast/ast_query.go

@@ -0,0 +1,150 @@
+// SPDX-License-Identifier: Apache-2.0
+
+// Package executor - Commands for agent-editor Model documents.
+//
+// Handles `SHOW MODELS [IN module]` and `DESCRIBE MODEL Module.Name`.
+// The underlying BSON is a CustomBlobDocuments$CustomBlobDocument with
+// CustomDocumentType = "agenteditor.model". See
+// docs/11-proposals/PROPOSAL_agent_document_support.md for schema.
+package executor
+
+import (
+	"fmt"
+
+	"github.com/mendixlabs/mxcli/mdl/ast"
+	"github.com/mendixlabs/mxcli/sdk/agenteditor"
+)
+
+// showAgentEditorModels handles SHOW MODELS [IN module].
+func (e *Executor) showAgentEditorModels(moduleName string) error {
+	if e.reader == nil {
+		return fmt.Errorf("not connected to a project")
+	}
+
+	models, err := e.reader.ListAgentEditorModels()
+	if err != nil {
+		return fmt.Errorf("failed to list models: %w", err)
+	}
+
+	h, err := e.getHierarchy()
+	if err != nil {
+		return err
+	}
+
+	result := &TableResult{
+		Columns: []string{"Qualified Name", "Module", "Name", "Provider", "Key Constant", "Display Name"},
+	}
+
+	for _, m := range models {
+		modID := h.FindModuleID(m.ContainerID)
+		modName := h.GetModuleName(modID)
+		if moduleName != "" && modName != moduleName {
+			continue
+		}
+
+		keyConstant := ""
+		if m.Key != nil {
+			keyConstant = m.Key.QualifiedName
+		}
+
+		result.Rows = append(result.Rows, []any{
+			fmt.Sprintf("%s.%s", modName, m.Name),
+			modName,
+			m.Name,
+			m.Provider,
+			keyConstant,
+			m.DisplayName,
+		})
+	}
+
+	result.Summary = fmt.Sprintf("(%d model(s))", len(result.Rows))
+	return e.writeResult(result)
+}
+
+// describeAgentEditorModel handles DESCRIBE MODEL Module.Name.
+// Emits a round-trippable CREATE MODEL statement.
+func (e *Executor) describeAgentEditorModel(name ast.QualifiedName) error {
+	if e.reader == nil {
+		return fmt.Errorf("not connected to a project")
+	}
+
+	m := e.findAgentEditorModel(name.Module, name.Name)
+	if m == nil {
+		return fmt.Errorf("model not found: %s", name)
+	}
+
+	h, err := e.getHierarchy()
+	if err != nil {
+		return err
+	}
+	modID := h.FindModuleID(m.ContainerID)
+	modName := h.GetModuleName(modID)
+	qualifiedName := fmt.Sprintf("%s.%s", modName, m.Name)
+
+	if m.Documentation != "" {
+		fmt.Fprintf(e.output, "/**\n * %s\n */\n", m.Documentation)
+	}
+
+	fmt.Fprintf(e.output, "CREATE MODEL %s (\n", qualifiedName)
+
+	// Emit properties in stable order. User-set properties (Provider, Key)
+	// come first; Portal-populated metadata comes last and only if non-empty.
+	var lines []string
+	if m.Provider != "" {
+		lines = append(lines, fmt.Sprintf("  Provider: %s", m.Provider))
+	}
+	if m.Key != nil && m.Key.QualifiedName != "" {
+		lines = append(lines, fmt.Sprintf("  Key: %s", m.Key.QualifiedName))
+	}
+	// Portal-populated fields — round-tripped but flagged read-only in MDL.
+	if m.DisplayName != "" {
+		lines = append(lines, fmt.Sprintf("  DisplayName: '%s'", escapeSQLString(m.DisplayName)))
+	}
+	if m.KeyName != "" {
+		lines = append(lines, fmt.Sprintf("  KeyName: '%s'", escapeSQLString(m.KeyName)))
+	}
+	if m.KeyID != "" {
+		lines = append(lines, fmt.Sprintf("  KeyId: '%s'", escapeSQLString(m.KeyID)))
+	}
+	if m.Environment != "" {
+		lines = append(lines, fmt.Sprintf("  Environment: '%s'", escapeSQLString(m.Environment)))
+	}
+	if m.ResourceName != "" {
+		lines = append(lines, fmt.Sprintf("  ResourceName: '%s'", escapeSQLString(m.ResourceName)))
+	}
+	if m.DeepLinkURL != "" {
+		lines = append(lines, fmt.Sprintf("  DeepLinkURL: '%s'", escapeSQLString(m.DeepLinkURL)))
+	}
+
+	for i, line := range lines {
+		if i < len(lines)-1 {
+			fmt.Fprintln(e.output, line+",")
+		} else {
+			fmt.Fprintln(e.output, line)
+		}
+	}
+
+	fmt.Fprintln(e.output, ");")
+	fmt.Fprintln(e.output, "/")
+	return nil
+}
+
+// findAgentEditorModel looks up a model by module and name.
+func (e *Executor) findAgentEditorModel(moduleName, modelName string) *agenteditor.Model {
+	models, err := e.reader.ListAgentEditorModels()
+	if err != nil {
+		return nil
+	}
+	h, err := e.getHierarchy()
+	if err != nil {
+		return nil
+	}
+	for _, m := range models {
+		modID := h.FindModuleID(m.ContainerID)
+		modName := h.GetModuleName(modID)
+		if m.Name == modelName && modName == moduleName {
+			return m
+		}
+	}
+	return nil
+}

mdl/executor/cmd_agenteditor_models.go

@@ -110,6 +110,8 @@ func (e *Executor) execShow(s *ast.ShowStmt) error {
 		return e.showDatabaseConnections(s.InModule)
 	case ast.ShowImageCollections:
 		return e.showImageCollections(s.InModule)
+	case ast.ShowModels:
+		return e.showAgentEditorModels(s.InModule)
 	case ast.ShowRestClients:
 		return e.showRestClients(s.InModule)
 	case ast.ShowPublishedRestServices:
@@ -196,6 +198,8 @@ func (e *Executor) execDescribe(s *ast.DescribeStmt) error {
 			return e.describeFragment(s.Name)
 		case ast.DescribeImageCollection:
 			return e.describeImageCollection(s.Name)
+		case ast.DescribeModel:
+			return e.describeAgentEditorModel(s.Name)
 		case ast.DescribeRestClient:
 			return e.describeRestClient(s.Name)
 		case ast.DescribePublishedRestService:
@@ -273,6 +277,8 @@ func describeObjectTypeLabel(t ast.DescribeObjectType) string {
 		return "fragment"
 	case ast.DescribeImageCollection:
 		return "imagecollection"
+	case ast.DescribeModel:
+		return "model"
 	case ast.DescribeRestClient:
 		return "restclient"
 	case ast.DescribePublishedRestService:

mdl/executor/executor_query.go

@@ -316,6 +316,8 @@ ATTRIBUTES: A T T R I B U T E S;
 FILTERTYPE: F I L T E R T Y P E;
 IMAGE: I M A G E;
 COLLECTION: C O L L E C T I O N;
+MODEL: M O D E L;
+MODELS: M O D E L S;
 STATICIMAGE: S T A T I C I M A G E;
 DYNAMICIMAGE: D Y N A M I C I M A G E;
 CUSTOMCONTAINER: C U S T O M C O N T A I N E R;

mdl/grammar/MDLLexer.g4

@@ -2909,6 +2909,7 @@ showStatement
     | showOrList JAVA ACTIONS (IN (qualifiedName | IDENTIFIER))?
     | showOrList JAVASCRIPT ACTIONS (IN (qualifiedName | IDENTIFIER))?
     | showOrList IMAGE COLLECTION (IN (qualifiedName | IDENTIFIER))?
+    | showOrList MODELS (IN (qualifiedName | IDENTIFIER))?
     | showOrList JSON STRUCTURES (IN (qualifiedName | IDENTIFIER))?
     | showOrList IMPORT MAPPINGS (IN (qualifiedName | IDENTIFIER))?
     | showOrList EXPORT MAPPINGS (IN (qualifiedName | IDENTIFIER))?
@@ -3043,6 +3044,7 @@ describeStatement
     | DESCRIBE FRAGMENT FROM PAGE qualifiedName WIDGET identifierOrKeyword     // DESCRIBE FRAGMENT FROM PAGE Module.Page WIDGET name
     | DESCRIBE FRAGMENT FROM SNIPPET qualifiedName WIDGET identifierOrKeyword  // DESCRIBE FRAGMENT FROM SNIPPET Module.Snippet WIDGET name
     | DESCRIBE IMAGE COLLECTION qualifiedName           // DESCRIBE IMAGE COLLECTION Module.Name
+    | DESCRIBE MODEL qualifiedName                      // DESCRIBE MODEL Module.Name (agent-editor)
     | DESCRIBE JSON STRUCTURE qualifiedName              // DESCRIBE JSON STRUCTURE Module.Name
     | DESCRIBE IMPORT MAPPING qualifiedName             // DESCRIBE IMPORT MAPPING Module.Name
     | DESCRIBE EXPORT MAPPING qualifiedName             // DESCRIBE EXPORT MAPPING Module.Name
@@ -3645,7 +3647,7 @@ keyword
     | INTEGER_TYPE | LONG_TYPE | STRING_TYPE | STRINGTEMPLATE_TYPE
 
     // Module / project structure
-    | ACTIONS | COLLECTION | FOLDER | LAYOUT | LAYOUTS | LOCAL | MODULE | MODULES
+    | ACTIONS | COLLECTION | FOLDER | LAYOUT | LAYOUTS | LOCAL | MODEL | MODELS | MODULE | MODULES
     | NOTEBOOK | NOTEBOOKS | PAGE | PAGES | PROJECT | SNIPPET | SNIPPETS
     | STORE | STRUCTURE | STRUCTURES | VIEW