node-type-registry 0.36.0 → 0.37.0

package/blueprint-types.generated.d.ts

@@ -830,6 +830,41 @@ export interface BlueprintStorageConfig {
         buckets?: BlueprintEntityTableProvision;
     };
 }
+/** A requirement entry within a blueprint achievement. Defines what events must occur to earn the achievement. */
+export interface BlueprintAchievementRequirement {
+    /** Name identifier matching an event_type or step name. */
+    event_name: string;
+    /** Number of events needed to satisfy this requirement. */
+    count: number;
+    /** Human-readable description of what this requirement entails. */
+    description?: string;
+}
+/** A reward entry within a blueprint achievement. Defines credits granted when the achievement is earned. */
+export interface BlueprintAchievementReward {
+    /** Type of reward: limit_credit (grants limit credits) or meter_credit (grants meter credits). */
+    reward_type: 'limit_credit' | 'meter_credit';
+    /** Target limit name or meter slug for the credit grant. */
+    target_name: string;
+    /** Number of credits to grant. */
+    amount: number;
+    /** Credit type: permanent, expiring, etc. Defaults to "permanent". */
+    credit_type?: string;
+}
+/** An achievement entry for the blueprint achievements[] section. Creates a level with requirements and optional rewards in the events_module. Requires events_module to be provisioned (e.g., via entity_types[].has_levels = true or modules includes events_module). */
+export interface BlueprintAchievement {
+    /** Unique name for the achievement level. */
+    name: string;
+    /** Human-readable description of this achievement. */
+    description?: string;
+    /** Display ordering priority; lower values appear first. Defaults to 100. */
+    priority?: number;
+    /** Requirements that must be met to earn this achievement. */
+    requirements: BlueprintAchievementRequirement[];
+    /** Rewards granted when the achievement is earned. */
+    rewards?: BlueprintAchievementReward[];
+    /** Entity prefix to scope this achievement to (e.g., "org", "app"). Used to resolve the correct events_module. Defaults to "app". */
+    entity_prefix?: string;
+}
 /** Override object for the entity table created by a BlueprintEntityType. Shape mirrors BlueprintTable / secure_table_provision vocabulary. When supplied, policies[] replaces the default entity-table policies entirely. */
 export interface BlueprintEntityTableProvision {
     /** Whether to enable RLS on the entity table. Forwarded to secure_table_provision. Defaults to true. */
@@ -870,6 +905,8 @@ export interface BlueprintEntityType {
     has_storage?: boolean;
     /** Whether to provision entity-scoped invite tables ({prefix}_invites, {prefix}_claimed_invites) and a submit_{prefix}_invite_code() function. Defaults to false. */
     has_invites?: boolean;
+    /** Whether to auto-attach an EventTracker to the claimed_invites table for invite-based achievements. Requires has_invites=true AND has_levels=true. When true, records 'invite_claimed' events credited to the sender (inviter) on each claimed invite. Defaults to false. */
+    has_invite_achievements?: boolean;
     /** Escape hatch: when true AND table_provision is NULL, zero policies are provisioned on the entity table. Defaults to false. */
     skip_entity_policies?: boolean;
     /** Override for the entity table. Shape mirrors BlueprintTable / secure_table_provision vocabulary. When supplied, its policies[] replaces the five default entity-table policies; is_visible becomes a no-op. When NULL (default), the five default policies are applied (gated by is_visible). */
@@ -1142,4 +1179,6 @@ export interface BlueprintDefinition {
     entity_types?: BlueprintEntityType[];
     /** App-level storage configuration. Creates a storage_module (membership_type = NULL), seeds initial buckets, and overrides module-level settings (expiry times, file size limits, CORS). Use provisions for per-table policy overrides. For entity-scoped storage, use entity_types[].has_storage + entity_types[].storage instead. */
     storage?: BlueprintStorageConfig;
+    /** Achievement definitions. Each entry creates a level with requirements and optional rewards in the events_module. Requires events_module to be provisioned (e.g., via entity_types[].has_levels = true or modules includes events_module). */
+    achievements?: BlueprintAchievement[];
 }

package/codegen/generate-types.js

@@ -528,6 +528,37 @@ function buildBlueprintStorageConfig() {
         ])), 'Per-table overrides for storage tables. Each key targets a specific storage table (files, buckets) and uses the same shape as table_provision: { nodes, fields, grants, use_rls, policies }. Fanned out to secure_table_provision targeting the corresponding table. When a key includes policies[], those REPLACE the default storage policies for that table; tables without a key still get defaults.')
     ]), 'Storage configuration for an entity type. Seeds initial buckets, overrides module-level settings (expiry times, file size limits, CORS), and provides per-table provisioning overrides via provisions.');
 }
+// ---------------------------------------------------------------------------
+// Achievement types
+// ---------------------------------------------------------------------------
+function buildBlueprintAchievementRequirement() {
+    return addJSDoc(exportInterface('BlueprintAchievementRequirement', [
+        addJSDoc(requiredProp('event_name', t.tsStringKeyword()), 'Name identifier matching an event_type or step name.'),
+        addJSDoc(requiredProp('count', t.tsNumberKeyword()), 'Number of events needed to satisfy this requirement.'),
+        addJSDoc(optionalProp('description', t.tsStringKeyword()), 'Human-readable description of what this requirement entails.')
+    ]), 'A requirement entry within a blueprint achievement. Defines what events must occur to earn the achievement.');
+}
+function buildBlueprintAchievementReward() {
+    return addJSDoc(exportInterface('BlueprintAchievementReward', [
+        addJSDoc(requiredProp('reward_type', t.tsUnionType([
+            t.tsLiteralType(t.stringLiteral('limit_credit')),
+            t.tsLiteralType(t.stringLiteral('meter_credit'))
+        ])), 'Type of reward: limit_credit (grants limit credits) or meter_credit (grants meter credits).'),
+        addJSDoc(requiredProp('target_name', t.tsStringKeyword()), 'Target limit name or meter slug for the credit grant.'),
+        addJSDoc(requiredProp('amount', t.tsNumberKeyword()), 'Number of credits to grant.'),
+        addJSDoc(optionalProp('credit_type', t.tsStringKeyword()), 'Credit type: permanent, expiring, etc. Defaults to "permanent".')
+    ]), 'A reward entry within a blueprint achievement. Defines credits granted when the achievement is earned.');
+}
+function buildBlueprintAchievement() {
+    return addJSDoc(exportInterface('BlueprintAchievement', [
+        addJSDoc(requiredProp('name', t.tsStringKeyword()), 'Unique name for the achievement level.'),
+        addJSDoc(optionalProp('description', t.tsStringKeyword()), 'Human-readable description of this achievement.'),
+        addJSDoc(optionalProp('priority', t.tsNumberKeyword()), 'Display ordering priority; lower values appear first. Defaults to 100.'),
+        addJSDoc(requiredProp('requirements', t.tsArrayType(t.tsTypeReference(t.identifier('BlueprintAchievementRequirement')))), 'Requirements that must be met to earn this achievement.'),
+        addJSDoc(optionalProp('rewards', t.tsArrayType(t.tsTypeReference(t.identifier('BlueprintAchievementReward')))), 'Rewards granted when the achievement is earned.'),
+        addJSDoc(optionalProp('entity_prefix', t.tsStringKeyword()), 'Entity prefix to scope this achievement to (e.g., "org", "app"). Used to resolve the correct events_module. Defaults to "app".')
+    ]), 'An achievement entry for the blueprint achievements[] section. Creates a level with requirements and optional rewards in the events_module. Requires events_module to be provisioned (e.g., via entity_types[].has_levels = true or modules includes events_module).');
+}
 function buildBlueprintEntityTableProvision() {
     return addJSDoc(exportInterface('BlueprintEntityTableProvision', [
         addJSDoc(optionalProp('use_rls', t.tsBooleanKeyword()), 'Whether to enable RLS on the entity table. Forwarded to secure_table_provision. Defaults to true.'),
@@ -553,6 +584,7 @@ function buildBlueprintEntityType() {
         addJSDoc(optionalProp('has_levels', t.tsBooleanKeyword()), 'Whether to provision a levels module for this entity type. Defaults to false.'),
         addJSDoc(optionalProp('has_storage', t.tsBooleanKeyword()), 'Whether to provision a storage module (buckets, files tables) for this entity type. Defaults to false.'),
         addJSDoc(optionalProp('has_invites', t.tsBooleanKeyword()), 'Whether to provision entity-scoped invite tables ({prefix}_invites, {prefix}_claimed_invites) and a submit_{prefix}_invite_code() function. Defaults to false.'),
+        addJSDoc(optionalProp('has_invite_achievements', t.tsBooleanKeyword()), "Whether to auto-attach an EventTracker to the claimed_invites table for invite-based achievements. Requires has_invites=true AND has_levels=true. When true, records 'invite_claimed' events credited to the sender (inviter) on each claimed invite. Defaults to false."),
         addJSDoc(optionalProp('skip_entity_policies', t.tsBooleanKeyword()), 'Escape hatch: when true AND table_provision is NULL, zero policies are provisioned on the entity table. Defaults to false.'),
         addJSDoc(optionalProp('table_provision', t.tsTypeReference(t.identifier('BlueprintEntityTableProvision'))), 'Override for the entity table. Shape mirrors BlueprintTable / secure_table_provision vocabulary. When supplied, its policies[] replaces the five default entity-table policies; is_visible becomes a no-op. When NULL (default), the five default policies are applied (gated by is_visible).'),
         addJSDoc(optionalProp('storage', t.tsTypeReference(t.identifier('BlueprintStorageConfig'))), 'Storage configuration. Only used when has_storage is true. Controls RLS policies on storage tables, seeds initial buckets, and overrides module-level settings (expiry times, file size limits, CORS).')
@@ -583,7 +615,8 @@ function buildBlueprintDefinition() {
         addJSDoc(optionalProp('full_text_searches', t.tsArrayType(t.tsTypeReference(t.identifier('BlueprintFullTextSearch')))), 'Full-text search configurations.'),
         addJSDoc(optionalProp('unique_constraints', t.tsArrayType(t.tsTypeReference(t.identifier('BlueprintUniqueConstraint')))), 'Unique constraints on table columns.'),
         addJSDoc(optionalProp('entity_types', t.tsArrayType(t.tsTypeReference(t.identifier('BlueprintEntityType')))), 'Entity types to provision in Phase 0 (before tables). Each entry creates an entity table with membership modules and security.'),
-        addJSDoc(optionalProp('storage', t.tsTypeReference(t.identifier('BlueprintStorageConfig'))), 'App-level storage configuration. Creates a storage_module (membership_type = NULL), seeds initial buckets, and overrides module-level settings (expiry times, file size limits, CORS). Use provisions for per-table policy overrides. For entity-scoped storage, use entity_types[].has_storage + entity_types[].storage instead.')
+        addJSDoc(optionalProp('storage', t.tsTypeReference(t.identifier('BlueprintStorageConfig'))), 'App-level storage configuration. Creates a storage_module (membership_type = NULL), seeds initial buckets, and overrides module-level settings (expiry times, file size limits, CORS). Use provisions for per-table policy overrides. For entity-scoped storage, use entity_types[].has_storage + entity_types[].storage instead.'),
+        addJSDoc(optionalProp('achievements', t.tsArrayType(t.tsTypeReference(t.identifier('BlueprintAchievement')))), 'Achievement definitions. Each entry creates a level with requirements and optional rewards in the events_module. Requires events_module to be provisioned (e.g., via entity_types[].has_levels = true or modules includes events_module).')
     ]), 'The complete blueprint definition -- the JSONB shape accepted by construct_blueprint().');
 }
 // ---------------------------------------------------------------------------
@@ -642,6 +675,9 @@ function buildProgram(meta) {
     statements.push(buildBlueprintTableUniqueConstraint());
     statements.push(buildBlueprintBucketSeed());
     statements.push(buildBlueprintStorageConfig());
+    statements.push(buildBlueprintAchievementRequirement());
+    statements.push(buildBlueprintAchievementReward());
+    statements.push(buildBlueprintAchievement());
     statements.push(buildBlueprintEntityTableProvision());
     statements.push(buildBlueprintEntityType());
     // -- Node types discriminated union --

package/conditions/index.d.ts

@@ -0,0 +1 @@
+export { conditionDefs, conditionProperties, triggerConditionSchema, triggerConditionsProperty } from './trigger-condition';

package/conditions/index.js

@@ -0,0 +1,8 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.triggerConditionsProperty = exports.triggerConditionSchema = exports.conditionProperties = exports.conditionDefs = void 0;
+var trigger_condition_1 = require("./trigger-condition");
+Object.defineProperty(exports, "conditionDefs", { enumerable: true, get: function () { return trigger_condition_1.conditionDefs; } });
+Object.defineProperty(exports, "conditionProperties", { enumerable: true, get: function () { return trigger_condition_1.conditionProperties; } });
+Object.defineProperty(exports, "triggerConditionSchema", { enumerable: true, get: function () { return trigger_condition_1.triggerConditionSchema; } });
+Object.defineProperty(exports, "triggerConditionsProperty", { enumerable: true, get: function () { return trigger_condition_1.triggerConditionsProperty; } });

package/conditions/trigger-condition.d.ts

@@ -0,0 +1,35 @@
+import type { JSONSchema } from '../types';
+/**
+ * Shared trigger condition schema used by any node type that creates
+ * PostgreSQL triggers with conditional WHEN clauses.
+ *
+ * Consumed by: JobTrigger, EventTracker, ProcessExtraction,
+ * ProcessImageVersions, ProcessFileEmbedding, ProcessImageEmbedding.
+ *
+ * On the SQL side, these conditions are compiled to AST via
+ * metaschema_generators.build_condition_ast().
+ */
+export declare const triggerConditionSchema: JSONSchema;
+/**
+ * $defs block for parameter_schema. Spread into any node that uses conditions.
+ *
+ * Usage:
+ *   parameter_schema: { type: 'object', $defs: conditionDefs, properties: { ... } }
+ */
+export declare const conditionDefs: Record<string, JSONSchema>;
+/**
+ * Common condition-related properties for trigger-based nodes.
+ * Three mutually exclusive options for WHEN clause specification.
+ *
+ * Usage:
+ *   properties: { event_name: { ... }, ...conditionProperties }
+ */
+export declare const conditionProperties: Record<string, JSONSchema>;
+/**
+ * Standalone trigger_conditions property for nodes that compose on top of
+ * JobTrigger (Process* nodes). These use trigger_conditions instead of
+ * the full condition_field/conditions/watch_fields trio because the
+ * underlying JobTrigger handles the WHEN clause; this property adds
+ * additional conditions merged via AND.
+ */
+export declare const triggerConditionsProperty: JSONSchema;

package/conditions/trigger-condition.js

@@ -0,0 +1,97 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.triggerConditionsProperty = exports.conditionProperties = exports.conditionDefs = exports.triggerConditionSchema = void 0;
+/**
+ * Shared trigger condition schema used by any node type that creates
+ * PostgreSQL triggers with conditional WHEN clauses.
+ *
+ * Consumed by: JobTrigger, EventTracker, ProcessExtraction,
+ * ProcessImageVersions, ProcessFileEmbedding, ProcessImageEmbedding.
+ *
+ * On the SQL side, these conditions are compiled to AST via
+ * metaschema_generators.build_condition_ast().
+ */
+exports.triggerConditionSchema = {
+    type: 'object',
+    description: 'A leaf condition ({field, op, value?, row?, ref?}) or a combinator ({AND, OR, NOT}).',
+    properties: {
+        field: { type: 'string', format: 'column-ref', description: 'Column name (validated against the table).' },
+        op: {
+            type: 'string',
+            enum: ['=', '!=', '>', '<', '>=', '<=', 'LIKE', 'NOT LIKE', 'IS NULL', 'IS NOT NULL', 'IS DISTINCT FROM'],
+            description: 'Comparison operator.'
+        },
+        value: { description: 'Comparison value. Type is resolved from the column definition. Omit for IS NULL, IS NOT NULL, IS DISTINCT FROM.' },
+        row: { type: 'string', enum: ['NEW', 'OLD'], default: 'NEW', description: 'Row reference (default: NEW).' },
+        ref: {
+            type: 'object',
+            description: 'Column reference for field-to-field comparison (alternative to value).',
+            properties: {
+                field: { type: 'string', format: 'column-ref' },
+                row: { type: 'string', enum: ['NEW', 'OLD'], default: 'NEW' }
+            }
+        },
+        AND: { type: 'array', description: 'Array of conditions combined with AND.', items: { $ref: '#/$defs/triggerCondition' } },
+        OR: { type: 'array', description: 'Array of conditions combined with OR.', items: { $ref: '#/$defs/triggerCondition' } },
+        NOT: { $ref: '#/$defs/triggerCondition', description: 'Negated condition.' }
+    }
+};
+/**
+ * $defs block for parameter_schema. Spread into any node that uses conditions.
+ *
+ * Usage:
+ *   parameter_schema: { type: 'object', $defs: conditionDefs, properties: { ... } }
+ */
+exports.conditionDefs = {
+    triggerCondition: exports.triggerConditionSchema
+};
+/**
+ * Common condition-related properties for trigger-based nodes.
+ * Three mutually exclusive options for WHEN clause specification.
+ *
+ * Usage:
+ *   properties: { event_name: { ... }, ...conditionProperties }
+ */
+exports.conditionProperties = {
+    condition_field: {
+        type: 'string',
+        format: 'column-ref',
+        description: 'Column name for conditional WHEN clause (fires only when field equals condition_value)'
+    },
+    condition_value: {
+        type: 'string',
+        description: 'Value to compare against condition_field in WHEN clause'
+    },
+    conditions: {
+        description: 'Compound conditions for the trigger WHEN clause. Accepts a single leaf condition, an array of conditions (implicitly AND), or a nested combinator tree ({AND: [...], OR: [...], NOT: {...}}). Each leaf is {field, op, value?, row?, ref?}. Column types are resolved automatically from the table schema. Cannot be combined with condition_field or watch_fields.',
+        'x-codegen-type': 'TriggerCondition | TriggerCondition[]',
+        oneOf: [
+            { $ref: '#/$defs/triggerCondition' },
+            { type: 'array', items: { $ref: '#/$defs/triggerCondition' } }
+        ]
+    },
+    watch_fields: {
+        type: 'array',
+        items: {
+            type: 'string',
+            format: 'column-ref'
+        },
+        description: 'For UPDATE triggers, only fire when these fields change (uses DISTINCT FROM)'
+    }
+};
+/**
+ * Standalone trigger_conditions property for nodes that compose on top of
+ * JobTrigger (Process* nodes). These use trigger_conditions instead of
+ * the full condition_field/conditions/watch_fields trio because the
+ * underlying JobTrigger handles the WHEN clause; this property adds
+ * additional conditions merged via AND.
+ */
+exports.triggerConditionsProperty = {
+    description: 'Additional compound conditions beyond auto-generated filtering. ' +
+        'Merged with the auto-generated conditions via AND.',
+    'x-codegen-type': 'TriggerCondition | TriggerCondition[]',
+    oneOf: [
+        { $ref: '#/$defs/triggerCondition' },
+        { type: 'array', items: { $ref: '#/$defs/triggerCondition' } }
+    ]
+};

package/data/data-aggregate-limit-counter.d.ts

@@ -1,2 +1,2 @@
 import type { NodeTypeDefinition } from '../types';
-export declare const LimitAggregate: NodeTypeDefinition;
+export declare const LimitEnforceAggregate: NodeTypeDefinition;

package/data/data-aggregate-limit-counter.js

@@ -1,11 +1,11 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.LimitAggregate = void 0;
-exports.LimitAggregate = {
-    name: 'LimitAggregate',
-    slug: 'data_aggregate_limit_counter',
-    category: 'limit',
-    display_name: 'Aggregate Limit Counter',
+exports.LimitEnforceAggregate = void 0;
+exports.LimitEnforceAggregate = {
+    name: 'LimitEnforceAggregate',
+    slug: 'limit_enforce_aggregate',
+    category: 'limit_enforce',
+    display_name: 'Enforce Aggregate Counter',
     description: 'Declaratively attaches aggregate limit-tracking triggers to a table. On INSERT the named limit is incremented per entity; on DELETE it is decremented. Uses org_limit_aggregates_inc/dec for per-entity (org-level) aggregate limits rather than per-user limits. Requires a provisioned limits_module for the target database.',
     parameter_schema: {
         type: 'object',
@@ -32,5 +32,5 @@ exports.LimitAggregate = {
         },
         required: ['limit_name'],
     },
-    tags: ['limits', 'triggers', 'aggregates', 'billing'],
+    tags: ['limits', 'triggers', 'aggregates', 'enforce'],
 };

package/data/data-billing-meter.d.ts

@@ -1,2 +1,2 @@
 import type { NodeTypeDefinition } from '../types';
-export declare const BillingMeter: NodeTypeDefinition;
+export declare const LimitTrackUsage: NodeTypeDefinition;

package/data/data-billing-meter.js

@@ -1,11 +1,11 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.BillingMeter = void 0;
-exports.BillingMeter = {
-    name: 'BillingMeter',
-    slug: 'data_billing_meter',
-    category: 'billing',
-    display_name: 'Billing Meter',
+exports.LimitTrackUsage = void 0;
+exports.LimitTrackUsage = {
+    name: 'LimitTrackUsage',
+    slug: 'limit_track_usage',
+    category: 'limit_track',
+    display_name: 'Track Usage',
     description: 'Declaratively attaches billing usage-recording triggers to a table. On INSERT the named meter is incremented via record_usage; on DELETE it is decremented (reversal). On UPDATE, if the entity_field changes, the old entity is decremented and the new entity is incremented. Requires a provisioned billing_module for the target database.',
     parameter_schema: {
         type: 'object',
@@ -37,5 +37,5 @@ exports.BillingMeter = {
         },
         required: ['meter_slug'],
     },
-    tags: ['billing', 'triggers', 'metering', 'usage'],
+    tags: ['billing', 'triggers', 'metering', 'usage', 'track'],
 };

package/data/data-chunks.js

@@ -66,6 +66,17 @@ exports.ProcessChunks = {
                 description: 'Distance metric for the HNSW index on chunk embeddings',
                 default: 'cosine'
             },
+            // ── Model config (optional — flows into job payload) ──────────
+            embedding_model: {
+                type: 'string',
+                description: 'Embedding model identifier for per-chunk embeddings. ' +
+                    'When null, the worker falls back to runtime config (llm_module / env vars).'
+            },
+            embedding_provider: {
+                type: 'string',
+                description: 'Embedding provider name (e.g. "ollama", "openai"). ' +
+                    'When null, the worker falls back to runtime config.'
+            },
             // ── Table naming ───────────────────────────────────────────────
             chunks_table_name: {
                 type: 'string',
@@ -77,6 +88,15 @@ exports.ProcessChunks = {
                 items: { type: 'string' },
                 description: 'Field names from the parent table to copy into chunk metadata'
             },
+            // ── Search indexes ───────────────────────────────────────────────
+            search_indexes: {
+                type: 'array',
+                items: { type: 'string', enum: ['fulltext', 'bm25', 'trigram'] },
+                description: 'Text search indexes to create on the chunks content column. ' +
+                    'Enables keyword-based retrieval alongside vector search for ' +
+                    'hybrid RAG workflows.',
+                default: ['fulltext']
+            },
             // ── Job trigger ────────────────────────────────────────────────
             enqueue_chunking_job: {
                 type: 'boolean',

package/data/data-feature-flag.d.ts

@@ -1,2 +1,2 @@
 import type { NodeTypeDefinition } from '../types';
-export declare const LimitFeatureFlag: NodeTypeDefinition;
+export declare const LimitEnforceFeature: NodeTypeDefinition;

package/data/data-feature-flag.js

@@ -1,11 +1,11 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.LimitFeatureFlag = void 0;
-exports.LimitFeatureFlag = {
-    name: 'LimitFeatureFlag',
-    slug: 'data_feature_flag',
-    category: 'limit',
-    display_name: 'Feature Flag',
+exports.LimitEnforceFeature = void 0;
+exports.LimitEnforceFeature = {
+    name: 'LimitEnforceFeature',
+    slug: 'limit_enforce_feature',
+    category: 'limit_enforce',
+    display_name: 'Enforce Feature Flag',
     description: 'Gates a table behind a feature flag backed by the cap tables. Attaches a BEFORE INSERT trigger that checks whether the named feature cap value is > 0. Features are modeled as caps with max=0 (disabled) or max=1 (enabled) in limit_caps / limit_caps_defaults tables. Resolution: COALESCE(per-entity cap, scope default, 0).',
     parameter_schema: {
         type: 'object',
@@ -29,5 +29,5 @@ exports.LimitFeatureFlag = {
         },
         required: ['feature_name'],
     },
-    tags: ['limits', 'triggers', 'feature-flags', 'billing', 'caps'],
+    tags: ['limits', 'triggers', 'feature-flags', 'enforce', 'caps'],
 };

package/data/data-file-embedding.js

@@ -1,6 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.ProcessFileEmbedding = void 0;
+const conditions_1 = require("../conditions");
 exports.ProcessFileEmbedding = {
     name: 'ProcessFileEmbedding',
     slug: 'data_file_embedding',
@@ -15,6 +16,7 @@ exports.ProcessFileEmbedding = {
         'names, and embedding strategies.',
     parameter_schema: {
         type: 'object',
+        $defs: conditions_1.conditionDefs,
         properties: {
             // ── Vector config (passed through to SearchVector) ─────────────
             field_name: {
@@ -45,6 +47,18 @@ exports.ProcessFileEmbedding = {
                 description: 'Index-specific options. HNSW: {m, ef_construction}. IVFFlat: {lists}.',
                 default: {}
             },
+            // ── Model config (optional — flows into job payload) ──────────
+            embedding_model: {
+                type: 'string',
+                description: 'Embedding model identifier (e.g. "nomic-embed-text", "text-embedding-3-small", ' +
+                    '"clip-vit-base-patch32"). Included in the job payload so the worker knows which ' +
+                    'model to use. When null, the worker falls back to runtime config (llm_module / env vars).'
+            },
+            embedding_provider: {
+                type: 'string',
+                description: 'Embedding provider name (e.g. "ollama", "openai"). ' +
+                    'When null, the worker falls back to runtime config.'
+            },
             // ── MIME scoping ───────────────────────────────────────────────
             mime_patterns: {
                 type: 'array',
@@ -77,16 +91,7 @@ exports.ProcessFileEmbedding = {
                     bucket_id: 'bucket_id'
                 }
             },
-            trigger_conditions: {
-                description: 'Additional compound conditions beyond MIME filtering. ' +
-                    'Merged with the auto-generated MIME conditions via AND. ' +
-                    'Use this to add status checks, field guards, etc.',
-                'x-codegen-type': 'TriggerCondition | TriggerCondition[]',
-                oneOf: [
-                    { $ref: '#/$defs/triggerCondition' },
-                    { type: 'array', items: { $ref: '#/$defs/triggerCondition' } }
-                ]
-            },
+            trigger_conditions: conditions_1.triggerConditionsProperty,
             // ── Extraction config (optional — enables extract mode) ────────
             extraction: {
                 type: 'object',
@@ -150,6 +155,13 @@ exports.ProcessFileEmbedding = {
                         items: { type: 'string' },
                         description: 'Field names from parent to copy into chunk metadata'
                     },
+                    search_indexes: {
+                        type: 'array',
+                        items: { type: 'string', enum: ['fulltext', 'bm25', 'trigram'] },
+                        description: 'Text search indexes to create on the chunks content column. ' +
+                            'Enables keyword-based retrieval alongside vector search.',
+                        default: ['fulltext']
+                    },
                     enqueue_chunking_job: {
                         type: 'boolean',
                         description: 'Whether to auto-enqueue a chunking job on insert/update',

package/data/data-image-embedding.js

@@ -1,6 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.ProcessImageEmbedding = void 0;
+const conditions_1 = require("../conditions");
 /**
  * Image-specific preset of ProcessFileEmbedding.
  *
@@ -24,6 +25,7 @@ exports.ProcessImageEmbedding = {
         'Accepts all ProcessFileEmbedding parameters — any overrides are forwarded through.',
     parameter_schema: {
         type: 'object',
+        $defs: conditions_1.conditionDefs,
         properties: {
             // ── Vector config (passed through to ProcessFileEmbedding) ──────────
             field_name: {
@@ -54,6 +56,18 @@ exports.ProcessImageEmbedding = {
                 description: 'Index-specific options. HNSW: {m, ef_construction}. IVFFlat: {lists}.',
                 default: {}
             },
+            // ── Model config (optional — flows into job payload) ──────────
+            embedding_model: {
+                type: 'string',
+                description: 'Embedding model identifier (e.g. "clip-vit-base-patch32"). ' +
+                    'Included in the job payload so the worker knows which model to use. ' +
+                    'When null, the worker falls back to runtime config (llm_module / env vars).'
+            },
+            embedding_provider: {
+                type: 'string',
+                description: 'Embedding provider name (e.g. "ollama", "openai"). ' +
+                    'When null, the worker falls back to runtime config.'
+            },
             // ── MIME scoping ───────────────────────────────────────────────
             mime_patterns: {
                 type: 'array',
@@ -84,15 +98,7 @@ exports.ProcessImageEmbedding = {
                     bucket_id: 'bucket_id'
                 }
             },
-            trigger_conditions: {
-                description: 'Additional compound conditions beyond MIME filtering. ' +
-                    'Merged with the auto-generated MIME conditions via AND.',
-                'x-codegen-type': 'TriggerCondition | TriggerCondition[]',
-                oneOf: [
-                    { $ref: '#/$defs/triggerCondition' },
-                    { type: 'array', items: { $ref: '#/$defs/triggerCondition' } }
-                ]
-            },
+            trigger_conditions: conditions_1.triggerConditionsProperty,
             // ── Extraction config (optional — enables extract mode) ────────
             extraction: {
                 type: 'object',

package/data/data-job-trigger.js

@@ -1,31 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.JobTrigger = void 0;
-const triggerConditionSchema = {
-    type: 'object',
-    description: 'A leaf condition ({field, op, value?, row?, ref?}) or a combinator ({AND, OR, NOT}).',
-    properties: {
-        field: { type: 'string', format: 'column-ref', description: 'Column name (validated against the table).' },
-        op: {
-            type: 'string',
-            enum: ['=', '!=', '>', '<', '>=', '<=', 'LIKE', 'NOT LIKE', 'IS NULL', 'IS NOT NULL', 'IS DISTINCT FROM'],
-            description: 'Comparison operator.'
-        },
-        value: { description: 'Comparison value. Type is resolved from the column definition. Omit for IS NULL, IS NOT NULL, IS DISTINCT FROM.' },
-        row: { type: 'string', enum: ['NEW', 'OLD'], default: 'NEW', description: 'Row reference (default: NEW).' },
-        ref: {
-            type: 'object',
-            description: 'Column reference for field-to-field comparison (alternative to value).',
-            properties: {
-                field: { type: 'string', format: 'column-ref' },
-                row: { type: 'string', enum: ['NEW', 'OLD'], default: 'NEW' }
-            }
-        },
-        AND: { type: 'array', description: 'Array of conditions combined with AND.', items: { $ref: '#/$defs/triggerCondition' } },
-        OR: { type: 'array', description: 'Array of conditions combined with OR.', items: { $ref: '#/$defs/triggerCondition' } },
-        NOT: { $ref: '#/$defs/triggerCondition', description: 'Negated condition.' }
-    }
-};
+const conditions_1 = require("../conditions");
 exports.JobTrigger = {
     name: 'JobTrigger',
     slug: 'data_job_trigger',
@@ -34,9 +10,7 @@ exports.JobTrigger = {
     description: 'Dynamically creates PostgreSQL triggers that enqueue jobs via app_jobs.add_job() when table rows are inserted, updated, or deleted. Supports configurable payload strategies (full row, row ID, selected fields, or custom mapping), conditional firing via WHEN clauses, watched field changes, and extended job options (queue, priority, delay, max attempts).',
     parameter_schema: {
         type: 'object',
-        $defs: {
-            triggerCondition: triggerConditionSchema
-        },
+        $defs: conditions_1.conditionDefs,
         properties: {
             task_identifier: {
                 type: 'string',
@@ -95,31 +69,7 @@ exports.JobTrigger = {
                 description: 'Include table/schema metadata in payload',
                 default: false
             },
-            condition_field: {
-                type: 'string',
-                format: 'column-ref',
-                description: 'Column name for conditional WHEN clause (fires only when field equals condition_value)'
-            },
-            condition_value: {
-                type: 'string',
-                description: 'Value to compare against condition_field in WHEN clause'
-            },
-            conditions: {
-                description: 'Compound conditions for the trigger WHEN clause. Accepts a single leaf condition, an array of conditions (implicitly AND), or a nested combinator tree ({AND: [...], OR: [...], NOT: {...}}). Each leaf is {field, op, value?, row?, ref?}. Column types are resolved automatically from the table schema. Cannot be combined with condition_field or watch_fields.',
-                'x-codegen-type': 'TriggerCondition | TriggerCondition[]',
-                oneOf: [
-                    { $ref: '#/$defs/triggerCondition' },
-                    { type: 'array', items: { $ref: '#/$defs/triggerCondition' } }
-                ]
-            },
-            watch_fields: {
-                type: 'array',
-                items: {
-                    type: 'string',
-                    format: 'column-ref'
-                },
-                description: 'For UPDATE triggers, only fire when these fields change (uses DISTINCT FROM)'
-            },
+            ...conditions_1.conditionProperties,
             job_key: {
                 type: 'string',
                 description: 'Static job key for upsert semantics (prevents duplicate jobs)'

package/data/data-limit-counter.d.ts

@@ -1,2 +1,2 @@
 import type { NodeTypeDefinition } from '../types';
-export declare const LimitCounter: NodeTypeDefinition;
+export declare const LimitEnforceCounter: NodeTypeDefinition;

package/data/data-limit-counter.js

@@ -1,11 +1,11 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.LimitCounter = void 0;
-exports.LimitCounter = {
-    name: 'LimitCounter',
-    slug: 'data_limit_counter',
-    category: 'limit',
-    display_name: 'Limit Counter',
+exports.LimitEnforceCounter = void 0;
+exports.LimitEnforceCounter = {
+    name: 'LimitEnforceCounter',
+    slug: 'limit_enforce_counter',
+    category: 'limit_enforce',
+    display_name: 'Enforce Counter',
     description: 'Declaratively attaches limit-tracking triggers to a table. On INSERT the named limit is incremented; on DELETE it is decremented. Requires a provisioned limits_module for the target scope.',
     parameter_schema: {
         type: 'object',
@@ -38,5 +38,5 @@ exports.LimitCounter = {
         },
         required: ['limit_name'],
     },
-    tags: ['limits', 'triggers', 'billing'],
+    tags: ['limits', 'triggers', 'enforce'],
 };

package/data/data-meter-rate-limit.d.ts

@@ -0,0 +1,2 @@
+import type { NodeTypeDefinition } from '../types';
+export declare const LimitEnforceRate: NodeTypeDefinition;