@ai-matrx/content-ir 0.6.0 → 0.7.0

package/CHANGELOG.md

@@ -1,5 +1,18 @@
 # Changelog
 
+## 0.7.0 — 2026-08-29
+
+- **`kindSchemaFromJsonSchema` — the registry-facing door for deriving a
+  kind's fields from its schema.** One schema in; the kind's `KindSchema` out,
+  plus every child kind the schema declared inline or through `$defs`, plus
+  the conversion problems. Pure and synchronous, so a host can call it from a
+  warm load, a cold fetch, a reducer, or a test. Accepts a bare JSON Schema
+  and the provider `{name, schema, strict}` envelope alike.
+
+  This is what makes a stored second copy of a kind's fields unnecessary. It
+  never returns a partial guess: an inexpressible field widens to `json`, and
+  only a structurally unusable root yields null.
+
 ## 0.6.0 — 2026-08-29
 
 - **`$ref` / `$defs` resolution — a kind's child kinds are no longer invisible

package/dist/index.cjs

@@ -4295,6 +4295,41 @@ function kindSchemaToJsonSchema(kind, resolve, options = {}) {
   return { name: kind, schema: { ...rootNode, $defs: defs }, strict, unresolved };
 }
 
+// convert/json-schema-to-kind.ts
+function kindSchemaFromJsonSchema(kind, jsonSchema) {
+  if (jsonSchema === null || jsonSchema === void 0) {
+    return { schema: null, children: {}, problems: [] };
+  }
+  const normalized = normalizeAiSchemaInput(jsonSchema);
+  const rootSchema = normalized.rootSchema ?? (typeof jsonSchema === "object" && !Array.isArray(jsonSchema) ? jsonSchema : null);
+  if (!rootSchema) {
+    return {
+      schema: null,
+      children: {},
+      problems: [
+        {
+          severity: "error",
+          path: "",
+          message: `Kind "${kind}": emitted_json_schema is not a JSON object.`
+        }
+      ]
+    };
+  }
+  const converted = convertAiSchemaToBlockFields(kind, rootSchema, false);
+  let schema = null;
+  const children = {};
+  for (const draft of converted.blockSchemas) {
+    const asKindSchema = {
+      kind: draft.slug,
+      fields: draft.fields,
+      ...draft.root ? { root: draft.root } : {}
+    };
+    if (draft.slug === kind) schema = asKindSchema;
+    else children[draft.slug] = asKindSchema;
+  }
+  return { schema, children, problems: converted.problems };
+}
+
 // wire/partial-kind.ts
 var IR_PARTIAL_KEY = "__ir_partial";
 var PARTIAL_STATES = [
@@ -4626,6 +4661,7 @@ exports.isJsonAnyField = isJsonAnyField;
 exports.isProvisionalKind = isProvisionalKind;
 exports.isScalarArrayType = isScalarArrayType;
 exports.isTerminalKindEvent = isTerminalKindEvent;
+exports.kindSchemaFromJsonSchema = kindSchemaFromJsonSchema;
 exports.kindSchemaToJsonSchema = kindSchemaToJsonSchema;
 exports.kindSchemaToStorage = kindSchemaToStorage;
 exports.kindVerdictOf = kindVerdictOf;