node-type-registry 0.41.0 → 0.43.0

package/esm/blueprint-types.generated.js

@@ -14,25 +14,37 @@
 ;
 /**
  * ===========================================================================
- * Billing node type parameters
+ * Check node type parameters
  * ===========================================================================
  */
 ;
 /**
  * ===========================================================================
- * Check node type parameters
+ * Data node type parameters
  * ===========================================================================
  */
 ;
 /**
  * ===========================================================================
- * Data node type parameters
+ * Event node type parameters
+ * ===========================================================================
+ */
+;
+/**
+ * ===========================================================================
+ * Limit_enforce node type parameters
+ * ===========================================================================
+ */
+;
+/**
+ * ===========================================================================
+ * Limit_track node type parameters
  * ===========================================================================
  */
 ;
 /**
  * ===========================================================================
- * Limit node type parameters
+ * Limit_warning node type parameters
  * ===========================================================================
  */
 ;

package/esm/codegen/generate-types.js

@@ -137,6 +137,56 @@ function buildTriggerConditionInterface() {
     ]), 'Recursive condition type for compound trigger WHEN clauses. Leaf conditions specify {field, op, value?, row?, ref?}. Combinators nest via AND, OR, NOT.');
 }
 // ---------------------------------------------------------------------------
+// FieldType — structured PostgreSQL type representation.
+// ---------------------------------------------------------------------------
+function buildFieldTypeInterface() {
+    const argType = t.tsUnionType([
+        t.tsStringKeyword(),
+        t.tsNumberKeyword(),
+        t.tsBooleanKeyword()
+    ]);
+    return addJSDoc(exportInterface('FieldType', [
+        addJSDoc(requiredProp('name', t.tsStringKeyword()), 'Type name. Must be a valid SQL identifier.'),
+        addJSDoc(optionalProp('schema', t.tsStringKeyword()), 'Schema qualifier.'),
+        addJSDoc(optionalProp('args', t.tsArrayType(argType)), 'Type arguments (e.g., [10, 2] for numeric(10,2), ["Point", 4326] for geometry).'),
+        addJSDoc(optionalProp('array_dimensions', t.tsNumberKeyword()), 'Number of array dimensions. 1 = text[], 2 = text[][].'),
+        addJSDoc(optionalProp('range', t.tsArrayType(t.tsStringKeyword())), 'Interval field range. 1-2 elements: ["day"] or ["day", "second"].')
+    ]), 'Structured representation of a PostgreSQL data type. Stored as JSONB in metaschema_public.field.type.');
+}
+// ---------------------------------------------------------------------------
+// FieldDefault — structured PostgreSQL default value expression.
+// ---------------------------------------------------------------------------
+function buildFieldDefaultInterface() {
+    const defaultRef = t.tsTypeReference(t.identifier('FieldDefault'));
+    const fieldTypeRef = t.tsTypeReference(t.identifier('FieldType'));
+    const valueType = t.tsUnionType([
+        t.tsStringKeyword(),
+        t.tsNumberKeyword(),
+        t.tsBooleanKeyword(),
+        t.tsNullKeyword(),
+        t.tsArrayType(t.tsUnknownKeyword()),
+        recordType(t.tsStringKeyword(), t.tsUnknownKeyword())
+    ]);
+    const argType = t.tsUnionType([
+        t.tsStringKeyword(),
+        t.tsNumberKeyword(),
+        t.tsBooleanKeyword(),
+        t.tsNullKeyword(),
+        defaultRef
+    ]);
+    return addJSDoc(exportInterface('FieldDefault', [
+        addJSDoc(optionalProp('value', valueType), 'Literal value (string, number, boolean, null, array, or object).'),
+        addJSDoc(optionalProp('function', t.tsStringKeyword()), 'Function name. Must be a valid SQL identifier.'),
+        addJSDoc(optionalProp('schema', t.tsStringKeyword()), 'Schema qualifier for function.'),
+        addJSDoc(optionalProp('args', t.tsArrayType(argType)), 'Function arguments (recursive).'),
+        addJSDoc(optionalProp('cast', fieldTypeRef), 'Output type cast.'),
+        addJSDoc(optionalProp('operator', t.tsStringKeyword()), 'Binary operator (e.g., "+", "-", "||").'),
+        addJSDoc(optionalProp('left', defaultRef), 'Left operand for operator expression.'),
+        addJSDoc(optionalProp('right', defaultRef), 'Right operand for operator expression.'),
+        addJSDoc(optionalProp('sql_keyword', t.tsStringKeyword()), 'SQL keyword (e.g., "CURRENT_TIMESTAMP", "CURRENT_USER").')
+    ]), 'Structured representation of a PostgreSQL default value expression. Stored as JSONB in metaschema_public.field.default_value.');
+}
+// ---------------------------------------------------------------------------
 // x-codegen-type post-processing — replaces properties that have an
 // 'x-codegen-type' marker in their JSON Schema with a hand-written TS type
 // reference.  This lets node type definitions delegate complex types
@@ -302,11 +352,13 @@ function buildBlueprintField(meta) {
         return deriveInterfaceFromTable(table, 'BlueprintField', 'A custom field (column) to add to a blueprint table. Derived from _meta.');
     }
     // Static fallback
+    const fieldTypeRef = t.tsTypeReference(t.identifier('FieldType'));
+    const fieldDefaultRef = t.tsTypeReference(t.identifier('FieldDefault'));
     return addJSDoc(exportInterface('BlueprintField', [
         addJSDoc(requiredProp('name', t.tsStringKeyword()), 'The column name.'),
-        addJSDoc(requiredProp('type', t.tsStringKeyword()), 'The PostgreSQL type (e.g., "text", "integer", "boolean", "uuid").'),
+        addJSDoc(requiredProp('type', t.tsUnionType([fieldTypeRef, t.tsStringKeyword()])), 'PostgreSQL type as a FieldType object (e.g., { name: "text" }) or legacy string.'),
         addJSDoc(optionalProp('is_required', t.tsBooleanKeyword()), 'Whether the column has a NOT NULL constraint.'),
-        addJSDoc(optionalProp('default_value', t.tsStringKeyword()), 'SQL default value expression (e.g., "true", "now()").'),
+        addJSDoc(optionalProp('default_value', t.tsUnionType([fieldDefaultRef, t.tsStringKeyword()])), 'Default value as a FieldDefault object (e.g., { function: "now" }) or legacy string.'),
         addJSDoc(optionalProp('description', t.tsStringKeyword()), 'Comment/description for this field.')
     ]), 'A custom field (column) to add to a blueprint table.');
 }
@@ -461,7 +513,7 @@ function buildBlueprintTableUniqueConstraint() {
 /**
  * Build the BlueprintBucketSeed interface.
  *
- * Matches the bucket entries in storage_config.buckets[].
+ * Matches the bucket entries in storage.buckets[].
  */
 function buildBlueprintBucketSeed() {
     return addJSDoc(exportInterface('BlueprintBucketSeed', [
@@ -471,12 +523,12 @@ function buildBlueprintBucketSeed() {
         addJSDoc(optionalProp('allowed_mime_types', t.tsArrayType(t.tsStringKeyword())), 'MIME type allowlist (e.g., ["image/png", "image/jpeg"]). NULL means all types allowed.'),
         addJSDoc(optionalProp('max_file_size', t.tsNumberKeyword()), 'Maximum file size in bytes for this bucket. NULL means no limit.'),
         addJSDoc(optionalProp('allowed_origins', t.tsArrayType(t.tsStringKeyword())), 'CORS allowed origins for this bucket.')
-    ]), 'A bucket seed entry for storage_config.buckets[]. Creates an initial bucket row in the {prefix}_buckets table during entity type provisioning. Only used for app-level storage (not entity-scoped).');
+    ]), 'A bucket seed entry for storage.buckets[]. Creates an initial bucket row in the {prefix}_buckets table during entity type provisioning. Only used for app-level storage (not entity-scoped).');
 }
 /**
  * Build the BlueprintStorageConfig interface.
  *
- * Matches the jsonb shape accepted by storage_config on entity_type_provision.
+ * Matches the jsonb shape accepted by storage on entity_type_provision.
  */
 function buildBlueprintStorageConfig() {
     return addJSDoc(exportInterface('BlueprintStorageConfig', [
@@ -529,6 +581,108 @@ function buildBlueprintAchievement() {
         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).');
 }
+// ---------------------------------------------------------------------------
+// Module config types (namespace, function, agent, graph)
+// ---------------------------------------------------------------------------
+/**
+ * Build the BlueprintNamespaceConfig interface.
+ *
+ * Matches the jsonb shape accepted by namespaces on entity_type_provision
+ * and the top-level definition.namespaces[] array in construct_blueprint().
+ */
+function buildBlueprintNamespaceConfig() {
+    return addJSDoc(exportInterface('BlueprintNamespaceConfig', [
+        addJSDoc(optionalProp('scope', t.tsUnionType([
+            t.tsLiteralType(t.stringLiteral('app')),
+            t.tsLiteralType(t.stringLiteral('org'))
+        ])), 'Namespace scope. "app" (default) creates app-level namespaces (membership_type = NULL). "org" creates per-org namespaces. Only used at the top level of a blueprint definition — entity-scoped namespaces inherit scope from the entity type.'),
+        addJSDoc(optionalProp('key', t.tsStringKeyword()), 'Module discriminator for multi-module namespaces. Defaults to "default" (omitted from table names). Non-default keys appear as an infix: {prefix}_{key}_namespaces.'),
+        addJSDoc(optionalProp('policies', t.tsArrayType(t.tsTypeReference(t.identifier('BlueprintPolicy')))), 'RLS policy overrides for the namespaces table. NULL = apply defaults from apply_namespace_security().'),
+        addJSDoc(optionalProp('provisions', t.tsTypeLiteral([
+            optionalProp('namespaces', t.tsTypeReference(t.identifier('BlueprintEntityTableProvision'))),
+            optionalProp('namespace_events', t.tsTypeReference(t.identifier('BlueprintEntityTableProvision')))
+        ])), 'Per-table overrides for namespace tables. Each key targets a specific table (namespaces, namespace_events) and uses the same shape as table_provision: { nodes, fields, grants, use_rls, policies }. Fanned out to secure_table_provision.')
+    ]), 'Namespace module configuration. When used at the top level of a blueprint, the scope field controls whether namespaces are app-level ("app", default) or org-level ("org"). When used inside entity_types[], scope is inherited from the entity type. Provisions a namespaces table with computed-name proxy, rename trigger, and entity-scoped RLS.');
+}
+/**
+ * Build the BlueprintFunctionConfig interface.
+ *
+ * Matches the jsonb shape accepted by functions on entity_type_provision
+ * and the top-level definition.functions[] array in construct_blueprint().
+ */
+function buildBlueprintFunctionConfig() {
+    return addJSDoc(exportInterface('BlueprintFunctionConfig', [
+        addJSDoc(optionalProp('scope', t.tsUnionType([
+            t.tsLiteralType(t.stringLiteral('app')),
+            t.tsLiteralType(t.stringLiteral('org'))
+        ])), 'Function scope. "app" (default) creates app-level functions (membership_type = NULL). "org" creates per-org functions. Only used at the top level of a blueprint definition — entity-scoped functions inherit scope from the entity type.'),
+        addJSDoc(optionalProp('key', t.tsStringKeyword()), 'Module discriminator for multi-module functions. Defaults to "default" (omitted from table names). Non-default keys appear as an infix: {prefix}_{key}_function_definitions.'),
+        addJSDoc(optionalProp('policies', t.tsArrayType(t.tsTypeReference(t.identifier('BlueprintPolicy')))), 'RLS policy overrides for the function tables. NULL = apply defaults from apply_function_security().'),
+        addJSDoc(optionalProp('provisions', t.tsTypeLiteral([
+            optionalProp('definitions', t.tsTypeReference(t.identifier('BlueprintEntityTableProvision'))),
+            optionalProp('invocations', t.tsTypeReference(t.identifier('BlueprintEntityTableProvision'))),
+            optionalProp('execution_logs', t.tsTypeReference(t.identifier('BlueprintEntityTableProvision')))
+        ])), 'Per-table overrides for function tables. Each key targets a specific table (definitions, invocations, execution_logs) and uses the same shape as table_provision: { nodes, fields, grants, use_rls, policies }. Fanned out to secure_table_provision.')
+    ]), 'Function module configuration. When used at the top level of a blueprint, the scope field controls whether functions are app-level ("app", default) or org-level ("org"). When used inside entity_types[], scope is inherited from the entity type. Provisions function_definitions, function_invocations (partitioned, 12-month retention), and function_execution_logs tables.');
+}
+/**
+ * Build the BlueprintAgentConfig interface.
+ *
+ * Matches the jsonb shape accepted by agents on entity_type_provision
+ * and the top-level definition.agents[] array in construct_blueprint().
+ */
+function buildBlueprintAgentConfig() {
+    return addJSDoc(exportInterface('BlueprintAgentConfig', [
+        addJSDoc(optionalProp('scope', t.tsUnionType([
+            t.tsLiteralType(t.stringLiteral('app')),
+            t.tsLiteralType(t.stringLiteral('org'))
+        ])), 'Agent scope. "app" (default) creates app-level agent tables (membership_type = NULL). "org" creates per-org agent tables. Only used at the top level of a blueprint definition — entity-scoped agents inherit scope from the entity type.'),
+        addJSDoc(optionalProp('key', t.tsStringKeyword()), 'Module discriminator for multi-module agents. Defaults to "default" (omitted from table names). Non-default keys appear as an infix: {prefix}_{key}_agent_thread.'),
+        addJSDoc(optionalProp('api_name', t.tsStringKeyword()), 'API name for the agent module. Used in GraphQL naming. Defaults to "agent".'),
+        addJSDoc(optionalProp('has_knowledge', t.tsBooleanKeyword()), 'Whether to provision the agent_knowledge table with vector embeddings, tags, and trigger_phrases. Also inferred when a "knowledge" key is present. Defaults to false.'),
+        addJSDoc(optionalProp('knowledge', t.tsTypeLiteral([
+            optionalProp('has_chunks', t.tsBooleanKeyword()),
+            optionalProp('dimensions', t.tsNumberKeyword()),
+            optionalProp('chunk_size', t.tsNumberKeyword()),
+            optionalProp('chunk_overlap', t.tsNumberKeyword()),
+            optionalProp('chunk_strategy', t.tsUnionType([
+                t.tsLiteralType(t.stringLiteral('fixed')),
+                t.tsLiteralType(t.stringLiteral('sentence')),
+                t.tsLiteralType(t.stringLiteral('paragraph')),
+                t.tsLiteralType(t.stringLiteral('semantic'))
+            ])),
+            optionalProp('embedding_model', t.tsStringKeyword()),
+            optionalProp('embedding_provider', t.tsStringKeyword()),
+            optionalProp('search_indexes', t.tsArrayType(t.tsUnionType([
+                t.tsLiteralType(t.stringLiteral('fulltext')),
+                t.tsLiteralType(t.stringLiteral('bm25')),
+                t.tsLiteralType(t.stringLiteral('trigram'))
+            ])))
+        ])), 'Knowledge configuration overrides. Set has_chunks to false to disable the chunking pipeline. Controls vector dimensions, chunking strategy, embedding model/provider, and text search indexes for the agent_knowledge table. Presence implies has_knowledge = true.'),
+        addJSDoc(optionalProp('policies', t.tsArrayType(t.tsTypeReference(t.identifier('BlueprintPolicy')))), 'RLS policy overrides for the agent tables. NULL = apply defaults from apply_agent_security().'),
+        addJSDoc(optionalProp('provisions', t.tsTypeLiteral([
+            optionalProp('thread', t.tsTypeReference(t.identifier('BlueprintEntityTableProvision'))),
+            optionalProp('message', t.tsTypeReference(t.identifier('BlueprintEntityTableProvision'))),
+            optionalProp('task', t.tsTypeReference(t.identifier('BlueprintEntityTableProvision'))),
+            optionalProp('prompt', t.tsTypeReference(t.identifier('BlueprintEntityTableProvision'))),
+            optionalProp('knowledge', t.tsTypeReference(t.identifier('BlueprintEntityTableProvision')))
+        ])), 'Per-table overrides for agent tables. Each key targets a specific table (thread, message, task, prompt, knowledge) and uses the same shape as table_provision: { nodes, fields, grants, use_rls, policies }. Fanned out to secure_table_provision.')
+    ]), 'Agent module configuration. When used at the top level of a blueprint, the scope field controls whether agents are app-level ("app", default) or org-level ("org"). When used inside entity_types[], scope is inherited from the entity type. Provisions thread, message, task, prompt tables (and optionally knowledge with vector embeddings).');
+}
+/**
+ * Build the BlueprintGraphConfig interface.
+ *
+ * Matches the jsonb shape accepted by graphs on entity_type_provision.
+ * Graph module requires a merkle_store_module_id dependency, so
+ * entity_type_provision only registers permissions. The graph module itself
+ * must be provisioned separately with the merkle store dependency resolved.
+ */
+function buildBlueprintGraphConfig() {
+    return addJSDoc(exportInterface('BlueprintGraphConfig', [
+        addJSDoc(optionalProp('key', t.tsStringKeyword()), 'Module discriminator for multi-module graphs. Defaults to "default".'),
+        addJSDoc(optionalProp('policies', t.tsArrayType(t.tsTypeReference(t.identifier('BlueprintPolicy')))), 'RLS policy overrides for the graph tables. NULL = apply defaults from apply_graph_security().')
+    ]), 'Graph module configuration. Presence triggers permission registration (manage_graphs, execute_graphs). The graph module requires a merkle_store_module_id dependency, so entity_type_provision only registers permissions here — the graph module itself must be provisioned separately.');
+}
 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.'),
@@ -556,7 +710,11 @@ function buildBlueprintEntityType() {
         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.tsArrayType(t.tsTypeReference(t.identifier('BlueprintStorageConfig')))), 'Storage module configuration array. Each entry provisions a separate storage module with its own tables, RLS, and settings. When non-empty, has_storage is derived as true. Each entry may specify a storage_key for multi-module support (defaults to "default").')
+        addJSDoc(optionalProp('storage', t.tsArrayType(t.tsTypeReference(t.identifier('BlueprintStorageConfig')))), 'Storage module configuration array. Presence triggers provisioning (same inference model as namespaces, functions, agents). Each entry provisions a separate storage module with its own tables, RLS, and settings. Each entry may specify a storage_key for multi-module support (defaults to "default").'),
+        addJSDoc(optionalProp('namespaces', t.tsArrayType(t.tsTypeReference(t.identifier('BlueprintNamespaceConfig')))), 'Namespace module configuration array. Presence triggers provisioning. Each entry provisions a namespace_module with its own tables, computed-name proxy, and entity-scoped RLS. Registers manage_namespaces permission bit. "[{}]" = provision one default namespace module.'),
+        addJSDoc(optionalProp('functions', t.tsArrayType(t.tsTypeReference(t.identifier('BlueprintFunctionConfig')))), 'Function module configuration array. Presence triggers provisioning. Each entry provisions function_definitions, function_invocations (partitioned), and function_execution_logs tables. Registers manage_functions + invoke_functions permission bits. "[{}]" = provision one default function module.'),
+        addJSDoc(optionalProp('agents', t.tsArrayType(t.tsTypeReference(t.identifier('BlueprintAgentConfig')))), 'Agent module configuration array. Presence triggers provisioning. Each entry provisions thread, message, task, prompt tables (and optionally knowledge with vector embeddings). "[{}]" = provision one default agent module.'),
+        addJSDoc(optionalProp('graphs', t.tsArrayType(t.tsTypeReference(t.identifier('BlueprintGraphConfig')))), 'Graph module configuration array. Presence triggers permission registration (manage_graphs, execute_graphs). Graph module requires a merkle_store_module_id dependency, so entity_type_provision only registers permissions here. "[{}]" = register default graph permissions.')
     ]), 'An entity type entry for Phase 0 of construct_blueprint(). When name is provided, provisions a new entity type with its own entity table, membership modules, and security policies via entity_type_provision. When name is omitted and only prefix is given, extends an existing entity type (e.g., the built-in "org") with additional capabilities like storage — without creating a new entity type.');
 }
 function buildBlueprintTable() {
@@ -585,7 +743,10 @@ function buildBlueprintDefinition() {
         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.tsArrayType(t.tsTypeReference(t.identifier('BlueprintStorageConfig')))), 'Top-level storage configuration array. Each entry has an optional scope ("app" or "org"). App-scoped (default) creates storage_module with membership_type = NULL. Org-scoped creates per-org/user storage with owner_id and AFTER INSERT bucket seeding. When infra is installed, a private "functions" bucket is auto-injected into org-scoped entries. For child entity type storage, use 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).')
+        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).'),
+        addJSDoc(optionalProp('namespaces', t.tsArrayType(t.tsTypeReference(t.identifier('BlueprintNamespaceConfig')))), 'Top-level namespace configuration array (Phase 0.6). Each entry has an optional scope ("app" or "org"). App-scoped (default) creates namespace_module with membership_type = NULL. Org-scoped creates per-org namespaces. For entity-scoped namespaces, use entity_types[].namespaces instead.'),
+        addJSDoc(optionalProp('functions', t.tsArrayType(t.tsTypeReference(t.identifier('BlueprintFunctionConfig')))), 'Top-level function configuration array (Phase 0.6). Each entry has an optional scope ("app" or "org"). App-scoped (default) creates function_module with membership_type = NULL. Org-scoped creates per-org functions. For entity-scoped functions, use entity_types[].functions instead.'),
+        addJSDoc(optionalProp('agents', t.tsArrayType(t.tsTypeReference(t.identifier('BlueprintAgentConfig')))), 'Top-level agent configuration array (Phase 0.6). Each entry has an optional scope ("app" or "org"). App-scoped (default) creates agent_module with membership_type = NULL. Org-scoped creates per-org agents. For entity-scoped agents, use entity_types[].agents instead.')
     ]), 'The complete blueprint definition -- the JSONB shape accepted by construct_blueprint().');
 }
 // ---------------------------------------------------------------------------
@@ -619,8 +780,10 @@ function buildProgram(meta) {
     // -- Shared recursive types (emitted before parameter interfaces) --
     statements.push(sectionComment('Shared recursive types'));
     statements.push(buildTriggerConditionInterface());
+    statements.push(buildFieldTypeInterface());
+    statements.push(buildFieldDefaultInterface());
     // -- Parameter interfaces grouped by category --
-    const categoryOrder = ['billing', 'check', 'data', 'limit', 'search', 'job', 'process', 'authz', 'relation', 'view'];
+    const categoryOrder = ['billing', 'check', 'data', 'event', 'limit', 'limit_enforce', 'limit_track', 'limit_warning', 'search', 'job', 'process', 'authz', 'relation', 'view'];
     for (const cat of categoryOrder) {
         const nts = categories.get(cat);
         if (!nts || nts.length === 0)
@@ -647,6 +810,10 @@ function buildProgram(meta) {
     statements.push(buildBlueprintAchievementRequirement());
     statements.push(buildBlueprintAchievementReward());
     statements.push(buildBlueprintAchievement());
+    statements.push(buildBlueprintNamespaceConfig());
+    statements.push(buildBlueprintFunctionConfig());
+    statements.push(buildBlueprintAgentConfig());
+    statements.push(buildBlueprintGraphConfig());
     statements.push(buildBlueprintEntityTableProvision());
     statements.push(buildBlueprintEntityType());
     // -- Node types discriminated union --

package/esm/data/check-greater-than.js

@@ -10,21 +10,21 @@ export const CheckGreaterThan = {
             column: {
                 type: 'string',
                 format: 'column-ref',
-                description: 'Single column to compare against value (mutually exclusive with columns)',
+                description: 'Single column to compare against value (mutually exclusive with columns)'
             },
             value: {
                 type: 'number',
                 description: 'Threshold value for single-column comparison (column > value)',
-                default: 0,
+                default: 0
             },
             columns: {
                 type: 'array',
                 items: { type: 'string', format: 'column-ref' },
                 description: 'Two columns for cross-column comparison (columns[0] > columns[1])',
                 minItems: 2,
-                maxItems: 2,
-            },
-        },
+                maxItems: 2
+            }
+        }
     },
-    tags: ['check', 'constraint', 'validation', 'comparison'],
+    tags: ['check', 'constraint', 'validation', 'comparison']
 };

package/esm/data/check-less-than.js

@@ -10,20 +10,20 @@ export const CheckLessThan = {
             column: {
                 type: 'string',
                 format: 'column-ref',
-                description: 'Single column to compare against value (mutually exclusive with columns)',
+                description: 'Single column to compare against value (mutually exclusive with columns)'
             },
             value: {
                 type: 'number',
-                description: 'Threshold value for single-column comparison (column < value)',
+                description: 'Threshold value for single-column comparison (column < value)'
             },
             columns: {
                 type: 'array',
                 items: { type: 'string', format: 'column-ref' },
                 description: 'Two columns for cross-column comparison (columns[0] < columns[1])',
                 minItems: 2,
-                maxItems: 2,
-            },
-        },
+                maxItems: 2
+            }
+        }
     },
-    tags: ['check', 'constraint', 'validation', 'comparison'],
+    tags: ['check', 'constraint', 'validation', 'comparison']
 };

package/esm/data/check-not-equal.js

@@ -12,10 +12,10 @@ export const CheckNotEqual = {
                 items: { type: 'string', format: 'column-ref' },
                 description: 'Two columns that must not be equal',
                 minItems: 2,
-                maxItems: 2,
-            },
+                maxItems: 2
+            }
         },
-        required: ['columns'],
+        required: ['columns']
     },
-    tags: ['check', 'constraint', 'validation', 'inequality'],
+    tags: ['check', 'constraint', 'validation', 'inequality']
 };

package/esm/data/check-one-of.js

@@ -10,15 +10,15 @@ export const CheckOneOf = {
             column: {
                 type: 'string',
                 format: 'column-ref',
-                description: 'Column to validate against the allowed values',
+                description: 'Column to validate against the allowed values'
             },
             values: {
                 type: 'array',
                 items: { type: 'string' },
-                description: 'Array of allowed values for the column',
-            },
+                description: 'Array of allowed values for the column'
+            }
         },
-        required: ['column', 'values'],
+        required: ['column', 'values']
     },
-    tags: ['check', 'constraint', 'validation', 'enum'],
+    tags: ['check', 'constraint', 'validation', 'enum']
 };

package/esm/data/data-jsonb.js

@@ -14,9 +14,10 @@ export const DataJsonb = {
                 default: 'metadata'
             },
             default_value: {
-                type: 'string',
-                description: 'Default value expression',
-                default: "'{}'::jsonb"
+                type: 'object',
+                description: 'Default value as a FieldDefault object',
+                'x-codegen-type': 'FieldDefault',
+                default: { value: {}, cast: { name: 'jsonb' } }
             },
             is_required: {
                 type: 'boolean',

package/esm/data/data-member-owner.d.ts

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

package/esm/data/data-member-owner.js

@@ -0,0 +1,50 @@
+export const DataMemberOwner = {
+    name: 'DataMemberOwner',
+    slug: 'data_member_owner',
+    category: 'data',
+    display_name: 'Member Owner',
+    description: 'Adds owner_id and entity_id columns with a compound AuthzMemberOwner policy. The actor must own the row (owner_id = current_user_id()) AND be a member of the entity (entity_id in SPRT). Use for private data within an entity scope — e.g., personal chat threads that belong to the company but only the author can see.',
+    parameter_schema: {
+        type: 'object',
+        properties: {
+            owner_field_name: {
+                type: 'string',
+                format: 'column-ref',
+                description: 'Column name for the owner reference',
+                default: 'owner_id'
+            },
+            entity_field_name: {
+                type: 'string',
+                format: 'column-ref',
+                description: 'Column name for the entity reference',
+                default: 'entity_id'
+            },
+            include_id: {
+                type: 'boolean',
+                description: 'If true, also adds a UUID primary key column with auto-generation',
+                default: true
+            },
+            include_user_fk: {
+                type: 'boolean',
+                description: 'If true, adds foreign key constraints from owner_id and entity_id to the users table',
+                default: true
+            },
+            create_index: {
+                type: 'boolean',
+                description: 'If true, creates B-tree indexes on the owner and entity columns',
+                default: true
+            },
+            membership_type: {
+                type: 'integer',
+                description: 'Membership type for SPRT resolution. Required for entity-scoped provisioning.',
+                default: null
+            }
+        }
+    },
+    tags: [
+        'ownership',
+        'membership',
+        'security',
+        'schema'
+    ]
+};

package/esm/data/data-status-field.js

@@ -14,9 +14,10 @@ export const DataStatusField = {
                 default: 'status'
             },
             type: {
-                type: 'string',
-                description: 'Column type (text or citext)',
-                default: 'text'
+                type: 'object',
+                description: 'Column type as a FieldType object',
+                'x-codegen-type': 'FieldType',
+                default: { name: 'text' }
             },
             default_value: {
                 type: 'string',

package/esm/data/data-tags.js

@@ -14,9 +14,10 @@ export const DataTags = {
                 default: 'tags'
             },
             default_value: {
-                type: 'string',
-                description: 'Default value expression for the tags column',
-                default: 'ARRAY[]::citext[]'
+                type: 'object',
+                description: 'Default value as a FieldDefault object',
+                'x-codegen-type': 'FieldDefault',
+                default: { value: [], cast: { name: 'citext', array_dimensions: 1 } }
             },
             is_required: {
                 type: 'boolean',

package/esm/data/index.d.ts

@@ -12,6 +12,7 @@ export { DataImmutableFields } from './data-immutable-fields';
 export { DataInflection } from './data-inflection';
 export { DataInheritFromParent } from './data-inherit-from-parent';
 export { DataJsonb } from './data-jsonb';
+export { DataMemberOwner } from './data-member-owner';
 export { DataOwnedFields } from './data-owned-fields';
 export { DataOwnershipInEntity } from './data-ownership-in-entity';
 export { DataPeoplestamps } from './data-peoplestamps';

package/esm/data/index.js

@@ -12,6 +12,7 @@ export { DataImmutableFields } from './data-immutable-fields';
 export { DataInflection } from './data-inflection';
 export { DataInheritFromParent } from './data-inherit-from-parent';
 export { DataJsonb } from './data-jsonb';
+export { DataMemberOwner } from './data-member-owner';
 export { DataOwnedFields } from './data-owned-fields';
 export { DataOwnershipInEntity } from './data-ownership-in-entity';
 export { DataPeoplestamps } from './data-peoplestamps';

package/esm/event/referral.js

@@ -39,7 +39,26 @@ export const EventReferral = {
             entity_field: {
                 type: 'string',
                 format: 'column-ref',
-                description: 'Column containing the entity ID (org/group) for entity-scoped referral events. Omit for user-only events.'
+                description: 'Column containing the entity ID (org/group) for entity-scoped referral events. For FK lookups (e.g., channel_id → channels.entity_id), combine with entity_lookup. Omit for user-only events.'
+            },
+            entity_lookup: {
+                type: 'object',
+                description: 'FK lookup configuration for resolving entity_id through a related table. Used when entity_field is a FK (e.g., channel_id) rather than a direct entity_id. The generator validates all fields against metaschema within the same database_id.',
+                properties: {
+                    obj_table: {
+                        type: 'string',
+                        description: 'Name of the related table to look up entity_id from (e.g., "channels"). Required.'
+                    },
+                    obj_schema: {
+                        type: 'string',
+                        description: 'Schema of the related table (user-facing name, e.g., "public"). Optional — if omitted, resolved by table name within the same database_id (raises error if ambiguous).'
+                    },
+                    obj_field: {
+                        type: 'string',
+                        description: 'Column on the related table that holds the entity_id (e.g., "entity_id"). Required.'
+                    }
+                },
+                required: ['obj_table', 'obj_field']
             },
             max_depth: {
                 type: 'integer',
@@ -49,7 +68,7 @@ export const EventReferral = {
                     'be combined with entity_field.',
                 default: 1,
                 minimum: 1,
-                maximum: 10,
+                maximum: 10
             },
             auto_register_type: {
                 type: 'boolean',

package/esm/event/tracker.js

@@ -49,7 +49,26 @@ export const EventTracker = {
             entity_field: {
                 type: 'string',
                 format: 'column-ref',
-                description: 'Column containing the entity ID (org/group) for entity-scoped events. Omit for user-only events.'
+                description: 'Column containing the entity ID (org/group) for entity-scoped events. For FK lookups (e.g., channel_id → channels.entity_id), combine with entity_lookup. Omit for user-only events.'
+            },
+            entity_lookup: {
+                type: 'object',
+                description: 'FK lookup configuration for resolving entity_id through a related table. Used when entity_field is a FK (e.g., channel_id) rather than a direct entity_id. The generator validates all fields against metaschema within the same database_id.',
+                properties: {
+                    obj_table: {
+                        type: 'string',
+                        description: 'Name of the related table to look up entity_id from (e.g., "channels"). Required.'
+                    },
+                    obj_schema: {
+                        type: 'string',
+                        description: 'Schema of the related table (user-facing name, e.g., "public"). Optional — if omitted, resolved by table name within the same database_id (raises error if ambiguous).'
+                    },
+                    obj_field: {
+                        type: 'string',
+                        description: 'Column on the related table that holds the entity_id (e.g., "entity_id"). Required.'
+                    }
+                },
+                required: ['obj_table', 'obj_field']
             },
             auto_register_type: {
                 type: 'boolean',

package/esm/index.d.ts

@@ -8,7 +8,7 @@ export * from './limit';
 export * from './module-presets';
 export * from './process';
 export * from './relation';
-export type { JSONSchema, NodeTypeDefinition } from './types';
+export type { FieldDefault, FieldDefaultArg, FieldType, JSONSchema, NodeTypeDefinition } from './types';
 export * from './view';
 import type { NodeTypeDefinition } from './types';
 export declare const allNodeTypes: NodeTypeDefinition[];