@happyvertical/smrt-core 0.57.36 → 0.57.37

package/agents/build-knowledge.md

@@ -382,3 +382,7 @@ and decorators), minus a leading `ClassName - ` / `ClassName: `, tags
 sentence boundary. `@internal` classes and classes without docs emit no key. It
 is not inherited from a parent class. Generated MCP tool descriptions are
 unchanged (they stay generic).
+
+## AGENTS.md discovery in a monorepo (#3476)
+
+`buildDomainKnowledgeManifest()` takes the agent doc from the project root, else from the nearest ancestor `AGENTS.md` up to the workspace root (the nearest directory with `pnpm-workspace.yaml`, else the git root, a directory containing `.git`). It never walks past that boundary, and with no boundary above the project root it checks only the root. `agentDocPath` stays relative to the project root (so an inherited doc reads `../../AGENTS.md`), and `agentDoc` and `sourceHashes.agents` are populated from it. Module docs linked from the doc (`moduleDocs`) are only followed when `AGENTS.md` sits at the project root, since their links resolve against that directory.

package/agents/data-query.md

@@ -37,6 +37,29 @@ silently match every row. `valuesEnforced: false` (valid only with `values`) mar
 skips that check; the normalized schema keeps only the `false` form. Range and
 `like` operators, result rows, and facets are never checked against the set.
 
+## Null tests (#4448)
+
+`isNull` and `isNotNull` are `condition` operators with no `value`:
+`{"kind":"condition","field":"endedAt","operator":"isNull"}`. A field offers
+them only when its `filterOperators` declares them, which adapters do only for
+storage that can hold null; `data.inspect` shows them with the other
+operators. The canonical form has no `value` key; an explicit `"value": null`
+is accepted and dropped, so both spellings share one fingerprint, and any
+other value fails with the valueless shape in the message. They never touch
+allowed values (#4381). The types split `DataQueryCondition` into
+`DataQueryValueCondition` (`DataQueryValueOperator`) and
+`DataQueryNullCondition` (`DataQueryNullOperator`, `value?: never`).
+
+Existing requests keep their meaning and canonical form. `eq null` / `ne null`
+were already accepted wherever `eq`/`ne` are declared and still lower to
+`IS NULL` / `IS NOT NULL`; `isNull` is a distinct canonical form with its own
+fingerprint, not a rewrite of `eq null`. Null semantics of value operators are
+the adapter's (SQL three-valued logic): the SMRT collection and content
+adapters treat `ne x`/`notIn` as null-inclusive (`IS NULL OR <> x`), and the
+report adapter's `ne x`/`notIn` is a plain `<>` that excludes nulls. Negation
+maps `isNull` and `isNotNull` onto each other, an exact complement in every
+adapter.
+
 Only normalized `DataQueryResult` envelopes cross REST, MCP, WebMCP, and browser
 boundaries. Adapter-specific report/content context wraps the base envelope; it
 does not add unsafe fields or SQL-like controls.

package/agents/recipes.md

@@ -305,6 +305,12 @@ and only the keys below. Field names are checked in core
 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.
+A package-local test that runs `applyGenerationPasses` on a single package's
+manifest must first set `manifest.smrtDependencies` to the packages whose
+models it inherits from (`['@happyvertical/smrt-core']` for `SmrtHierarchical`'s
+`parentId`, plus `@happyvertical/smrt-content` for a `Content` subclass), or
+every inherited field name in `options` is rejected; the real build reads them
+from the dependency tree (`packages/places/src/__tests__/recipes.test.ts`).
 
 ## options: curation hints, never a second schema
 

package/dist/cookbook/engine/schemas.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"schemas.d.ts","sourceRoot":"","sources":["../../../src/cookbook/engine/schemas.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,WAAW,EACX,WAAW,EACX,aAAa,EACb,UAAU,EACX,MAAM,YAAY,CAAC;AA8BpB;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,aAAa,GAAG,WAAW,EAAE,CAoRvE;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,aAAa,GAAG;IACtD,IAAI,EAAE,WAAW,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,UAAU,CAAC;CACzB,CA+BA;AAgBD;;;;GAIG;AACH,wBAAgB,WAAW,CACzB,MAAM,EAAE,UAAU,EAClB,KAAK,EAAE,OAAO,EACd,IAAI,SAAU,GACb;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAiG1C;AAED,MAAM,MAAM,cAAc,GAAG,QAAQ,CAAC,MAAM,CAAC,WAAW,EAAE,UAAU,CAAC,CAAC,CAAC;AAEvE,yCAAyC;AACzC,wBAAgB,cAAc,CAAC,OAAO,EAAE,aAAa,GAAG,cAAc,CAIrE"}
+{"version":3,"file":"schemas.d.ts","sourceRoot":"","sources":["../../../src/cookbook/engine/schemas.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,WAAW,EACX,WAAW,EACX,aAAa,EACb,UAAU,EACX,MAAM,YAAY,CAAC;AA+BpB;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,aAAa,GAAG,WAAW,EAAE,CAoRvE;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,aAAa,GAAG;IACtD,IAAI,EAAE,WAAW,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,UAAU,CAAC;CACzB,CA+BA;AAgBD;;;;GAIG;AACH,wBAAgB,WAAW,CACzB,MAAM,EAAE,UAAU,EAClB,KAAK,EAAE,OAAO,EACd,IAAI,SAAU,GACb;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAiG1C;AAED,MAAM,MAAM,cAAc,GAAG,QAAQ,CAAC,MAAM,CAAC,WAAW,EAAE,UAAU,CAAC,CAAC,CAAC;AAEvE,yCAAyC;AACzC,wBAAgB,cAAc,CAAC,OAAO,EAAE,aAAa,GAAG,cAAc,CAIrE"}

package/dist/cookbook/engine/schemas.js

@@ -4,7 +4,7 @@ var ids = (description, values) => ({
 	type: "array",
 	description,
 	minItems: 1,
-	maxItems: 50,
+	maxItems: 100,
 	items: values?.length ? {
 		type: "string",
 		enum: [...values]

package/dist/cookbook/engine/schemas.js.map

@@ -1 +1 @@
-{"version":3,"file":"schemas.js","names":[],"sources":["../../../src/cookbook/engine/schemas.ts"],"sourcesContent":["import { DEFAULT_THEME_PRESETS, MAX_TERMS_LENGTH } from './defaults.js';\nimport type {\n  CommandName,\n  CommandTool,\n  EngineCatalog,\n  JsonSchema,\n} from './types.js';\n\nconst ids = (description: string, values?: readonly string[]): JsonSchema => ({\n  type: 'array',\n  description,\n  minItems: 1,\n  maxItems: 50,\n  items: values?.length\n    ? { type: 'string', enum: [...values] }\n    : { type: 'string', minLength: 1 },\n});\n\nconst text = (description: string, extra: JsonSchema = {}): JsonSchema => ({\n  type: 'string',\n  description,\n  minLength: 1,\n  maxLength: 200,\n  ...extra,\n});\n\nconst object = (\n  properties: Record<string, JsonSchema>,\n  required: string[] = [],\n): JsonSchema => ({\n  type: 'object',\n  properties,\n  ...(required.length ? { required } : {}),\n  additionalProperties: false,\n});\n\n/**\n * Every command as an MCP/LLM tool definition (`inputSchema` is JSON Schema\n * 2020-12). Recipe and cookbook ids become enums from the catalog, so\n * grammar-constrained decoding cannot name one that does not exist.\n */\nexport function buildCommandTools(catalog: EngineCatalog): CommandTool[] {\n  const recipeIds = catalog.recipes.map((r) => r.id);\n  const cookbookIds = (catalog.cookbooks ?? []).map((c) => c.id);\n  const presets = catalog.themePresets ?? DEFAULT_THEME_PRESETS;\n  const cookbookId = (description: string): JsonSchema => ({\n    type: 'string',\n    description,\n    ...(cookbookIds.length ? { enum: [...cookbookIds] } : { minLength: 1 }),\n  });\n  const entryId = (what: string): JsonSchema =>\n    text(`The id of ${what}, as the plan snapshot's \"sections\" lists it.`);\n  const replace: JsonSchema = {\n    type: 'boolean',\n    description: 'Confirm replacing what is there.',\n  };\n  return [\n    {\n      name: 'add_recipes',\n      description:\n        'Switch recipes on. Recipes they require come along. Returns what was added.',\n      inputSchema: object({ ids: ids('Recipe ids to add.', recipeIds) }, [\n        'ids',\n      ]),\n    },\n    {\n      name: 'remove_recipes',\n      description:\n        'Switch recipes off. A recipe another one needs is kept and reported.',\n      inputSchema: object({ ids: ids('Recipe ids to remove.', recipeIds) }, [\n        'ids',\n      ]),\n    },\n    {\n      name: 'add_features',\n      description:\n        'Add single models no recipe covers, by qualified name (`@scope/pkg:Class`).',\n      inputSchema: object({ ids: ids('Qualified model names to add.') }, [\n        'ids',\n      ]),\n    },\n    {\n      name: 'remove_features',\n      description: 'Remove single models added with add_features.',\n      inputSchema: object({ ids: ids('Qualified model names to remove.') }, [\n        'ids',\n      ]),\n    },\n    {\n      name: 'add_cookbook',\n      description:\n        'Add the recipes and features of a ready-made cookbook to the current app. Nothing is replaced.',\n      inputSchema: object({ id: cookbookId('The cookbook to add.') }, ['id']),\n    },\n    {\n      name: 'remove_cookbook',\n      description:\n        'Remove the recipes and features a ready-made cookbook adds. Ones another recipe needs are kept.',\n      inputSchema: object({ id: cookbookId('The cookbook to remove.') }, [\n        'id',\n      ]),\n    },\n    {\n      name: 'apply_cookbook',\n      description:\n        'Select a ready-made cookbook: replace the whole app (recipes, options, menu, theme) with it. When the app has anything in it, replace must be true.',\n      inputSchema: object(\n        { id: cookbookId('The cookbook to set up.'), replace },\n        ['id'],\n      ),\n    },\n    {\n      name: 'import_cookbook',\n      description:\n        'Replace the whole app with a cookbook document (version 1). Checked strictly; nothing is applied if it is invalid. When the app has anything in it, replace must be true.',\n      inputSchema: object(\n        {\n          document: {\n            type: 'object',\n            description: 'A cookbook document, version 1.',\n          },\n          replace,\n        },\n        ['document'],\n      ),\n    },\n    {\n      name: 'set_settings',\n      description:\n        'Change app settings: currency, default tax rate (percent), default payment terms. Applies to new records only.',\n      inputSchema: object({\n        currency: catalog.currencies?.length\n          ? {\n              type: 'string',\n              description: 'ISO 4217 code, e.g. CAD.',\n              enum: [...catalog.currencies],\n            }\n          : {\n              type: 'string',\n              description: 'ISO 4217 code, e.g. CAD.',\n              pattern: '^[A-Z]{3}$',\n            },\n        taxRate: {\n          type: 'number',\n          description: 'Default tax rate in percent, 0 to 100.',\n          minimum: 0,\n          maximum: 100,\n        },\n        paymentTerms: {\n          type: 'string',\n          description: 'Default payment terms, e.g. \"Net 30\".',\n          minLength: 1,\n          maxLength: MAX_TERMS_LENGTH,\n        },\n        pricesIncludeTax: {\n          type: 'boolean',\n          description: 'Whether new document prices include tax.',\n        },\n        taxRounding: {\n          enum: ['line', 'document'],\n          description: 'Whether tax rounds per line or per document.',\n        },\n      }),\n    },\n    {\n      name: 'set_policy',\n      description:\n        \"Set one field's policy: default value, visibility, label or help. The model must be covered by a recipe or feature that is on. null clears a part.\",\n      inputSchema: object(\n        {\n          model: text(\n            'Qualified model name, e.g. @happyvertical/smrt-commerce:Order.',\n          ),\n          field: text('The model field name.'),\n          defaultValue: {\n            description:\n              'The default as a JSON value (a string, number or boolean). null clears it.',\n          },\n          visibility: {\n            enum: ['basic', 'advanced', 'hidden', null],\n            description: 'Whether the field shows in forms and lists.',\n          },\n          label: {\n            type: ['string', 'null'],\n            description: 'A different label.',\n            maxLength: 120,\n          },\n          help: {\n            type: ['string', 'null'],\n            description: 'Help text under the field.',\n            maxLength: 400,\n          },\n        },\n        ['model', 'field'],\n      ),\n    },\n    {\n      name: 'set_theme',\n      description:\n        'Change the look: a preset, a brand colour, light or dark. A preset replaces a brand colour.',\n      inputSchema: object({\n        preset: { enum: [...presets], description: 'A built-in theme.' },\n        primary: {\n          type: 'string',\n          description: 'Brand colour as #rrggbb.',\n          pattern: '^#[0-9a-fA-F]{6}$',\n        },\n        colorScheme: {\n          enum: ['light', 'dark', 'system'],\n          description: 'Light, dark or follow the device.',\n        },\n        fontFamily: {\n          type: ['string', 'null'],\n          minLength: 1,\n          description: 'Font key. Null restores the preset font.',\n        },\n        borderRadius: {\n          enum: ['none', 'sm', 'md', 'lg', 'xl', 'full'],\n          description: 'Corner roundness.',\n        },\n        density: {\n          enum: ['comfortable', 'touch'],\n          description: 'Control size: comfortable, or larger touch targets.',\n        },\n        contrast: {\n          enum: ['auto', 'standard', 'more'],\n          description:\n            'Contrast: auto follows the device, or force standard or more.',\n        },\n      }),\n    },\n    {\n      name: 'reset_theme',\n      description: 'Go back to the default look.',\n      inputSchema: object({}),\n    },\n    {\n      name: 'set_name',\n      description: 'Name, describe and specify the app. null clears a part.',\n      inputSchema: object({\n        name: { type: ['string', 'null'], minLength: 1, maxLength: 60 },\n        description: {\n          type: ['string', 'null'],\n          minLength: 1,\n          maxLength: 400,\n        },\n        specs: {\n          type: ['string', 'null'],\n          minLength: 1,\n          maxLength: 20000,\n          description:\n            'Product requirements beyond recipes and features, as plain text or a short list.',\n        },\n      }),\n    },\n    {\n      name: 'rename_section',\n      description: 'Rename a menu section.',\n      inputSchema: object(\n        {\n          id: entryId('the section'),\n          label: text('The new name.', { maxLength: 60 }),\n        },\n        ['id', 'label'],\n      ),\n    },\n    {\n      name: 'rename_item',\n      description: 'Rename a menu entry. A null label restores its own name.',\n      inputSchema: object(\n        {\n          id: entryId('the entry'),\n          label: { type: ['string', 'null'], minLength: 1, maxLength: 60 },\n        },\n        ['id', 'label'],\n      ),\n    },\n    {\n      name: 'hide',\n      description: 'Hide a menu section or entry. Nothing is deleted.',\n      inputSchema: object({ id: entryId('the section or entry') }, ['id']),\n    },\n    {\n      name: 'show',\n      description: 'Show a hidden menu section or entry again.',\n      inputSchema: object({ id: entryId('the section or entry') }, ['id']),\n    },\n    {\n      name: 'validate',\n      description:\n        'Check the current cookbook against the catalog and report typed diagnostics. Changes nothing.',\n      inputSchema: object({}),\n    },\n    {\n      name: 'export_cookbook',\n      description:\n        'The cookbook as a <name>.cookbook.json file (text in the result). Changes nothing.',\n      inputSchema: object({\n        name: text('A name for the file.', { maxLength: 60 }),\n      }),\n    },\n    {\n      name: 'undo',\n      description:\n        'Undo an earlier change by the undoId its receipt carried. Refused with a conflict when the plan changed since, unless force is true.',\n      inputSchema: object(\n        {\n          undoId: text('The undoId from a receipt.'),\n          force: {\n            type: 'boolean',\n            description: 'Undo even after later edits.',\n          },\n        },\n        ['undoId'],\n      ),\n    },\n  ];\n}\n\n/**\n * The batch envelope as a tool definition: several commands, applied\n * all-or-nothing. Commands inside are validated against their own schemas.\n */\nexport function buildBatchTool(catalog: EngineCatalog): {\n  name: 'run_batch';\n  description: string;\n  inputSchema: JsonSchema;\n} {\n  return {\n    name: 'run_batch',\n    description:\n      'Run several commands as one atomic batch: all apply or none does. A failure names the command and leaves the plan unchanged.',\n    inputSchema: {\n      type: 'object',\n      properties: {\n        id: { type: 'string', minLength: 1, maxLength: 200 },\n        expectedRevision: { type: 'integer', minimum: 0 },\n        commands: {\n          type: 'array',\n          minItems: 1,\n          maxItems: 50,\n          items: {\n            oneOf: buildCommandTools(catalog).map((tool) => ({\n              type: 'object',\n              properties: {\n                name: { const: tool.name },\n                input: tool.inputSchema,\n              },\n              required: ['name'],\n              additionalProperties: false,\n            })),\n          },\n        },\n      },\n      required: ['commands'],\n      additionalProperties: false,\n    },\n  };\n}\n\nconst typeOf = (value: unknown): string =>\n  value === null\n    ? 'null'\n    : Array.isArray(value)\n      ? 'array'\n      : Number.isInteger(value)\n        ? 'integer'\n        : typeof value;\n\nfunction typeMatches(wanted: string, value: unknown): boolean {\n  const actual = typeOf(value);\n  return actual === wanted || (wanted === 'number' && actual === 'integer');\n}\n\n/**\n * Check a value against a command schema (the subset the commands use). One\n * validator for runtime and exported schemas, so they cannot drift. Returns\n * the first problem as `{ path, message }`, or null.\n */\nexport function checkSchema(\n  schema: JsonSchema,\n  value: unknown,\n  path = 'input',\n): { path: string; message: string } | null {\n  const bad = (message: string) => ({ path, message: `${path} ${message}` });\n  const type = schema.type as string | string[] | undefined;\n  if (type) {\n    const wanted = Array.isArray(type) ? type : [type];\n    if (!wanted.some((t) => typeMatches(t, value))) {\n      return bad(`must be ${wanted.join(' or ')}`);\n    }\n  }\n  const choices = schema.enum as unknown[] | undefined;\n  if (choices && !choices.includes(value)) {\n    return bad(\n      choices.length > 12\n        ? 'is not a known value'\n        : `must be one of ${choices.map((c) => JSON.stringify(c)).join(', ')}`,\n    );\n  }\n  if (typeof value === 'string') {\n    const { minLength, maxLength, pattern } = schema as {\n      minLength?: number;\n      maxLength?: number;\n      pattern?: string;\n    };\n    if (minLength !== undefined && value.length < minLength) {\n      return bad('must not be empty');\n    }\n    if (maxLength !== undefined && value.length > maxLength) {\n      return bad(`must be at most ${maxLength} characters`);\n    }\n    if (pattern && !new RegExp(pattern).test(value)) {\n      return bad('has the wrong format');\n    }\n  }\n  if (typeof value === 'number') {\n    const { minimum, maximum } = schema as {\n      minimum?: number;\n      maximum?: number;\n    };\n    if (!Number.isFinite(value)) return bad('must be a finite number');\n    if (minimum !== undefined && value < minimum) {\n      return bad(`must be at least ${minimum}`);\n    }\n    if (maximum !== undefined && value > maximum) {\n      return bad(`must be at most ${maximum}`);\n    }\n  }\n  if (Array.isArray(value)) {\n    const { minItems, maxItems, items } = schema as {\n      minItems?: number;\n      maxItems?: number;\n      items?: JsonSchema;\n    };\n    if (minItems !== undefined && value.length < minItems) {\n      return bad(`needs at least ${minItems} item${minItems === 1 ? '' : 's'}`);\n    }\n    if (maxItems !== undefined && value.length > maxItems) {\n      return bad(`takes at most ${maxItems} items`);\n    }\n    if (items) {\n      for (const [index, item] of value.entries()) {\n        const problem = checkSchema(items, item, `${path}[${index}]`);\n        if (problem) return problem;\n      }\n    }\n  }\n  if (typeOf(value) === 'object') {\n    const object = value as Record<string, unknown>;\n    const { properties, required, additionalProperties } = schema as {\n      properties?: Record<string, JsonSchema>;\n      required?: string[];\n      additionalProperties?: boolean;\n    };\n    for (const key of required ?? []) {\n      if (object[key] === undefined) {\n        return {\n          path: `${path}.${key}`,\n          message: `${path}.${key} is required`,\n        };\n      }\n    }\n    for (const [key, entry] of Object.entries(object)) {\n      const child = properties?.[key];\n      if (!child) {\n        if (additionalProperties === false) {\n          return {\n            path: `${path}.${key}`,\n            message: `${path}.${key} is not an option of this command`,\n          };\n        }\n        continue;\n      }\n      if (entry === undefined) continue;\n      const problem = checkSchema(child, entry, `${path}.${key}`);\n      if (problem) return problem;\n    }\n  }\n  return null;\n}\n\nexport type CommandSchemas = Readonly<Record<CommandName, JsonSchema>>;\n\n/** The input schemas by command name. */\nexport function commandSchemas(catalog: EngineCatalog): CommandSchemas {\n  return Object.fromEntries(\n    buildCommandTools(catalog).map((tool) => [tool.name, tool.inputSchema]),\n  ) as CommandSchemas;\n}\n"],"mappings":"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"}
+{"version":3,"file":"schemas.js","names":[],"sources":["../../../src/cookbook/engine/schemas.ts"],"sourcesContent":["import { DEFAULT_THEME_PRESETS, MAX_TERMS_LENGTH } from './defaults.js';\nimport type {\n  CommandName,\n  CommandTool,\n  EngineCatalog,\n  JsonSchema,\n} from './types.js';\n\nconst ids = (description: string, values?: readonly string[]): JsonSchema => ({\n  type: 'array',\n  description,\n  minItems: 1,\n  // Room for every recipe in the catalog at once (55 at smrt 0.57.36).\n  maxItems: 100,\n  items: values?.length\n    ? { type: 'string', enum: [...values] }\n    : { type: 'string', minLength: 1 },\n});\n\nconst text = (description: string, extra: JsonSchema = {}): JsonSchema => ({\n  type: 'string',\n  description,\n  minLength: 1,\n  maxLength: 200,\n  ...extra,\n});\n\nconst object = (\n  properties: Record<string, JsonSchema>,\n  required: string[] = [],\n): JsonSchema => ({\n  type: 'object',\n  properties,\n  ...(required.length ? { required } : {}),\n  additionalProperties: false,\n});\n\n/**\n * Every command as an MCP/LLM tool definition (`inputSchema` is JSON Schema\n * 2020-12). Recipe and cookbook ids become enums from the catalog, so\n * grammar-constrained decoding cannot name one that does not exist.\n */\nexport function buildCommandTools(catalog: EngineCatalog): CommandTool[] {\n  const recipeIds = catalog.recipes.map((r) => r.id);\n  const cookbookIds = (catalog.cookbooks ?? []).map((c) => c.id);\n  const presets = catalog.themePresets ?? DEFAULT_THEME_PRESETS;\n  const cookbookId = (description: string): JsonSchema => ({\n    type: 'string',\n    description,\n    ...(cookbookIds.length ? { enum: [...cookbookIds] } : { minLength: 1 }),\n  });\n  const entryId = (what: string): JsonSchema =>\n    text(`The id of ${what}, as the plan snapshot's \"sections\" lists it.`);\n  const replace: JsonSchema = {\n    type: 'boolean',\n    description: 'Confirm replacing what is there.',\n  };\n  return [\n    {\n      name: 'add_recipes',\n      description:\n        'Switch recipes on. Recipes they require come along. Returns what was added.',\n      inputSchema: object({ ids: ids('Recipe ids to add.', recipeIds) }, [\n        'ids',\n      ]),\n    },\n    {\n      name: 'remove_recipes',\n      description:\n        'Switch recipes off. A recipe another one needs is kept and reported.',\n      inputSchema: object({ ids: ids('Recipe ids to remove.', recipeIds) }, [\n        'ids',\n      ]),\n    },\n    {\n      name: 'add_features',\n      description:\n        'Add single models no recipe covers, by qualified name (`@scope/pkg:Class`).',\n      inputSchema: object({ ids: ids('Qualified model names to add.') }, [\n        'ids',\n      ]),\n    },\n    {\n      name: 'remove_features',\n      description: 'Remove single models added with add_features.',\n      inputSchema: object({ ids: ids('Qualified model names to remove.') }, [\n        'ids',\n      ]),\n    },\n    {\n      name: 'add_cookbook',\n      description:\n        'Add the recipes and features of a ready-made cookbook to the current app. Nothing is replaced.',\n      inputSchema: object({ id: cookbookId('The cookbook to add.') }, ['id']),\n    },\n    {\n      name: 'remove_cookbook',\n      description:\n        'Remove the recipes and features a ready-made cookbook adds. Ones another recipe needs are kept.',\n      inputSchema: object({ id: cookbookId('The cookbook to remove.') }, [\n        'id',\n      ]),\n    },\n    {\n      name: 'apply_cookbook',\n      description:\n        'Select a ready-made cookbook: replace the whole app (recipes, options, menu, theme) with it. When the app has anything in it, replace must be true.',\n      inputSchema: object(\n        { id: cookbookId('The cookbook to set up.'), replace },\n        ['id'],\n      ),\n    },\n    {\n      name: 'import_cookbook',\n      description:\n        'Replace the whole app with a cookbook document (version 1). Checked strictly; nothing is applied if it is invalid. When the app has anything in it, replace must be true.',\n      inputSchema: object(\n        {\n          document: {\n            type: 'object',\n            description: 'A cookbook document, version 1.',\n          },\n          replace,\n        },\n        ['document'],\n      ),\n    },\n    {\n      name: 'set_settings',\n      description:\n        'Change app settings: currency, default tax rate (percent), default payment terms. Applies to new records only.',\n      inputSchema: object({\n        currency: catalog.currencies?.length\n          ? {\n              type: 'string',\n              description: 'ISO 4217 code, e.g. CAD.',\n              enum: [...catalog.currencies],\n            }\n          : {\n              type: 'string',\n              description: 'ISO 4217 code, e.g. CAD.',\n              pattern: '^[A-Z]{3}$',\n            },\n        taxRate: {\n          type: 'number',\n          description: 'Default tax rate in percent, 0 to 100.',\n          minimum: 0,\n          maximum: 100,\n        },\n        paymentTerms: {\n          type: 'string',\n          description: 'Default payment terms, e.g. \"Net 30\".',\n          minLength: 1,\n          maxLength: MAX_TERMS_LENGTH,\n        },\n        pricesIncludeTax: {\n          type: 'boolean',\n          description: 'Whether new document prices include tax.',\n        },\n        taxRounding: {\n          enum: ['line', 'document'],\n          description: 'Whether tax rounds per line or per document.',\n        },\n      }),\n    },\n    {\n      name: 'set_policy',\n      description:\n        \"Set one field's policy: default value, visibility, label or help. The model must be covered by a recipe or feature that is on. null clears a part.\",\n      inputSchema: object(\n        {\n          model: text(\n            'Qualified model name, e.g. @happyvertical/smrt-commerce:Order.',\n          ),\n          field: text('The model field name.'),\n          defaultValue: {\n            description:\n              'The default as a JSON value (a string, number or boolean). null clears it.',\n          },\n          visibility: {\n            enum: ['basic', 'advanced', 'hidden', null],\n            description: 'Whether the field shows in forms and lists.',\n          },\n          label: {\n            type: ['string', 'null'],\n            description: 'A different label.',\n            maxLength: 120,\n          },\n          help: {\n            type: ['string', 'null'],\n            description: 'Help text under the field.',\n            maxLength: 400,\n          },\n        },\n        ['model', 'field'],\n      ),\n    },\n    {\n      name: 'set_theme',\n      description:\n        'Change the look: a preset, a brand colour, light or dark. A preset replaces a brand colour.',\n      inputSchema: object({\n        preset: { enum: [...presets], description: 'A built-in theme.' },\n        primary: {\n          type: 'string',\n          description: 'Brand colour as #rrggbb.',\n          pattern: '^#[0-9a-fA-F]{6}$',\n        },\n        colorScheme: {\n          enum: ['light', 'dark', 'system'],\n          description: 'Light, dark or follow the device.',\n        },\n        fontFamily: {\n          type: ['string', 'null'],\n          minLength: 1,\n          description: 'Font key. Null restores the preset font.',\n        },\n        borderRadius: {\n          enum: ['none', 'sm', 'md', 'lg', 'xl', 'full'],\n          description: 'Corner roundness.',\n        },\n        density: {\n          enum: ['comfortable', 'touch'],\n          description: 'Control size: comfortable, or larger touch targets.',\n        },\n        contrast: {\n          enum: ['auto', 'standard', 'more'],\n          description:\n            'Contrast: auto follows the device, or force standard or more.',\n        },\n      }),\n    },\n    {\n      name: 'reset_theme',\n      description: 'Go back to the default look.',\n      inputSchema: object({}),\n    },\n    {\n      name: 'set_name',\n      description: 'Name, describe and specify the app. null clears a part.',\n      inputSchema: object({\n        name: { type: ['string', 'null'], minLength: 1, maxLength: 60 },\n        description: {\n          type: ['string', 'null'],\n          minLength: 1,\n          maxLength: 400,\n        },\n        specs: {\n          type: ['string', 'null'],\n          minLength: 1,\n          maxLength: 20000,\n          description:\n            'Product requirements beyond recipes and features, as plain text or a short list.',\n        },\n      }),\n    },\n    {\n      name: 'rename_section',\n      description: 'Rename a menu section.',\n      inputSchema: object(\n        {\n          id: entryId('the section'),\n          label: text('The new name.', { maxLength: 60 }),\n        },\n        ['id', 'label'],\n      ),\n    },\n    {\n      name: 'rename_item',\n      description: 'Rename a menu entry. A null label restores its own name.',\n      inputSchema: object(\n        {\n          id: entryId('the entry'),\n          label: { type: ['string', 'null'], minLength: 1, maxLength: 60 },\n        },\n        ['id', 'label'],\n      ),\n    },\n    {\n      name: 'hide',\n      description: 'Hide a menu section or entry. Nothing is deleted.',\n      inputSchema: object({ id: entryId('the section or entry') }, ['id']),\n    },\n    {\n      name: 'show',\n      description: 'Show a hidden menu section or entry again.',\n      inputSchema: object({ id: entryId('the section or entry') }, ['id']),\n    },\n    {\n      name: 'validate',\n      description:\n        'Check the current cookbook against the catalog and report typed diagnostics. Changes nothing.',\n      inputSchema: object({}),\n    },\n    {\n      name: 'export_cookbook',\n      description:\n        'The cookbook as a <name>.cookbook.json file (text in the result). Changes nothing.',\n      inputSchema: object({\n        name: text('A name for the file.', { maxLength: 60 }),\n      }),\n    },\n    {\n      name: 'undo',\n      description:\n        'Undo an earlier change by the undoId its receipt carried. Refused with a conflict when the plan changed since, unless force is true.',\n      inputSchema: object(\n        {\n          undoId: text('The undoId from a receipt.'),\n          force: {\n            type: 'boolean',\n            description: 'Undo even after later edits.',\n          },\n        },\n        ['undoId'],\n      ),\n    },\n  ];\n}\n\n/**\n * The batch envelope as a tool definition: several commands, applied\n * all-or-nothing. Commands inside are validated against their own schemas.\n */\nexport function buildBatchTool(catalog: EngineCatalog): {\n  name: 'run_batch';\n  description: string;\n  inputSchema: JsonSchema;\n} {\n  return {\n    name: 'run_batch',\n    description:\n      'Run several commands as one atomic batch: all apply or none does. A failure names the command and leaves the plan unchanged.',\n    inputSchema: {\n      type: 'object',\n      properties: {\n        id: { type: 'string', minLength: 1, maxLength: 200 },\n        expectedRevision: { type: 'integer', minimum: 0 },\n        commands: {\n          type: 'array',\n          minItems: 1,\n          maxItems: 50,\n          items: {\n            oneOf: buildCommandTools(catalog).map((tool) => ({\n              type: 'object',\n              properties: {\n                name: { const: tool.name },\n                input: tool.inputSchema,\n              },\n              required: ['name'],\n              additionalProperties: false,\n            })),\n          },\n        },\n      },\n      required: ['commands'],\n      additionalProperties: false,\n    },\n  };\n}\n\nconst typeOf = (value: unknown): string =>\n  value === null\n    ? 'null'\n    : Array.isArray(value)\n      ? 'array'\n      : Number.isInteger(value)\n        ? 'integer'\n        : typeof value;\n\nfunction typeMatches(wanted: string, value: unknown): boolean {\n  const actual = typeOf(value);\n  return actual === wanted || (wanted === 'number' && actual === 'integer');\n}\n\n/**\n * Check a value against a command schema (the subset the commands use). One\n * validator for runtime and exported schemas, so they cannot drift. Returns\n * the first problem as `{ path, message }`, or null.\n */\nexport function checkSchema(\n  schema: JsonSchema,\n  value: unknown,\n  path = 'input',\n): { path: string; message: string } | null {\n  const bad = (message: string) => ({ path, message: `${path} ${message}` });\n  const type = schema.type as string | string[] | undefined;\n  if (type) {\n    const wanted = Array.isArray(type) ? type : [type];\n    if (!wanted.some((t) => typeMatches(t, value))) {\n      return bad(`must be ${wanted.join(' or ')}`);\n    }\n  }\n  const choices = schema.enum as unknown[] | undefined;\n  if (choices && !choices.includes(value)) {\n    return bad(\n      choices.length > 12\n        ? 'is not a known value'\n        : `must be one of ${choices.map((c) => JSON.stringify(c)).join(', ')}`,\n    );\n  }\n  if (typeof value === 'string') {\n    const { minLength, maxLength, pattern } = schema as {\n      minLength?: number;\n      maxLength?: number;\n      pattern?: string;\n    };\n    if (minLength !== undefined && value.length < minLength) {\n      return bad('must not be empty');\n    }\n    if (maxLength !== undefined && value.length > maxLength) {\n      return bad(`must be at most ${maxLength} characters`);\n    }\n    if (pattern && !new RegExp(pattern).test(value)) {\n      return bad('has the wrong format');\n    }\n  }\n  if (typeof value === 'number') {\n    const { minimum, maximum } = schema as {\n      minimum?: number;\n      maximum?: number;\n    };\n    if (!Number.isFinite(value)) return bad('must be a finite number');\n    if (minimum !== undefined && value < minimum) {\n      return bad(`must be at least ${minimum}`);\n    }\n    if (maximum !== undefined && value > maximum) {\n      return bad(`must be at most ${maximum}`);\n    }\n  }\n  if (Array.isArray(value)) {\n    const { minItems, maxItems, items } = schema as {\n      minItems?: number;\n      maxItems?: number;\n      items?: JsonSchema;\n    };\n    if (minItems !== undefined && value.length < minItems) {\n      return bad(`needs at least ${minItems} item${minItems === 1 ? '' : 's'}`);\n    }\n    if (maxItems !== undefined && value.length > maxItems) {\n      return bad(`takes at most ${maxItems} items`);\n    }\n    if (items) {\n      for (const [index, item] of value.entries()) {\n        const problem = checkSchema(items, item, `${path}[${index}]`);\n        if (problem) return problem;\n      }\n    }\n  }\n  if (typeOf(value) === 'object') {\n    const object = value as Record<string, unknown>;\n    const { properties, required, additionalProperties } = schema as {\n      properties?: Record<string, JsonSchema>;\n      required?: string[];\n      additionalProperties?: boolean;\n    };\n    for (const key of required ?? []) {\n      if (object[key] === undefined) {\n        return {\n          path: `${path}.${key}`,\n          message: `${path}.${key} is required`,\n        };\n      }\n    }\n    for (const [key, entry] of Object.entries(object)) {\n      const child = properties?.[key];\n      if (!child) {\n        if (additionalProperties === false) {\n          return {\n            path: `${path}.${key}`,\n            message: `${path}.${key} is not an option of this command`,\n          };\n        }\n        continue;\n      }\n      if (entry === undefined) continue;\n      const problem = checkSchema(child, entry, `${path}.${key}`);\n      if (problem) return problem;\n    }\n  }\n  return null;\n}\n\nexport type CommandSchemas = Readonly<Record<CommandName, JsonSchema>>;\n\n/** The input schemas by command name. */\nexport function commandSchemas(catalog: EngineCatalog): CommandSchemas {\n  return Object.fromEntries(\n    buildCommandTools(catalog).map((tool) => [tool.name, tool.inputSchema]),\n  ) as CommandSchemas;\n}\n"],"mappings":"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"}

package/dist/data-query.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"data-query.d.ts","sourceRoot":"","sources":["../src/data-query.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EACV,qBAAqB,EAKrB,wBAAwB,EAKxB,gBAAgB,EAChB,eAAe,EAGf,eAAe,EAGhB,MAAM,2BAA2B,CAAC;AACnC,OAAO,EAAE,eAAe,EAAE,MAAM,aAAU,CAAC;AAG3C,4EAA4E;AAC5E,eAAO,MAAM,6BAA6B,KAAK,CAAC;AAChD,eAAO,MAAM,yBAAyB,OAAQ,CAAC;AAC/C,eAAO,MAAM,+BAA+B,UAAY,CAAC;AACzD,eAAO,MAAM,2BAA2B,WAAa,CAAC;AACtD,eAAO,MAAM,4BAA4B,SAAU,CAAC;AACpD,eAAO,MAAM,qBAAqB,UAAY,CAAC;AAC/C,eAAO,MAAM,2BAA2B,IAAI,CAAC;AAC7C,eAAO,MAAM,sBAAsB,KAAK,CAAC;AACzC,eAAO,MAAM,wBAAwB,MAAM,CAAC;AAC5C,eAAO,MAAM,qBAAqB,KAAK,CAAC;AACxC,eAAO,MAAM,uBAAuB,MAAM,CAAC;AAC3C,eAAO,MAAM,4BAA4B,OAAQ,CAAC;AAClD,eAAO,MAAM,yBAAyB,KAAK,CAAC;AAC5C,eAAO,MAAM,mCAAmC,OAAQ,CAAC;AACzD,eAAO,MAAM,iCAAiC,QAAS,CAAC;AACxD;;;GAGG;AACH,eAAO,MAAM,2BAA2B,MAAM,CAAC;AAC/C,eAAO,MAAM,iCAAiC,MAAM,CAAC;AACrD,eAAO,MAAM,uCAAuC,MAAM,CAAC;AAC3D,eAAO,MAAM,6CAA6C,MAAM,CAAC;AA0BjE,iFAAiF;AACjF,qBAAa,wBAAyB,SAAQ,eAAe;IAC3D,QAAQ,CAAC,MAAM,OAAO;IACtB,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;gBAG7B,OAAO,EAAE,MAAM,EACf,IAAI,SAAuB,EAC3B,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;CAMpC;AAuYD;;;;;GAKG;AACH,wBAAgB,6BAA6B,CAC3C,KAAK,EAAE,OAAO,EACd,IAAI,EAAE,wBAAwB,CAAC,MAAM,CAAC,EACtC,OAAO,EAAE,MAAM,GACd,qBAAqB,EAAE,CAgEzB;AAsCD,yEAAyE;AACzE,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,OAAO,GAAG,eAAe,CAiIxE;AA6UD;;;;;GAKG;AACH,wBAAgB,yBAAyB,CACvC,KAAK,EAAE,OAAO,EACd,WAAW,EAAE,OAAO,GACnB,gBAAgB,CAuGlB;AAED,oFAAoF;AACpF,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,GAAG,MAAM,CAI7E;AAED,4FAA4F;AAC5F,wBAAgB,0BAA0B,CACxC,KAAK,EAAE,OAAO,EACd,MAAM,EAAE,OAAO,GACd,MAAM,CAER;AAuLD;;;;;GAKG;AACH,wBAAgB,wBAAwB,CACtC,KAAK,EAAE,OAAO,EACd,YAAY,EAAE,OAAO,EACrB,WAAW,EAAE,OAAO,GACnB,eAAe,CAuLjB"}
+{"version":3,"file":"data-query.d.ts","sourceRoot":"","sources":["../src/data-query.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EACV,qBAAqB,EAKrB,wBAAwB,EAMxB,gBAAgB,EAChB,eAAe,EAGf,eAAe,EAGhB,MAAM,2BAA2B,CAAC;AACnC,OAAO,EAAE,eAAe,EAAE,MAAM,aAAU,CAAC;AAG3C,4EAA4E;AAC5E,eAAO,MAAM,6BAA6B,KAAK,CAAC;AAChD,eAAO,MAAM,yBAAyB,OAAQ,CAAC;AAC/C,eAAO,MAAM,+BAA+B,UAAY,CAAC;AACzD,eAAO,MAAM,2BAA2B,WAAa,CAAC;AACtD,eAAO,MAAM,4BAA4B,SAAU,CAAC;AACpD,eAAO,MAAM,qBAAqB,UAAY,CAAC;AAC/C,eAAO,MAAM,2BAA2B,IAAI,CAAC;AAC7C,eAAO,MAAM,sBAAsB,KAAK,CAAC;AACzC,eAAO,MAAM,wBAAwB,MAAM,CAAC;AAC5C,eAAO,MAAM,qBAAqB,KAAK,CAAC;AACxC,eAAO,MAAM,uBAAuB,MAAM,CAAC;AAC3C,eAAO,MAAM,4BAA4B,OAAQ,CAAC;AAClD,eAAO,MAAM,yBAAyB,KAAK,CAAC;AAC5C,eAAO,MAAM,mCAAmC,OAAQ,CAAC;AACzD,eAAO,MAAM,iCAAiC,QAAS,CAAC;AACxD;;;GAGG;AACH,eAAO,MAAM,2BAA2B,MAAM,CAAC;AAC/C,eAAO,MAAM,iCAAiC,MAAM,CAAC;AACrD,eAAO,MAAM,uCAAuC,MAAM,CAAC;AAC3D,eAAO,MAAM,6CAA6C,MAAM,CAAC;AAiCjE,iFAAiF;AACjF,qBAAa,wBAAyB,SAAQ,eAAe;IAC3D,QAAQ,CAAC,MAAM,OAAO;IACtB,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;gBAG7B,OAAO,EAAE,MAAM,EACf,IAAI,SAAuB,EAC3B,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;CAMpC;AAuYD;;;;;GAKG;AACH,wBAAgB,6BAA6B,CAC3C,KAAK,EAAE,OAAO,EACd,IAAI,EAAE,wBAAwB,CAAC,MAAM,CAAC,EACtC,OAAO,EAAE,MAAM,GACd,qBAAqB,EAAE,CAgEzB;AAsCD,yEAAyE;AACzE,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,OAAO,GAAG,eAAe,CAiIxE;AA4VD;;;;;GAKG;AACH,wBAAgB,yBAAyB,CACvC,KAAK,EAAE,OAAO,EACd,WAAW,EAAE,OAAO,GACnB,gBAAgB,CAuGlB;AAED,oFAAoF;AACpF,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,GAAG,MAAM,CAI7E;AAED,4FAA4F;AAC5F,wBAAgB,0BAA0B,CACxC,KAAK,EAAE,OAAO,EACd,MAAM,EAAE,OAAO,GACd,MAAM,CAER;AAuLD;;;;;GAKG;AACH,wBAAgB,wBAAwB,CACtC,KAAK,EAAE,OAAO,EACd,YAAY,EAAE,OAAO,EACrB,WAAW,EAAE,OAAO,GACnB,eAAe,CAuLjB"}

package/dist/data-query.js

@@ -44,8 +44,12 @@ var FILTER_OPERATORS = /* @__PURE__ */ new Set([
 	"lte",
 	"in",
 	"notIn",
-	"like"
+	"like",
+	"isNull",
+	"isNotNull"
 ]);
+/** Null tests (#4448): conditions that take no `value`. */
+var NULL_OPERATORS = /* @__PURE__ */ new Set(["isNull", "isNotNull"]);
 var FORBIDDEN_KEYS = /* @__PURE__ */ new Set([
 	"__proto__",
 	"constructor",
@@ -459,6 +463,14 @@ function normalizeFilter(value, fields, depth = 0, budget = { nodes: 0 }) {
 		if (!descriptor) return fail(`Data query field is not declared: ${field}`, "DATA_QUERY_FIELD_NOT_ALLOWED");
 		const operator = stringValue(object.operator, "Data query condition operator");
 		if (!FILTER_OPERATORS.has(operator) || !descriptor.filterOperators?.includes(operator)) return fail(`Data query operator ${operator} is not allowed for ${field}`, "DATA_QUERY_OPERATOR_NOT_ALLOWED");
+		if (NULL_OPERATORS.has(operator)) {
+			if (object.value !== void 0 && object.value !== null) return fail(`Data query ${operator} takes no value; omit value: {"kind":"condition","field":${JSON.stringify(field)},"operator":"${operator}"}`);
+			return {
+				kind: "condition",
+				field,
+				operator
+			};
+		}
 		if (operator === "in" || operator === "notIn") {
 			if (!Array.isArray(object.value) || object.value.length === 0) return fail(`Data query ${operator} value must be a non-empty array`);
 			if (object.value.length > 100) return fail(`Data query ${operator} value cannot exceed 100 items`);