@happyvertical/smrt-core 0.46.0 → 0.47.1

package/dist/utils/scanner-module.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"scanner-module.d.ts","sourceRoot":"","sources":["../../src/utils/scanner-module.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"scanner-module.d.ts","sourceRoot":"","sources":["../../src/utils/scanner-module.ts"],"names":[],"mappings":"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"}

package/dist/vite-plugin/api-client-entries.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"api-client-entries.d.ts","sourceRoot":"","sources":["../../src/vite-plugin/api-client-entries.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,KAAK,EACV,qBAAqB,EACrB,mBAAmB,EACpB,MAAM,qBAAqB,CAAC;AAQ7B,MAAM,MAAM,mBAAmB,GAC3B,MAAM,GACN,KAAK,GACL,QAAQ,GACR,QAAQ,GACR,QAAQ,GACR,QAAQ,CAAC;AAEb,MAAM,WAAW,cAAc;IAC7B,wCAAwC;IACxC,UAAU,EAAE,MAAM,CAAC;IACnB,wEAAwE;IACxE,GAAG,EAAE,qBAAqB,CAAC;IAC3B,6EAA6E;IAC7E,SAAS,EAAE,MAAM,CAAC;IAClB,iEAAiE;IACjE,iBAAiB,EAAE,MAAM,CAAC;IAC1B,2EAA2E;IAC3E,WAAW,EAAE,mBAAmB,EAAE,CAAC;IACnC,sEAAsE;IACtE,aAAa,EAAE,KAAK,CAAC;QACnB,IAAI,EAAE,MAAM,CAAC;QACb,KAAK,EAAE,MAAM,GAAG,YAAY,CAAC;QAC7B,cAAc,EAAE,MAAM,EAAE,CAAC;QACzB,UAAU,EAAE,KAAK,CAAC;YAChB,IAAI,EAAE,MAAM,CAAC;YACb,IAAI,EAAE,MAAM,CAAC;YACb,QAAQ,CAAC,EAAE,OAAO,CAAC;YACnB,OAAO,CAAC,EAAE,OAAO,CAAC;SACnB,CAAC,CAAC;KACJ,CAAC,CAAC;CACJ;AAED,wBAAgB,uBAAuB,CACrC,iBAAiB,EAAE,MAAM,EACzB,WAAW,EAAE,mBAAmB,EAAE,EAClC,iBAAiB,GAAE,MAAM,EAAO,GAC/B,MAAM,GAAG,SAAS,CAepB;AAED,wBAAgB,qCAAqC,CACnD,MAAM,EAAE,cAAc,CAAC,eAAe,CAAC,CAAC,MAAM,CAAC,EAC/C,OAAO,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,GAChC,MAAM,CAyCR;AAoSD;;;;GAIG;AACH,wBAAgB,sBAAsB,CACpC,QAAQ,EAAE,mBAAmB,GAC5B,cAAc,EAAE,CAwElB"}
+{"version":3,"file":"api-client-entries.d.ts","sourceRoot":"","sources":["../../src/vite-plugin/api-client-entries.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAOH,OAAO,KAAK,EACV,qBAAqB,EACrB,mBAAmB,EACpB,MAAM,qBAAqB,CAAC;AAQ7B,MAAM,MAAM,mBAAmB,GAC3B,MAAM,GACN,KAAK,GACL,QAAQ,GACR,QAAQ,GACR,QAAQ,GACR,QAAQ,CAAC;AAEb,MAAM,WAAW,cAAc;IAC7B,wCAAwC;IACxC,UAAU,EAAE,MAAM,CAAC;IACnB,wEAAwE;IACxE,GAAG,EAAE,qBAAqB,CAAC;IAC3B,6EAA6E;IAC7E,SAAS,EAAE,MAAM,CAAC;IAClB,iEAAiE;IACjE,iBAAiB,EAAE,MAAM,CAAC;IAC1B,2EAA2E;IAC3E,WAAW,EAAE,mBAAmB,EAAE,CAAC;IACnC,sEAAsE;IACtE,aAAa,EAAE,KAAK,CAAC;QACnB,IAAI,EAAE,MAAM,CAAC;QACb,KAAK,EAAE,MAAM,GAAG,YAAY,CAAC;QAC7B,cAAc,EAAE,MAAM,EAAE,CAAC;QACzB,UAAU,EAAE,KAAK,CAAC;YAChB,IAAI,EAAE,MAAM,CAAC;YACb,IAAI,EAAE,MAAM,CAAC;YACb,QAAQ,CAAC,EAAE,OAAO,CAAC;YACnB,OAAO,CAAC,EAAE,OAAO,CAAC;SACnB,CAAC,CAAC;KACJ,CAAC,CAAC;CACJ;AAED,wBAAgB,uBAAuB,CACrC,iBAAiB,EAAE,MAAM,EACzB,WAAW,EAAE,mBAAmB,EAAE,EAClC,iBAAiB,GAAE,MAAM,EAAO,GAC/B,MAAM,GAAG,SAAS,CAepB;AAED,wBAAgB,qCAAqC,CACnD,MAAM,EAAE,cAAc,CAAC,eAAe,CAAC,CAAC,MAAM,CAAC,EAC/C,OAAO,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,GAChC,MAAM,CAyCR;AA+SD;;;;GAIG;AACH,wBAAgB,sBAAsB,CACpC,QAAQ,EAAE,mBAAmB,GAC5B,cAAc,EAAE,CAwElB"}

package/dist/vite-plugin/api-client-entries.js

@@ -1,4 +1,4 @@
-import { CRUD_OPERATIONS } from "../generators/custom-action.js";
+import { CRUD_OPERATIONS, createManifestClassNamePredicate, resolveApiMethodExposure } from "../generators/custom-action.js";
 import { resolveApiActionRouteConfig } from "./sveltekit-generator.js";
 import { findManifestObjectByName, isCollectionManifestClass, resolveCollectionItemObject } from "./web-collections.js";
 //#region src/vite-plugin/api-client-entries.ts
@@ -68,18 +68,20 @@ function isAncestorOf(manifest, ancestor, descendant) {
 	}
 	return false;
 }
-var CRUD_OPERATION_SET = new Set(CRUD_OPERATIONS);
+new Set(CRUD_OPERATIONS);
 function resolveGeneratedClientCustomMethods(obj, manifest) {
 	const apiConfig = obj.decoratorConfig?.api;
 	if (apiConfig === false) return [];
-	const config = typeof apiConfig === "object" && apiConfig !== null ? apiConfig : void 0;
-	const included = Array.isArray(config?.include) ? config.include : void 0;
-	const excluded = Array.isArray(config?.exclude) ? config.exclude : void 0;
 	const isCollection = isCollectionManifestClass(manifest, obj);
+	const isModelClassName = createManifestClassNamePredicate(manifest);
 	return Object.entries(obj.methods ?? {}).flatMap(([name, method]) => {
-		if (CRUD_OPERATION_SET.has(name) || !method.isPublic) return [];
-		if (included && !included.includes(name)) return [];
-		if (excluded?.includes(name)) return [];
+		if (!resolveApiMethodExposure({
+			actionName: name,
+			method,
+			apiConfig,
+			isCollectionClass: isCollection,
+			...isModelClassName ? { isModelClassName } : {}
+		}).exposed) return [];
 		const routeConfig = resolveApiActionRouteConfig(name, method, apiConfig, {}, isCollection ? "collection" : method.isStatic ? "collection" : "item");
 		return [{
 			name,

package/dist/vite-plugin/api-client-entries.js.map

@@ -1 +1 @@
-{"version":3,"file":"api-client-entries.js","names":[],"sources":["../../src/vite-plugin/api-client-entries.ts"],"sourcesContent":["/**\n * Manifest -> generated API-client entry selection.\n *\n * Runtime client values, Vite ambient declarations, and physical prebuild\n * declarations must agree on which manifest object owns a collection's\n * canonical endpoint. Collection classes describe access methods, not row\n * payloads, so a populated model always wins the shared collection key.\n */\n\nimport { CRUD_OPERATIONS } from '../generators/custom-action.js';\nimport type {\n  SmartObjectDefinition,\n  SmartObjectManifest,\n} from '../scanner/types.js';\nimport { resolveApiActionRouteConfig } from './sveltekit-generator.js';\nimport {\n  findManifestObjectByName,\n  isCollectionManifestClass,\n  resolveCollectionItemObject,\n} from './web-collections.js';\n\nexport type ApiClientCrudMethod =\n  | 'list'\n  | 'get'\n  | 'create'\n  | 'update'\n  | 'delete'\n  | 'search';\n\nexport interface ApiClientEntry {\n  /** Original key in manifest.objects. */\n  objectName: string;\n  /** Object whose routes and custom methods this client entry exposes. */\n  obj: SmartObjectDefinition;\n  /** Canonical collection key or deterministic class-derived secondary key. */\n  clientKey: string;\n  /** Row-payload interface used by CRUD methods for this entry. */\n  dataInterfaceName: string;\n  /** Standard client operations whose server routes are actually emitted. */\n  crudMethods: ApiClientCrudMethod[];\n  /** Custom methods whose routes are actually emitted by the server. */\n  customMethods: Array<{\n    name: string;\n    scope: 'item' | 'collection';\n    pathParamNames: string[];\n    parameters: Array<{\n      name: string;\n      type: string;\n      optional?: boolean;\n      default?: unknown;\n    }>;\n  }>;\n}\n\nexport function renderApiClientCrudType(\n  dataInterfaceName: string,\n  crudMethods: ApiClientCrudMethod[],\n  overriddenMethods: string[] = [],\n): string | undefined {\n  const overridden = new Set(overriddenMethods);\n  const methods = crudMethods.filter((method) => !overridden.has(method));\n  if (methods.length === 0) return undefined;\n  if (\n    methods.length === 6 &&\n    methods.every(\n      (method, index) => method === [...CRUD_OPERATIONS, 'search'][index],\n    )\n  ) {\n    return `CrudOperations<${dataInterfaceName}>`;\n  }\n  return `Pick<CrudOperations<${dataInterfaceName}>, ${methods\n    .map((method) => JSON.stringify(method))\n    .join(' | ')}>`;\n}\n\nexport function renderApiClientCustomMethodParameters(\n  method: ApiClientEntry['customMethods'][number],\n  mapType: (type: string) => string,\n): string {\n  const pathParamNames = new Set(method.pathParamNames);\n  const params = method.parameters;\n  const hasSingleOptionsParameter =\n    params.length === 1 && params[0]?.name === 'options';\n  const requiredPathProperties = method.pathParamNames\n    .map((name) => `${name}: string`)\n    .join('; ');\n  let optionsType: string;\n\n  if (hasSingleOptionsParameter) {\n    const directOptionsType = mapType(params[0].type);\n    optionsType = requiredPathProperties\n      ? `${directOptionsType} & { ${requiredPathProperties} }`\n      : directOptionsType;\n  } else {\n    const parameterNames = new Set(params.map((param) => param.name));\n    const properties = params.map(\n      (param) =>\n        `${param.name}${pathParamNames.has(param.name) || !param.optional ? '' : '?'}: ${mapType(param.type)}`,\n    );\n    for (const pathParamName of method.pathParamNames) {\n      if (!parameterNames.has(pathParamName)) {\n        properties.push(`${pathParamName}: string`);\n      }\n    }\n    optionsType =\n      properties.length > 0\n        ? `{ ${properties.join('; ')} }`\n        : 'Record<string, never>';\n  }\n\n  const hasRequiredOptions = hasSingleOptionsParameter\n    ? !params[0]?.optional\n    : params.some(\n        (param) => !pathParamNames.has(param.name) && !param.optional,\n      );\n  const optionsParameter = `${method.pathParamNames.length > 0 || hasRequiredOptions ? 'options' : 'options?'}: ${optionsType}`;\n  return method.scope === 'collection'\n    ? optionsParameter\n    : `id: string, ${optionsParameter}`;\n}\n\ninterface ManifestCandidate {\n  objectName: string;\n  obj: SmartObjectDefinition;\n}\n\nfunction compareText(left: string, right: string): number {\n  if (left < right) return -1;\n  if (left > right) return 1;\n  return 0;\n}\n\nfunction candidateIdentity(candidate: ManifestCandidate): string {\n  return [\n    candidate.obj.qualifiedName ?? '',\n    candidate.obj.className,\n    candidate.objectName,\n  ].join('\\0');\n}\n\nfunction compareCandidateIdentity(\n  left: ManifestCandidate,\n  right: ManifestCandidate,\n): number {\n  return compareText(candidateIdentity(left), candidateIdentity(right));\n}\n\nfunction lowerFirst(value: string): string {\n  return value ? value[0].toLowerCase() + value.slice(1) : value;\n}\n\nfunction isAncestorOf(\n  manifest: SmartObjectManifest,\n  ancestor: SmartObjectDefinition,\n  descendant: SmartObjectDefinition,\n): boolean {\n  const seen = new Set<string>();\n  let child = descendant;\n  let parentName = child.extendsQualified || child.extends;\n\n  while (parentName && !seen.has(parentName)) {\n    seen.add(parentName);\n    const parent = findManifestObjectByName(manifest, parentName, child);\n    if (!parent) return false;\n    if (parent === ancestor) return true;\n    child = parent;\n    parentName = parent.extendsQualified || parent.extends;\n  }\n\n  return false;\n}\n\nconst CRUD_OPERATION_SET = new Set<string>(CRUD_OPERATIONS);\n\nfunction resolveGeneratedClientCustomMethods(\n  obj: SmartObjectDefinition,\n  manifest: SmartObjectManifest,\n): ApiClientEntry['customMethods'] {\n  const apiConfig = obj.decoratorConfig?.api;\n  if (apiConfig === false) return [];\n\n  const config =\n    typeof apiConfig === 'object' && apiConfig !== null ? apiConfig : undefined;\n  const included = Array.isArray(config?.include) ? config.include : undefined;\n  const excluded = Array.isArray(config?.exclude) ? config.exclude : undefined;\n  const isCollection = isCollectionManifestClass(manifest, obj);\n\n  return Object.entries(obj.methods ?? {}).flatMap(([name, method]) => {\n    if (CRUD_OPERATION_SET.has(name) || !method.isPublic) return [];\n    if (included && !included.includes(name)) return [];\n    if (excluded?.includes(name)) return [];\n\n    const routeConfig = resolveApiActionRouteConfig(\n      name,\n      method,\n      apiConfig,\n      {},\n      isCollection ? 'collection' : method.isStatic ? 'collection' : 'item',\n    );\n\n    return [\n      {\n        name,\n        scope: routeConfig.scope,\n        pathParamNames: routeConfig.pathParamNames,\n        parameters: method.parameters ?? [],\n      },\n    ];\n  });\n}\n\nfunction resolveCrudObject(\n  obj: SmartObjectDefinition,\n  manifest: SmartObjectManifest,\n): SmartObjectDefinition | undefined {\n  if (!isCollectionManifestClass(manifest, obj)) return obj;\n\n  const itemObject = resolveCollectionItemObject(manifest, obj);\n  if (itemObject) return itemObject;\n\n  // A non-conventional collection can still share an endpoint with a model.\n  return Object.values(manifest.objects)\n    .filter(\n      (candidate) =>\n        candidate.collection === obj.collection &&\n        !isCollectionManifestClass(manifest, candidate),\n    )\n    .sort((left, right) =>\n      compareText(\n        left.qualifiedName ?? left.className,\n        right.qualifiedName ?? right.className,\n      ),\n    )[0];\n}\n\nfunction resolveGeneratedClientCrudMethods(\n  obj: SmartObjectDefinition,\n  manifest: SmartObjectManifest,\n): ApiClientCrudMethod[] {\n  const crudObject = resolveCrudObject(obj, manifest);\n  const apiConfig = crudObject?.decoratorConfig?.api;\n  if (!crudObject || apiConfig === false) return [];\n\n  if (apiConfig === true || apiConfig === undefined) {\n    return [...CRUD_OPERATIONS, 'search'];\n  }\n  if (typeof apiConfig !== 'object' || apiConfig === null) {\n    return [...CRUD_OPERATIONS, 'search'];\n  }\n\n  const included = Array.isArray(apiConfig.include)\n    ? apiConfig.include\n    : undefined;\n  const excluded = Array.isArray(apiConfig.exclude) ? apiConfig.exclude : [];\n  const standardMethods = (\n    included\n      ? CRUD_OPERATIONS.filter((action) => included.includes(action))\n      : [...CRUD_OPERATIONS]\n  ).filter((action) => !excluded.includes(action));\n\n  // Preserve the historical search convenience only for an unbounded API\n  // config. Explicit include lists are fail-closed; a real custom search\n  // method is carried separately by resolveGeneratedClientCustomMethods().\n  const includeSearch = !included && !excluded.includes('search');\n  return includeSearch ? [...standardMethods, 'search'] : standardMethods;\n}\n\n/**\n * Resolve the CRUD surface that the generated route files actually expose for\n * one shared collection endpoint.\n *\n * Route generation processes manifest objects in insertion order. Collection\n * and item handlers live in separate files, and the last model that emits each\n * file replaces the earlier file. Mirror that behavior here so every client\n * alias for a shared endpoint has the same, real action set.\n */\nfunction resolveGeneratedEndpointCrudMethods(\n  collection: string,\n  manifest: SmartObjectManifest,\n): ApiClientCrudMethod[] {\n  let collectionMethods: ApiClientCrudMethod[] = [];\n  let itemMethods: ApiClientCrudMethod[] = [];\n\n  for (const obj of Object.values(manifest.objects)) {\n    if (\n      obj.collection !== collection ||\n      isCollectionManifestClass(manifest, obj)\n    ) {\n      continue;\n    }\n\n    const methods = resolveGeneratedClientCrudMethods(obj, manifest);\n    const emittedCollectionMethods = methods.filter((method) =>\n      ['list', 'create', 'search'].includes(method),\n    );\n    const emittedItemMethods = methods.filter((method) =>\n      ['get', 'update', 'delete'].includes(method),\n    );\n\n    // generateRoutesForObject only writes a route file when that file has at\n    // least one standard handler. A custom-only object leaves an earlier CRUD\n    // file intact rather than replacing it with an empty file.\n    if (\n      emittedCollectionMethods.some(\n        (method) => method === 'list' || method === 'create',\n      )\n    ) {\n      collectionMethods = emittedCollectionMethods;\n    }\n    if (emittedItemMethods.length > 0) {\n      itemMethods = emittedItemMethods;\n    }\n  }\n\n  const emitted = new Set([...collectionMethods, ...itemMethods]);\n  const orderedMethods: ApiClientCrudMethod[] = [...CRUD_OPERATIONS, 'search'];\n  return orderedMethods.filter((method) => emitted.has(method));\n}\n\nfunction exposesApiClientSurface(\n  obj: SmartObjectDefinition,\n  manifest: SmartObjectManifest,\n): boolean {\n  if (obj.decoratorConfig?.api === false) return false;\n  if (resolveGeneratedClientCrudMethods(obj, manifest).length > 0) return true;\n\n  // A disabled item has no CRUD routes. Keep its companion collection only\n  // when the collection itself contributes a custom route that the SvelteKit\n  // generator will actually emit.\n  return resolveGeneratedClientCustomMethods(obj, manifest).length > 0;\n}\n\nfunction resolveDataInterfaceName(\n  obj: SmartObjectDefinition,\n  manifest: SmartObjectManifest,\n): string {\n  if (!isCollectionManifestClass(manifest, obj)) {\n    return `${obj.className}Data`;\n  }\n\n  const itemObject = resolveCollectionItemObject(manifest, obj);\n  return `${itemObject?.className || obj.className}Data`;\n}\n\nfunction sharedCollectionModelDepth(\n  manifest: SmartObjectManifest,\n  obj: SmartObjectDefinition,\n): number {\n  const seen = new Set<string>();\n  let depth = 0;\n  let child = obj;\n  let parentName = child.extendsQualified || child.extends;\n\n  while (parentName && !seen.has(parentName)) {\n    seen.add(parentName);\n    const parent = findManifestObjectByName(manifest, parentName, child);\n    if (!parent || parent.collection !== obj.collection) break;\n    depth += 1;\n    child = parent;\n    parentName = parent.extendsQualified || parent.extends;\n  }\n\n  return depth;\n}\n\n/**\n * Select the owner of one canonical collection endpoint with a transitive rank.\n *\n * Models beat collection classes because CRUD payloads are rows. Among models,\n * shallower same-collection ancestry wins, then a root with more descendants\n * wins (the STI base over an unrelated endpoint collision), then qualified\n * identity resolves any remaining ambiguity. Numeric/lexical tuple ranks stay\n * transitive, unlike pairwise ancestry overrides inside Array.sort().\n */\nfunction selectCanonicalOwner(\n  manifest: SmartObjectManifest,\n  group: ManifestCandidate[],\n): ManifestCandidate | undefined {\n  const models = group.filter(\n    (candidate) => !isCollectionManifestClass(manifest, candidate.obj),\n  );\n\n  if (models.length > 0) {\n    return [...models]\n      .map((candidate) => ({\n        candidate,\n        depth: sharedCollectionModelDepth(manifest, candidate.obj),\n        descendantCount: models.filter(\n          (other) =>\n            other !== candidate &&\n            isAncestorOf(manifest, candidate.obj, other.obj),\n        ).length,\n      }))\n      .sort(\n        (left, right) =>\n          left.depth - right.depth ||\n          right.descendantCount - left.descendantCount ||\n          compareCandidateIdentity(left.candidate, right.candidate),\n      )[0]?.candidate;\n  }\n\n  return [...group].sort((left, right) => {\n    const leftHasItem = resolveCollectionItemObject(manifest, left.obj);\n    const rightHasItem = resolveCollectionItemObject(manifest, right.obj);\n    if (Boolean(leftHasItem) !== Boolean(rightHasItem)) {\n      return leftHasItem ? -1 : 1;\n    }\n    return compareCandidateIdentity(left, right);\n  })[0];\n}\n\n/**\n * Select every generated client entry with deterministic endpoint keys and row\n * payload types. Exactly one entry owns each canonical collection key; other\n * API objects remain available under stable class-derived secondary keys.\n */\nexport function selectApiClientEntries(\n  manifest: SmartObjectManifest,\n): ApiClientEntry[] {\n  const candidates = Object.entries(manifest.objects)\n    .filter(([, obj]) => exposesApiClientSurface(obj, manifest))\n    .map(([objectName, obj]): ManifestCandidate => ({ objectName, obj }));\n  const candidatesByCollection = new Map<string, ManifestCandidate[]>();\n\n  for (const candidate of candidates) {\n    const group = candidatesByCollection.get(candidate.obj.collection) ?? [];\n    group.push(candidate);\n    candidatesByCollection.set(candidate.obj.collection, group);\n  }\n\n  const canonicalOwners = new Map<string, ManifestCandidate>();\n  for (const [collection, group] of candidatesByCollection) {\n    const canonicalOwner = selectCanonicalOwner(manifest, group);\n    if (canonicalOwner) canonicalOwners.set(collection, canonicalOwner);\n  }\n\n  // Canonical owners are emitted first within each collection. Sorting all\n  // remaining candidates by identity makes numeric suffixes stable too.\n  const orderedCandidates = [...candidates].sort((left, right) => {\n    const collectionOrder = compareText(\n      left.obj.collection,\n      right.obj.collection,\n    );\n    if (collectionOrder !== 0) return collectionOrder;\n\n    const leftIsCanonical = canonicalOwners.get(left.obj.collection) === left;\n    const rightIsCanonical =\n      canonicalOwners.get(right.obj.collection) === right;\n    if (leftIsCanonical !== rightIsCanonical) {\n      return leftIsCanonical ? -1 : 1;\n    }\n\n    return compareCandidateIdentity(left, right);\n  });\n\n  // A secondary key must never shadow any canonical endpoint, including a\n  // later collection whose canonical owner has not been emitted yet.\n  const reservedCanonicalKeys = new Set(canonicalOwners.keys());\n  const usedKeys = new Set<string>();\n\n  return orderedCandidates.map(({ objectName, obj }) => {\n    const isCanonicalOwner =\n      canonicalOwners.get(obj.collection)?.objectName === objectName;\n    let clientKey = isCanonicalOwner\n      ? obj.collection\n      : lowerFirst(obj.className);\n    const baseClientKey = clientKey;\n    let suffix = 2;\n\n    while (\n      usedKeys.has(clientKey) ||\n      (!isCanonicalOwner && reservedCanonicalKeys.has(clientKey))\n    ) {\n      clientKey = `${baseClientKey}${suffix}`;\n      suffix += 1;\n    }\n\n    usedKeys.add(clientKey);\n    return {\n      objectName,\n      obj,\n      clientKey,\n      dataInterfaceName: resolveDataInterfaceName(obj, manifest),\n      crudMethods: resolveGeneratedEndpointCrudMethods(\n        obj.collection,\n        manifest,\n      ),\n      customMethods: resolveGeneratedClientCustomMethods(obj, manifest),\n    };\n  });\n}\n"],"mappings":"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"}
+{"version":3,"file":"api-client-entries.js","names":[],"sources":["../../src/vite-plugin/api-client-entries.ts"],"sourcesContent":["/**\n * Manifest -> generated API-client entry selection.\n *\n * Runtime client values, Vite ambient declarations, and physical prebuild\n * declarations must agree on which manifest object owns a collection's\n * canonical endpoint. Collection classes describe access methods, not row\n * payloads, so a populated model always wins the shared collection key.\n */\n\nimport {\n  CRUD_OPERATIONS,\n  createManifestClassNamePredicate,\n  resolveApiMethodExposure,\n} from '../generators/custom-action.js';\nimport type {\n  SmartObjectDefinition,\n  SmartObjectManifest,\n} from '../scanner/types.js';\nimport { resolveApiActionRouteConfig } from './sveltekit-generator.js';\nimport {\n  findManifestObjectByName,\n  isCollectionManifestClass,\n  resolveCollectionItemObject,\n} from './web-collections.js';\n\nexport type ApiClientCrudMethod =\n  | 'list'\n  | 'get'\n  | 'create'\n  | 'update'\n  | 'delete'\n  | 'search';\n\nexport interface ApiClientEntry {\n  /** Original key in manifest.objects. */\n  objectName: string;\n  /** Object whose routes and custom methods this client entry exposes. */\n  obj: SmartObjectDefinition;\n  /** Canonical collection key or deterministic class-derived secondary key. */\n  clientKey: string;\n  /** Row-payload interface used by CRUD methods for this entry. */\n  dataInterfaceName: string;\n  /** Standard client operations whose server routes are actually emitted. */\n  crudMethods: ApiClientCrudMethod[];\n  /** Custom methods whose routes are actually emitted by the server. */\n  customMethods: Array<{\n    name: string;\n    scope: 'item' | 'collection';\n    pathParamNames: string[];\n    parameters: Array<{\n      name: string;\n      type: string;\n      optional?: boolean;\n      default?: unknown;\n    }>;\n  }>;\n}\n\nexport function renderApiClientCrudType(\n  dataInterfaceName: string,\n  crudMethods: ApiClientCrudMethod[],\n  overriddenMethods: string[] = [],\n): string | undefined {\n  const overridden = new Set(overriddenMethods);\n  const methods = crudMethods.filter((method) => !overridden.has(method));\n  if (methods.length === 0) return undefined;\n  if (\n    methods.length === 6 &&\n    methods.every(\n      (method, index) => method === [...CRUD_OPERATIONS, 'search'][index],\n    )\n  ) {\n    return `CrudOperations<${dataInterfaceName}>`;\n  }\n  return `Pick<CrudOperations<${dataInterfaceName}>, ${methods\n    .map((method) => JSON.stringify(method))\n    .join(' | ')}>`;\n}\n\nexport function renderApiClientCustomMethodParameters(\n  method: ApiClientEntry['customMethods'][number],\n  mapType: (type: string) => string,\n): string {\n  const pathParamNames = new Set(method.pathParamNames);\n  const params = method.parameters;\n  const hasSingleOptionsParameter =\n    params.length === 1 && params[0]?.name === 'options';\n  const requiredPathProperties = method.pathParamNames\n    .map((name) => `${name}: string`)\n    .join('; ');\n  let optionsType: string;\n\n  if (hasSingleOptionsParameter) {\n    const directOptionsType = mapType(params[0].type);\n    optionsType = requiredPathProperties\n      ? `${directOptionsType} & { ${requiredPathProperties} }`\n      : directOptionsType;\n  } else {\n    const parameterNames = new Set(params.map((param) => param.name));\n    const properties = params.map(\n      (param) =>\n        `${param.name}${pathParamNames.has(param.name) || !param.optional ? '' : '?'}: ${mapType(param.type)}`,\n    );\n    for (const pathParamName of method.pathParamNames) {\n      if (!parameterNames.has(pathParamName)) {\n        properties.push(`${pathParamName}: string`);\n      }\n    }\n    optionsType =\n      properties.length > 0\n        ? `{ ${properties.join('; ')} }`\n        : 'Record<string, never>';\n  }\n\n  const hasRequiredOptions = hasSingleOptionsParameter\n    ? !params[0]?.optional\n    : params.some(\n        (param) => !pathParamNames.has(param.name) && !param.optional,\n      );\n  const optionsParameter = `${method.pathParamNames.length > 0 || hasRequiredOptions ? 'options' : 'options?'}: ${optionsType}`;\n  return method.scope === 'collection'\n    ? optionsParameter\n    : `id: string, ${optionsParameter}`;\n}\n\ninterface ManifestCandidate {\n  objectName: string;\n  obj: SmartObjectDefinition;\n}\n\nfunction compareText(left: string, right: string): number {\n  if (left < right) return -1;\n  if (left > right) return 1;\n  return 0;\n}\n\nfunction candidateIdentity(candidate: ManifestCandidate): string {\n  return [\n    candidate.obj.qualifiedName ?? '',\n    candidate.obj.className,\n    candidate.objectName,\n  ].join('\\0');\n}\n\nfunction compareCandidateIdentity(\n  left: ManifestCandidate,\n  right: ManifestCandidate,\n): number {\n  return compareText(candidateIdentity(left), candidateIdentity(right));\n}\n\nfunction lowerFirst(value: string): string {\n  return value ? value[0].toLowerCase() + value.slice(1) : value;\n}\n\nfunction isAncestorOf(\n  manifest: SmartObjectManifest,\n  ancestor: SmartObjectDefinition,\n  descendant: SmartObjectDefinition,\n): boolean {\n  const seen = new Set<string>();\n  let child = descendant;\n  let parentName = child.extendsQualified || child.extends;\n\n  while (parentName && !seen.has(parentName)) {\n    seen.add(parentName);\n    const parent = findManifestObjectByName(manifest, parentName, child);\n    if (!parent) return false;\n    if (parent === ancestor) return true;\n    child = parent;\n    parentName = parent.extendsQualified || parent.extends;\n  }\n\n  return false;\n}\n\nconst CRUD_OPERATION_SET = new Set<string>(CRUD_OPERATIONS);\n\nfunction resolveGeneratedClientCustomMethods(\n  obj: SmartObjectDefinition,\n  manifest: SmartObjectManifest,\n): ApiClientEntry['customMethods'] {\n  const apiConfig = obj.decoratorConfig?.api;\n  if (apiConfig === false) return [];\n\n  const isCollection = isCollectionManifestClass(manifest, obj);\n  const isModelClassName = createManifestClassNamePredicate(manifest);\n\n  return Object.entries(obj.methods ?? {}).flatMap(([name, method]) => {\n    // The client's whole contract is \"methods whose routes the server actually\n    // emits\", so it reads the SAME resolver the emitters do rather than its own\n    // include/exclude copy. Before #2686 that copy was equivalent; once the\n    // wire-ability gate and `@method()` joined the decision, a local copy would\n    // hand callers a typed `client.assets.createNewVersion(...)` pointing at a\n    // route that is no longer written.\n    if (\n      !resolveApiMethodExposure({\n        actionName: name,\n        method,\n        apiConfig,\n        isCollectionClass: isCollection,\n        ...(isModelClassName ? { isModelClassName } : {}),\n      }).exposed\n    ) {\n      return [];\n    }\n\n    const routeConfig = resolveApiActionRouteConfig(\n      name,\n      method,\n      apiConfig,\n      {},\n      isCollection ? 'collection' : method.isStatic ? 'collection' : 'item',\n    );\n\n    return [\n      {\n        name,\n        scope: routeConfig.scope,\n        pathParamNames: routeConfig.pathParamNames,\n        parameters: method.parameters ?? [],\n      },\n    ];\n  });\n}\n\nfunction resolveCrudObject(\n  obj: SmartObjectDefinition,\n  manifest: SmartObjectManifest,\n): SmartObjectDefinition | undefined {\n  if (!isCollectionManifestClass(manifest, obj)) return obj;\n\n  const itemObject = resolveCollectionItemObject(manifest, obj);\n  if (itemObject) return itemObject;\n\n  // A non-conventional collection can still share an endpoint with a model.\n  return Object.values(manifest.objects)\n    .filter(\n      (candidate) =>\n        candidate.collection === obj.collection &&\n        !isCollectionManifestClass(manifest, candidate),\n    )\n    .sort((left, right) =>\n      compareText(\n        left.qualifiedName ?? left.className,\n        right.qualifiedName ?? right.className,\n      ),\n    )[0];\n}\n\nfunction resolveGeneratedClientCrudMethods(\n  obj: SmartObjectDefinition,\n  manifest: SmartObjectManifest,\n): ApiClientCrudMethod[] {\n  const crudObject = resolveCrudObject(obj, manifest);\n  const apiConfig = crudObject?.decoratorConfig?.api;\n  if (!crudObject || apiConfig === false) return [];\n\n  if (apiConfig === true || apiConfig === undefined) {\n    return [...CRUD_OPERATIONS, 'search'];\n  }\n  if (typeof apiConfig !== 'object' || apiConfig === null) {\n    return [...CRUD_OPERATIONS, 'search'];\n  }\n\n  const included = Array.isArray(apiConfig.include)\n    ? apiConfig.include\n    : undefined;\n  const excluded = Array.isArray(apiConfig.exclude) ? apiConfig.exclude : [];\n  const standardMethods = (\n    included\n      ? CRUD_OPERATIONS.filter((action) => included.includes(action))\n      : [...CRUD_OPERATIONS]\n  ).filter((action) => !excluded.includes(action));\n\n  // Preserve the historical search convenience only for an unbounded API\n  // config. Explicit include lists are fail-closed; a real custom search\n  // method is carried separately by resolveGeneratedClientCustomMethods().\n  const includeSearch = !included && !excluded.includes('search');\n  return includeSearch ? [...standardMethods, 'search'] : standardMethods;\n}\n\n/**\n * Resolve the CRUD surface that the generated route files actually expose for\n * one shared collection endpoint.\n *\n * Route generation processes manifest objects in insertion order. Collection\n * and item handlers live in separate files, and the last model that emits each\n * file replaces the earlier file. Mirror that behavior here so every client\n * alias for a shared endpoint has the same, real action set.\n */\nfunction resolveGeneratedEndpointCrudMethods(\n  collection: string,\n  manifest: SmartObjectManifest,\n): ApiClientCrudMethod[] {\n  let collectionMethods: ApiClientCrudMethod[] = [];\n  let itemMethods: ApiClientCrudMethod[] = [];\n\n  for (const obj of Object.values(manifest.objects)) {\n    if (\n      obj.collection !== collection ||\n      isCollectionManifestClass(manifest, obj)\n    ) {\n      continue;\n    }\n\n    const methods = resolveGeneratedClientCrudMethods(obj, manifest);\n    const emittedCollectionMethods = methods.filter((method) =>\n      ['list', 'create', 'search'].includes(method),\n    );\n    const emittedItemMethods = methods.filter((method) =>\n      ['get', 'update', 'delete'].includes(method),\n    );\n\n    // generateRoutesForObject only writes a route file when that file has at\n    // least one standard handler. A custom-only object leaves an earlier CRUD\n    // file intact rather than replacing it with an empty file.\n    if (\n      emittedCollectionMethods.some(\n        (method) => method === 'list' || method === 'create',\n      )\n    ) {\n      collectionMethods = emittedCollectionMethods;\n    }\n    if (emittedItemMethods.length > 0) {\n      itemMethods = emittedItemMethods;\n    }\n  }\n\n  const emitted = new Set([...collectionMethods, ...itemMethods]);\n  const orderedMethods: ApiClientCrudMethod[] = [...CRUD_OPERATIONS, 'search'];\n  return orderedMethods.filter((method) => emitted.has(method));\n}\n\nfunction exposesApiClientSurface(\n  obj: SmartObjectDefinition,\n  manifest: SmartObjectManifest,\n): boolean {\n  if (obj.decoratorConfig?.api === false) return false;\n  if (resolveGeneratedClientCrudMethods(obj, manifest).length > 0) return true;\n\n  // A disabled item has no CRUD routes. Keep its companion collection only\n  // when the collection itself contributes a custom route that the SvelteKit\n  // generator will actually emit.\n  return resolveGeneratedClientCustomMethods(obj, manifest).length > 0;\n}\n\nfunction resolveDataInterfaceName(\n  obj: SmartObjectDefinition,\n  manifest: SmartObjectManifest,\n): string {\n  if (!isCollectionManifestClass(manifest, obj)) {\n    return `${obj.className}Data`;\n  }\n\n  const itemObject = resolveCollectionItemObject(manifest, obj);\n  return `${itemObject?.className || obj.className}Data`;\n}\n\nfunction sharedCollectionModelDepth(\n  manifest: SmartObjectManifest,\n  obj: SmartObjectDefinition,\n): number {\n  const seen = new Set<string>();\n  let depth = 0;\n  let child = obj;\n  let parentName = child.extendsQualified || child.extends;\n\n  while (parentName && !seen.has(parentName)) {\n    seen.add(parentName);\n    const parent = findManifestObjectByName(manifest, parentName, child);\n    if (!parent || parent.collection !== obj.collection) break;\n    depth += 1;\n    child = parent;\n    parentName = parent.extendsQualified || parent.extends;\n  }\n\n  return depth;\n}\n\n/**\n * Select the owner of one canonical collection endpoint with a transitive rank.\n *\n * Models beat collection classes because CRUD payloads are rows. Among models,\n * shallower same-collection ancestry wins, then a root with more descendants\n * wins (the STI base over an unrelated endpoint collision), then qualified\n * identity resolves any remaining ambiguity. Numeric/lexical tuple ranks stay\n * transitive, unlike pairwise ancestry overrides inside Array.sort().\n */\nfunction selectCanonicalOwner(\n  manifest: SmartObjectManifest,\n  group: ManifestCandidate[],\n): ManifestCandidate | undefined {\n  const models = group.filter(\n    (candidate) => !isCollectionManifestClass(manifest, candidate.obj),\n  );\n\n  if (models.length > 0) {\n    return [...models]\n      .map((candidate) => ({\n        candidate,\n        depth: sharedCollectionModelDepth(manifest, candidate.obj),\n        descendantCount: models.filter(\n          (other) =>\n            other !== candidate &&\n            isAncestorOf(manifest, candidate.obj, other.obj),\n        ).length,\n      }))\n      .sort(\n        (left, right) =>\n          left.depth - right.depth ||\n          right.descendantCount - left.descendantCount ||\n          compareCandidateIdentity(left.candidate, right.candidate),\n      )[0]?.candidate;\n  }\n\n  return [...group].sort((left, right) => {\n    const leftHasItem = resolveCollectionItemObject(manifest, left.obj);\n    const rightHasItem = resolveCollectionItemObject(manifest, right.obj);\n    if (Boolean(leftHasItem) !== Boolean(rightHasItem)) {\n      return leftHasItem ? -1 : 1;\n    }\n    return compareCandidateIdentity(left, right);\n  })[0];\n}\n\n/**\n * Select every generated client entry with deterministic endpoint keys and row\n * payload types. Exactly one entry owns each canonical collection key; other\n * API objects remain available under stable class-derived secondary keys.\n */\nexport function selectApiClientEntries(\n  manifest: SmartObjectManifest,\n): ApiClientEntry[] {\n  const candidates = Object.entries(manifest.objects)\n    .filter(([, obj]) => exposesApiClientSurface(obj, manifest))\n    .map(([objectName, obj]): ManifestCandidate => ({ objectName, obj }));\n  const candidatesByCollection = new Map<string, ManifestCandidate[]>();\n\n  for (const candidate of candidates) {\n    const group = candidatesByCollection.get(candidate.obj.collection) ?? [];\n    group.push(candidate);\n    candidatesByCollection.set(candidate.obj.collection, group);\n  }\n\n  const canonicalOwners = new Map<string, ManifestCandidate>();\n  for (const [collection, group] of candidatesByCollection) {\n    const canonicalOwner = selectCanonicalOwner(manifest, group);\n    if (canonicalOwner) canonicalOwners.set(collection, canonicalOwner);\n  }\n\n  // Canonical owners are emitted first within each collection. Sorting all\n  // remaining candidates by identity makes numeric suffixes stable too.\n  const orderedCandidates = [...candidates].sort((left, right) => {\n    const collectionOrder = compareText(\n      left.obj.collection,\n      right.obj.collection,\n    );\n    if (collectionOrder !== 0) return collectionOrder;\n\n    const leftIsCanonical = canonicalOwners.get(left.obj.collection) === left;\n    const rightIsCanonical =\n      canonicalOwners.get(right.obj.collection) === right;\n    if (leftIsCanonical !== rightIsCanonical) {\n      return leftIsCanonical ? -1 : 1;\n    }\n\n    return compareCandidateIdentity(left, right);\n  });\n\n  // A secondary key must never shadow any canonical endpoint, including a\n  // later collection whose canonical owner has not been emitted yet.\n  const reservedCanonicalKeys = new Set(canonicalOwners.keys());\n  const usedKeys = new Set<string>();\n\n  return orderedCandidates.map(({ objectName, obj }) => {\n    const isCanonicalOwner =\n      canonicalOwners.get(obj.collection)?.objectName === objectName;\n    let clientKey = isCanonicalOwner\n      ? obj.collection\n      : lowerFirst(obj.className);\n    const baseClientKey = clientKey;\n    let suffix = 2;\n\n    while (\n      usedKeys.has(clientKey) ||\n      (!isCanonicalOwner && reservedCanonicalKeys.has(clientKey))\n    ) {\n      clientKey = `${baseClientKey}${suffix}`;\n      suffix += 1;\n    }\n\n    usedKeys.add(clientKey);\n    return {\n      objectName,\n      obj,\n      clientKey,\n      dataInterfaceName: resolveDataInterfaceName(obj, manifest),\n      crudMethods: resolveGeneratedEndpointCrudMethods(\n        obj.collection,\n        manifest,\n      ),\n      customMethods: resolveGeneratedClientCustomMethods(obj, manifest),\n    };\n  });\n}\n"],"mappings":"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"}

package/dist/vite-plugin/index.d.ts

@@ -2,7 +2,7 @@ import { DomainKnowledgeAgentSurface, DomainKnowledgeConfig } from '@happyvertic
 import { Plugin } from 'vite';
 import { SmrtGenerationSnapshotOptions } from '../generation-snapshot.js';
 import { SmartObjectManifest } from '../scanner/types.js';
-import { ScannerAgentSurface } from '../utils/scanner-module.js';
+import { ScannerAgentSurface, ScannerModule } from '../utils/scanner-module.js';
 export { loadVerifiedSmrtGenerationSnapshot, type SerializeSmrtGenerationSnapshotOptions, type SmrtGenerationSnapshotArtifact, type SmrtGenerationSnapshotOptions, type SmrtGenerationSnapshotView, serializeSmrtGenerationSnapshot, sha256SmrtGenerationSnapshot, } from '../generation-snapshot.js';
 export type { CliApiCoherenceViolation, SvelteKitOptions, } from './sveltekit-generator.js';
 export { findCliApiCoherenceViolations, generateSvelteKitRoutes, methodNameToKebab, resolveApiActionRouteConfig, resolveApiActionSet, validateCliIncludeAgainstApi, } from './sveltekit-generator.js';
@@ -112,6 +112,39 @@ export interface SmrtPluginOptions {
  * scan path.
  */
 export declare function toKnowledgeAgentSurface(surface: ScannerAgentSurface | undefined): DomainKnowledgeAgentSurface | undefined;
+/**
+ * Compare the emitted intents against the tool names this build will really
+ * register, and project the result into the knowledge-artifact shape (#2725).
+ *
+ * The rule lives in the scanner, which owns the tool-name derivation. The INPUT
+ * lives here, because only core resolves the exposure policy:
+ * {@link buildWebMcpToolDefinitions} is the function that emits the runtime
+ * `webMcpToolDefinitions`, so its output is the set that actually registers.
+ * Handing the scanner every verb a class COULD expose would report collisions
+ * with tools nobody mounts.
+ *
+ * The check is passed in rather than imported: core reaches the scanner through
+ * {@link importScanner}, which resolves src or dist depending on how core itself
+ * was built, and a static import here would defeat that.
+ *
+ * `declaredBy` is `Class.action` — the same identity `smrt doctor` prints beside
+ * a generated model tool — so a reader can find the other side of the collision
+ * without cross-referencing anything.
+ */
+export declare function collectAgentSurfaceToolNameCollisions(input: {
+    surface: ScannerAgentSurface;
+    manifest: SmartObjectManifest;
+    checkAgentSurfaceToolNames: ScannerModule['checkAgentSurfaceToolNames'];
+    kebabRoutes?: boolean;
+    /**
+     * Prefixes the fixed UI tools mount under. Nothing in a build knows this —
+     * `ui.prefix` is a runtime `<Provider webmcp={{ ui: { prefix } }}>` prop, and
+     * the scanner's default of `smrt_ui_` is correct for every app that leaves it
+     * alone. Threaded anyway so the seam is complete: the day a build-time source
+     * exists, only this call site changes.
+     */
+    uiToolPrefixes?: readonly string[];
+}): DomainKnowledgeAgentSurface['diagnostics'];
 export declare function isRegisterShimModuleId(id: string): boolean;
 /**
  * Generate the replacement `__smrt-register__` module with the build-time

package/dist/vite-plugin/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/vite-plugin/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/vite-plugin/index.ts"],"names":[],"mappings":"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"}

package/dist/vite-plugin/index.js

@@ -68,6 +68,70 @@ function reportAgentSurfaceDiagnostics(surface) {
 		console.warn(`  ${where} — ${diagnostic.message}`);
 	}
 }
+/**
+* Compare the emitted intents against the tool names this build will really
+* register, and project the result into the knowledge-artifact shape (#2725).
+*
+* The rule lives in the scanner, which owns the tool-name derivation. The INPUT
+* lives here, because only core resolves the exposure policy:
+* {@link buildWebMcpToolDefinitions} is the function that emits the runtime
+* `webMcpToolDefinitions`, so its output is the set that actually registers.
+* Handing the scanner every verb a class COULD expose would report collisions
+* with tools nobody mounts.
+*
+* The check is passed in rather than imported: core reaches the scanner through
+* {@link importScanner}, which resolves src or dist depending on how core itself
+* was built, and a static import here would defeat that.
+*
+* `declaredBy` is `Class.action` — the same identity `smrt doctor` prints beside
+* a generated model tool — so a reader can find the other side of the collision
+* without cross-referencing anything.
+*/
+function collectAgentSurfaceToolNameCollisions(input) {
+	return input.checkAgentSurfaceToolNames(input.surface, {
+		generatedToolNames: buildWebMcpToolDefinitions(input.manifest, { kebabRoutes: input.kebabRoutes ?? false }).map((definition) => ({
+			name: definition.name,
+			declaredBy: `${definition.className}.${definition.action}`
+		})),
+		...input.uiToolPrefixes ? { uiToolPrefixes: input.uiToolPrefixes } : {}
+	}).map(({ filePath, ...rest }) => ({
+		...rest,
+		sourceFile: filePath
+	}));
+}
+/**
+* Print every emitted intent whose WebMCP tool name something else also claims
+* (#2725).
+*
+* "Also claims", not "is already taken", for the same reason `smrt doctor`'s
+* header says so: a build cannot see the provider's WebMCP `namespace` or
+* `effects` policy, either of which separates the pair outright. This line runs
+* on every build and every watch rebuild, so it is the surface an author sees
+* most; each message beneath states the condition, and the header must not
+* assert past it.
+*
+* Separate from {@link reportAgentSurfaceDiagnostics} because it says
+* something different: those declarations were EXCLUDED, these are emitted and
+* merely at risk. Folding them into that header would tell an author their
+* intent had been dropped when it had not.
+*/
+function reportAgentSurfaceToolNameCollisions(diagnostics) {
+	if (diagnostics.length === 0) return;
+	console.warn(`[smrt] ⚠️  ${diagnostics.length} declared intent(s) derive a WebMCP tool name something else also claims:`);
+	for (const diagnostic of diagnostics) {
+		const where = diagnostic.line ? `${diagnostic.sourceFile}:${diagnostic.line}` : diagnostic.sourceFile;
+		console.warn(`  ${where} — ${diagnostic.message}`);
+	}
+}
+/**
+* Order the emitted diagnostics the way the scanner's own merge does, so
+* appending the manifest-derived collisions cannot make the artifact depend on
+* when they were computed.
+*/
+function sortKnowledgeAgentSurfaceDiagnostics(diagnostics) {
+	const compare = (a, b) => a < b ? -1 : a > b ? 1 : 0;
+	return [...diagnostics].sort((a, b) => compare(a.sourceFile, b.sourceFile) || (a.line ?? 0) - (b.line ?? 0) || (a.column ?? 0) - (b.column ?? 0) || compare(a.code, b.code) || compare(a.message, b.message));
+}
 async function importScanner() {
 	return importWorkspaceModule({
 		packageName: "@happyvertical/smrt-scanner",
@@ -152,7 +216,7 @@ function smrtPlugin(options = {}) {
 		for (const { className, unreachable } of violations) {
 			const cliConfig = m.objects[className]?.decoratorConfig?.cli;
 			const isEnforced = typeof cliConfig === "object" && cliConfig !== null && Array.isArray(cliConfig.include) && cliConfig.include.length > 0;
-			for (const action of unreachable) console.warn(`[smrt] ${className}.${action} is exposed as a CLI command but is not exposed via the api.` + (isEnforced ? " Build will fail until this is resolved.\n" : " (Not yet build-blocking for this cli:true/{} class -- see #2638.)\n") + `  Either:\n    - Add '${action}' to api.include, or\n    - Remove '${action}' from cli.include / add it to cli.exclude.\n  The CLI invokes methods over HTTP; methods without API routes are unreachable.\n  If this CLI is intentionally invoked in-process (no HTTP), set\n  \`cli: { skipApiCheck: true }\` on the @smrt() decorator to acknowledge.`);
+			for (const action of unreachable) console.warn(`[smrt] ${className}.${action} is exposed as a CLI command but is not exposed via the api.` + (isEnforced ? " Build will fail until this is resolved.\n" : " (Not yet build-blocking for this cli:true/{} class -- see #2638.)\n") + `  Either:\n    - Decorate '${action}' with @method({ expose: true }) to route it, or\n    - Add '${action}' to api.include, or\n    - Remove '${action}' from cli.include / add it to cli.exclude.\n  The CLI invokes methods over HTTP; methods without API routes are unreachable.\n  A public method is routed by default only when every parameter can be\n  built from JSON; see withheldSurfaces in the knowledge artifact for the\n  reason this one was withheld (#2686).\n  If this CLI is intentionally invoked in-process (no HTTP), set\n  \`cli: { skipApiCheck: true }\` on the @smrt() decorator to acknowledge.`);
 		}
 	}
 	let server;
@@ -578,7 +642,8 @@ function smrtPlugin(options = {}) {
 	async function scanWithOxc(rootDir) {
 		const startTime = performance.now();
 		try {
-			const { OxcScanner, ManifestAdapter } = await importScanner();
+			const scannerModule = await importScanner();
+			const { OxcScanner, ManifestAdapter } = scannerModule;
 			console.log(`[smrt] Using experimental OXC scanner for faster builds`);
 			const safeExclude = [...exclude || [], "**/*.svelte"];
 			const { results, resolved } = await new OxcScanner({
@@ -626,6 +691,20 @@ function smrtPlugin(options = {}) {
 				packageName,
 				packageJson
 			});
+			if (agentSurface && results.agentSurface) try {
+				const collisions = collectAgentSurfaceToolNameCollisions({
+					surface: results.agentSurface,
+					manifest: newManifest,
+					checkAgentSurfaceToolNames: scannerModule.checkAgentSurfaceToolNames,
+					kebabRoutes: svelteKit.kebabRoutes ?? false
+				});
+				if (collisions.length > 0) {
+					reportAgentSurfaceToolNameCollisions(collisions);
+					agentSurface.diagnostics = sortKnowledgeAgentSurfaceDiagnostics([...agentSurface.diagnostics, ...collisions]);
+				}
+			} catch (error) {
+				console.warn("[smrt] Skipped the agent-surface tool-name collision check:", error);
+			}
 			const elapsed = performance.now() - startTime;
 			const objectCount = Object.keys(newManifest.objects).length;
 			if (objectCount > 0) {
@@ -1296,6 +1375,6 @@ async function loadDefaultUI() {
 	return getDefaultUIModule();
 }
 //#endregion
-export { buildWebMcpToolDefinitions, findCliApiCoherenceViolations, generateInlineRegisterModule, generateSvelteKitRoutes, generateTypeDeclarationFile, isRegisterShimModuleId, loadVerifiedSmrtGenerationSnapshot, methodNameToKebab, resolveApiActionRouteConfig, resolveApiActionSet, serializeSmrtGenerationSnapshot, sha256SmrtGenerationSnapshot, smrtPlugin, toKnowledgeAgentSurface, validateCliIncludeAgainstApi };
+export { buildWebMcpToolDefinitions, collectAgentSurfaceToolNameCollisions, findCliApiCoherenceViolations, generateInlineRegisterModule, generateSvelteKitRoutes, generateTypeDeclarationFile, isRegisterShimModuleId, loadVerifiedSmrtGenerationSnapshot, methodNameToKebab, resolveApiActionRouteConfig, resolveApiActionSet, serializeSmrtGenerationSnapshot, sha256SmrtGenerationSnapshot, smrtPlugin, toKnowledgeAgentSurface, validateCliIncludeAgainstApi };
 
 //# sourceMappingURL=index.js.map