@happyvertical/smrt-core 0.40.62 → 0.40.64

package/AGENTS.md

@@ -41,7 +41,7 @@ refreshes `last_used_at`. Keep semantic search behind the
 
 ```typescript
 await collection.list({
-  where: { status: 'active', price: { op: '>', value: 10 } },
+  where: { status: 'active', 'price >': 10 },
   limit: 50, offset: 0, orderBy: 'created_at DESC'
 });
 ```
@@ -59,15 +59,40 @@ an `initialize()` hook may query through the same transaction-bound PostgreSQL
 client. Keep this serialization invariant; use `select` when callers need plain
 rows without model hydration.
 
-**WHERE operators**: `=`, `>`, `<`, `>=`, `<=`, `!=`, `in`, `not in`, `like`, `is null`, `is not null`. Arrays auto-detect `IN`. Dot notation for JSON paths: `metadata.userId`.
+**WHERE operators**: `=`, `>`, `<`, `>=`, `<=`, `!=`, `in`, `not in`, `like`.
+Arrays auto-detect `IN`. NULL is a value, not an operator: `{ deletedAt: null }`
+renders `IS NULL` and `{ 'deletedAt !=': null }` renders `IS NOT NULL`.
+
+This list is the set `@happyvertical/sql`'s `buildWhere` can execute, and
+`convertWhereKeys` accepts nothing outside it — an operator accepted here but
+unknown there fails inside the query builder, after the API said the query was
+valid (#2276). Two entries were removed for that reason and now reject at the
+API boundary: `contains` (never existed in the SQL layer; use `like` with
+explicit wildcards) and dot-notation JSON paths such as `metadata.userId` (never
+rewritten into an extraction expression, so they reached SQL as qualified column
+references). Re-adding either requires the query builder to support it first;
+`src/__tests__/issue-2276-where-contract.test.ts` executes every accepted
+operator against a database to keep the two in step.
 
 STI child collections auto-filter by `_meta_type`.
 
+## Bounded Collection Read Plans
+
+Use `executeCollectionReadPlan()` when one operation needs several independent
+collections. It bounds top-level `collection.list()` concurrency while keeping
+all reads on the normal registry/collection path. Callers must choose an
+explicit positive `maxConcurrency` and pass their normal shared
+`collectionOptions` when database or tenant context matters.
+
+The executor deliberately does not compose SQL, cache the plan, or change pool
+defaults. On failure it stops starting queued entries, drains operations already
+in flight, and rethrows the first error.
+
 ## Object Memory & Semantic Search
 
 Two persistence primitives every `SmrtObject`/`SmrtCollection` inherits — load-bearing for learning agents, usable by any object. Full guide: `docs/content/core.md` → "Context Memory System".
 
-- **Context memory** (`remember`/`recall`/`recallAll`/`forget`/`forgetScope`, table `_smrt_contexts`): stores any JSON value keyed by `(owner_class, owner_id, scope, key, version)` with a `confidence` score (0–1) and a stored `expiresAt` (metadata — `recall()` does **not** filter expired rows; expiry is caller-managed). `recall()` returns the highest-confidence match with an optional `minConfidence` floor and **opt-in** hierarchical scope fallback (`includeAncestors: true` → `'a/b/c' → 'a/b' → 'a' → 'global'`; default off); `recallAll()` returns a `Map`. Typical use: cache a learned strategy (e.g. a working selector per host) and reuse it across sessions. `success_count`/`failure_count` columns exist for outcome-weighting but are not auto-updated by the framework.
+- **Context memory** (`remember`/`recall`/`recallAll`/`forget`/`forgetScope`, table `_smrt_contexts`): stores any JSON value keyed by `(owner_class, owner_id, scope, key, version)` with a `confidence` score (0–1) and a stored `expiresAt` (metadata — `recall()` does **not** filter expired rows; expiry is caller-managed). `recall()` returns the highest-confidence match with an optional `minConfidence` floor and **opt-in** hierarchical scope fallback (`includeAncestors: true` → `'a/b/c' → 'a/b' → 'a' → 'global'`; default off); `recallAll()` returns a `Map`. Typical use: cache a learned strategy (e.g. a working selector per host) and reuse it across sessions. `success_count`/`failure_count` columns exist for outcome-weighting: `SmrtObject.remember()` leaves them untouched, `SmrtCollection.remember()` resets them to zero, and neither recall path updates them. `LearningMemory` is the layer that maintains them (and that does filter expired rows).
 - **Semantic search** (on `SmrtCollection`, table `_smrt_embeddings`): `semanticSearch(query)`, `findSimilar(object)`, `findSimilarToEmbedding(vector)` — cosine ranking over embeddings of the fields declared in `@smrt({ embeddings })`. Native pgvector/HNSW when configured, in-memory `CosineSimilarity` fallback otherwise; default local model `Xenova/bge-base-en-v1.5` (768-dim) or AI `text-embedding-3-small`. Hits hydrate via `list({ 'id in': … })`, so `@TenantScoped` isolation applies to results.
 
 ## @smrt() Decorator Options
@@ -173,3 +198,4 @@ emitDecoratorMetadata: true`.
   must abort before adapting partial scan results. A syntax error or unresolved
   `@smrt()` config spread cannot be allowed to emit a default-open manifest.
 - **Vite plugin loads scanner from `dist/` first**: `src/vite-plugin/import-build-aware.ts` prefers `dist/` when it exists on disk; it only falls back to `src/` on fresh clones. So if you edit `src/scanner/*.ts` or `src/schema/generator.ts` and want those edits reflected in consumer manifest generation, you must rebuild (`pnpm build` or have `pnpm dev` / `pnpm build:watch` running in core). This is intentional — sniffing `.ts` vs `.js` via `import.meta.url` was non-deterministic under tsx and broke 12–13 publishes (#1139).
+- **Bundled registry ownership**: flattened production bundles can rewrite constructor names and make decorator-time stack inference attribute provider code to the consumer. Generated registration repairs identity only from the exact imported constructor plus an explicit package and isolated one-object manifest; never infer ownership from output paths, simple names, or table names. Distinct packages may export the same simple name under qualified keys. The production-consumer gate lives in `packages/bundle-gate/src/__tests__/registry-identity.spec.ts` (#2308).

package/README.md

@@ -67,6 +67,44 @@ const results = await products.list({
 
 ```
 
+### Bounded multi-collection reads
+
+When one request needs several independent collections, use a keyed read plan
+instead of an unbounded `Promise.all`. Every entry still uses the normal
+collection `list()` path, but only the requested number of operations run at
+once:
+
+```typescript
+import {
+  executeCollectionReadPlan,
+  type SmrtCollectionReadPlanEntry,
+} from '@happyvertical/smrt-core';
+
+const categories: SmrtCollectionReadPlanEntry<Category> = {
+  className: 'Category',
+  options: { orderBy: 'name ASC' },
+};
+const products: SmrtCollectionReadPlanEntry<Product> = {
+  className: 'Product',
+  options: { where: { isPublished: true }, orderBy: 'name ASC' },
+};
+const records = await executeCollectionReadPlan(
+  {
+    categories,
+    products,
+  },
+  {
+    collectionOptions: { db: 'file:products.db' },
+    maxConcurrency: 2,
+  },
+);
+```
+
+`maxConcurrency` is required and must be a positive integer. If an entry
+fails, the executor starts no further queued entries, waits for already-running
+entries to settle, and rethrows the first error. Read plans do not compose SQL,
+cache whole-plan results, or change database pool defaults.
+
 ### Generate metadata and migrate
 
 Configure Vite 8's Oxc decorator transform and point `smrtPlugin()` at the
@@ -119,7 +157,8 @@ src/routes/api/**/+server.ts
 !src/routes/api/v1/**/+server.ts
 ```
 
-Migration takes the recognized SMRT header plus the contiguous run of
+Migration takes the recognized `# SMRT auto-generated routes (from Vite plugin)`
+header — matched as a whole line — plus the contiguous run of
 recursive `+server.ts` wildcards directly beneath it, negations included. The
 run is matched by shape rather than against your current `routesDir`, so a
 project that moved `routesDir` after adopting the plugin still migrates, and
@@ -372,9 +411,12 @@ Generators produce OpenAPI REST endpoints, Commander CLI commands, and MCP serve
 
 Long-running item actions may opt into the experimental
 `io.modelcontextprotocol/tasks` extension. Tasks are disabled by default; list
-the action names explicitly and mark the action as background-eligible:
+the action names explicitly, and — if the class restricts what the job runner
+may dispatch — include the action in that allowlist:
 
 ```typescript
+import { backgroundEligible } from '@happyvertical/smrt-jobs';
+
 @smrt({
   mcp: { include: ['generateReport'], tasks: ['generateReport'] },
 })
@@ -384,6 +426,12 @@ class Report extends SmrtObject {
 }
 ```
 
+`@backgroundEligible()` is owned and enforced by `@happyvertical/smrt-jobs`, not
+by this package. It is **restrictive**: a class with no marked methods lets
+`TaskRunner` dispatch any of its methods, and the first marked method turns the
+set into an exhaustive allowlist that excludes every other method on the class.
+Use it to narrow the reachable surface, and mark every method you dispatch.
+
 The generated MCP server advertises the extension only when at least one task
 action is enabled. A task-aware client can request the action as a durable job,
 then use `tasks/get`, `tasks/update`, and `tasks/cancel` to observe or control

package/agents/generators.md

@@ -27,6 +27,28 @@ The web module also emits a build-time **`manifestHash`** constant (#1764): `com
 
 Per-field web emission (#2046): `buildWebFieldDefinitions` carries `description` (from `@field({ description })`) and sanitized `ui` hints (from `@field({ ui: { basic, group, order, locked } })`, read off the manifest `_meta.ui` bag through per-key type guards) into each emitted field definition, and `buildWebToolDescriptors` threads the same `description` into browser MCP tool schemas. `sensitive`/`transient` fields are excluded from emission entirely, so their descriptions never ship. Both keys are conditional, so hint-less schemas emit byte-identical definitions (and hashes) as before; adding a description/ui hint changes the manifest hash — deliberate over-invalidation, harmless per the #1764 contract.
 
+## Generated MCP server output language
+
+`MCPGenerator` builds every file as TypeScript, so the requested `outputPath`
+extension decides what is written (#2279). `.ts`/`.mts` targets keep the source
+verbatim for `tsx` or Node type stripping — which is why the generated source
+must stay erasable-syntax-only (no parameter properties, enums, or namespaces).
+Every other target (`.smrt/mcp-server/index.js` by default) is transpiled to
+JavaScript with the `typescript` dependency before writing, because the printed
+run script and the generated `claude-config.example.json` both invoke it with
+plain `node`. A `.cjs`/`.cts` target is rejected outright: generated servers are
+ES modules. `src/generators/mcp-emit.ts` owns those decisions — do not
+reintroduce a bare `writeFile` of generated source.
+
+Modular output writes `config`, `tools/index`, and `handlers/index` with the
+entry point's own extension, and emits the entry's relative import specifiers
+with that same extension, so the files it imports both exist and load with the
+same module semantics — an `.mjs` entry gets `.mjs` siblings, not `.js` ones a
+CommonJS package would then parse as CommonJS. The entry is written at the
+requested path rather than a hardcoded `index.js`.
+Generated code also has to be valid in an ES module: `arguments` is not a legal
+binding name there, however convenient it reads.
+
 ## Custom-action contract
 
 `resolveCustomActionMetadata()` is the common discovery and invocation contract

package/dist/__typechecks__/collection-read-plan.d.ts

@@ -0,0 +1,50 @@
+import { SmrtCollectionReadPlan, SmrtCollectionReadPlanEntry, SmrtCollectionReadPlanResult } from '../collection-read-plan';
+import { SmrtObject } from '../object';
+type Equal<Left, Right> = (<Value>() => Value extends Left ? 1 : 2) extends <Value>() => Value extends Right ? 1 : 2 ? true : false;
+type Expect<Value extends true> = Value;
+type ReadPlanTypeProbe = SmrtObject & {
+    name: string;
+};
+declare const plain: SmrtCollectionReadPlanEntry<ReadPlanTypeProbe>;
+declare const projected: SmrtCollectionReadPlanEntry<ReadPlanTypeProbe, {
+    select: readonly ['id', 'name'];
+}>;
+type Result = SmrtCollectionReadPlanResult<{
+    plain: typeof plain;
+    projected: typeof projected;
+}>;
+type PlainResultIsTyped = Expect<Equal<Result['plain'], ReadPlanTypeProbe[]>>;
+type ProjectedResultIsTyped = Expect<Equal<Result['projected'], {
+    id: string | null | undefined;
+    name: string;
+}[]>>;
+type InvalidOptionsAreRejected = Expect<Equal<{
+    limit: string;
+} extends NonNullable<SmrtCollectionReadPlan[string]['options']> ? true : false, false>>;
+type ProjectionIncludeIsRejected = Expect<Equal<{
+    select: readonly ['id'];
+    include: string[];
+} extends NonNullable<SmrtCollectionReadPlan[string]['options']> ? true : false, false>>;
+type MixedOptions = {
+    limit: number;
+    select?: undefined;
+} | {
+    select: readonly ['id'];
+    include?: never;
+};
+type MixedEntry = SmrtCollectionReadPlanEntry<ReadPlanTypeProbe, MixedOptions>;
+type MixedResult = SmrtCollectionReadPlanResult<{
+    mixed: MixedEntry;
+}>;
+type MixedResultIsSound = Expect<Equal<MixedResult['mixed'], ReadPlanTypeProbe[] | {
+    id: string | null | undefined;
+}[]>>;
+export type CollectionReadPlanTypeAssertions = [
+    PlainResultIsTyped,
+    ProjectedResultIsTyped,
+    InvalidOptionsAreRejected,
+    ProjectionIncludeIsRejected,
+    MixedResultIsSound
+];
+export {};
+//# sourceMappingURL=collection-read-plan.d.ts.map

package/dist/__typechecks__/collection-read-plan.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"collection-read-plan.d.ts","sourceRoot":"","sources":["../../src/__typechecks__/collection-read-plan.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,sBAAsB,EAC3B,KAAK,2BAA2B,EAChC,KAAK,4BAA4B,EAClC,MAAM,yBAAyB,CAAC;AACjC,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAE5C,KAAK,KAAK,CAAC,IAAI,EAAE,KAAK,IACpB,CAAC,CAAC,KAAK,OAAO,KAAK,SAAS,IAAI,GAAG,CAAC,GAAG,CAAC,CAAC,SAAS,CAChD,KAAK,OACA,KAAK,SAAS,KAAK,GAAG,CAAC,GAAG,CAAC,GAC9B,IAAI,GACJ,KAAK,CAAC;AACZ,KAAK,MAAM,CAAC,KAAK,SAAS,IAAI,IAAI,KAAK,CAAC;AAExC,KAAK,iBAAiB,GAAG,UAAU,GAAG;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC;AAEvD,QAAA,MAAM,KAAK,EAAE,2BAA2B,CAAC,iBAAiB,CAEzD,CAAC;AACF,QAAA,MAAM,SAAS,EAAE,2BAA2B,CAC1C,iBAAiB,EACjB;IAAE,MAAM,EAAE,SAAS,CAAC,IAAI,EAAE,MAAM,CAAC,CAAA;CAAE,CAIpC,CAAC;AAEF,KAAK,MAAM,GAAG,4BAA4B,CAAC;IACzC,KAAK,EAAE,OAAO,KAAK,CAAC;IACpB,SAAS,EAAE,OAAO,SAAS,CAAC;CAC7B,CAAC,CAAC;AACH,KAAK,kBAAkB,GAAG,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,OAAO,CAAC,EAAE,iBAAiB,EAAE,CAAC,CAAC,CAAC;AAC9E,KAAK,sBAAsB,GAAG,MAAM,CAClC,KAAK,CAAC,MAAM,CAAC,WAAW,CAAC,EAAE;IAAE,EAAE,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,EAAE,CAAC,CAC9E,CAAC;AACF,KAAK,yBAAyB,GAAG,MAAM,CACrC,KAAK,CACH;IAAE,KAAK,EAAE,MAAM,CAAA;CAAE,SAAS,WAAW,CACnC,sBAAsB,CAAC,MAAM,CAAC,CAAC,SAAS,CAAC,CAC1C,GACG,IAAI,GACJ,KAAK,EACT,KAAK,CACN,CACF,CAAC;AACF,KAAK,2BAA2B,GAAG,MAAM,CACvC,KAAK,CACH;IACE,MAAM,EAAE,SAAS,CAAC,IAAI,CAAC,CAAC;IACxB,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB,SAAS,WAAW,CAAC,sBAAsB,CAAC,MAAM,CAAC,CAAC,SAAS,CAAC,CAAC,GAC5D,IAAI,GACJ,KAAK,EACT,KAAK,CACN,CACF,CAAC;AAEF,KAAK,YAAY,GACb;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,SAAS,CAAA;CAAE,GACrC;IAAE,MAAM,EAAE,SAAS,CAAC,IAAI,CAAC,CAAC;IAAC,OAAO,CAAC,EAAE,KAAK,CAAA;CAAE,CAAC;AACjD,KAAK,UAAU,GAAG,2BAA2B,CAAC,iBAAiB,EAAE,YAAY,CAAC,CAAC;AAK/E,KAAK,WAAW,GAAG,4BAA4B,CAAC;IAAE,KAAK,EAAE,UAAU,CAAA;CAAE,CAAC,CAAC;AACvE,KAAK,kBAAkB,GAAG,MAAM,CAC9B,KAAK,CACH,WAAW,CAAC,OAAO,CAAC,EACpB,iBAAiB,EAAE,GAAG;IAAE,EAAE,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,CAAA;CAAE,EAAE,CAC1D,CACF,CAAC;AAiCF,MAAM,MAAM,gCAAgC,GAAG;IAC7C,kBAAkB;IAClB,sBAAsB;IACtB,yBAAyB;IACzB,2BAA2B;IAC3B,kBAAkB;CACnB,CAAC"}

package/dist/collection-read-plan.d.ts

@@ -0,0 +1,77 @@
+import { SmrtClassOptions } from './class';
+import { SmrtListOptions, SmrtSelectedRow, SmrtSelectField } from './collection';
+import { SmrtObject } from './object';
+type DynamicSmrtObject = SmrtObject & Record<string, unknown>;
+type SmrtHydratedCollectionReadOptions<ModelType extends SmrtObject> = Omit<SmrtListOptions<ModelType>, 'select'> & {
+    select?: undefined;
+};
+type SmrtProjectedCollectionReadOptions<ModelType extends SmrtObject> = Omit<SmrtListOptions<ModelType>, 'select' | 'include'> & {
+    select: readonly SmrtSelectField<ModelType>[];
+    include?: never;
+};
+type SmrtCollectionReadOptions<ModelType extends SmrtObject> = SmrtHydratedCollectionReadOptions<ModelType> | SmrtProjectedCollectionReadOptions<ModelType>;
+type DynamicSmrtListOptions = SmrtCollectionReadOptions<DynamicSmrtObject>;
+declare const smrtCollectionReadPlanModel: unique symbol;
+type SmrtCollectionReadPlanEntryOptions<ModelType extends SmrtObject, ListOptions extends SmrtCollectionReadOptions<ModelType> | undefined> = ListOptions extends SmrtProjectedCollectionReadOptions<ModelType> ? {
+    /** Projection options forwarded unchanged to `SmrtCollection.list()`. */
+    options: ListOptions;
+} : {
+    /** Standard hydrated-list options forwarded unchanged to `SmrtCollection.list()`. */
+    options?: ListOptions;
+};
+/**
+ * One independent collection read in a bounded read plan.
+ *
+ * `ModelType` is optional for dynamic registries. Consumers that know the
+ * model type can annotate an entry to retain model/projection result typing.
+ */
+export type SmrtCollectionReadPlanEntry<ModelType extends SmrtObject = SmrtObject, ListOptions extends SmrtCollectionReadOptions<ModelType> | undefined = SmrtHydratedCollectionReadOptions<ModelType>> = {
+    /** Registered SMRT object or collection name. */
+    className: string;
+    /** @internal Retains the model type for keyed result inference. */
+    readonly [smrtCollectionReadPlanModel]?: ModelType;
+} & SmrtCollectionReadPlanEntryOptions<ModelType, ListOptions>;
+/** A keyed group of independent collection reads. */
+export type SmrtCollectionReadPlan = Record<string, {
+    className: string;
+    options?: DynamicSmrtListOptions;
+}>;
+type SmrtCollectionReadPlanEntryModel<Entry> = Entry extends {
+    readonly [smrtCollectionReadPlanModel]?: infer ModelType;
+} ? ModelType extends SmrtObject ? ModelType : SmrtObject : SmrtObject;
+type SmrtCollectionReadPlanEntryResult<Entry> = Entry extends {
+    options: {
+        select: infer Select;
+    };
+} ? Select extends readonly SmrtSelectField<SmrtCollectionReadPlanEntryModel<Entry>>[] ? SmrtSelectedRow<SmrtCollectionReadPlanEntryModel<Entry>, Select>[] : never : SmrtCollectionReadPlanEntryModel<Entry>[];
+/** Results retain the exact keys declared by the input plan. */
+export type SmrtCollectionReadPlanResult<Plan extends SmrtCollectionReadPlan> = {
+    [Key in keyof Plan]: SmrtCollectionReadPlanEntryResult<Plan[Key]>;
+};
+export interface ExecuteCollectionReadPlanOptions {
+    /**
+     * Maximum number of top-level `collection.list()` operations in flight.
+     * Must be a positive integer and is intentionally required so callers make
+     * workload policy explicit.
+     */
+    maxConcurrency: number;
+    /** Normal options used to resolve every collection in the plan. */
+    collectionOptions?: SmrtClassOptions;
+}
+/**
+ * Execute independent collection reads without unbounded database fan-out.
+ *
+ * Each entry resolves through `ObjectRegistry.getCollection()` and calls the
+ * collection's public `list()` method, preserving interceptors, tenancy, STI,
+ * hydration, eager loading, projections, and opt-in collection caching.
+ *
+ * On failure, no additional queued entry is started. Operations that were
+ * already in flight are allowed to settle before the first error is rethrown,
+ * so the function never leaves detached database work behind.
+ *
+ * This function does not compose SQL, cache the plan, or change database pool
+ * defaults. It only bounds top-level list-operation concurrency.
+ */
+export declare function executeCollectionReadPlan<const Plan extends SmrtCollectionReadPlan>(plan: Plan, options: ExecuteCollectionReadPlanOptions): Promise<SmrtCollectionReadPlanResult<Plan>>;
+export {};
+//# sourceMappingURL=collection-read-plan.d.ts.map

package/dist/collection-read-plan.d.ts.map

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

package/dist/collection-read-plan.js

@@ -0,0 +1,55 @@
+import { ObjectRegistry } from "./registry.js";
+//#region src/collection-read-plan.ts
+async function listCollection(collection, options) {
+	if (options?.select !== void 0) return await collection.list(options);
+	return await collection.list(options);
+}
+/**
+* Execute independent collection reads without unbounded database fan-out.
+*
+* Each entry resolves through `ObjectRegistry.getCollection()` and calls the
+* collection's public `list()` method, preserving interceptors, tenancy, STI,
+* hydration, eager loading, projections, and opt-in collection caching.
+*
+* On failure, no additional queued entry is started. Operations that were
+* already in flight are allowed to settle before the first error is rethrown,
+* so the function never leaves detached database work behind.
+*
+* This function does not compose SQL, cache the plan, or change database pool
+* defaults. It only bounds top-level list-operation concurrency.
+*/
+async function executeCollectionReadPlan(plan, options) {
+	if (!Number.isInteger(options.maxConcurrency) || options.maxConcurrency <= 0) throw new RangeError("maxConcurrency must be a positive integer");
+	const entries = Object.entries(plan);
+	if (entries.length === 0) return Object.fromEntries([]);
+	let nextIndex = 0;
+	let failed = false;
+	let firstError;
+	const values = new Array(entries.length);
+	const runWorker = async () => {
+		while (!failed) {
+			const entryIndex = nextIndex;
+			nextIndex += 1;
+			if (entryIndex >= entries.length) return;
+			const [, entry] = entries[entryIndex];
+			try {
+				const value = await listCollection(await ObjectRegistry.getCollection(entry.className, options.collectionOptions), entry.options);
+				values[entryIndex] = value;
+			} catch (error) {
+				if (!failed) {
+					failed = true;
+					firstError = error;
+				}
+				return;
+			}
+		}
+	};
+	const workerCount = Math.min(options.maxConcurrency, entries.length);
+	await Promise.all(Array.from({ length: workerCount }, runWorker));
+	if (failed) throw firstError;
+	return Object.fromEntries(entries.map(([key], index) => [key, values[index]]));
+}
+//#endregion
+export { executeCollectionReadPlan };
+
+//# sourceMappingURL=collection-read-plan.js.map

package/dist/collection-read-plan.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"collection-read-plan.js","names":[],"sources":["../src/collection-read-plan.ts"],"sourcesContent":["import type { SmrtClassOptions } from './class';\nimport type {\n  SmrtCollection,\n  SmrtListOptions,\n  SmrtSelectedRow,\n  SmrtSelectField,\n} from './collection';\nimport type { SmrtObject } from './object';\nimport { ObjectRegistry } from './registry';\n\ntype DynamicSmrtObject = SmrtObject & Record<string, unknown>;\ntype SmrtHydratedCollectionReadOptions<ModelType extends SmrtObject> = Omit<\n  SmrtListOptions<ModelType>,\n  'select'\n> & {\n  select?: undefined;\n};\ntype SmrtProjectedCollectionReadOptions<ModelType extends SmrtObject> = Omit<\n  SmrtListOptions<ModelType>,\n  'select' | 'include'\n> & {\n  select: readonly SmrtSelectField<ModelType>[];\n  include?: never;\n};\ntype SmrtCollectionReadOptions<ModelType extends SmrtObject> =\n  | SmrtHydratedCollectionReadOptions<ModelType>\n  | SmrtProjectedCollectionReadOptions<ModelType>;\ntype DynamicSmrtListOptions = SmrtCollectionReadOptions<DynamicSmrtObject>;\ndeclare const smrtCollectionReadPlanModel: unique symbol;\n\ntype SmrtCollectionReadPlanEntryOptions<\n  ModelType extends SmrtObject,\n  ListOptions extends SmrtCollectionReadOptions<ModelType> | undefined,\n> =\n  ListOptions extends SmrtProjectedCollectionReadOptions<ModelType>\n    ? {\n        /** Projection options forwarded unchanged to `SmrtCollection.list()`. */\n        options: ListOptions;\n      }\n    : {\n        /** Standard hydrated-list options forwarded unchanged to `SmrtCollection.list()`. */\n        options?: ListOptions;\n      };\n\n/**\n * One independent collection read in a bounded read plan.\n *\n * `ModelType` is optional for dynamic registries. Consumers that know the\n * model type can annotate an entry to retain model/projection result typing.\n */\nexport type SmrtCollectionReadPlanEntry<\n  ModelType extends SmrtObject = SmrtObject,\n  ListOptions extends\n    | SmrtCollectionReadOptions<ModelType>\n    | undefined = SmrtHydratedCollectionReadOptions<ModelType>,\n> = {\n  /** Registered SMRT object or collection name. */\n  className: string;\n  /** @internal Retains the model type for keyed result inference. */\n  readonly [smrtCollectionReadPlanModel]?: ModelType;\n} & SmrtCollectionReadPlanEntryOptions<ModelType, ListOptions>;\n\n/** A keyed group of independent collection reads. */\nexport type SmrtCollectionReadPlan = Record<\n  string,\n  {\n    className: string;\n    options?: DynamicSmrtListOptions;\n  }\n>;\n\ntype SmrtCollectionReadPlanEntryModel<Entry> = Entry extends {\n  readonly [smrtCollectionReadPlanModel]?: infer ModelType;\n}\n  ? ModelType extends SmrtObject\n    ? ModelType\n    : SmrtObject\n  : SmrtObject;\n\ntype SmrtCollectionReadPlanEntryResult<Entry> = Entry extends {\n  options: { select: infer Select };\n}\n  ? Select extends readonly SmrtSelectField<\n      SmrtCollectionReadPlanEntryModel<Entry>\n    >[]\n    ? SmrtSelectedRow<SmrtCollectionReadPlanEntryModel<Entry>, Select>[]\n    : never\n  : SmrtCollectionReadPlanEntryModel<Entry>[];\n\n/** Results retain the exact keys declared by the input plan. */\nexport type SmrtCollectionReadPlanResult<Plan extends SmrtCollectionReadPlan> =\n  {\n    [Key in keyof Plan]: SmrtCollectionReadPlanEntryResult<Plan[Key]>;\n  };\n\nexport interface ExecuteCollectionReadPlanOptions {\n  /**\n   * Maximum number of top-level `collection.list()` operations in flight.\n   * Must be a positive integer and is intentionally required so callers make\n   * workload policy explicit.\n   */\n  maxConcurrency: number;\n  /** Normal options used to resolve every collection in the plan. */\n  collectionOptions?: SmrtClassOptions;\n}\n\nasync function listCollection(\n  collection: SmrtCollection<DynamicSmrtObject>,\n  options: DynamicSmrtListOptions | undefined,\n): Promise<unknown[]> {\n  if (options?.select !== undefined) {\n    return await collection.list(\n      options as DynamicSmrtListOptions & {\n        select: readonly SmrtSelectField<DynamicSmrtObject>[];\n        include?: never;\n      },\n    );\n  }\n\n  return await collection.list(\n    options as\n      | (Omit<DynamicSmrtListOptions, 'select'> & {\n          select?: undefined;\n        })\n      | undefined,\n  );\n}\n\n/**\n * Execute independent collection reads without unbounded database fan-out.\n *\n * Each entry resolves through `ObjectRegistry.getCollection()` and calls the\n * collection's public `list()` method, preserving interceptors, tenancy, STI,\n * hydration, eager loading, projections, and opt-in collection caching.\n *\n * On failure, no additional queued entry is started. Operations that were\n * already in flight are allowed to settle before the first error is rethrown,\n * so the function never leaves detached database work behind.\n *\n * This function does not compose SQL, cache the plan, or change database pool\n * defaults. It only bounds top-level list-operation concurrency.\n */\nexport async function executeCollectionReadPlan<\n  const Plan extends SmrtCollectionReadPlan,\n>(\n  plan: Plan,\n  options: ExecuteCollectionReadPlanOptions,\n): Promise<SmrtCollectionReadPlanResult<Plan>> {\n  if (\n    !Number.isInteger(options.maxConcurrency) ||\n    options.maxConcurrency <= 0\n  ) {\n    throw new RangeError('maxConcurrency must be a positive integer');\n  }\n\n  const entries = Object.entries(plan) as [keyof Plan, Plan[keyof Plan]][];\n\n  if (entries.length === 0) {\n    return Object.fromEntries(\n      [],\n    ) as unknown as SmrtCollectionReadPlanResult<Plan>;\n  }\n\n  let nextIndex = 0;\n  let failed = false;\n  let firstError: unknown;\n  const values: unknown[][] = new Array(entries.length);\n\n  const runWorker = async (): Promise<void> => {\n    while (!failed) {\n      const entryIndex = nextIndex;\n      nextIndex += 1;\n      if (entryIndex >= entries.length) return;\n\n      const [, entry] = entries[entryIndex];\n\n      try {\n        const collection =\n          await ObjectRegistry.getCollection<DynamicSmrtObject>(\n            entry.className,\n            options.collectionOptions,\n          );\n        const value = await listCollection(collection, entry.options);\n        values[entryIndex] = value;\n      } catch (error) {\n        if (!failed) {\n          failed = true;\n          firstError = error;\n        }\n        return;\n      }\n    }\n  };\n\n  const workerCount = Math.min(options.maxConcurrency, entries.length);\n  await Promise.all(Array.from({ length: workerCount }, runWorker));\n\n  if (failed) throw firstError;\n  return Object.fromEntries(\n    entries.map(([key], index) => [key, values[index]]),\n  ) as unknown as SmrtCollectionReadPlanResult<Plan>;\n}\n"],"mappings":";;AA0GA,eAAe,eACb,YACA,SACoB;CACpB,IAAI,SAAS,WAAW,KAAA,GACtB,OAAO,MAAM,WAAW,KACtB,OAIF;CAGF,OAAO,MAAM,WAAW,KACtB,OAKF;AACF;;;;;;;;;;;;;;;AAgBA,eAAsB,0BAGpB,MACA,SAC6C;CAC7C,IACE,CAAC,OAAO,UAAU,QAAQ,cAAc,KACxC,QAAQ,kBAAkB,GAE1B,MAAM,IAAI,WAAW,2CAA2C;CAGlE,MAAM,UAAU,OAAO,QAAQ,IAAI;CAEnC,IAAI,QAAQ,WAAW,GACrB,OAAO,OAAO,YACZ,CAAC,CACH;CAGF,IAAI,YAAY;CAChB,IAAI,SAAS;CACb,IAAI;CACJ,MAAM,SAAsB,IAAI,MAAM,QAAQ,MAAM;CAEpD,MAAM,YAAY,YAA2B;EAC3C,OAAO,CAAC,QAAQ;GACd,MAAM,aAAa;GACnB,aAAa;GACb,IAAI,cAAc,QAAQ,QAAQ;GAElC,MAAM,GAAG,SAAS,QAAQ;GAE1B,IAAI;IAMF,MAAM,QAAQ,MAAM,eAAe,MAJ3B,eAAe,cACnB,MAAM,WACN,QAAQ,iBACV,GAC6C,MAAM,OAAO;IAC5D,OAAO,cAAc;GACvB,SAAS,OAAO;IACd,IAAI,CAAC,QAAQ;KACX,SAAS;KACT,aAAa;IACf;IACA;GACF;EACF;CACF;CAEA,MAAM,cAAc,KAAK,IAAI,QAAQ,gBAAgB,QAAQ,MAAM;CACnE,MAAM,QAAQ,IAAI,MAAM,KAAK,EAAE,QAAQ,YAAY,GAAG,SAAS,CAAC;CAEhE,IAAI,QAAQ,MAAM;CAClB,OAAO,OAAO,YACZ,QAAQ,KAAK,CAAC,MAAM,UAAU,CAAC,KAAK,OAAO,MAAM,CAAC,CACpD;AACF"}

package/dist/collection.d.ts

@@ -753,6 +753,10 @@ export declare class SmrtCollection<ModelType extends SmrtObject> extends SmrtCl
      * Stores context applicable to all instances of this collection type.
      * Use for patterns that apply to the entire collection (e.g., default parsing strategies).
      *
+     * `expiresAt` is stored on the `_smrt_contexts` row as caller-managed metadata.
+     * {@link recall} and {@link recallAll} do **not** filter on it, so an expired
+     * entry is still returned; filter or delete expired entries yourself.
+     *
      * @param options - Context options
      * @returns Promise that resolves when context is stored
      * @example
@@ -877,7 +881,9 @@ export declare class SmrtCollection<ModelType extends SmrtObject> extends SmrtCl
      *
      * @param query - Text to search for
      * @param options - Search options
-     * @param options.field - Specific field to search (defaults to first embedding field)
+     * @param options.field - Specific field to search (defaults to first embedding
+     *   field). Any configured embedding field, or the configured
+     *   `combinedField.name`, is accepted.
      * @param options.limit - Maximum results to return (default: 10)
      * @param options.minSimilarity - Minimum similarity threshold 0-1 (default: 0)
      * @param options.where - Additional WHERE filters to apply
@@ -893,6 +899,11 @@ export declare class SmrtCollection<ModelType extends SmrtObject> extends SmrtCl
      * for (const article of results) {
      *   console.log(`${article.title} (similarity: ${article._similarity})`);
      * }
+     *
+     * // Search the combined vector built from `combinedField.template`
+     * const combined = await articles.semanticSearch('machine learning trends', {
+     *   field: 'content'
+     * });
      * ```
      */
     semanticSearch(query: string, options?: {

package/dist/collection.d.ts.map

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

package/dist/collection.js

@@ -33,6 +33,22 @@ function resolveMetaTypeInWhere(where) {
 	return where;
 }
 /**
+* Field names that carry a stored embedding vector for a class (Issue #2281)
+*
+* `SmrtObject.generateEmbeddings()` writes one vector per configured field and,
+* when `combinedField` is set, an extra vector under `combinedField.name`. Any
+* of those names is a legitimate target for the collection's semantic-search
+* methods, so validation and error messages should describe the whole set.
+*
+* @param config - Resolved embedding configuration for the class
+* @returns Configured field names, plus the combined field name when distinct
+*/
+function getSearchableEmbeddingFields(config) {
+	const combinedName = config.combinedField?.name;
+	if (!combinedName || config.fields.includes(combinedName)) return config.fields;
+	return [...config.fields, combinedName];
+}
+/**
 * Typed CRUD collection for a specific `SmrtObject` subclass.
 *
 * Each concrete collection pairs with exactly one model class via the required
@@ -111,9 +127,9 @@ var SmrtCollection = class SmrtCollection extends SmrtClass {
 			"!=",
 			"in",
 			"not in",
-			"like",
-			"contains"
+			"like"
 		];
+		const UNSUPPORTED_OPERATOR_HINTS = /* @__PURE__ */ new Map([["contains", "Use 'like' with explicit wildcards instead, e.g. { 'name like': '%term%' }."]]);
 		const fields = this.getFieldsSync();
 		const validFieldNames = new Set(Object.keys(fields).map((f) => toSnakeCase(f)));
 		const sensitiveFieldNames = this.collectSensitiveFieldNames(fields);
@@ -156,8 +172,12 @@ var SmrtCollection = class SmrtCollection extends SmrtClass {
 			const metaPathTargetsSensitive = (snakeBaseFieldName === "_meta_data" || snakeBaseFieldName === "meta_data") && !!jsonPath && jsonPath.split(".").filter(Boolean).some((segment) => sensitiveFieldNames.has(segment) || sensitiveFieldNames.has(toSnakeCase(segment)));
 			if (sensitiveFieldNames.has(snakeBaseFieldName) || metaPathTargetsSensitive) throw new Error(`Invalid WHERE clause field: '${fieldName}'. Filtering on sensitive fields is not allowed.`);
 			const effectiveOperator = operator === "=" && Array.isArray(value) ? "in" : operator;
-			if (!VALID_OPERATORS.includes(effectiveOperator)) throw new Error(`Invalid WHERE clause operator: '${operator}'. Valid operators: ${VALID_OPERATORS.join(", ")}`);
+			if (!VALID_OPERATORS.includes(effectiveOperator)) {
+				const hint = UNSUPPORTED_OPERATOR_HINTS.get(effectiveOperator);
+				throw new Error(`Invalid WHERE clause operator: '${operator}'. Valid operators: ${VALID_OPERATORS.join(", ")}` + (hint ? `. ${hint}` : ""));
+			}
 			if (!skipFieldValidation && !validFieldNames.has(snakeBaseFieldName)) throw new Error(`Invalid WHERE clause field: '${fieldName}'. Field does not exist on ${itemClassName}. Valid fields: ${Array.from(validFieldNames).sort().join(", ")}`);
+			if (jsonPath) throw new Error(`Invalid WHERE clause field: '${fieldName}'. Dot-notation JSON paths are not supported — the path is not rewritten into a JSON extraction expression, so it would reach SQL as a qualified column reference and fail at execution. Filter on the '${baseFieldName}' column itself, or filter the extracted values in application code.`);
 			if ((effectiveOperator === "in" || effectiveOperator === "not in") && !Array.isArray(value)) throw new Error(`WHERE clause operator '${effectiveOperator}' requires an array value for field '${fieldName}', got ${typeof value}`);
 			if ((effectiveOperator === "in" || effectiveOperator === "not in") && Array.isArray(value) && value.length === 0) throw new Error(`WHERE clause operator '${effectiveOperator}' requires a non-empty array for field '${fieldName}'. Use listByIds([]) for graceful empty array handling.`);
 			if (effectiveOperator === "like" && typeof value !== "string") throw new Error(`WHERE clause operator 'like' requires a string value for field '${fieldName}', got ${typeof value}`);
@@ -1274,6 +1294,10 @@ var SmrtCollection = class SmrtCollection extends SmrtClass {
 	* Stores context applicable to all instances of this collection type.
 	* Use for patterns that apply to the entire collection (e.g., default parsing strategies).
 	*
+	* `expiresAt` is stored on the `_smrt_contexts` row as caller-managed metadata.
+	* {@link recall} and {@link recallAll} do **not** filter on it, so an expired
+	* entry is still returned; filter or delete expired entries yourself.
+	*
 	* @param options - Context options
 	* @returns Promise that resolves when context is stored
 	* @example
@@ -1502,7 +1526,9 @@ var SmrtCollection = class SmrtCollection extends SmrtClass {
 	*
 	* @param query - Text to search for
 	* @param options - Search options
-	* @param options.field - Specific field to search (defaults to first embedding field)
+	* @param options.field - Specific field to search (defaults to first embedding
+	*   field). Any configured embedding field, or the configured
+	*   `combinedField.name`, is accepted.
 	* @param options.limit - Maximum results to return (default: 10)
 	* @param options.minSimilarity - Minimum similarity threshold 0-1 (default: 0)
 	* @param options.where - Additional WHERE filters to apply
@@ -1518,6 +1544,11 @@ var SmrtCollection = class SmrtCollection extends SmrtClass {
 	* for (const article of results) {
 	*   console.log(`${article.title} (similarity: ${article._similarity})`);
 	* }
+	*
+	* // Search the combined vector built from `combinedField.template`
+	* const combined = await articles.semanticSearch('machine learning trends', {
+	*   field: 'content'
+	* });
 	* ```
 	*/
 	async semanticSearch(query, options = {}) {
@@ -1525,7 +1556,8 @@ var SmrtCollection = class SmrtCollection extends SmrtClass {
 		const embeddingConfig = ObjectRegistry.resolveEmbeddingConfig(this._itemClass.name);
 		if (!embeddingConfig) throw new Error(`No embedding configuration found for ${this._itemClass.name}. Add embeddings config to @smrt() decorator.`);
 		const searchField = field || embeddingConfig.fields[0];
-		if (!embeddingConfig.fields.includes(searchField)) throw new Error(`Field '${searchField}' is not configured for embeddings on ${this._itemClass.name}. Available fields: ${embeddingConfig.fields.join(", ")}`);
+		const searchableFields = getSearchableEmbeddingFields(embeddingConfig);
+		if (!searchableFields.includes(searchField)) throw new Error(`Field '${searchField}' is not configured for embeddings on ${this._itemClass.name}. Available fields: ${searchableFields.join(", ")}`);
 		const [queryEmbedding] = await new EmbeddingProvider({
 			dimensions: embeddingConfig.dimensions,
 			provider: embeddingConfig.provider,