simple-dynamsoft-mcp 7.2.9 → 7.3.0

package/src/server/resource-index/samples.js

@@ -18,12 +18,16 @@ let cachedWebFrameworkPlatforms = null;
 let cachedDbrWebFrameworkPlatforms = null;
 let cachedDdvWebFrameworkPlatforms = null;
 let cachedDcvWebFrameworkPlatforms = null;
+let cachedMrzWebFrameworkPlatforms = null;
+let cachedMdsWebFrameworkPlatforms = null;
 
 function resetSampleDiscoveryCaches() {
   cachedWebFrameworkPlatforms = null;
   cachedDbrWebFrameworkPlatforms = null;
   cachedDdvWebFrameworkPlatforms = null;
   cachedDcvWebFrameworkPlatforms = null;
+  cachedMrzWebFrameworkPlatforms = null;
+  cachedMdsWebFrameworkPlatforms = null;
 }
 
 function getCodeFileExtensions() {
@@ -46,6 +50,10 @@ function getDbrWebSamplesRoot() {
   return getExistingPath(join(SAMPLE_ROOTS.dbrWeb, "web"), SAMPLE_ROOTS.dbrWeb);
 }
 
+function getDedicatedWebSamplesRoot(root) {
+  return getExistingPath(join(root, "samples"), root);
+}
+
 function getDbrCrossMobileRoot(platform) {
   if (platform === "maui") return SAMPLE_ROOTS.dbrMaui;
   if (platform === "react-native") return SAMPLE_ROOTS.dbrReactNative;
@@ -291,6 +299,63 @@ function discoverWebSamples() {
   return categories;
 }
 
+function discoverDedicatedWebSamples(root) {
+  const categories = { root: [] };
+  const webPath = getDedicatedWebSamplesRoot(root);
+  if (!webPath || !existsSync(webPath)) return categories;
+
+  for (const entry of readdirSync(webPath, { withFileTypes: true })) {
+    if (entry.name.startsWith(".")) continue;
+
+    if (entry.isFile() && entry.name.endsWith(".html")) {
+      if (entry.name !== "index.html") {
+        categories.root.push(entry.name.replace(".html", ""));
+      }
+      continue;
+    }
+
+    if (!entry.isDirectory()) continue;
+
+    const categoryPath = join(webPath, entry.name);
+
+    if (entry.name === "frameworks" || entry.name === "scenarios") {
+      const categorySamples = [];
+      for (const child of readdirSync(categoryPath, { withFileTypes: true })) {
+        if (child.name.startsWith(".")) continue;
+        if (child.isDirectory()) categorySamples.push(child.name);
+        else if (child.isFile() && child.name.endsWith(".html") && child.name !== "index.html") {
+          categorySamples.push(child.name.replace(".html", ""));
+        }
+      }
+
+      categories[entry.name] = sortUnique(categorySamples);
+      continue;
+    }
+
+    if (existsSync(join(categoryPath, "index.html")) || existsSync(join(categoryPath, "README.md"))) {
+      categories.root.push(entry.name);
+      continue;
+    }
+
+    const categorySamples = [];
+    for (const child of readdirSync(categoryPath, { withFileTypes: true })) {
+      if (child.name.startsWith(".")) continue;
+      if (child.isDirectory()) categorySamples.push(child.name);
+      else if (child.isFile() && child.name.endsWith(".html") && child.name !== "index.html") {
+        categorySamples.push(child.name.replace(".html", ""));
+      }
+    }
+
+    categories[entry.name] = sortUnique(categorySamples);
+  }
+
+  for (const [key, value] of Object.entries(categories)) {
+    if (value.length === 0) delete categories[key];
+  }
+
+  return categories;
+}
+
 function getWebSamplePath(category, sampleName) {
   const webPath = getDbrWebSamplesRoot();
   if (!webPath || !existsSync(webPath)) return null;
@@ -316,6 +381,44 @@ function getWebSamplePath(category, sampleName) {
   return null;
 }
 
+function getDedicatedWebSamplePath(root, category, sampleName) {
+  const webPath = getDedicatedWebSamplesRoot(root);
+  if (!webPath || !existsSync(webPath)) return null;
+
+  if (category === "root" || !category) {
+    const htmlPath = join(webPath, `${sampleName}.html`);
+    if (existsSync(htmlPath)) return htmlPath;
+
+    const dirPath = join(webPath, sampleName);
+    if (existsSync(dirPath) && statSync(dirPath).isDirectory()) {
+      const indexPath = join(dirPath, "index.html");
+      if (existsSync(indexPath)) return indexPath;
+      const readmePath = join(dirPath, "README.md");
+      if (existsSync(readmePath)) return readmePath;
+      return dirPath;
+    }
+
+    return null;
+  }
+
+  const dirPath = join(webPath, category, sampleName);
+  if (existsSync(dirPath) && statSync(dirPath).isDirectory()) {
+    return dirPath;
+  }
+
+  const htmlPath = join(webPath, category, `${sampleName}.html`);
+  if (existsSync(htmlPath)) return htmlPath;
+  return null;
+}
+
+function discoverMrzWebSamples() {
+  return discoverDedicatedWebSamples(SAMPLE_ROOTS.mrzWeb);
+}
+
+function discoverMdsWebSamples() {
+  return discoverDedicatedWebSamples(SAMPLE_ROOTS.mdsWeb);
+}
+
 function discoverDwtSamples() {
   const categories = {};
   if (!existsSync(SAMPLE_ROOTS.dwt)) return categories;
@@ -388,12 +491,42 @@ function getDdvWebFrameworkPlatforms() {
   return cachedDdvWebFrameworkPlatforms;
 }
 
+function getMrzWebFrameworkPlatforms() {
+  if (cachedMrzWebFrameworkPlatforms) return cachedMrzWebFrameworkPlatforms;
+  const frameworks = new Set();
+  const webSamples = discoverMrzWebSamples();
+  if (webSamples.frameworks) {
+    for (const name of webSamples.frameworks) {
+      const normalized = normalizePlatform(name);
+      if (normalized && normalized !== "web") frameworks.add(normalized);
+    }
+  }
+  cachedMrzWebFrameworkPlatforms = Array.from(frameworks).sort();
+  return cachedMrzWebFrameworkPlatforms;
+}
+
+function getMdsWebFrameworkPlatforms() {
+  if (cachedMdsWebFrameworkPlatforms) return cachedMdsWebFrameworkPlatforms;
+  const frameworks = new Set();
+  const webSamples = discoverMdsWebSamples();
+  if (webSamples.frameworks) {
+    for (const name of webSamples.frameworks) {
+      const normalized = normalizePlatform(name);
+      if (normalized && normalized !== "web") frameworks.add(normalized);
+    }
+  }
+  cachedMdsWebFrameworkPlatforms = Array.from(frameworks).sort();
+  return cachedMdsWebFrameworkPlatforms;
+}
+
 function getWebFrameworkPlatforms() {
   if (cachedWebFrameworkPlatforms) return cachedWebFrameworkPlatforms;
   const frameworks = new Set([
     ...getDbrWebFrameworkPlatforms(),
     ...getDdvWebFrameworkPlatforms(),
-    ...getDcvWebFrameworkPlatforms()
+    ...getDcvWebFrameworkPlatforms(),
+    ...getMrzWebFrameworkPlatforms(),
+    ...getMdsWebFrameworkPlatforms()
   ]);
   cachedWebFrameworkPlatforms = frameworks;
   return cachedWebFrameworkPlatforms;
@@ -575,6 +708,14 @@ function getDcvWebSamplePath(sampleName) {
   return null;
 }
 
+function getMrzWebSamplePath(category, sampleName) {
+  return getDedicatedWebSamplePath(SAMPLE_ROOTS.mrzWeb, category, sampleName);
+}
+
+function getMdsWebSamplePath(category, sampleName) {
+  return getDedicatedWebSamplePath(SAMPLE_ROOTS.mdsWeb, category, sampleName);
+}
+
 function readCodeFile(filePath) {
   if (!existsSync(filePath)) return null;
   return readFileSync(filePath, "utf8");
@@ -701,6 +842,8 @@ export {
   discoverDcvServerSamples,
   discoverDcvWebSamples,
   discoverWebSamples,
+  discoverMrzWebSamples,
+  discoverMdsWebSamples,
   getWebSamplePath,
   discoverDwtSamples,
   discoverDdvSamples,
@@ -708,6 +851,8 @@ export {
   getDbrWebFrameworkPlatforms,
   getDcvWebFrameworkPlatforms,
   getDdvWebFrameworkPlatforms,
+  getMrzWebFrameworkPlatforms,
+  getMdsWebFrameworkPlatforms,
   getWebFrameworkPlatforms,
   findCodeFilesInSample,
   getDbrMobilePlatforms,
@@ -720,6 +865,8 @@ export {
   getDcvMobileSamplePath,
   getDcvServerSamplePath,
   getDcvWebSamplePath,
+  getMrzWebSamplePath,
+  getMdsWebSamplePath,
   getDwtSamplePath,
   getDdvSamplePath,
   readCodeFile,

package/src/server/resource-index/uri.js

@@ -70,6 +70,18 @@ function parseSampleUri(uri) {
     };
   }
 
+  if ((parsed.product === "mrz" || parsed.product === "mds") && (parsed.edition === "mobile" || parsed.edition === "server" || parsed.edition === "web")) {
+    const isStructuredWebSample = parsed.edition === "web" && parsed.parts.length >= 6;
+    return {
+      product: parsed.product,
+      edition: parsed.edition,
+      platform: parsed.platform,
+      version: parsed.version,
+      category: isStructuredWebSample ? parsed.parts[4] : undefined,
+      sampleName: isStructuredWebSample ? parsed.parts[5] : parsed.parts[4]
+    };
+  }
+
   if (parsed.product === "dcv" && (parsed.edition === "mobile" || parsed.edition === "server" || parsed.edition === "web")) {
     return {
       product: "dcv",

package/src/server/resource-index/version-policy.js

@@ -1,6 +1,11 @@
 import { LEGACY_DBR_LINKS, LEGACY_DWT_LINKS } from "./config.js";
 import { inferProductFromQuery, normalizeEdition, normalizePlatform } from "../normalizers.js";
 
+const VERSION_FAMILY_BY_PRODUCT = {
+  mrz: "dcv",
+  mds: "dcv"
+};
+
 function parseMajorVersion(version) {
   if (!version) return null;
   const match = String(version).match(/(\d+)/);
@@ -69,7 +74,8 @@ function ensureLatestMajor({ product, version, query, edition, platform, latestM
   const inferredProduct = product || inferProductFromQuery(query);
   if (!inferredProduct) return { ok: true };
 
-  const currentMajor = latestMajor[inferredProduct];
+  const versionFamily = VERSION_FAMILY_BY_PRODUCT[inferredProduct] || inferredProduct;
+  const currentMajor = latestMajor[versionFamily];
   const requestedMajor = parseMajorVersion(version) ?? detectMajorFromQuery(query);
 
   if (!requestedMajor || requestedMajor === currentMajor) {
@@ -83,10 +89,11 @@ function ensureLatestMajor({ product, version, query, edition, platform, latestM
     };
   }
 
-  if (inferredProduct === "dcv") {
+  if (versionFamily === "dcv") {
+    const offeringName = inferredProduct === "dcv" ? "DCV" : inferredProduct.toUpperCase();
     return {
       ok: false,
-      message: `This MCP server only serves the latest major version of DCV (v${currentMajor}).`
+      message: `This MCP server only serves the latest major version of ${offeringName} (DCV-backed, v${currentMajor}).`
     };
   }
 
@@ -140,13 +147,14 @@ function buildVersionPolicyText(latestMajor) {
     "This MCP server only serves the latest major versions of each product.",
     "",
     `- DBR latest major: v${latestMajor.dbr}`,
-    `- DCV latest major: v${latestMajor.dcv}`,
+    `- MRZ latest major: v${latestMajor.dcv} (DCV-backed)`,
+    `- MDS latest major: v${latestMajor.dcv} (DCV-backed)`,
     `- DWT latest major: v${latestMajor.dwt}`,
     `- DDV latest major: v${latestMajor.ddv}`,
     "",
     "Legacy support:",
     "- DBR v9 and v10 docs are linked when requested.",
-    "- DCV has no legacy archive links in this server.",
+    "- MRZ and MDS do not publish separate legacy archive links; they follow the latest DCV-backed major only.",
     `- DWT archived docs available: ${dwtLegacyVersions || "none"}.`,
     "- DDV has no legacy archive links in this server.",
     "",

package/src/server/resource-index.js

@@ -32,14 +32,20 @@ import {
   discoverDcvMobileSamples,
   discoverDcvServerSamples,
   discoverDcvWebSamples,
+  discoverMrzWebSamples,
+  discoverMdsWebSamples,
   discoverWebSamples,
   getWebSamplePath,
+  getMrzWebSamplePath,
+  getMdsWebSamplePath,
   discoverDwtSamples,
   discoverDdvSamples,
   mapDdvSampleToFramework,
   getDbrWebFrameworkPlatforms,
   getDcvWebFrameworkPlatforms,
   getDdvWebFrameworkPlatforms,
+  getMrzWebFrameworkPlatforms,
+  getMdsWebFrameworkPlatforms,
   getWebFrameworkPlatforms,
   findCodeFilesInSample,
   getDbrMobilePlatforms,
@@ -137,6 +143,8 @@ let dbrMobileDocs = [];
 let dbrServerDocs = [];
 let dcvCoreDocs = [];
 let dcvWebDocs = [];
+let mrzWebDocs = [];
+let mdsWebDocs = [];
 let dcvMobileDocs = [];
 let dcvServerDocs = [];
 let dwtDocs = { articles: [] };
@@ -198,6 +206,28 @@ function loadDocumentationSets() {
     () => "web"
   );
 
+  mrzWebDocs = withEditionScope(
+    loadMarkdownDocs({
+      rootDir: DOC_ROOTS.mrzWeb,
+      urlBase: DOCS_CONFIG.mrzWeb.urlBase,
+      excludeDirs: DOCS_CONFIG.mrzWeb.excludeDirs,
+      excludeFiles: DOCS_CONFIG.mrzWeb.excludeFiles
+    }).articles,
+    "web",
+    () => "web"
+  );
+
+  mdsWebDocs = withEditionScope(
+    loadMarkdownDocs({
+      rootDir: DOC_ROOTS.mdsWeb,
+      urlBase: DOCS_CONFIG.mdsWeb.urlBase,
+      excludeDirs: DOCS_CONFIG.mdsWeb.excludeDirs,
+      excludeFiles: DOCS_CONFIG.mdsWeb.excludeFiles
+    }).articles,
+    "web",
+    () => "web"
+  );
+
   dcvMobileDocs = withEditionScope(
     loadMarkdownDocs({
       rootDir: DOC_ROOTS.dcvMobile,
@@ -292,6 +322,8 @@ function buildIndexData() {
     LATEST_MAJOR,
     dcvCoreDocs,
     dcvWebDocs,
+    mrzWebDocs,
+    mdsWebDocs,
     dcvMobileDocs,
     dcvServerDocs,
     dbrWebDocs,
@@ -301,6 +333,10 @@ function buildIndexData() {
     ddvDocs,
     discoverDcvWebSamples,
     getDcvWebFrameworkPlatforms,
+    discoverMrzWebSamples,
+    getMrzWebFrameworkPlatforms,
+    discoverMdsWebSamples,
+    getMdsWebFrameworkPlatforms,
     getDcvMobilePlatforms,
     getDcvServerPlatforms,
     discoverDcvMobileSamples,
@@ -313,7 +349,8 @@ function buildIndexData() {
     discoverDbrServerSamples,
     discoverDwtSamples,
     discoverDdvSamples,
-    getDdvWebFrameworkPlatforms
+    getDdvWebFrameworkPlatforms,
+    resourceIndex
   });
 }
 
@@ -326,6 +363,8 @@ function buildResourceIndex() {
     LATEST_MAJOR,
     dcvCoreDocs,
     dcvWebDocs,
+    mrzWebDocs,
+    mdsWebDocs,
     dcvMobileDocs,
     dcvServerDocs,
     dbrWebDocs,
@@ -341,6 +380,10 @@ function buildResourceIndex() {
     getDcvServerSampleContent,
     discoverDcvWebSamples,
     getDcvWebSamplePath,
+    discoverMrzWebSamples,
+    getMrzWebSamplePath,
+    discoverMdsWebSamples,
+    getMdsWebSamplePath,
     discoverMobileSamples,
     getDbrMobilePlatforms,
     getMobileSamplePath,
@@ -393,9 +436,12 @@ function platformMatches(normalizedPlatform, entry) {
   if (normalizedPlatform === entry.platform) return true;
   if (normalizedPlatform === "web") return entry.platform === "web";
   if (isWebFrameworkPlatform(normalizedPlatform)) {
+    const aliases = WEB_FRAMEWORK_TAG_ALIASES[normalizedPlatform] || [normalizedPlatform];
+    if (aliases.includes(entry.platform)) {
+      return true;
+    }
     if (entry.platform === "web" && Array.isArray(entry.tags)) {
       const tags = entry.tags.map((tag) => String(tag).toLowerCase());
-      const aliases = WEB_FRAMEWORK_TAG_ALIASES[normalizedPlatform] || [normalizedPlatform];
       return aliases.some((alias) => tags.includes(alias));
     }
     return entry.platform === normalizedPlatform;
@@ -499,6 +545,8 @@ function getRagSignatureData() {
     resourceCount: resourceIndex.length,
     dcvCoreDocCount: dcvCoreDocs.length,
     dcvWebDocCount: dcvWebDocs.length,
+    mrzWebDocCount: mrzWebDocs.length,
+    mdsWebDocCount: mdsWebDocs.length,
     dcvMobileDocCount: dcvMobileDocs.length,
     dcvServerDocCount: dcvServerDocs.length,
     dbrWebDocCount: dbrWebDocs.length,
@@ -519,6 +567,8 @@ function getRagSignatureData() {
       dbrFlutterSamplesHead: readManifestRepoCommit(SAMPLE_ROOTS.dbrFlutter),
       dbrNodejsSamplesHead: readManifestRepoCommit(SAMPLE_ROOTS.dbrNodejs),
       dcvWebSamplesHead: readManifestRepoCommit(SAMPLE_ROOTS.dcvWeb),
+      mrzWebSamplesHead: readManifestRepoCommit(SAMPLE_ROOTS.mrzWeb),
+      mdsWebSamplesHead: readManifestRepoCommit(SAMPLE_ROOTS.mdsWeb),
       dcvMobileSamplesHead: readManifestRepoCommit(SAMPLE_ROOTS.dcvMobile),
       dcvPythonSamplesHead: readManifestRepoCommit(SAMPLE_ROOTS.dcvPython),
       dcvDotnetSamplesHead: readManifestRepoCommit(SAMPLE_ROOTS.dcvDotnet),
@@ -536,6 +586,8 @@ function getRagSignatureData() {
       dbrServerDocsHead: readManifestRepoCommit(DOC_ROOTS.dbrServer),
       dcvCoreDocsHead: readManifestRepoCommit(DOC_ROOTS.dcvCore),
       dcvWebDocsHead: readManifestRepoCommit(DOC_ROOTS.dcvWeb),
+      mrzWebDocsHead: readManifestRepoCommit(DOC_ROOTS.mrzWeb),
+      mdsWebDocsHead: readManifestRepoCommit(DOC_ROOTS.mdsWeb),
       dcvMobileDocsHead: readManifestRepoCommit(DOC_ROOTS.dcvMobile),
       dcvServerDocsHead: readManifestRepoCommit(DOC_ROOTS.dcvServer),
       dwtDocsHead: readManifestRepoCommit(DOC_ROOTS.dwt),
@@ -560,6 +612,8 @@ export {
   discoverDcvMobileSamples,
   discoverDcvServerSamples,
   discoverDcvWebSamples,
+  discoverMrzWebSamples,
+  discoverMdsWebSamples,
   discoverWebSamples,
   getWebSamplePath,
   discoverDwtSamples,
@@ -568,6 +622,8 @@ export {
   getDbrWebFrameworkPlatforms,
   getDcvWebFrameworkPlatforms,
   getDdvWebFrameworkPlatforms,
+  getMrzWebFrameworkPlatforms,
+  getMdsWebFrameworkPlatforms,
   getWebFrameworkPlatforms,
   findCodeFilesInSample,
   getDbrServerSamplePath,
@@ -580,6 +636,8 @@ export {
   getDcvMobileSamplePath,
   getDcvServerSamplePath,
   getDcvWebSamplePath,
+  getMrzWebSamplePath,
+  getMdsWebSamplePath,
   getDwtSamplePath,
   getDdvSamplePath,
   readCodeFile,

package/src/server/resources/register-resources.js

@@ -28,7 +28,7 @@ export function registerResourceHandlers({
   async function templateReadHandler(uri) {
     const uriStr = uri.toString();
     const parsed = parseResourceUri(uriStr);
-    if (parsed && ["dcv", "dbr", "dwt", "ddv"].includes(parsed.product)) {
+    if (parsed && ["dbr", "dwt", "ddv", "mrz", "mds"].includes(parsed.product)) {
       const policy = ensureLatestMajor({
         product: parsed.product,
         version: parsed.version,

package/src/server/tools/public-routing.js

@@ -0,0 +1,75 @@
+const SERVER_SAMPLE_REPOS = {
+  python: "https://github.com/Dynamsoft/capture-vision-python-samples",
+  cpp: "https://github.com/Dynamsoft/capture-vision-cpp-samples",
+  java: "https://github.com/Dynamsoft/capture-vision-java-samples",
+  dotnet: "https://github.com/Dynamsoft/capture-vision-dotnet-samples",
+  nodejs: "https://github.com/Dynamsoft/capture-vision-nodejs-samples"
+};
+
+const MOBILE_SAMPLE_REPOS = {
+  android: "https://github.com/Dynamsoft/capture-vision-mobile-samples/tree/main/Android",
+  ios: "https://github.com/Dynamsoft/capture-vision-mobile-samples/tree/main/iOS",
+  spm: "https://github.com/Dynamsoft/capture-vision-mobile-samples/tree/main/iOS",
+  "react-native": "https://github.com/Dynamsoft/capture-vision-react-native-samples",
+  flutter: "https://github.com/Dynamsoft/capture-vision-flutter-samples",
+  maui: "https://github.com/Dynamsoft/capture-vision-maui-samples"
+};
+
+function getPublicServerSamplesUrl(platform) {
+  return SERVER_SAMPLE_REPOS[platform] || SERVER_SAMPLE_REPOS.python;
+}
+
+function getPublicMobileSamplesUrl(platform) {
+  return MOBILE_SAMPLE_REPOS[platform] || MOBILE_SAMPLE_REPOS.android;
+}
+
+function getUnsupportedPublicScopeRedirect(product, edition, platform) {
+  if (product === "mrz" && edition === "server") {
+    return {
+      label: "MRZ",
+      docsUrl: "https://www.dynamsoft.com/capture-vision/docs/server/",
+      samplesUrl: getPublicServerSamplesUrl(platform)
+    };
+  }
+
+  if (product === "mds" && edition === "mobile") {
+    return {
+      label: "MDS",
+      docsUrl: "https://www.dynamsoft.com/capture-vision/docs/mobile/",
+      samplesUrl: getPublicMobileSamplesUrl(platform)
+    };
+  }
+
+  if (product === "mds" && edition === "server") {
+    return {
+      label: "MDS",
+      docsUrl: "https://www.dynamsoft.com/capture-vision/docs/server/",
+      samplesUrl: getPublicServerSamplesUrl(platform)
+    };
+  }
+
+  return null;
+}
+
+function buildUnsupportedPublicScopeResponse(product, edition, platform) {
+  const redirect = getUnsupportedPublicScopeRedirect(product, edition, platform);
+  if (!redirect) return null;
+
+  const scope = [edition, platform].filter(Boolean).join(" / ") || "general";
+  return {
+    content: [{
+      type: "text",
+      text: [
+        `${redirect.label} ${scope} is not indexed in this MCP yet. Use these official links instead.`,
+        "Reference links:",
+        `- Docs: ${redirect.docsUrl}`,
+        `- Samples: ${redirect.samplesUrl}`
+      ].join("\n")
+    }]
+  };
+}
+
+export {
+  getUnsupportedPublicScopeRedirect,
+  buildUnsupportedPublicScopeResponse
+};

package/src/server/tools/register-index-tools.js

@@ -1,5 +1,7 @@
 import { z } from "zod";
 import { formatScoreLabel, formatScoreNote } from "../helpers/server-helpers.js";
+import { buildUnknownPublicProductResponse, isKnownPublicOffering } from "../public-offerings.js";
+import { buildUnsupportedPublicScopeResponse } from "./public-routing.js";
 
 export function registerIndexTools({
   server,
@@ -16,23 +18,29 @@ export function registerIndexTools({
   getSampleEntries,
   getSampleSuggestions
 }) {
+  function looksLikeSampleIdQuery(value) {
+    const normalized = String(value || "").trim();
+    if (!normalized) return false;
+    return /[-_/]/.test(normalized);
+  }
+
   server.registerTool(
     "get_index",
     {
       title: "Get Index",
       description: [
-        "Get a compact index of all Dynamsoft products, editions, platforms, versions, and available docs/samples.",
+        "Get a compact index of the public Dynamsoft offerings, editions, platforms, versions, and available docs/samples.",
         "",
         "WHEN TO USE:",
         "- As the first call in any conversation to discover what is available.",
         "- To determine valid product/edition/platform combinations before calling other tools.",
-        "- To get DBR-vs-DCV selection guidance (DBR for barcode-only; DCV for MRZ, VIN, document normalization, driver license).",
+        "- To get public product-selection guidance (DBR for barcode-only; MRZ for machine-readable-zone workflows; MDS for document scan and normalization workflows).",
         "",
         "WHEN NOT TO USE:",
         "- Do not call get_index repeatedly; the index is static within a session.",
         "- If you already know the product/edition/platform, skip directly to search or get_quickstart.",
         "",
-        "RETURNS: A JSON object with top-level keys: productSelection and products. productSelection contains guidance for choosing between products (for example, DBR vs DCV), and products contains per-product entries (dcv, dbr, dwt, ddv) with editions, platforms, latest versions, and counts of available docs and samples.",
+        "RETURNS: A JSON object with top-level keys: productSelection and products. productSelection contains guidance for choosing between public offerings, and products contains per-product entries (dbr, dwt, ddv, mrz, mds) with editions, platforms, latest versions, and counts of available docs and samples.",
         "",
         "PARAMETERS: None.",
         "",
@@ -64,7 +72,7 @@ export function registerIndexTools({
         "",
         "WHEN TO USE:",
         "- To find docs or samples by keyword, topic, or exact sample ID.",
-        "- To look up specific scenarios: MRZ scanning, VIN reading, barcode decoding, document normalization, etc.",
+        "- To look up specific scenarios: MRZ scanning, barcode decoding, document normalization, document scanning, and viewer workflows.",
         "- When you have a natural-language question about a Dynamsoft SDK.",
         "- For sample lookup by exact ID (e.g. query='hello-world', type='sample').",
         "",
@@ -75,7 +83,7 @@ export function registerIndexTools({
         "",
         "PARAMETERS:",
         "- query (required): Keywords or exact sample ID. Examples: 'barcode scanning from camera', 'MRZ passport reader', 'hello-world'.",
-        "- product: dcv, dbr, dwt, or ddv. Prefer DCV for MRZ/VIN/document-normalization/driver-license; DBR for barcode-only.",
+        "- product: dbr, dwt, ddv, mrz, or mds. Use DBR for barcode-only, MRZ for passport/machine-readable-zone workflows, and MDS for document scan or normalization workflows.",
         "- edition: core, mobile, web, or server.",
         "- platform: android, ios, js, python, cpp, java, dotnet, nodejs, react, vue, angular, flutter, react-native, maui, etc.",
         "- version: Version constraint (e.g. '10', '11.x'). Only latest major is served by default.",
@@ -88,7 +96,7 @@ export function registerIndexTools({
       ].join("\n"),
       inputSchema: {
         query: z.string().trim().min(1, "Query is required.").describe("Keywords to search across docs and samples."),
-        product: z.string().optional().describe("Product: dcv, dbr, dwt, ddv"),
+        product: z.string().optional().describe("Product: dbr, dwt, ddv, mrz, mds"),
         edition: z.string().optional().describe("Edition: core, mobile, web, server/desktop"),
         platform: z.string().optional().describe("Platform: android, ios, maui, react-native, flutter, js, python, cpp, java, dotnet, nodejs, angular, blazor, capacitor, electron, es6, native-ts, next, nuxt, pwa, react, requirejs, svelte, vue, webview, spm, core"),
         version: z.string().optional().describe("Version constraint (major or full version)"),
@@ -104,8 +112,14 @@ export function registerIndexTools({
     },
     async ({ query, product, edition, platform, version, type, limit }) => {
       const normalizedProduct = normalizeProduct(product);
+      if (product && !isKnownPublicOffering(normalizedProduct)) {
+        return buildUnknownPublicProductResponse(product);
+      }
+
       const normalizedPlatform = normalizePlatform(platform);
       const normalizedEdition = normalizeEdition(edition, normalizedPlatform, normalizedProduct);
+      const unsupportedScopeResponse = buildUnsupportedPublicScopeResponse(normalizedProduct, normalizedEdition, normalizedPlatform);
+      if (unsupportedScopeResponse) return unsupportedScopeResponse;
 
       await ensureScopeHydrated({
         product: normalizedProduct,
@@ -185,14 +199,19 @@ export function registerIndexTools({
         }
       }
 
-      const topResults = await searchResources({
-        query,
-        product: normalizedProduct,
-        edition: normalizedEdition,
-        platform: normalizedPlatform,
-        type: effectiveType,
-        limit: maxResults
-      });
+      const preferSampleSuggestionFallback =
+        effectiveType === "sample" && looksLikeSampleIdQuery(query);
+
+      const topResults = preferSampleSuggestionFallback
+        ? []
+        : await searchResources({
+            query,
+            product: normalizedProduct,
+            edition: normalizedEdition,
+            platform: normalizedPlatform,
+            type: effectiveType,
+            limit: maxResults
+          });
 
       if (topResults.length === 0) {
         // Only try sample suggestions when searching samples or any type