@ai-matrx/content-ir 0.19.28 → 0.20.0

package/CHANGELOG.md

@@ -1,11 +1,25 @@
 # Changelog
 
+
+## 0.20.0
+
+### `KindDefinition.schemaSource: "table"` + `table` facet (KINDS-GLUE wave 3 slice 4)
+
+- A `table:<uuid>` kind ("a record of that Table") is answered by the host from the Table's live Fields, never a
+  `kind_definition` row. `schemaSource` gains `"table"`; `KindDefinition.table?: TableKindFacet` carries the
+  Table id, organization, name, title field, stamp, field ids, options-table ids and the store's refusal sentence.
+
+### Consumer action
+
+- None required; a host that switches on `schemaSource` exhaustively handles `"table"`.
+
 ## 0.19.28
 
 Automatic changed-only republish (docs/metadata drift since the last tag — see
 `git diff npm/content-ir-core/v0.19.27..npm/content-ir-core/v0.19.28 -- apps/shared/content-ir-core`).
 No source changes intended and no consumer action required.
 
+
 ## 0.19.27
 
 Automatic changed-only republish (docs/metadata drift since the last tag — see

package/dist/index.d.cts

@@ -3,7 +3,7 @@ export { I as IrTree, a as IrTreeNode, J as JsonPath, K as KindStreamEvent, b as
 export { CompleteValueEnvelopeOptions, CompliantKindSnapshot, ContentRegionInit, Fingerprinter, IR_ENVELOPE_CACHE_VERSION, InboundEnvelopeHooks, InboundEnvelopeVerdict, IrEnvelopeCache, JSON_DISCRIMINATOR, JsonStreamTokenizer, JsonToken, KindResolution, NormalizeJsonRegionOptions, Punct, RegionEndReason, RegionFormat, RegionSourceKind, SchemaLayoutMode, buildCompliantKindSnapshot, classifyInboundEnvelopeMetadata, createFingerprinter, emptyValueForFieldSchema, envelopeCacheFromEnvelopes, envelopeFromCompleteValue, fenceDiscriminator, fingerprintText, formatBlockLabel, isCanonicalBlockIR, isIrEnvelopeCache, mergeResidueIntoValue, normalizeJsonRegion, readEnvelope, reconstructRegionValue, reuseEnvelopeIfCurrent, sanitizeInboundEnvelopeMetadata, schemaLayoutMode, schemaStructureDepth, stripKindDeep, xmlDiscriminator } from './core.cjs';
 export { A as ArrayItemScalarType, F as FieldSchema, K as KIND_KEY, a as KindSchema, R as RecordValueType, S as ScalarFieldType, i as isJsonAnyField, b as isScalarArrayType, r as readObjectKind, s as scalarArrayItemType } from './kind-schema.types-CwncWj9U.cjs';
 export { ParseSession, ParseSessionOptions, disposeParseSession, getParseSession, openParseSession } from './session.cjs';
-export { DualGateDefinition, DualGateInput, DualGateResolvedComponent, DualGateResult, Json, KindBlockProps, KindDefinition, KindEdgeSpec, KindStorageError, KindStorageShape, KindTier, KindValidationResult, KindValidator, KindValidatorOptions, LegResult, ROOT_STORAGE_NAME, SchemaSourcePort, SchemaUnavailableReason, StoredFieldElement, createKindValidator, describeDualGateFailure, kindSchemaToStorage, runKindDualGate, storageToKindSchema, validateStructuralLeg } from './registry.cjs';
+export { DualGateDefinition, DualGateInput, DualGateResolvedComponent, DualGateResult, Json, KindBlockProps, KindDefinition, KindEdgeSpec, KindStorageError, KindStorageShape, KindTier, KindValidationResult, KindValidator, KindValidatorOptions, LegResult, ROOT_STORAGE_NAME, SchemaSourcePort, SchemaUnavailableReason, StoredFieldElement, TableKindFacet, createKindValidator, describeDualGateFailure, kindSchemaToStorage, runKindDualGate, storageToKindSchema, validateStructuralLeg } from './registry.cjs';
 export { ArrayItemKindBinding, BlockSchemaDraft, CONTROL_KEYS, CONTROL_KEY_FIELDS, ControlKey, ControlKeysMode, ConversionProblem, DroppedMetadata, FieldComparison, ItemKindRefCheck, JsonSchemaNode, KindJsonSchemaExport, KindJsonSchemaOptions, KindSchemaFromJsonOptions, KindSchemaFromJsonResult, RECORD_DISPOSITION, SavePlanEntry, SavePlanValidation, SchemaConversionResult, WithControlKeysOptions, buildAgentSchemaWithRenderBlockSupport, collectReferencedKinds, collectSchemaReferencedKinds, compareWithExistingKindSchema, controlKeysApplyTo, convertAiSchemaToBlockFields, fieldsToDbPayload, injectKindIntoObjectSchema, isDuplicateBlockSlug, kindSchemaFromJsonSchema, kindSchemaToJsonSchema, normalizeAiSchemaInput, runSchemaConversion, stripControlKeys, validateBlockSchemaSavePlan, withControlKeyFields, withControlKeys } from './convert.cjs';
 export { AnyPartialKindEvent, IR_PARTIAL_KEY, KindVerdict, NODE_OUTCOME_KIND, NodeOutcomeWrapper, PartialKindEvent, PartialKindNode, PartialKindState, RUN_RESULT_KIND, RetractedKindEvent, RunResultWrapper, SupersededKindEvent, advancePartialKind, emitPayloadFence, emitPayloadJson, isProvisionalKind, isTerminalKindEvent, kindVerdictOf, makePartialKindStalenessGate, readNodeOutcomeValue, readOutputRef, readPartialKindEvent, readRunResultValue, rehydrateNodeOutcome, rehydrateRunResult, sanitizeInboundPartialKindMetadata, withRootKind } from './wire.cjs';
 export { ACTION_BY_CLASS, CAPABILITY_BY_CLASS, CLASSES, DIRECTIVE_VERSION, DecodedDirective, DirectiveCapability, DirectiveClass, DirectiveDecodeError, DirectiveDisplay, DirectiveItemKindLookup, DirectiveItemsEdge, DirectiveNounCatalog, DirectiveNounEntry, DirectiveSlug, IN_CONTENT_CLASSES, ItemFact, KindDirectiveShell, RESERVED_PREFIX, SIDE_EFFECT_CLASSES, SLUG_PREFIX, asKindInstance, buildDirectiveSlug, buildKindDirective, capabilityOf, decodeDirective, directiveDisplay, directiveItemKindFromEdges, directiveSlugOf, executesAtOutputRoot, isDirectiveClass, isKindDirective, isLegacyShell, isReservedDirectiveSlug, itemFacts, itemSubtitle, itemTitle, legacyShellUses, looksLikeDirectiveHead, nounFamily, nounLabel, nounTitleColumn, parseDirectiveSlug, resetLegacyShellUses, resolvesInContent, titleCaseToken, tryDecodeDirective, tryDecodeDirectiveContent } from './directives.cjs';

package/dist/index.d.ts

@@ -3,7 +3,7 @@ export { I as IrTree, a as IrTreeNode, J as JsonPath, K as KindStreamEvent, b as
 export { CompleteValueEnvelopeOptions, CompliantKindSnapshot, ContentRegionInit, Fingerprinter, IR_ENVELOPE_CACHE_VERSION, InboundEnvelopeHooks, InboundEnvelopeVerdict, IrEnvelopeCache, JSON_DISCRIMINATOR, JsonStreamTokenizer, JsonToken, KindResolution, NormalizeJsonRegionOptions, Punct, RegionEndReason, RegionFormat, RegionSourceKind, SchemaLayoutMode, buildCompliantKindSnapshot, classifyInboundEnvelopeMetadata, createFingerprinter, emptyValueForFieldSchema, envelopeCacheFromEnvelopes, envelopeFromCompleteValue, fenceDiscriminator, fingerprintText, formatBlockLabel, isCanonicalBlockIR, isIrEnvelopeCache, mergeResidueIntoValue, normalizeJsonRegion, readEnvelope, reconstructRegionValue, reuseEnvelopeIfCurrent, sanitizeInboundEnvelopeMetadata, schemaLayoutMode, schemaStructureDepth, stripKindDeep, xmlDiscriminator } from './core.js';
 export { A as ArrayItemScalarType, F as FieldSchema, K as KIND_KEY, a as KindSchema, R as RecordValueType, S as ScalarFieldType, i as isJsonAnyField, b as isScalarArrayType, r as readObjectKind, s as scalarArrayItemType } from './kind-schema.types-CwncWj9U.js';
 export { ParseSession, ParseSessionOptions, disposeParseSession, getParseSession, openParseSession } from './session.js';
-export { DualGateDefinition, DualGateInput, DualGateResolvedComponent, DualGateResult, Json, KindBlockProps, KindDefinition, KindEdgeSpec, KindStorageError, KindStorageShape, KindTier, KindValidationResult, KindValidator, KindValidatorOptions, LegResult, ROOT_STORAGE_NAME, SchemaSourcePort, SchemaUnavailableReason, StoredFieldElement, createKindValidator, describeDualGateFailure, kindSchemaToStorage, runKindDualGate, storageToKindSchema, validateStructuralLeg } from './registry.js';
+export { DualGateDefinition, DualGateInput, DualGateResolvedComponent, DualGateResult, Json, KindBlockProps, KindDefinition, KindEdgeSpec, KindStorageError, KindStorageShape, KindTier, KindValidationResult, KindValidator, KindValidatorOptions, LegResult, ROOT_STORAGE_NAME, SchemaSourcePort, SchemaUnavailableReason, StoredFieldElement, TableKindFacet, createKindValidator, describeDualGateFailure, kindSchemaToStorage, runKindDualGate, storageToKindSchema, validateStructuralLeg } from './registry.js';
 export { ArrayItemKindBinding, BlockSchemaDraft, CONTROL_KEYS, CONTROL_KEY_FIELDS, ControlKey, ControlKeysMode, ConversionProblem, DroppedMetadata, FieldComparison, ItemKindRefCheck, JsonSchemaNode, KindJsonSchemaExport, KindJsonSchemaOptions, KindSchemaFromJsonOptions, KindSchemaFromJsonResult, RECORD_DISPOSITION, SavePlanEntry, SavePlanValidation, SchemaConversionResult, WithControlKeysOptions, buildAgentSchemaWithRenderBlockSupport, collectReferencedKinds, collectSchemaReferencedKinds, compareWithExistingKindSchema, controlKeysApplyTo, convertAiSchemaToBlockFields, fieldsToDbPayload, injectKindIntoObjectSchema, isDuplicateBlockSlug, kindSchemaFromJsonSchema, kindSchemaToJsonSchema, normalizeAiSchemaInput, runSchemaConversion, stripControlKeys, validateBlockSchemaSavePlan, withControlKeyFields, withControlKeys } from './convert.js';
 export { AnyPartialKindEvent, IR_PARTIAL_KEY, KindVerdict, NODE_OUTCOME_KIND, NodeOutcomeWrapper, PartialKindEvent, PartialKindNode, PartialKindState, RUN_RESULT_KIND, RetractedKindEvent, RunResultWrapper, SupersededKindEvent, advancePartialKind, emitPayloadFence, emitPayloadJson, isProvisionalKind, isTerminalKindEvent, kindVerdictOf, makePartialKindStalenessGate, readNodeOutcomeValue, readOutputRef, readPartialKindEvent, readRunResultValue, rehydrateNodeOutcome, rehydrateRunResult, sanitizeInboundPartialKindMetadata, withRootKind } from './wire.js';
 export { ACTION_BY_CLASS, CAPABILITY_BY_CLASS, CLASSES, DIRECTIVE_VERSION, DecodedDirective, DirectiveCapability, DirectiveClass, DirectiveDecodeError, DirectiveDisplay, DirectiveItemKindLookup, DirectiveItemsEdge, DirectiveNounCatalog, DirectiveNounEntry, DirectiveSlug, IN_CONTENT_CLASSES, ItemFact, KindDirectiveShell, RESERVED_PREFIX, SIDE_EFFECT_CLASSES, SLUG_PREFIX, asKindInstance, buildDirectiveSlug, buildKindDirective, capabilityOf, decodeDirective, directiveDisplay, directiveItemKindFromEdges, directiveSlugOf, executesAtOutputRoot, isDirectiveClass, isKindDirective, isLegacyShell, isReservedDirectiveSlug, itemFacts, itemSubtitle, itemTitle, legacyShellUses, looksLikeDirectiveHead, nounFamily, nounLabel, nounTitleColumn, parseDirectiveSlug, resetLegacyShellUses, resolvesInContent, titleCaseToken, tryDecodeDirective, tryDecodeDirectiveContent } from './directives.js';

package/dist/registry.d.cts

@@ -29,13 +29,37 @@ interface KindBlockProps {
     resolve: (kind: string) => KindSchema | undefined;
 }
 type KindTier = "eager" | "warm" | "cold";
+/**
+ * A TABLE AS A KIND (KINDS-GLUE wave 3 §1.4): what the host learned from the store's
+ * `custom.table_kind_facts` when it answered a `table:<uuid>` kind. `stamp` moves on any Field or
+ * choice change; `optionsTableIds` are the Tables whose records are this Table's choices (a change
+ * there is a change here). `refusal` is the store's own sentence when the person may not open the
+ * Table — the definition still exists so the card can say so instead of loading forever.
+ */
+interface TableKindFacet {
+    tableId: string;
+    organizationId: string | null;
+    name: string | null;
+    titleField: string | null;
+    stamp: string | null;
+    fieldIds: string[];
+    optionsTableIds: string[];
+    refusal?: string | null;
+}
 interface KindDefinition {
     /** Canonical slug — THE key. */
     kind: string;
     /** null until the warm/cold fetch delivers it. */
     schema: KindSchema | null;
-    schemaSource: "system" | "flexible_data" | "content_ir";
+    /**
+     * Where the schema came from. `"table"` (KINDS-GLUE wave 3): the kind is `table:<uuid>` — "a
+     * record of that Table" — and its schema is derived from the Table's live Fields
+     * (`@ai-matrx/records` `tableRenderSchema`), never a `kind_definition` row.
+     */
+    schemaSource: "system" | "flexible_data" | "content_ir" | "table";
     tier: KindTier;
+    /** Present only for `schemaSource: "table"` — the Table the kind is derived from. */
+    table?: TableKindFacet;
     /** Component facet — lazy-loaded renderer for this kind. */
     component?: {
         load: () => Promise<{
@@ -457,4 +481,4 @@ interface KindValidatorOptions {
 /** Build a validator over one host's schema source. */
 declare function createKindValidator(source: SchemaSourcePort, options?: KindValidatorOptions): KindValidator;
 
-export { type DualGateDefinition, type DualGateInput, type DualGateResolvedComponent, type DualGateResult, type Json, type KindBlockProps, type KindDefinition, type KindEdgeSpec, KindStorageError, type KindStorageShape, type KindTier, type KindValidationResult, type KindValidator, type KindValidatorOptions, type LegResult, ROOT_STORAGE_NAME, type SchemaSourcePort, type SchemaUnavailableReason, type StoredFieldElement, createKindValidator, describeDualGateFailure, kindSchemaToStorage, runKindDualGate, storageToKindSchema, validateStructuralLeg };
+export { type DualGateDefinition, type DualGateInput, type DualGateResolvedComponent, type DualGateResult, type Json, type KindBlockProps, type KindDefinition, type KindEdgeSpec, KindStorageError, type KindStorageShape, type KindTier, type KindValidationResult, type KindValidator, type KindValidatorOptions, type LegResult, ROOT_STORAGE_NAME, type SchemaSourcePort, type SchemaUnavailableReason, type StoredFieldElement, type TableKindFacet, createKindValidator, describeDualGateFailure, kindSchemaToStorage, runKindDualGate, storageToKindSchema, validateStructuralLeg };

package/dist/registry.d.ts

@@ -29,13 +29,37 @@ interface KindBlockProps {
     resolve: (kind: string) => KindSchema | undefined;
 }
 type KindTier = "eager" | "warm" | "cold";
+/**
+ * A TABLE AS A KIND (KINDS-GLUE wave 3 §1.4): what the host learned from the store's
+ * `custom.table_kind_facts` when it answered a `table:<uuid>` kind. `stamp` moves on any Field or
+ * choice change; `optionsTableIds` are the Tables whose records are this Table's choices (a change
+ * there is a change here). `refusal` is the store's own sentence when the person may not open the
+ * Table — the definition still exists so the card can say so instead of loading forever.
+ */
+interface TableKindFacet {
+    tableId: string;
+    organizationId: string | null;
+    name: string | null;
+    titleField: string | null;
+    stamp: string | null;
+    fieldIds: string[];
+    optionsTableIds: string[];
+    refusal?: string | null;
+}
 interface KindDefinition {
     /** Canonical slug — THE key. */
     kind: string;
     /** null until the warm/cold fetch delivers it. */
     schema: KindSchema | null;
-    schemaSource: "system" | "flexible_data" | "content_ir";
+    /**
+     * Where the schema came from. `"table"` (KINDS-GLUE wave 3): the kind is `table:<uuid>` — "a
+     * record of that Table" — and its schema is derived from the Table's live Fields
+     * (`@ai-matrx/records` `tableRenderSchema`), never a `kind_definition` row.
+     */
+    schemaSource: "system" | "flexible_data" | "content_ir" | "table";
     tier: KindTier;
+    /** Present only for `schemaSource: "table"` — the Table the kind is derived from. */
+    table?: TableKindFacet;
     /** Component facet — lazy-loaded renderer for this kind. */
     component?: {
         load: () => Promise<{
@@ -457,4 +481,4 @@ interface KindValidatorOptions {
 /** Build a validator over one host's schema source. */
 declare function createKindValidator(source: SchemaSourcePort, options?: KindValidatorOptions): KindValidator;
 
-export { type DualGateDefinition, type DualGateInput, type DualGateResolvedComponent, type DualGateResult, type Json, type KindBlockProps, type KindDefinition, type KindEdgeSpec, KindStorageError, type KindStorageShape, type KindTier, type KindValidationResult, type KindValidator, type KindValidatorOptions, type LegResult, ROOT_STORAGE_NAME, type SchemaSourcePort, type SchemaUnavailableReason, type StoredFieldElement, createKindValidator, describeDualGateFailure, kindSchemaToStorage, runKindDualGate, storageToKindSchema, validateStructuralLeg };
+export { type DualGateDefinition, type DualGateInput, type DualGateResolvedComponent, type DualGateResult, type Json, type KindBlockProps, type KindDefinition, type KindEdgeSpec, KindStorageError, type KindStorageShape, type KindTier, type KindValidationResult, type KindValidator, type KindValidatorOptions, type LegResult, ROOT_STORAGE_NAME, type SchemaSourcePort, type SchemaUnavailableReason, type StoredFieldElement, type TableKindFacet, createKindValidator, describeDualGateFailure, kindSchemaToStorage, runKindDualGate, storageToKindSchema, validateStructuralLeg };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ai-matrx/content-ir",
-  "version": "0.19.28",
+  "version": "0.20.0",
   "description": "The pure AI Matrx Content IR parser, normalized envelope, session, schema conversion, and structural validation kernel.",
   "type": "module",
   "main": "./dist/index.cjs",