@dereekb/firebase-server 13.12.2 → 13.12.3

package/mcp/index.cjs.js

@@ -357,7 +357,7 @@ function stringifyResult(result) {
     return firebase.callModelOidcScopeForCallType(callType);
 }
 
-function _array_like_to_array$5(arr, len) {
+function _array_like_to_array$6(arr, len) {
     if (len == null || len > arr.length) len = arr.length;
     for(var i = 0, arr2 = new Array(len); i < len; i++)arr2[i] = arr[i];
     return arr2;
@@ -393,19 +393,19 @@ function _non_iterable_rest$2() {
     throw new TypeError("Invalid attempt to destructure non-iterable instance.\\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method.");
 }
 function _sliced_to_array$2(arr, i) {
-    return _array_with_holes$2(arr) || _iterable_to_array_limit$2(arr, i) || _unsupported_iterable_to_array$5(arr, i) || _non_iterable_rest$2();
+    return _array_with_holes$2(arr) || _iterable_to_array_limit$2(arr, i) || _unsupported_iterable_to_array$6(arr, i) || _non_iterable_rest$2();
 }
 function _type_of$1(obj) {
     "@swc/helpers - typeof";
     return obj && typeof Symbol !== "undefined" && obj.constructor === Symbol ? "symbol" : typeof obj;
 }
-function _unsupported_iterable_to_array$5(o, minLen) {
+function _unsupported_iterable_to_array$6(o, minLen) {
     if (!o) return;
-    if (typeof o === "string") return _array_like_to_array$5(o, minLen);
+    if (typeof o === "string") return _array_like_to_array$6(o, minLen);
     var n = Object.prototype.toString.call(o).slice(8, -1);
     if (n === "Object" && o.constructor) n = o.constructor.name;
     if (n === "Map" || n === "Set") return Array.from(n);
-    if (n === "Arguments" || /^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(n)) return _array_like_to_array$5(o, minLen);
+    if (n === "Arguments" || /^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(n)) return _array_like_to_array$6(o, minLen);
 }
 /**
  * Default `toJsonSchema()` options.
@@ -691,13 +691,13 @@ function resolveInputSchema(context) {
     return result;
 }
 
-function _array_like_to_array$4(arr, len) {
+function _array_like_to_array$5(arr, len) {
     if (len == null || len > arr.length) len = arr.length;
     for(var i = 0, arr2 = new Array(len); i < len; i++)arr2[i] = arr[i];
     return arr2;
 }
-function _array_without_holes$4(arr) {
-    if (Array.isArray(arr)) return _array_like_to_array$4(arr);
+function _array_without_holes$5(arr) {
+    if (Array.isArray(arr)) return _array_like_to_array$5(arr);
 }
 function asyncGeneratorStep$3(gen, resolve, reject, _next, _throw, key, arg) {
     try {
@@ -728,22 +728,22 @@ function _async_to_generator$3(fn) {
         });
     };
 }
-function _iterable_to_array$4(iter) {
+function _iterable_to_array$5(iter) {
     if (typeof Symbol !== "undefined" && iter[Symbol.iterator] != null || iter["@@iterator"] != null) return Array.from(iter);
 }
-function _non_iterable_spread$4() {
+function _non_iterable_spread$5() {
     throw new TypeError("Invalid attempt to spread non-iterable instance.\\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method.");
 }
-function _to_consumable_array$4(arr) {
-    return _array_without_holes$4(arr) || _iterable_to_array$4(arr) || _unsupported_iterable_to_array$4(arr) || _non_iterable_spread$4();
+function _to_consumable_array$5(arr) {
+    return _array_without_holes$5(arr) || _iterable_to_array$5(arr) || _unsupported_iterable_to_array$5(arr) || _non_iterable_spread$5();
 }
-function _unsupported_iterable_to_array$4(o, minLen) {
+function _unsupported_iterable_to_array$5(o, minLen) {
     if (!o) return;
-    if (typeof o === "string") return _array_like_to_array$4(o, minLen);
+    if (typeof o === "string") return _array_like_to_array$5(o, minLen);
     var n = Object.prototype.toString.call(o).slice(8, -1);
     if (n === "Object" && o.constructor) n = o.constructor.name;
     if (n === "Map" || n === "Set") return Array.from(n);
-    if (n === "Arguments" || /^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(n)) return _array_like_to_array$4(o, minLen);
+    if (n === "Arguments" || /^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(n)) return _array_like_to_array$5(o, minLen);
 }
 function _ts_generator$3(thisArg, body) {
     var f, y, t, _ = {
@@ -1048,8 +1048,8 @@ function readInChunks(input) {
                     ];
                 case 2:
                     partial = _state.sent();
-                    (_merged_results = merged.results).push.apply(_merged_results, _to_consumable_array$4(partial.results));
-                    (_merged_errors = merged.errors).push.apply(_merged_errors, _to_consumable_array$4(partial.errors));
+                    (_merged_results = merged.results).push.apply(_merged_results, _to_consumable_array$5(partial.results));
+                    (_merged_errors = merged.errors).push.apply(_merged_errors, _to_consumable_array$5(partial.errors));
                     _state.label = 3;
                 case 3:
                     offset += MCP_MODEL_GET_BATCH_SIZE;
@@ -1140,6 +1140,14 @@ var MODEL_GET_OUTPUT_SCHEMA = {
     }
 };
 
+function _array_like_to_array$4(arr, len) {
+    if (len == null || len > arr.length) len = arr.length;
+    for(var i = 0, arr2 = new Array(len); i < len; i++)arr2[i] = arr[i];
+    return arr2;
+}
+function _array_without_holes$4(arr) {
+    if (Array.isArray(arr)) return _array_like_to_array$4(arr);
+}
 function _define_property$6(obj, key, value) {
     if (key in obj) {
         Object.defineProperty(obj, key, {
@@ -1153,6 +1161,12 @@ function _define_property$6(obj, key, value) {
     }
     return obj;
 }
+function _iterable_to_array$4(iter) {
+    if (typeof Symbol !== "undefined" && iter[Symbol.iterator] != null || iter["@@iterator"] != null) return Array.from(iter);
+}
+function _non_iterable_spread$4() {
+    throw new TypeError("Invalid attempt to spread non-iterable instance.\\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method.");
+}
 function _object_spread$2(target) {
     for(var i = 1; i < arguments.length; i++){
         var source = arguments[i] != null ? arguments[i] : {};
@@ -1168,6 +1182,36 @@ function _object_spread$2(target) {
     }
     return target;
 }
+function ownKeys(object, enumerableOnly) {
+    var keys = Object.keys(object);
+    if (Object.getOwnPropertySymbols) {
+        var symbols = Object.getOwnPropertySymbols(object);
+        keys.push.apply(keys, symbols);
+    }
+    return keys;
+}
+function _object_spread_props(target, source) {
+    source = source != null ? source : {};
+    if (Object.getOwnPropertyDescriptors) {
+        Object.defineProperties(target, Object.getOwnPropertyDescriptors(source));
+    } else {
+        ownKeys(Object(source)).forEach(function(key) {
+            Object.defineProperty(target, key, Object.getOwnPropertyDescriptor(source, key));
+        });
+    }
+    return target;
+}
+function _to_consumable_array$4(arr) {
+    return _array_without_holes$4(arr) || _iterable_to_array$4(arr) || _unsupported_iterable_to_array$4(arr) || _non_iterable_spread$4();
+}
+function _unsupported_iterable_to_array$4(o, minLen) {
+    if (!o) return;
+    if (typeof o === "string") return _array_like_to_array$4(o, minLen);
+    var n = Object.prototype.toString.call(o).slice(8, -1);
+    if (n === "Object" && o.constructor) n = o.constructor.name;
+    if (n === "Map" || n === "Set") return Array.from(n);
+    if (n === "Arguments" || /^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(n)) return _array_like_to_array$4(o, minLen);
+}
 // MARK: Constants
 /**
  * Reserved tool name for the built-in `model-info` static tool.
@@ -1180,13 +1224,27 @@ function _object_spread$2(target) {
  * Synthetic model type used in the tool's dispatch identity. Mirrors {@link MODEL_GET_DISPATCH_MODEL_TYPE};
  * apps avoiding collisions should not register a real model literally named "model".
  */ var MODEL_INFO_DISPATCH_MODEL_TYPE = 'model';
+/**
+ * Group label applied to manifest entries that declare no `modelGroup`. Keeps the `groups` mode
+ * total reconcilable with the catalog size (sum of group counts always equals `totalModels`).
+ */ var MODEL_INFO_UNGROUPED_LABEL = '(ungrouped)';
+/**
+ * Hint string surfaced alongside the default `groups` response so callers know how to drill in.
+ */ var MODEL_INFO_GROUPS_HINT = 'Pass `model` for one/many models, `modelGroup` for a group, or `all:true` for the full catalog.';
 // MARK: Factory
 /**
  * Builds the built-in `model-info` MCP tool definition.
  *
- * Mirrors dbx-cli's `model-info [model]` command:
- * - Without a `model` arg: returns a summary list (modelType, modelName, prefix, group, identity, field count).
- * - With a `model` arg: matches by `modelType`, `identityConst`, or `collectionPrefix` and returns the full entry.
+ * Modes (selected by input):
+ * - No args: returns model groups + counts (`mode: 'groups'`) — the cheap default for browsing.
+ * - `model` (string): returns the full entry for one model (`mode: 'single'`).
+ * - `model` (string array): returns full detail per match (`mode: 'multiple'`); misses land in `notFound`.
+ * - `modelGroup`: returns the summary list of that group's models (`mode: 'list'`).
+ * - `all: true`: returns the full catalog summary (`mode: 'list'`).
+ * - `fields`: forces (`true`) or suppresses (`false`) full persisted-field detail in list/multiple modes.
+ *
+ * Each `model` query matches by `modelType`, `identityConst`, or `collectionPrefix`. When several
+ * params are supplied, precedence is `model` > `modelGroup` > `all` > the default `groups` view.
  *
  * Output is delivered as both stringified JSON in `content[0].text` and `structuredContent`
  * so MCP clients can consume either form.
@@ -1199,7 +1257,8 @@ function _object_spread$2(target) {
         return Promise.resolve(modelInfoToolHandler(args, ctx, deps));
     };
     var name = MODEL_INFO_TOOL_NAME;
-    var description = "Browse the Firestore model catalog (".concat(deps.manifest.length, " model").concat(deps.manifest.length === 1 ? '' : 's', "). Without `model`, returns a summary list of every model. With `model` (matched by modelType, identityConst, or collectionPrefix), returns the full entry with persisted fields.");
+    var count = deps.manifest.length;
+    var description = "Browse the Firestore model catalog (".concat(count, " model").concat(count === 1 ? '' : 's', "). No args returns model groups + counts (start here). ") + '`model` (a modelType/identityConst/collectionPrefix string, or an array of them) returns full detail per match — misses are reported in `notFound`. ' + '`modelGroup` returns the summary list for that group. `all:true` returns the full catalog summary. ' + '`fields` (boolean) forces or suppresses persisted-field detail in list/multiple modes.';
     return {
         name: name,
         description: description,
@@ -1230,7 +1289,7 @@ function modelInfoToolHandler(args, _ctx, deps) {
     var result;
     try {
         var input = parseModelInfoInput(args);
-        var output = input.model == null ? buildListOutput(deps.manifest) : buildSingleOutput(input.model, deps.manifest);
+        var output = resolveModelInfoOutput(input, deps.manifest);
         result = {
             content: [
                 {
@@ -1245,60 +1304,285 @@ function modelInfoToolHandler(args, _ctx, deps) {
     }
     return result;
 }
+function resolveModelInfoOutput(input, manifest) {
+    var output;
+    if (input.modelQueries != null) {
+        output = buildModelLookupOutput({
+            queries: input.modelQueries,
+            isArray: input.modelIsArray,
+            manifest: manifest,
+            fields: input.fields
+        });
+    } else if (input.modelGroup != null) {
+        output = buildGroupFilterOutput({
+            group: input.modelGroup,
+            manifest: manifest,
+            fields: input.fields
+        });
+    } else if (input.all) {
+        output = buildAllOutput(manifest, input.fields);
+    } else {
+        output = buildGroupsOutput(manifest);
+    }
+    return output;
+}
+// MARK: Input parsing
 function parseModelInfoInput(args) {
-    var raw = args['model'];
-    var model;
+    var modelQueries = parseModelArg(args['model']);
+    var modelGroup = parseModelGroupArg(args['modelGroup']);
+    var all = parseBooleanArg(args['all'], 'all');
+    var fields = parseBooleanArg(args['fields'], 'fields');
+    return _object_spread$2(_object_spread_props(_object_spread$2(_object_spread_props(_object_spread$2({}, modelQueries == null ? {} : {
+        modelQueries: modelQueries
+    }), {
+        modelIsArray: Array.isArray(args['model'])
+    }), modelGroup == null ? {} : {
+        modelGroup: modelGroup
+    }), {
+        all: all !== null && all !== void 0 ? all : false
+    }), fields == null ? {} : {
+        fields: fields
+    });
+}
+function parseModelArg(raw) {
+    var result;
     if (raw == null) {
-        model = undefined;
+        result = undefined;
     } else if (typeof raw === 'string') {
-        var trimmed = raw.trim();
-        if (trimmed.length === 0) {
-            throw new Error('model-info: "model" must be a non-empty string when provided.');
+        result = [
+            requireNonEmptyString(raw, 'model')
+        ];
+    } else if (Array.isArray(raw)) {
+        if (raw.length === 0) {
+            throw new Error('model-info: "model" array must contain at least one entry.');
         }
-        model = trimmed;
+        result = raw.map(function(value, index) {
+            return requireNonEmptyString(value, "model[".concat(index, "]"));
+        });
+    } else {
+        throw new TypeError('model-info: "model" must be a string or an array of strings when provided.');
+    }
+    return result;
+}
+function parseModelGroupArg(raw) {
+    var result;
+    if (raw == null) {
+        result = undefined;
+    } else if (typeof raw === 'string') {
+        result = requireNonEmptyString(raw, 'modelGroup');
     } else {
-        throw new TypeError('model-info: "model" must be a string when provided.');
+        throw new TypeError('model-info: "modelGroup" must be a string when provided.');
+    }
+    return result;
+}
+function parseBooleanArg(raw, label) {
+    var result;
+    if (raw == null) {
+        result = undefined;
+    } else if (typeof raw === 'boolean') {
+        result = raw;
+    } else {
+        throw new TypeError('model-info: "'.concat(label, '" must be a boolean when provided.'));
+    }
+    return result;
+}
+function requireNonEmptyString(value, label) {
+    if (typeof value !== 'string') {
+        throw new TypeError('model-info: "'.concat(label, '" must be a string.'));
     }
+    var trimmed = value.trim();
+    if (trimmed.length === 0) {
+        throw new Error('model-info: "'.concat(label, '" must be a non-empty string.'));
+    }
+    return trimmed;
+}
+// MARK: Output builders
+function buildGroupsOutput(manifest) {
     return {
-        model: model
+        mode: 'groups',
+        groups: computeGroupCounts(manifest),
+        totalModels: manifest.length,
+        hint: MODEL_INFO_GROUPS_HINT
     };
 }
-function buildListOutput(manifest) {
-    var models = manifest.map(function(entry) {
-        var row = _object_spread$2({
-            modelType: entry.modelType,
-            modelName: entry.modelName,
-            identityConst: entry.identityConst,
-            collectionPrefix: entry.collectionPrefix,
-            sourcePackage: entry.sourcePackage,
-            fieldCount: entry.fields.length
-        }, entry.modelGroup == null ? {} : {
-            modelGroup: entry.modelGroup
-        }, entry.parentIdentityConst == null ? {} : {
-            parentIdentityConst: entry.parentIdentityConst
-        }, entry.description == null ? {} : {
-            description: entry.description
-        }, entry.read == null ? {} : {
-            read: entry.read
-        }, entry.serviceFactory == null ? {} : {
-            serviceFactoryExport: entry.serviceFactory.exportName
-        });
-        return row;
+function buildGroupFilterOutput(config) {
+    var group = config.group, manifest = config.manifest, fields = config.fields;
+    var detailed = fields !== null && fields !== void 0 ? fields : false;
+    var lower = group.toLowerCase();
+    var matches = manifest.filter(function(entry) {
+        var _entry_modelGroup;
+        return ((_entry_modelGroup = entry.modelGroup) === null || _entry_modelGroup === void 0 ? void 0 : _entry_modelGroup.toLowerCase()) === lower;
     });
+    var result;
+    if (matches.length === 0) {
+        throw new Error(buildUnknownGroupMessage(group, manifest));
+    } else {
+        var canonical = matches[0].modelGroup;
+        result = {
+            mode: 'list',
+            modelGroup: canonical,
+            models: matches.map(function(entry) {
+                return toModelRow(entry, detailed);
+            })
+        };
+    }
+    return result;
+}
+function buildAllOutput(manifest, fields) {
+    var detailed = fields !== null && fields !== void 0 ? fields : false;
     return {
         mode: 'list',
-        models: models
+        models: manifest.map(function(entry) {
+            return toModelRow(entry, detailed);
+        })
     };
 }
-function buildSingleOutput(query, manifest) {
-    var entry = findModelEntry(query, manifest);
-    if (entry == null) {
-        throw new Error('model-info: no model matches "'.concat(query, '". Call `model-info` without arguments to list available models.'));
+function buildModelLookupOutput(config) {
+    var queries = config.queries, isArray = config.isArray, manifest = config.manifest, fields = config.fields;
+    var detailed = fields !== null && fields !== void 0 ? fields : true;
+    var matched = [];
+    var notFound = [];
+    var _iteratorNormalCompletion = true, _didIteratorError = false, _iteratorError = undefined;
+    try {
+        for(var _iterator = queries[Symbol.iterator](), _step; !(_iteratorNormalCompletion = (_step = _iterator.next()).done); _iteratorNormalCompletion = true){
+            var query = _step.value;
+            var entry = findModelEntry(query, manifest);
+            if (entry == null) {
+                notFound.push({
+                    query: query,
+                    message: buildModelNotFoundMessage(query, manifest)
+                });
+            } else {
+                matched.push(toModelRow(entry, detailed));
+            }
+        }
+    } catch (err) {
+        _didIteratorError = true;
+        _iteratorError = err;
+    } finally{
+        try {
+            if (!_iteratorNormalCompletion && _iterator.return != null) {
+                _iterator.return();
+            }
+        } finally{
+            if (_didIteratorError) {
+                throw _iteratorError;
+            }
+        }
     }
-    return {
-        mode: 'single',
-        model: entry
-    };
+    var result;
+    if (isArray) {
+        result = notFound.length > 0 ? {
+            mode: 'multiple',
+            models: matched,
+            notFound: notFound
+        } : {
+            mode: 'multiple',
+            models: matched
+        };
+    } else if (matched.length > 0) {
+        result = {
+            mode: 'single',
+            model: matched[0]
+        };
+    } else {
+        throw new Error(notFound[0].message);
+    }
+    return result;
+}
+// MARK: Row + group helpers
+function toModelRow(entry, detailed) {
+    return detailed ? entry : toSummaryRow(entry);
+}
+function toSummaryRow(entry) {
+    return _object_spread$2({
+        modelType: entry.modelType,
+        modelName: entry.modelName,
+        identityConst: entry.identityConst,
+        collectionPrefix: entry.collectionPrefix,
+        sourcePackage: entry.sourcePackage,
+        fieldCount: entry.fields.length
+    }, entry.modelGroup == null ? {} : {
+        modelGroup: entry.modelGroup
+    }, entry.parentIdentityConst == null ? {} : {
+        parentIdentityConst: entry.parentIdentityConst
+    }, entry.description == null ? {} : {
+        description: entry.description
+    }, entry.read == null ? {} : {
+        read: entry.read
+    }, entry.serviceFactory == null ? {} : {
+        serviceFactoryExport: entry.serviceFactory.exportName
+    });
+}
+/**
+ * Counts models per `modelGroup`, bucketing entries without a group under
+ * {@link MODEL_INFO_UNGROUPED_LABEL}. Sorted by count descending, then group name ascending.
+ *
+ * @param manifest - Model manifest to summarize.
+ * @returns One {@link ModelInfoGroupCount} per group, ordered most-populous-first.
+ *
+ * @__NO_SIDE_EFFECTS__
+ */ function computeGroupCounts(manifest) {
+    var grouped = util.makeValuesGroupMap(_to_consumable_array$4(manifest), function(entry) {
+        var _entry_modelGroup;
+        return (_entry_modelGroup = entry.modelGroup) !== null && _entry_modelGroup !== void 0 ? _entry_modelGroup : MODEL_INFO_UNGROUPED_LABEL;
+    });
+    var counts = [];
+    grouped.forEach(function(entries, group) {
+        counts.push({
+            modelGroup: group,
+            modelCount: entries.length
+        });
+    });
+    counts.sort(function(a, b) {
+        return b.modelCount - a.modelCount || a.modelGroup.localeCompare(b.modelGroup);
+    });
+    return counts;
+}
+function findGroupCount(query, manifest) {
+    var lower = query.toLowerCase();
+    var result;
+    var _iteratorNormalCompletion = true, _didIteratorError = false, _iteratorError = undefined;
+    try {
+        for(var _iterator = computeGroupCounts(manifest)[Symbol.iterator](), _step; !(_iteratorNormalCompletion = (_step = _iterator.next()).done); _iteratorNormalCompletion = true){
+            var count = _step.value;
+            if (count.modelGroup.toLowerCase() === lower) {
+                result = count;
+                break;
+            }
+        }
+    } catch (err) {
+        _didIteratorError = true;
+        _iteratorError = err;
+    } finally{
+        try {
+            if (!_iteratorNormalCompletion && _iterator.return != null) {
+                _iterator.return();
+            }
+        } finally{
+            if (_didIteratorError) {
+                throw _iteratorError;
+            }
+        }
+    }
+    return result;
+}
+function buildModelNotFoundMessage(query, manifest) {
+    var groupMatch = findGroupCount(query, manifest);
+    var message;
+    if (groupMatch != null) {
+        var plural = groupMatch.modelCount === 1 ? '' : 's';
+        message = 'model-info: no exact match for "'.concat(query, '" — did you mean group:"').concat(groupMatch.modelGroup, '" (').concat(groupMatch.modelCount, " model").concat(plural, ')? Use modelGroup:"').concat(groupMatch.modelGroup, '", or all:true for everything.');
+    } else {
+        message = 'model-info: no exact match for "'.concat(query, '". Call `model-info` with no arguments to list groups, or pass all:true for the full catalog.');
+    }
+    return message;
+}
+function buildUnknownGroupMessage(group, manifest) {
+    var available = computeGroupCounts(manifest).map(function(count) {
+        return "".concat(count.modelGroup, " (").concat(count.modelCount, ")");
+    }).join(', ');
+    return 'model-info: no model group matches "'.concat(group, '". Available groups: ').concat(available || '(none)', ". Call `model-info` with no arguments to list groups.");
 }
 /**
  * Resolves a manifest entry by `modelType`, `identityConst`, or `collectionPrefix`.
@@ -1340,160 +1624,205 @@ var MODEL_INFO_INPUT_SCHEMA = {
     type: 'object',
     properties: {
         model: {
+            description: 'One model (string) or many (string array), each matched by modelType, identityConst, or collectionPrefix. A string → `mode:"single"`; an array → `mode:"multiple"`. Misses are reported in `notFound`.',
+            oneOf: [
+                {
+                    type: 'string',
+                    minLength: 1
+                },
+                {
+                    type: 'array',
+                    minItems: 1,
+                    items: {
+                        type: 'string',
+                        minLength: 1
+                    }
+                }
+            ]
+        },
+        modelGroup: {
             type: 'string',
             minLength: 1,
-            description: 'Model to inspect (modelType, identityConst, or collectionPrefix). Omit to list every model.'
+            description: 'Return the summary list of models in this group (`mode:"list"`). Matched case-insensitively.'
+        },
+        all: {
+            type: 'boolean',
+            description: 'Opt in to the full catalog summary (every model). Never the default — omit to get groups instead.'
+        },
+        fields: {
+            type: 'boolean',
+            description: 'Force (true) or suppress (false) full persisted-field detail. Defaults to summary rows for list mode and full entries for single/multiple modes.'
         }
     },
     additionalProperties: false
 };
+// Shared item schema for model-bearing rows. Required props cover the summary form; full entries
+// add `fields`, `sourceFile`, and `serviceFactory` (allowed as additional properties).
+var MODEL_ROW_SCHEMA = {
+    type: 'object',
+    required: [
+        'modelType',
+        'modelName',
+        'identityConst',
+        'collectionPrefix',
+        'sourcePackage'
+    ],
+    properties: {
+        modelType: {
+            type: 'string'
+        },
+        modelName: {
+            type: 'string'
+        },
+        modelGroup: {
+            type: 'string'
+        },
+        identityConst: {
+            type: 'string'
+        },
+        collectionPrefix: {
+            type: 'string'
+        },
+        parentIdentityConst: {
+            type: 'string'
+        },
+        sourcePackage: {
+            type: 'string'
+        },
+        sourceFile: {
+            type: 'string'
+        },
+        fieldCount: {
+            type: 'integer'
+        },
+        description: {
+            type: 'string'
+        },
+        read: {
+            type: 'string',
+            enum: [
+                'system',
+                'owner',
+                'admin-only',
+                'permissions'
+            ]
+        },
+        serviceFactoryExport: {
+            type: 'string'
+        },
+        fields: {
+            type: 'array',
+            items: {
+                type: 'object'
+            }
+        },
+        serviceFactory: {
+            type: 'object',
+            required: [
+                'exportName',
+                'sourceFile'
+            ],
+            properties: {
+                exportName: {
+                    type: 'string'
+                },
+                sourceFile: {
+                    type: 'string'
+                }
+            }
+        }
+    }
+};
 // MCP's `tools/list` validator requires `outputSchema.type === 'object'` at the root
-// (see @modelcontextprotocol/sdk Zod schema), so the list/single union is expressed via a
-// top-level object whose nested `oneOf` discriminates by the `mode` literal.
+// (see @modelcontextprotocol/sdk Zod schema), so the variants are expressed via a top-level
+// object whose nested `oneOf` discriminates by the `mode` literal.
 var MODEL_INFO_OUTPUT_SCHEMA = {
     type: 'object',
     required: [
         'mode'
     ],
-    description: 'Either lists every model in the manifest (when `model` is omitted) or returns a full entry for the requested model (when `model` is provided). The `mode` field discriminates the variant.',
+    description: 'Discriminated by `mode`: `groups` (default model groups + counts), `list` (summary/full list for `modelGroup` or `all`), `single` (one `model`), or `multiple` (a `model` array, with misses in `notFound`).',
     properties: {
         mode: {
             type: 'string',
             enum: [
+                'groups',
                 'list',
-                'single'
+                'single',
+                'multiple'
             ]
         },
-        models: {
+        groups: {
             type: 'array',
-            description: 'Present when `mode` is `"list"`. One summary entry per registered model.',
+            description: 'Present when `mode` is `"groups"`. One entry per model group.',
             items: {
                 type: 'object',
                 required: [
-                    'modelType',
-                    'modelName',
-                    'identityConst',
-                    'collectionPrefix',
-                    'sourcePackage',
-                    'fieldCount'
+                    'modelGroup',
+                    'modelCount'
                 ],
                 properties: {
-                    modelType: {
-                        type: 'string'
-                    },
-                    modelName: {
-                        type: 'string'
-                    },
                     modelGroup: {
                         type: 'string'
                     },
-                    identityConst: {
-                        type: 'string'
-                    },
-                    collectionPrefix: {
-                        type: 'string'
-                    },
-                    parentIdentityConst: {
-                        type: 'string'
-                    },
-                    sourcePackage: {
-                        type: 'string'
-                    },
-                    fieldCount: {
+                    modelCount: {
                         type: 'integer'
-                    },
-                    description: {
+                    }
+                }
+            }
+        },
+        totalModels: {
+            type: 'integer',
+            description: 'Present when `mode` is `"groups"`. Total models across all groups.'
+        },
+        hint: {
+            type: 'string',
+            description: 'Present when `mode` is `"groups"`. Guidance on how to drill into the catalog.'
+        },
+        models: {
+            type: 'array',
+            description: 'Present when `mode` is `"list"` or `"multiple"`. Summary rows by default; full entries when `fields` requests detail.',
+            items: MODEL_ROW_SCHEMA
+        },
+        modelGroup: {
+            type: 'string',
+            description: 'Present when `mode` is `"list"` from a `modelGroup` filter. The canonical group name.'
+        },
+        model: _object_spread_props(_object_spread$2({}, MODEL_ROW_SCHEMA), {
+            description: 'Present when `mode` is `"single"`. The matched model entry (full detail unless `fields:false`).'
+        }),
+        notFound: {
+            type: 'array',
+            description: 'Present when `mode` is `"multiple"` and one or more queries matched nothing.',
+            items: {
+                type: 'object',
+                required: [
+                    'query',
+                    'message'
+                ],
+                properties: {
+                    query: {
                         type: 'string'
                     },
-                    read: {
-                        type: 'string',
-                        enum: [
-                            'system',
-                            'owner',
-                            'admin-only',
-                            'permissions'
-                        ]
-                    },
-                    serviceFactoryExport: {
+                    message: {
                         type: 'string'
                     }
                 }
             }
-        },
-        model: {
-            type: 'object',
-            description: 'Present when `mode` is `"single"`. The full manifest entry for the requested model.',
+        }
+    },
+    oneOf: [
+        {
             required: [
-                'modelType',
-                'modelName',
-                'identityConst',
-                'collectionPrefix',
-                'sourcePackage',
-                'sourceFile',
-                'fields'
+                'groups',
+                'totalModels'
             ],
             properties: {
-                modelType: {
-                    type: 'string'
-                },
-                modelName: {
-                    type: 'string'
-                },
-                modelGroup: {
-                    type: 'string'
-                },
-                identityConst: {
-                    type: 'string'
-                },
-                collectionPrefix: {
-                    type: 'string'
-                },
-                parentIdentityConst: {
-                    type: 'string'
-                },
-                description: {
-                    type: 'string'
-                },
-                sourcePackage: {
-                    type: 'string'
-                },
-                sourceFile: {
-                    type: 'string'
-                },
-                fields: {
-                    type: 'array',
-                    items: {
-                        type: 'object'
-                    }
-                },
-                read: {
-                    type: 'string',
-                    enum: [
-                        'system',
-                        'owner',
-                        'admin-only',
-                        'permissions'
-                    ]
-                },
-                serviceFactory: {
-                    type: 'object',
-                    required: [
-                        'exportName',
-                        'sourceFile'
-                    ],
-                    properties: {
-                        exportName: {
-                            type: 'string'
-                        },
-                        sourceFile: {
-                            type: 'string'
-                        }
-                    }
+                mode: {
+                    const: 'groups'
                 }
             }
-        }
-    },
-    oneOf: [
+        },
         {
             required: [
                 'models'
@@ -1513,6 +1842,16 @@ var MODEL_INFO_OUTPUT_SCHEMA = {
                     const: 'single'
                 }
             }
+        },
+        {
+            required: [
+                'models'
+            ],
+            properties: {
+                mode: {
+                    const: 'multiple'
+                }
+            }
         }
     ]
 };
@@ -3959,7 +4298,9 @@ exports.MODEL_GET_DISPATCH_MODEL_TYPE = MODEL_GET_DISPATCH_MODEL_TYPE;
 exports.MODEL_GET_TOOL_NAME = MODEL_GET_TOOL_NAME;
 exports.MODEL_INFO_DISPATCH_CALL = MODEL_INFO_DISPATCH_CALL;
 exports.MODEL_INFO_DISPATCH_MODEL_TYPE = MODEL_INFO_DISPATCH_MODEL_TYPE;
+exports.MODEL_INFO_GROUPS_HINT = MODEL_INFO_GROUPS_HINT;
 exports.MODEL_INFO_TOOL_NAME = MODEL_INFO_TOOL_NAME;
+exports.MODEL_INFO_UNGROUPED_LABEL = MODEL_INFO_UNGROUPED_LABEL;
 exports.McpAnalyticsService = McpAnalyticsService;
 exports.McpModuleConfig = McpModuleConfig;
 exports.appMcpAnalyticsModuleMetadata = appMcpAnalyticsModuleMetadata;