@happyvertical/smrt-core 0.55.0 → 0.55.2

package/AGENTS.md

@@ -26,6 +26,7 @@ and repository rules.
 | `src/system/registry-snapshot.ts` | Sanitized plain-JSON projection of the booted `ObjectRegistry` for the smrt-dev-mcp runtime dev-plane (#1831); never constructors, validators, values, or absolute paths | [agents/registry-snapshot.md](agents/registry-snapshot.md) |
 | `src/registry/qualified-name-aliases.ts`, `src/migrations/qualified-name-aliases.ts` | Model moves: `previousQualifiedNames` aliases, deprecation, doctor counts, opt-in backfill (#3338) | [agents/model-moves.md](agents/model-moves.md) |
 | `src/run-once.ts` | Shared idempotency seam: insert-only claim + caller work in one transaction, replay on retry, typed in-flight/unknown-outcome answers (#3080) | [agents/run-once.md](agents/run-once.md) |
+| `src/recipe.ts`, `../scanner/src/recipes.ts` | `SmrtRecipe`: declared user-facing units (models, nav, `requires`, curation `options`) collected into manifest and knowledge `recipes` (#3590) | [agents/recipes.md](agents/recipes.md) |
 
 ## Cross-module invariants
 
@@ -169,6 +170,13 @@ and repository rules.
   `src/filesystem-loader.ts`, not a static files-SDK import. Fully bundled apps
   import `@happyvertical/smrt-core/filesystem` at startup. Use
   `importOptionalDependency()` for similarly heavy optional dependencies.
+- `exports['.'].browser` (`dist/browser.js`) is the browser surface. Model
+  package roots are bundled for browsers by the bundle-gate browser fixture
+  (#3621): anything a model root imports from core must be exported by the
+  browser entry and must not reach `node:` built-ins, `pg`, `cosmiconfig`, or
+  `jiti`. Keep Node-only code behind a subpath or a lazy import; when a fix
+  makes a package pass, delete its entry in
+  `packages/bundle-gate/src/browser-gate/expected-failures.ts`.
 - Database retries are transient-only, four attempts total for `get`/`upsert`.
   Use `src/db-errors.ts` classifiers through the cause chain, never message
   matching (SDK driver text can live in `context.originalError`). Constraints,

package/agents/build-knowledge.md

@@ -15,6 +15,48 @@ schemas. No schema/persistence/security effect — `sensitive`/`readPermission`
 stay the security rail, and `sensitive`/`transient` fields never emit to the
 client at all.
 
+`ui.widget` (#3599) adds a presentation widget hint:
+`'textarea' | 'currency' | 'email' | 'url' | 'phone'`. It rides the same
+`_meta.ui` channel and is also emitted (sanitized) into web-collection
+definitions. The manifest generator validates it against the field type and
+fails the build otherwise: every widget needs a `text` field (`currency` is a
+currency-CODE picker for an ISO 4217 string such as `currency = 'USD'`, not a
+money amount; amounts are integer minor units and take no widget); an unknown
+value or a non-text field is an error. `ui.widget` is a hint only — it never changes
+the column type or validation.
+
+## Presentation metadata (#3599)
+
+Pure helpers live in `src/ui-metadata.ts`, published browser-safe as
+`@happyvertical/smrt-core/ui-metadata` (also re-exported from the package
+root). `ManifestGenerator.applyUiMetadata()` runs in `applyGenerationPasses`
+after inheritance, so every producer (Vite plugin, `ManifestBuilder`,
+`generateManifest`) validates the same way.
+
+- **Display label.** `@smrt({ display: { label: '<field>' } })` names the own
+  field generic pickers and assistants use to label a record. Own fields only —
+  no paths into other packages; a model whose label lives elsewhere ships a
+  selector. Undeclared, it defaults to the first of `name`, `title`, `label`,
+  `code` that is a usable own field. Build fails when the declared field is
+  missing, `sensitive`, `transient`, or a relationship/json field. The resolved
+  field is emitted as `displayLabelField` on the manifest object and in the
+  knowledge artifact, and generated MCP/WebMCP `list`/`get`/`update`/`delete`
+  descriptions end with ``Records are identified by their `<field>` field.``
+  (`describeAction` in `generators/tool-schema.ts`; nothing is added when the
+  model has no label field).
+- **Selector slots.** `ModuleUISlot.selects: '@scope/pkg:Model'`
+  (`@happyvertical/smrt-types`) marks a package component as THE selector for a
+  model. The scanner reads such slots statically from `src/**/ui.ts`
+  (`parseUiSelectorsFile`, independent of the class glob) and the manifest
+  carries them as `uiSelectors` keyed by slot id. `selects` must be a string
+  literal; a duplicate slot id, two selectors for one model, or an own-package
+  target that does not exist fails the build. Hosts call
+  `findSelectorFor(manifests, qualifiedName)`; generic forms use the selector
+  for any `@foreignKey`/`@crossPackageRef` field targeting that model and fall
+  back to a generic picker labelled by `displayLabelField`. `display` is read
+  per class: an STI subclass that declares none uses the default lookup rather
+  than its base's declaration, and a CTI child cannot name a parent's field.
+
 ## Worker registration artifact (#3117)
 
 With `svelteKit.enabled`, a production `vite build` compiles the generated

package/agents/generators.md

@@ -302,3 +302,16 @@ and static collection-scoped actions only need registration, so they import
 and `@happyvertical/smrt-app-runtime/sveltekit` resolves from the consumer, the
 generator writes a runtime-shaped default instead of the legacy
 `getCollection` file.
+
+## Enum-constrained fields (#3598)
+
+The scanner emits `enum: [...]` on a manifest field typed as a TS enum or
+string/number literal union. Registry-sourced fields mirror it into
+`_meta.enum` (`createFieldFromManifest` / `mergeManifestField`); read it with
+`readFieldEnum()` (top level first, then `_meta`), never directly. Generated
+tool schemas (`fieldTypeToJsonSchema`, so MCP and WebMCP descriptors), OpenAPI
+(`swagger.ts`) and the legacy `generateSchemaProperties` emit JSON Schema
+`enum` for `text`/`integer`/`decimal` fields only; a nullable field appends
+`null` to the list so `type: [.., 'null']` still validates. The client web
+collection `fields` map does not carry `enum` yet (it feeds the shape digest and
+three hand-mirrored d.ts files); tool inputs read it from the manifest field.

package/agents/recipes.md

@@ -0,0 +1,150 @@
+# SmrtRecipe: declared units of app functionality (#3590)
+
+A **recipe** is a small, named, user-facing unit ("Sales", "Customers"),
+smaller than a package. An app or agent adds a recipe and gets that section:
+navigation, list and create/edit views, and its prerequisites, without every
+model in the owning package. Source: `src/recipe.ts` (authoring base class),
+`packages/scanner/src/recipes.ts` (matcher and validation), types in
+`@happyvertical/smrt-types` (`RecipeDefinition`).
+
+## Authoring
+
+`SmrtRecipe` is an abstract, **non-persisted, non-`@smrt()`** base class
+exported from both core entries (`index.ts` and `browser.ts`). A recipe is a
+subclass with static properties, in the package that owns its models:
+
+```ts
+export class SalesRecipe extends SmrtRecipe {
+  static id = 'commerce.sales';          // dotted lowercase, unique
+  static label = 'Sales';
+  static summary = 'Take customer orders and track them.';
+  static synonyms = ['sales orders', 'orders'];
+  static models = [Order];               // class references
+  static nav = [{ label: 'Sales Orders', model: Order }];
+  static requires = ['commerce.customers']; // recipe ids, any package
+  static options = { Order: { fields: { status: { default: 'draft' } } } };
+}
+```
+
+Statics are read **structurally** (nothing is evaluated), so each must be
+spelled literally; `models` and `nav[].model` take identifiers. Write
+`static options = { ... } as const` so `visibility` stays a literal type.
+The emitted `options` are keyed by qualified model name.
+
+## How the scanner collects it
+
+The scanner class pass finds classes by decorator, which a recipe lacks, so
+`recipes.ts` is a second matcher in the style of the agent-surface one: a class
+whose `extends` resolves to the `SmrtRecipe` import binding from
+`@happyvertical/smrt-core` (named, aliased `SmrtRecipe as R`, or namespace
+`Core.SmrtRecipe`; any core subpath such as `/browser`). A same-named local
+class or an import from another library is not a recipe. A recipe must extend
+`SmrtRecipe` **directly**. Within one file, extending another recipe or declaring
+one as a class expression or inside a block is a scan error rather than a silent
+drop. Across files it is not detected: a module that never names `SmrtRecipe`
+is not read, so a recipe extending a recipe or intermediate base imported from
+another module is unsupported and would be missing from the artifacts.
+
+Class references resolve to qualified names (`@scope/pkg:Class`) through the
+import binding: a relative specifier picks the scanned class by file, then by
+class name (barrel re-exports keep the name); an aliased import follows the
+*imported* name; `Ns.Class` namespace members and same-file classes work; a
+bare package specifier is rejected (models must belong to this package). When
+the imported file declares no such class, the barrel fallback binds a same-named
+scanned class, so keep model class names unique within a package. This
+was chosen over qualified-name strings because it type-checks and survives
+renames; strings were not needed.
+
+Recipe discovery is independent of the model `include` glob (like intents; it is
+not gated by the `agentSurface` option), and
+`ScanResults.recipes` is populated by `resolve()`. Every error is a scan error,
+so every producer that reads `scanAndResolve()` (`smrtPlugin`, `ManifestBuilder`)
+fails the build. (The legacy `ManifestGenerator.generateManifest()` path takes
+pre-scanned results and never sees recipes.) The adapter qualifies names and emits a top-level `recipes` array in
+`manifest.json`; `buildDomainKnowledgeManifest` projects the same array into
+`smrt-knowledge.json`. A package with no recipe emits no key.
+
+## Build-time validation
+
+Ids are dotted lowercase and unique; `models` is non-empty, resolvable, and
+duplicate-free; every `nav` model is in `models`; `requires` are well-formed,
+not self-referential or duplicated, and acyclic within the package (ids in other
+packages cannot be checked at scan time); `options` name only listed models and
+and only the keys below. Field names are checked in core
+(`ManifestGenerator.assertRecipeOptions`, after inherited fields merge) against
+the merged manifest, so STI-merged, tenant, and framework-base fields such as
+`parentId` are accepted along with the universal `id`, `slug`, `context`,
+`created_at`, `updated_at`; anything else fails the build.
+
+## options: curation hints, never a second schema
+
+Keyed by model class name. `fields.<name>` accepts the smrt-fields policy
+vocabulary: `default`, `label`, `help`, `order`, `visibility`
+(`basic | advanced | hidden`), `locked`; applying a recipe produces
+field-policy rows. `exposure.<api|mcp|cli>` accepts only `false` or
+non-empty `{ exclude: [...] }` naming a CRUD verb (`list`, `get`, `create`,
+`update`, `delete`) or a public instance method the model declares or inherits: `true` and `include` are
+rejected because they can widen what the model already declares. Custom fields are out of scope.
+
+## User-facing help (#3591)
+
+Help is documentation for the people using the app, not developers. It lives
+beside the recipe as Markdown and is pointed to by `static help`:
+
+```ts
+export class SalesRecipe extends SmrtRecipe {
+  // ...
+  static help = './sales.recipe.md'; // relative to the recipe file, .md only
+}
+```
+
+The file holds an **Overview** and **Tasks** (short how-tos). A step names a
+field as `{field:<fieldName>}` or `{field:<Model>.<fieldName>}`; the Markdown
+block (heading, paragraph, or list item) containing a reference is **tied to
+that field**. Keep prose in the separate file rather than the recipe class.
+Field text itself comes from `@field({ description })`, the user-facing seed
+smrt-fields uses for form help; every field a recipe shows should carry one.
+
+**Emission.** The scanner reads the file (a missing, empty, non-`.md`, absolute
+or `..`-climbing path is a scan error) and emits
+`help: { markdown, fieldRefs }` on the recipe entry in `manifest.json` and
+`smrt-knowledge.json`, so a static host needs no further request.
+`fieldRefs` (distinct references as written, sorted) is **derived**, never
+authored. Knowledge fields also carry `description` (sensitive fields stay
+excluded). `ManifestGenerator.assertRecipeHelp` fails the build on a reference
+to a field the recipe's models do not declare, and on a `fieldRefs` list that
+disagrees with the Markdown. The scanner has its own copy of the reference
+grammar (`deriveHelpFieldRefs`; it cannot import core), so that comparison also
+keeps the two from drifting. A reference to a **sensitive** or universal (`id`,
+`slug`, ...) field also fails the build: neither reaches the knowledge artifact,
+so a host building its field list from it would silently drop the step naming
+one; describe such a field in prose without a reference.
+
+Known limitation: the help file is a generator input, but editing only it does
+not trigger a dev-server rescan (the watch matches source globs) and generation
+snapshots do not digest it, so rebuild (or touch a `.ts` source) after editing.
+
+**Rendering.** `src/recipe-help.ts` is pure and browser-safe (exported from
+both core entries). `renderHelp(help, models, options?)` takes the recipe's
+help plus the app's effective field policies (`HelpModel[]`; label, help,
+visibility, disabled in smrt-fields vocabulary, with `@field` descriptions) and
+returns `{ blocks, glossary, connect? }`:
+
+- `{field:x}` becomes the effective label;
+- a block tied to a hidden, disabled, undeclared, or **advanced** field (unless
+  `showAdvanced`) is dropped; a list item drops alone; a heading whose section
+  had content that was all dropped is pruned (a heading that never had content
+  stays);
+- the glossary lists each shown field with its effective help, else its
+  description. A shown field with neither is **skipped**, not listed blank;
+- `connect` is the collapsed "Connect other tools" section: the recipe's
+  generated REST routes, MCP tools and CLI commands (`options.surfaces`, from
+  the knowledge artifact), minus the recipe's `exposure` narrowing
+  (`options.exposure`). Hosts render it last.
+
+The result is an AST of text nodes (`text`, `code`, `strong`, `em`), never HTML,
+so authored markup stays inert text and nothing needs sanitizing. Only
+`##`-`####` headings, paragraphs, flat lists and bold/italic/code are
+understood. `helpToMarkdown(rendered)` flattens it for hosts with their own
+renderer; render that with raw HTML disabled. `validateHelp(help, models)`
+returns the build-failure problems for hand-built entries.

package/dist/browser.d.ts

@@ -27,10 +27,13 @@ export { type HierarchyView, SmrtHierarchical } from "./hierarchical.js";
 export { type JunctionAttachOptions, type JunctionFilterOptions, SmrtJunction, SmrtJunctionBase, } from "./junction.js";
 export * from "./object.js";
 export { SmrtPolymorphicAssociation, type SmrtPolymorphicAssociationOptions, } from "./polymorphic-association.js";
+export { SmrtRecipe, type SmrtRecipeModel, type SmrtRecipeModelOptions, type SmrtRecipeNavEntry, } from "./recipe.js";
+export { buildConnectSection, buildGlossary, type ConnectSection, type ConnectSurface, createRecipeHelp, extractFieldRefs, findField, type GlossaryEntry, type HelpBlock, type HelpField, type HelpModel, helpToMarkdown, type Inline, parseHelp, type RecipeHelp, type RenderedHelp, type RenderHelpOptions, renderHelp, resolveHelp, validateHelp, } from "./recipe-help.js";
 export * from "./registry.js";
 export { smrt as smrtRegistry } from "./registry.js";
 export * from "./signals/index.js";
 export * from "./system/index.js";
 export type { DiscoveryStrategy, ForgetOptions, ForgetScopeOptions, NoteMetadata, NoteOptions, RecallAllOptions, RecallOptions, SystemTableConfig, } from "./system/types.js";
 export * from "./tools/index.js";
+export * from './ui-metadata.js';
 //# sourceMappingURL=browser.d.ts.map

package/dist/browser.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"browser.d.ts","sourceRoot":"","sources":["../src/browser.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAGH,cAAc,qBAAkB,CAAC;AACjC,cAAc,YAAY,CAAC;AAE3B,cAAc,YAAS,CAAC;AACxB,cAAc,iBAAc,CAAC;AAC7B,YAAY,EACV,aAAa,EACb,kBAAkB,EAClB,aAAa,EACb,YAAY,GACb,MAAM,aAAU,CAAC;AAElB,OAAO,EAAE,MAAM,EAAE,MAAM,aAAU,CAAC;AAOlC,OAAO,EACL,qBAAqB,EACrB,sBAAsB,EACtB,KAAK,2BAA2B,EAChC,KAAK,iBAAiB,EACtB,yBAAyB,EACzB,4BAA4B,EAC5B,uBAAuB,EACvB,wBAAwB,EACxB,sBAAsB,GACvB,MAAM,gBAAa,CAAC;AAIrB,cAAc,gBAAa,CAAC;AAC5B,cAAc,aAAU,CAAC;AACzB,OAAO,EAAE,KAAK,aAAa,EAAE,gBAAgB,EAAE,MAAM,mBAAgB,CAAC;AACtE,OAAO,EACL,KAAK,qBAAqB,EAC1B,KAAK,qBAAqB,EAC1B,YAAY,EACZ,gBAAgB,GACjB,MAAM,eAAY,CAAC;AACpB,cAAc,aAAU,CAAC;AACzB,OAAO,EACL,0BAA0B,EAC1B,KAAK,iCAAiC,GACvC,MAAM,8BAA2B,CAAC;AACnC,cAAc,eAAY,CAAC;AAC3B,OAAO,EAAE,IAAI,IAAI,YAAY,EAAE,MAAM,eAAY,CAAC;AAElD,cAAc,oBAAiB,CAAC;AAEhC,cAAc,mBAAgB,CAAC;AAC/B,YAAY,EACV,iBAAiB,EACjB,aAAa,EACb,kBAAkB,EAClB,YAAY,EACZ,WAAW,EACX,gBAAgB,EAChB,aAAa,EACb,iBAAiB,GAClB,MAAM,mBAAgB,CAAC;AAExB,cAAc,kBAAe,CAAC"}
+{"version":3,"file":"browser.d.ts","sourceRoot":"","sources":["../src/browser.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAGH,cAAc,qBAAkB,CAAC;AACjC,cAAc,YAAY,CAAC;AAE3B,cAAc,YAAS,CAAC;AACxB,cAAc,iBAAc,CAAC;AAC7B,YAAY,EACV,aAAa,EACb,kBAAkB,EAClB,aAAa,EACb,YAAY,GACb,MAAM,aAAU,CAAC;AAElB,OAAO,EAAE,MAAM,EAAE,MAAM,aAAU,CAAC;AAOlC,OAAO,EACL,qBAAqB,EACrB,sBAAsB,EACtB,KAAK,2BAA2B,EAChC,KAAK,iBAAiB,EACtB,yBAAyB,EACzB,4BAA4B,EAC5B,uBAAuB,EACvB,wBAAwB,EACxB,sBAAsB,GACvB,MAAM,gBAAa,CAAC;AAIrB,cAAc,gBAAa,CAAC;AAC5B,cAAc,aAAU,CAAC;AACzB,OAAO,EAAE,KAAK,aAAa,EAAE,gBAAgB,EAAE,MAAM,mBAAgB,CAAC;AACtE,OAAO,EACL,KAAK,qBAAqB,EAC1B,KAAK,qBAAqB,EAC1B,YAAY,EACZ,gBAAgB,GACjB,MAAM,eAAY,CAAC;AACpB,cAAc,aAAU,CAAC;AACzB,OAAO,EACL,0BAA0B,EAC1B,KAAK,iCAAiC,GACvC,MAAM,8BAA2B,CAAC;AACnC,OAAO,EACL,UAAU,EACV,KAAK,eAAe,EACpB,KAAK,sBAAsB,EAC3B,KAAK,kBAAkB,GACxB,MAAM,aAAU,CAAC;AAClB,OAAO,EACL,mBAAmB,EACnB,aAAa,EACb,KAAK,cAAc,EACnB,KAAK,cAAc,EACnB,gBAAgB,EAChB,gBAAgB,EAChB,SAAS,EACT,KAAK,aAAa,EAClB,KAAK,SAAS,EACd,KAAK,SAAS,EACd,KAAK,SAAS,EACd,cAAc,EACd,KAAK,MAAM,EACX,SAAS,EACT,KAAK,UAAU,EACf,KAAK,YAAY,EACjB,KAAK,iBAAiB,EACtB,UAAU,EACV,WAAW,EACX,YAAY,GACb,MAAM,kBAAe,CAAC;AACvB,cAAc,eAAY,CAAC;AAC3B,OAAO,EAAE,IAAI,IAAI,YAAY,EAAE,MAAM,eAAY,CAAC;AAElD,cAAc,oBAAiB,CAAC;AAEhC,cAAc,mBAAgB,CAAC;AAC/B,YAAY,EACV,iBAAiB,EACjB,aAAa,EACb,kBAAkB,EAClB,YAAY,EACZ,WAAW,EACX,gBAAgB,EAChB,aAAa,EACb,iBAAiB,GAClB,MAAM,mBAAgB,CAAC;AAExB,cAAc,kBAAe,CAAC;AAO9B,cAAc,kBAAkB,CAAC"}

package/dist/browser.js

@@ -15,6 +15,8 @@ import { ensureSystemTables } from "./system/bootstrap.js";
 import { SmrtClass } from "./class.js";
 import { DEFAULT_FACET_LIMIT, EmbeddingUnavailableError, MAX_FACET_FIELDS, MAX_FACET_LIMIT, MAX_STI_READ_SCOPE_TYPES, SmrtCollection } from "./collection.js";
 import { convertTypeToJsonSchema, generateToolFromMethod, generateToolManifest, shouldIncludeMethod } from "./tools/tool-generator.js";
+import { buildConnectSection, buildGlossary, createRecipeHelp, extractFieldRefs, findField, helpToMarkdown, parseHelp, renderHelp, resolveHelp, validateHelp } from "./recipe-help.js";
+import { DEFAULT_DISPLAY_LABEL_FIELDS, FIELD_UI_WIDGETS, FIELD_UI_WIDGET_TYPES, describeDisplayLabel, displayLabelFieldProblem, findSelectorFor, isFieldUIWidget, resolveDisplayLabelField } from "./ui-metadata.js";
 import { executeToolCall, executeToolCalls, formatToolResults, validateToolCall } from "./tools/tool-executor.js";
 import { SmrtObject } from "./object.js";
 import { isFrameworkBaseClass } from "./registry/framework-base-classes.js";
@@ -24,10 +26,11 @@ import { auditChanges, auditSnapshot, getActiveAuditOptions, isAudited, requireA
 import { SmrtHierarchical } from "./hierarchical.js";
 import { SmrtJunction, SmrtJunctionBase } from "./junction.js";
 import { SmrtPolymorphicAssociation } from "./polymorphic-association.js";
+import { SmrtRecipe } from "./recipe.js";
 import "./signals/index.js";
 import { DIAGNOSTICS_DEFAULT_LIMIT, SYSTEM_DIAGNOSTICS_TABLES, readDispatchHealth, readJobHealth, readMigrationStatus, readRecentChanges, readRegistryDrift, readScheduleHealth, readSystemDiagnostics } from "./system/diagnostics.js";
 import { BOOTED_PROVENANCE, assertPlainJson, sanitizeMessagePaths, snapshotRegistry } from "./system/registry-snapshot.js";
 import { DEFAULT_RETENTION_POLICY, clearRetentionTasks, getRetentionTasks, pruneAiUsage, pruneExpiredContexts, pruneRunOnceClaims, registerRetentionTask, runRetentionSweep, unregisterRetentionTask } from "./system/retention.js";
 import "./system/index.js";
 import "./tools/index.js";
-export { AIError, AiUsageCollector, AiUsagePersistenceHandler, BOOTED_PROVENANCE, ConfigurationError, DEFAULT_AI_COST_RATES, DEFAULT_FACET_LIMIT, DEFAULT_RETENTION_POLICY, DIAGNOSTICS_DEFAULT_LIMIT, DatabaseError, EmbeddingUnavailableError, ErrorUtils, FilesystemError, MAX_FACET_FIELDS, MAX_FACET_LIMIT, MAX_STI_READ_SCOPE_TYPES, MetricsAdapter, NetworkError, ObjectRegistry, PubSubAdapter, RunOnceClaimError, RuntimeError, SMRT_COLLECTION_BASE_NAMES, SMRT_SCHEMA_VERSION, SYSTEM_DIAGNOSTICS_TABLES, SignalBus, SignalSanitizer, SmrtClass, SmrtCollection, SmrtError, SmrtHierarchical, SmrtJunction, SmrtJunctionBase, SmrtObject, SmrtPolymorphicAssociation, TenantIsolationError, ValidationError, ValidationReport, ValidationUtils, assertFiniteUnitInterval, assertPlainJson, assertPostgresSystemTimestampsCurrent, auditChanges, auditSnapshot, classifyDatabaseError, classifyDialectMessage, clearRetentionTasks, config, convertTypeToJsonSchema, ensureBootstrapSystemTableCompatibility, ensureDeferredSystemTableCompatibility, ensureDispatchSubscriptionsSystemTableCompatibility, ensureDispatchSystemTableCompatibility, ensureJobEventsSystemTableCompatibility, ensureJobsSystemTableCompatibility, ensureLegacySystemTableCompatibility, ensureSystemTables, estimateAiUsageCost, executeDecision, executeToolCall, executeToolCalls, formatToolResults, generateToolFromMethod, generateToolManifest, getActiveAuditOptions, getDatabaseEngine, getRetentionTasks, isAbortedTransactionError, isAudited, isDeterministicDatabaseError, isFrameworkBaseClass, isNotNullViolationError, isSmrtCollectionExtendsName, isTransientDatabaseError, isUniqueViolationError, migratePostgresSystemTimestamps, planPostgresSystemTimestampMigrations, pruneAiUsage, pruneExpiredContexts, pruneRunOnceClaims, readDispatchHealth, readJobHealth, readMigrationStatus, readRecentChanges, readRegistryDrift, readScheduleHealth, readSystemDiagnostics, registerRetentionTask, requireAuditOptions, runRetentionSweep, sanitizeMessagePaths, shouldIncludeMethod, smrt, smrt as smrtRegistry, snapshotRegistry, tableExists, unregisterRetentionTask, validateToolCall, writeAudit };
+export { AIError, AiUsageCollector, AiUsagePersistenceHandler, BOOTED_PROVENANCE, ConfigurationError, DEFAULT_AI_COST_RATES, DEFAULT_DISPLAY_LABEL_FIELDS, DEFAULT_FACET_LIMIT, DEFAULT_RETENTION_POLICY, DIAGNOSTICS_DEFAULT_LIMIT, DatabaseError, EmbeddingUnavailableError, ErrorUtils, FIELD_UI_WIDGETS, FIELD_UI_WIDGET_TYPES, FilesystemError, MAX_FACET_FIELDS, MAX_FACET_LIMIT, MAX_STI_READ_SCOPE_TYPES, MetricsAdapter, NetworkError, ObjectRegistry, PubSubAdapter, RunOnceClaimError, RuntimeError, SMRT_COLLECTION_BASE_NAMES, SMRT_SCHEMA_VERSION, SYSTEM_DIAGNOSTICS_TABLES, SignalBus, SignalSanitizer, SmrtClass, SmrtCollection, SmrtError, SmrtHierarchical, SmrtJunction, SmrtJunctionBase, SmrtObject, SmrtPolymorphicAssociation, SmrtRecipe, TenantIsolationError, ValidationError, ValidationReport, ValidationUtils, assertFiniteUnitInterval, assertPlainJson, assertPostgresSystemTimestampsCurrent, auditChanges, auditSnapshot, buildConnectSection, buildGlossary, classifyDatabaseError, classifyDialectMessage, clearRetentionTasks, config, convertTypeToJsonSchema, createRecipeHelp, describeDisplayLabel, displayLabelFieldProblem, ensureBootstrapSystemTableCompatibility, ensureDeferredSystemTableCompatibility, ensureDispatchSubscriptionsSystemTableCompatibility, ensureDispatchSystemTableCompatibility, ensureJobEventsSystemTableCompatibility, ensureJobsSystemTableCompatibility, ensureLegacySystemTableCompatibility, ensureSystemTables, estimateAiUsageCost, executeDecision, executeToolCall, executeToolCalls, extractFieldRefs, findField, findSelectorFor, formatToolResults, generateToolFromMethod, generateToolManifest, getActiveAuditOptions, getDatabaseEngine, getRetentionTasks, helpToMarkdown, isAbortedTransactionError, isAudited, isDeterministicDatabaseError, isFieldUIWidget, isFrameworkBaseClass, isNotNullViolationError, isSmrtCollectionExtendsName, isTransientDatabaseError, isUniqueViolationError, migratePostgresSystemTimestamps, parseHelp, planPostgresSystemTimestampMigrations, pruneAiUsage, pruneExpiredContexts, pruneRunOnceClaims, readDispatchHealth, readJobHealth, readMigrationStatus, readRecentChanges, readRegistryDrift, readScheduleHealth, readSystemDiagnostics, registerRetentionTask, renderHelp, requireAuditOptions, resolveDisplayLabelField, resolveHelp, runRetentionSweep, sanitizeMessagePaths, shouldIncludeMethod, smrt, smrt as smrtRegistry, snapshotRegistry, tableExists, unregisterRetentionTask, validateHelp, validateToolCall, writeAudit };

package/dist/generators/mcp.d.ts.map

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

package/dist/generators/mcp.js

@@ -2,13 +2,15 @@ import { buildDefaultListOrderBy, resolveListLimit, resolveListOffset } from "..
 import { SmrtCollection } from "../collection.js";
 import { isQualifiedName } from "../utils/qualified-names.js";
 import { SMRT_CUSTOM_ACTION_ERROR_METADATA_KEY, buildCustomActionInvocationArgs, customActionParameterInputName, isCrudOperation, isCrudToolAction, isFrameworkLifecycleMethod, normalizeCustomActionFailure, resolveCustomActionMetadata } from "./custom-action.js";
+import { resolveDisplayLabelField } from "../ui-metadata.js";
 import { isFrameworkBaseClass } from "../registry/framework-base-classes.js";
+import { readFieldEnum } from "../registry/manifest-field-merge.js";
 import { ObjectRegistry } from "../registry.js";
 import { generatedSiblingExtension, renderGeneratedSource, resolveGeneratedSourceLanguage } from "./mcp-emit.js";
 import { generateClaudeConfig, generateMCPDocumentation, generateMCPScript, generateRuntimeBootstrap } from "./mcp-runtime-template.js";
 import { canonicalMcpToolNames } from "./mcp-tool-name.js";
 import { runWithTenantGate } from "./tenant-gate.js";
-import { assertMcpJsonSchemaSafety, buildToolInputSchema, fieldTypeToJsonSchema, finalizeMcpJsonSchema, isCrudAction, resolveToolSemantics } from "./tool-schema.js";
+import { assertMcpJsonSchemaSafety, buildToolInputSchema, describeAction, fieldTypeToJsonSchema, finalizeMcpJsonSchema, isCrudAction, resolveToolSemantics } from "./tool-schema.js";
 import { dirname, resolve } from "node:path";
 import { mkdir, writeFile } from "node:fs/promises";
 //#region src/generators/mcp.ts
@@ -244,37 +246,38 @@ var MCPGenerator = class {
 		const fields = ObjectRegistry.getFields(objectName);
 		const lowerName = displayName.toLowerCase();
 		const classInfo = ObjectRegistry.getClass(objectName);
+		const labelField = resolveDisplayLabelField(Object.fromEntries(fields), ObjectRegistry.getConfig(objectName).display?.label);
 		if (shouldInclude("list")) tools.push({
 			name: `${lowerName}_list`,
-			description: `List ${displayName} objects with optional filtering`,
+			description: describeAction("list", displayName, labelField),
 			inputSchema: this.buildInputSchema(objectName, "list", fields),
 			outputSchema: this.buildOutputSchema(objectName, "list", fields),
 			annotations: mcpToolAnnotations("list")
 		});
 		if (shouldInclude("get")) tools.push({
 			name: `${lowerName}_get`,
-			description: `Get a specific ${displayName} by ID or slug`,
+			description: describeAction("get", displayName, labelField),
 			inputSchema: this.buildInputSchema(objectName, "get", fields),
 			outputSchema: this.buildOutputSchema(objectName, "get", fields),
 			annotations: mcpToolAnnotations("get")
 		});
 		if (shouldInclude("create")) tools.push({
 			name: `${lowerName}_create`,
-			description: `Create a new ${displayName}`,
+			description: describeAction("create", displayName, labelField),
 			inputSchema: this.buildInputSchema(objectName, "create", fields),
 			outputSchema: this.buildOutputSchema(objectName, "create", fields),
 			annotations: mcpToolAnnotations("create")
 		});
 		if (shouldInclude("update")) tools.push({
 			name: `${lowerName}_update`,
-			description: `Update an existing ${displayName}`,
+			description: describeAction("update", displayName, labelField),
 			inputSchema: this.buildInputSchema(objectName, "update", fields),
 			outputSchema: this.buildOutputSchema(objectName, "update", fields),
 			annotations: mcpToolAnnotations("update")
 		});
 		if (shouldInclude("delete")) tools.push({
 			name: `${lowerName}_delete`,
-			description: `Delete a ${displayName} by ID`,
+			description: describeAction("delete", displayName, labelField),
 			inputSchema: this.buildInputSchema(objectName, "delete", fields),
 			outputSchema: this.buildOutputSchema(objectName, "delete", fields),
 			annotations: mcpToolAnnotations("delete")
@@ -375,6 +378,7 @@ var MCPGenerator = class {
 			minLength: field._meta?.minLength,
 			min: field._meta?.min,
 			max: field._meta?.max,
+			enum: readFieldEnum(field),
 			related: field.related
 		}));
 	}