feat(catalog): index agent-editor documents (schema v5)

Agents, AI models, knowledge bases, and consumed MCP services share one
CustomBlobDocuments$CustomBlobDocument BSON wrapper, distinguished by the
CustomDocumentType discriminator. The document name is a top-level field of
that wrapper (not buried in the inner JSON config blob), so these are read
through the raw-unit surface and decoded directly — no CatalogReader/backend
change, keeping clear of the modelsdk-branch rewrite.

Adds four tables (agents, ai_models, knowledge_bases, consumed_mcp_services)
and unions them into the objects view (AGENT / AI_MODEL / KNOWLEDGE_BASE /
CONSUMED_MCP_SERVICE). describe auto-detect resolves all four by bare name.
Catalog schema bumped to v5; completes the objects index for #658.

Verified against test3-app: 8 agent-editor docs across all four types;
describe AgentEditorCommons.TranslationAgent round-trips.

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

Author: ako

CHANGELOG.md

@@ -15,7 +15,8 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/).
 ### Changed
 
 - **Catalog `objects` index includes associations** — the unified `objects` view now unions the `associations` table (`ObjectType = ASSOCIATION`), so it is a complete index for the cataloged document types and consumers no longer need a separate associations query. Catalog schema bumped to v3; cached `.mxcli/catalog.db` files rebuild automatically on the next `refresh catalog`.
-- **Catalog indexes image collections, JavaScript actions, and data transformers** — these document types had no catalog table at all; they are now built (via the raw-unit surface, so no `CatalogReader`/backend change) into their own tables and unioned into `objects` (`IMAGE_COLLECTION`, `JAVASCRIPT_ACTION`, `DATA_TRANSFORMER`). `describe` auto-detect resolves image collections and data transformers by bare name. Catalog schema bumped to v4. (Agent-editor docs — agent/model/knowledge base/consumed MCP service — remain uncataloged: they are `CustomBlobDocument`s with the name inside a JSON blob; tracked in #658.)
+- **Catalog indexes image collections, JavaScript actions, and data transformers** — these document types had no catalog table at all; they are now built (via the raw-unit surface, so no `CatalogReader`/backend change) into their own tables and unioned into `objects` (`IMAGE_COLLECTION`, `JAVASCRIPT_ACTION`, `DATA_TRANSFORMER`). `describe` auto-detect resolves image collections and data transformers by bare name. Catalog schema bumped to v4.
+- **Catalog indexes agent-editor documents** — agents, AI models, knowledge bases, and consumed MCP services (one shared `CustomBlobDocuments$CustomBlobDocument` BSON wrapper, distinguished by `CustomDocumentType`) are now cataloged into their own tables and unioned into `objects` (`AGENT`, `AI_MODEL`, `KNOWLEDGE_BASE`, `CONSUMED_MCP_SERVICE`). The document name turned out to be a top-level wrapper field (not buried in the inner JSON blob), so this reads through the raw-unit surface with no `CatalogReader`/backend change, and `describe` auto-detect resolves all four by bare name. Catalog schema bumped to v5; this completes the `objects` index for the document types tracked in #658. (Verified against `test3-app`: 8 agent-editor docs across all four types.)
 
 ### Fixed
 

cmd/mxcli/cmd_describe.go

@@ -307,6 +307,10 @@ var objectTypeToDescribe = map[string]string{
 	"DATABASE_CONNECTION":    "databaseconnection",
 	"IMAGE_COLLECTION":       "imagecollection",
 	"DATA_TRANSFORMER":       "datatransformer",
+	"AGENT":                  "agent",
+	"AI_MODEL":               "model",
+	"KNOWLEDGE_BASE":         "knowledgebase",
+	"CONSUMED_MCP_SERVICE":   "consumedmcpservice",
 	// JAVASCRIPT_ACTION is cataloged but has no `describe` CLI form, so it is
 	// intentionally omitted from auto-detect.
 }

mdl/catalog/builder.go

@@ -389,6 +389,10 @@ func (b *Builder) Build(progress ProgressFunc) error {
 		return fmt.Errorf("failed to build data transformers: %w", err)
 	}
 
+	if err := b.buildAgentEditorDocs(); err != nil {
+		return fmt.Errorf("failed to build agent-editor documents: %w", err)
+	}
+
 	if err := b.buildMicroflows(); err != nil {
 		return fmt.Errorf("failed to build microflows: %w", err)
 	}

mdl/catalog/builder_agenteditor.go

@@ -0,0 +1,88 @@
+// SPDX-License-Identifier: Apache-2.0
+
+package catalog
+
+import (
+	"database/sql"
+
+	"go.mongodb.org/mongo-driver/bson"
+)
+
+// agentEditorTable maps a CustomBlobDocument's CustomDocumentType to its catalog
+// table. The four agent-editor document types share one BSON wrapper
+// (CustomBlobDocuments$CustomBlobDocument) and are distinguished by this field.
+var agentEditorTable = map[string]string{
+	"agenteditor.agent":              "agents",
+	"agenteditor.model":              "ai_models",
+	"agenteditor.knowledgebase":      "knowledge_bases",
+	"agenteditor.consumedMCPService": "consumed_mcp_services",
+}
+
+// buildAgentEditorDocs catalogs the agent-editor documents (agent / model /
+// knowledge base / consumed MCP service). The document name is a top-level field
+// of the BSON wrapper (the type-specific config lives in the inner JSON blob,
+// which the catalog does not need), so this reads through the raw-unit surface
+// and decodes only the wrapper fields — no CatalogReader/backend change.
+func (b *Builder) buildAgentEditorDocs() error {
+	units, err := b.reader.ListRawUnitsByType("CustomBlobDocuments$CustomBlobDocument")
+	if err != nil {
+		return err
+	}
+
+	stmts := map[string]*sql.Stmt{}
+	defer func() {
+		for _, s := range stmts {
+			s.Close()
+		}
+	}()
+	stmtFor := func(table string) (*sql.Stmt, error) {
+		if s, ok := stmts[table]; ok {
+			return s, nil
+		}
+		s, err := b.tx.Prepare("INSERT INTO " + table + "_data " +
+			"(Id, Name, QualifiedName, ModuleName, Folder, Description, ProjectId, SnapshotId) " +
+			"VALUES (?, ?, ?, ?, ?, ?, ?, ?)")
+		if err != nil {
+			return nil, err
+		}
+		stmts[table] = s
+		return s, nil
+	}
+
+	projectID, snapshotID := b.snapshotMeta()
+
+	count := 0
+	for _, u := range units {
+		var doc struct {
+			Name               string `bson:"Name"`
+			Documentation      string `bson:"Documentation"`
+			CustomDocumentType string `bson:"CustomDocumentType"`
+		}
+		if err := bson.Unmarshal(u.Contents, &doc); err != nil || doc.Name == "" {
+			continue
+		}
+		table, ok := agentEditorTable[doc.CustomDocumentType]
+		if !ok {
+			continue // not an agent-editor document type we catalog
+		}
+		stmt, err := stmtFor(table)
+		if err != nil {
+			return err
+		}
+		moduleID := b.hierarchy.findModuleID(u.ContainerID)
+		moduleName := b.hierarchy.getModuleName(moduleID)
+		qualifiedName := moduleName + "." + doc.Name
+		folderPath := b.hierarchy.buildFolderPath(u.ContainerID)
+
+		if _, err := stmt.Exec(
+			string(u.ID), doc.Name, qualifiedName, moduleName, folderPath,
+			doc.Documentation, projectID, snapshotID,
+		); err != nil {
+			return err
+		}
+		count++
+	}
+
+	b.report("Agent-editor documents", count)
+	return nil
+}

mdl/catalog/catalog_test.go

@@ -189,6 +189,10 @@ func TestObjectsView_IncludesNewDocumentTypes(t *testing.T) {
 		{"javascript_actions", "JAVASCRIPT_ACTION"},
 		{"image_collections", "IMAGE_COLLECTION"},
 		{"data_transformers", "DATA_TRANSFORMER"},
+		{"agents", "AGENT"},
+		{"ai_models", "AI_MODEL"},
+		{"knowledge_bases", "KNOWLEDGE_BASE"},
+		{"consumed_mcp_services", "CONSUMED_MCP_SERVICE"},
 	}
 	for _, tc := range cases {
 		t.Run(tc.objectType, func(t *testing.T) {

mdl/catalog/tables.go

@@ -12,7 +12,7 @@ package catalog
 //	    SnapshotSource / SourceId / SourceBranch / SourceRevision columns
 //	    from every row (issue #576).
 //	1 — initial flat schema with denormalized snapshot columns on every row.
-const CatalogSchemaVersion = "4"
+const CatalogSchemaVersion = "5"
 
 // MetaSchemaVersion is the catalog_meta key that records the schema version
 // the cache was built against.
@@ -284,6 +284,29 @@ func (c *Catalog) createTables() error {
 		)`,
 		viewWithFullSnapshot("data_transformers"),
 
+		// agent-editor documents (CustomBlobDocuments, discriminated by
+		// CustomDocumentType into agent / model / knowledge base / MCP service).
+		`CREATE TABLE IF NOT EXISTS agents_data (
+			Id TEXT PRIMARY KEY, Name TEXT, QualifiedName TEXT, ModuleName TEXT,
+			Folder TEXT, Description TEXT, ProjectId TEXT, SnapshotId TEXT
+		)`,
+		viewWithFullSnapshot("agents"),
+		`CREATE TABLE IF NOT EXISTS ai_models_data (
+			Id TEXT PRIMARY KEY, Name TEXT, QualifiedName TEXT, ModuleName TEXT,
+			Folder TEXT, Description TEXT, ProjectId TEXT, SnapshotId TEXT
+		)`,
+		viewWithFullSnapshot("ai_models"),
+		`CREATE TABLE IF NOT EXISTS knowledge_bases_data (
+			Id TEXT PRIMARY KEY, Name TEXT, QualifiedName TEXT, ModuleName TEXT,
+			Folder TEXT, Description TEXT, ProjectId TEXT, SnapshotId TEXT
+		)`,
+		viewWithFullSnapshot("knowledge_bases"),
+		`CREATE TABLE IF NOT EXISTS consumed_mcp_services_data (
+			Id TEXT PRIMARY KEY, Name TEXT, QualifiedName TEXT, ModuleName TEXT,
+			Folder TEXT, Description TEXT, ProjectId TEXT, SnapshotId TEXT
+		)`,
+		viewWithFullSnapshot("consumed_mcp_services"),
+
 		// activities
 		`CREATE TABLE IF NOT EXISTS activities_data (
 			Id TEXT PRIMARY KEY,
@@ -858,6 +881,22 @@ func (c *Catalog) createTables() error {
 				ProjectId, ProjectName, SnapshotId, SnapshotDate, SnapshotSource
 			FROM data_transformers
 			UNION ALL
+			SELECT Id, 'AGENT' as ObjectType, Name, QualifiedName, ModuleName, Folder, Description,
+				ProjectId, ProjectName, SnapshotId, SnapshotDate, SnapshotSource
+			FROM agents
+			UNION ALL
+			SELECT Id, 'AI_MODEL' as ObjectType, Name, QualifiedName, ModuleName, Folder, Description,
+				ProjectId, ProjectName, SnapshotId, SnapshotDate, SnapshotSource
+			FROM ai_models
+			UNION ALL
+			SELECT Id, 'KNOWLEDGE_BASE' as ObjectType, Name, QualifiedName, ModuleName, Folder, Description,
+				ProjectId, ProjectName, SnapshotId, SnapshotDate, SnapshotSource
+			FROM knowledge_bases
+			UNION ALL
+			SELECT Id, 'CONSUMED_MCP_SERVICE' as ObjectType, Name, QualifiedName, ModuleName, Folder, Description,
+				ProjectId, ProjectName, SnapshotId, SnapshotDate, SnapshotSource
+			FROM consumed_mcp_services
+			UNION ALL
 			SELECT Id, 'ODATA_CLIENT' as ObjectType, Name, QualifiedName, ModuleName, '' as Folder, '' as Description,
 				ProjectId, ProjectName, SnapshotId, SnapshotDate, SnapshotSource
 			FROM odata_clients