node-type-registry 0.35.0 → 0.37.0

package/blueprint-types.generated.d.ts

@@ -66,12 +66,14 @@ export interface DataDirectOwnerParams {
     owner_field_name?: string;
     include_id?: boolean;
     include_user_fk?: boolean;
+    create_index?: boolean;
 }
 /** Adds entity reference for organization/group scoping. Enables AuthzEntityMembership, AuthzMembership, AuthzOrgHierarchy authorization. */
 export interface DataEntityMembershipParams {
     entity_field_name?: string;
     include_id?: boolean;
     include_user_fk?: boolean;
+    create_index?: boolean;
 }
 /** BEFORE INSERT trigger that forces a field to the value of jwt_public.current_user_id(). Prevents clients from spoofing the actor/uploader identity. The field value is always overwritten regardless of what the client provides. */
 export interface DataForceCurrentUserParams {
@@ -115,6 +117,7 @@ export interface DataOwnershipInEntityParams {
     entity_field_name?: string;
     include_id?: boolean;
     include_user_fk?: boolean;
+    create_index?: boolean;
 }
 /** Adds user tracking for creates/updates with created_by and updated_by columns. */
 export interface DataPeoplestampsParams {
@@ -122,6 +125,7 @@ export interface DataPeoplestampsParams {
     updated_by_field?: string;
     include_id?: boolean;
     include_user_fk?: boolean;
+    create_index?: boolean;
 }
 /** Adds publish state columns (is_published, published_at) for content visibility. Enables AuthzPublishable and AuthzTemporal authorization. */
 export interface DataPublishableParams {
@@ -136,7 +140,7 @@ export interface DataRealtimeParams {
 }
 /** Auto-generates URL-friendly slugs from field values on insert/update. Attaches BEFORE INSERT and BEFORE UPDATE triggers that call inflection.slugify() on the target field. References fields by name in data jsonb. */
 export interface DataSlugParams {
-    field_name: string;
+    field_name?: string;
     source_field_name?: string;
 }
 /** Adds soft delete support with deleted_at and is_deleted columns. */
@@ -271,6 +275,8 @@ export interface SearchUnifiedParams {
             chunking_task_name?: string;
         };
     };
+    embedding_text_field?: string;
+    composite_format?: 'labeled' | 'plain';
     trgm_fields?: string[];
     search_config?: {
         weights?: {
@@ -824,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. */
@@ -864,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). */
@@ -1136,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-composite-field.js

@@ -13,7 +13,8 @@ exports.DataCompositeField = {
             target: {
                 type: 'string',
                 format: 'column-ref',
-                description: "Name of the derived text field to create (default: 'embedding_text')"
+                description: 'Name of the derived text field to create',
+                default: 'embedding_text'
             },
             source_fields: {
                 type: 'array',
@@ -26,7 +27,8 @@ exports.DataCompositeField = {
             format: {
                 type: 'string',
                 enum: ['labeled', 'plain'],
-                description: "Output format: 'labeled' (field_name: value) or 'plain' (values only). Default: 'labeled'"
+                description: "Output format: 'labeled' (field_name: value) or 'plain' (values only)",
+                default: 'labeled'
             }
         },
         required: [

package/data/data-direct-owner.js

@@ -25,6 +25,11 @@ exports.DataDirectOwner = {
                 type: 'boolean',
                 description: 'If true, adds a foreign key constraint from owner_id to the users table',
                 default: true
+            },
+            create_index: {
+                type: 'boolean',
+                description: 'If true, creates a B-tree index on the owner column',
+                default: true
             }
         }
     },

package/data/data-entity-membership.js

@@ -25,6 +25,11 @@ exports.DataEntityMembership = {
                 type: 'boolean',
                 description: 'If true, adds a foreign key constraint from entity_id to the users table',
                 default: true
+            },
+            create_index: {
+                type: 'boolean',
+                description: 'If true, creates a B-tree index on the entity column',
+                default: true
             }
         }
     },

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',
@@ -121,6 +126,7 @@ exports.ProcessFileEmbedding = {
                 description: 'Chunking configuration passed through to ProcessChunks. When ' +
                     'include_chunks is true (or defaults to true in extract mode), these ' +
                     'params configure the chunks table, embedding dimensions, strategy, etc.',
+                default: {},
                 properties: {
                     content_field_name: {
                         type: 'string',
@@ -149,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',