@ai-matrx/content-ir 0.19.20 → 0.19.25

package/dist/index.cjs

@@ -1274,7 +1274,7 @@ var KindStreamParser = class {
     }
     if (!declaredKind2 && committedKind && this.speculativeKinds.has(pathKey)) {
       this.speculativeKinds.delete(pathKey);
-      this.finalizeSpeculatedObject(path, objectValue, committedKind, at);
+      this.finalizeSpeculatedObject(path, objectValue, committedKind, at, true);
       return;
     }
     if (path.length === 0 && !declaredKind2 && !committedKind && this.rootSurfaceKind) {
@@ -1352,7 +1352,7 @@ var KindStreamParser = class {
     });
   }
   /** Validate + complete an object typed purely by parent prediction. */
-  finalizeSpeculatedObject(path, objectValue, kind, at) {
+  finalizeSpeculatedObject(path, objectValue, kind, at, requireSharedField = false) {
     const schema = this.lookupSchema(kind);
     if (!schema) {
       this.emitRawObject(
@@ -1365,6 +1365,15 @@ var KindStreamParser = class {
       );
       return;
     }
+    if (requireSharedField && !Object.keys(objectValue).some((key) => key in schema.fields)) {
+      this.emitRawObject(
+        path,
+        objectValue,
+        `Object carries none of "${kind}"'s fields.`,
+        at
+      );
+      return;
+    }
     const outcome = this.validateObjectAgainstSchema(
       { ...objectValue, [KIND_KEY]: kind },
       schema
@@ -1625,16 +1634,7 @@ var KindStreamParser = class {
         ...emptyOutcome
       };
     }
-    for (const [fieldName, fieldSchema] of Object.entries(schema.fields)) {
-      if (fieldSchema.required) {
-        if (!(fieldName in objectValue)) {
-          return {
-            error: `Kind "${schema.kind}" is missing required field "${fieldName}".`,
-            ...emptyOutcome
-          };
-        }
-        continue;
-      }
+    for (const fieldName of Object.keys(schema.fields)) {
       if (!(fieldName in objectValue)) {
         optionalMissing.push(fieldName);
       }
@@ -1841,17 +1841,7 @@ var KindStreamParser = class {
   validateObjectAgainstFields(objectValue, fields) {
     const optionalMissing = [];
     const extraFields = [];
-    const emptyOutcome = { optionalMissing, extraFields };
-    for (const [fieldName, fieldSchema] of Object.entries(fields)) {
-      if (fieldSchema.required) {
-        if (!(fieldName in objectValue)) {
-          return {
-            error: `Inline object is missing required field "${fieldName}".`,
-            ...emptyOutcome
-          };
-        }
-        continue;
-      }
+    for (const fieldName of Object.keys(fields)) {
       if (!(fieldName in objectValue)) {
         optionalMissing.push(fieldName);
       }
@@ -3198,13 +3188,13 @@ function makeKindJsonSchemaProperty(kindSlug, strict) {
   return { ...base2, enum: [kindSlug] };
 }
 function injectKindIntoObjectSchema(objectSchema, kindSlug, strict) {
-  const clone = deepClone(objectSchema);
-  const properties = isRecord4(clone.properties) ? { ...clone.properties } : {};
+  const clone2 = deepClone(objectSchema);
+  const properties = isRecord4(clone2.properties) ? { ...clone2.properties } : {};
   properties[KIND_KEY] = makeKindJsonSchemaProperty(kindSlug, strict);
-  const required = Array.isArray(clone.required) ? clone.required.filter((k) => typeof k === "string") : [];
+  const required = Array.isArray(clone2.required) ? clone2.required.filter((k) => typeof k === "string") : [];
   const nextRequired = required.includes(KIND_KEY) ? required : [KIND_KEY, ...required];
   return {
-    ...clone,
+    ...clone2,
     properties,
     required: nextRequired,
     ...strict ? { additionalProperties: false } : {}
@@ -4401,8 +4391,132 @@ function kindSchemaToJsonSchema(kind, resolve, options = {}) {
   return { name: kind, schema: { ...rootNode, $defs: defs }, strict, unresolved };
 }
 
+// convert/control-keys.ts
+var CONTROL_KEYS = ["_replaces", "_new", "_record_id", "_records"];
+var RECORD_DISPOSITION = "record";
+var KIND_KEY2 = "__kind";
+var DOCUMENT_KEYS = /* @__PURE__ */ new Set(["$schema", "$id", "$defs", "definitions", "title", "description"]);
+var CONTROL = new Set(CONTROL_KEYS);
+function controlKeysApplyTo(disposition) {
+  return disposition === RECORD_DISPOSITION;
+}
+function clone(value) {
+  return value === void 0 ? value : JSON.parse(JSON.stringify(value));
+}
+function isObjectSchema(schema) {
+  if (!schema || typeof schema !== "object" || Array.isArray(schema)) return false;
+  const s = schema;
+  return s.type === "object" && !!s.properties && typeof s.properties === "object" && !Array.isArray(s.properties);
+}
+function requiredOf(schema) {
+  return Array.isArray(schema.required) ? schema.required : [];
+}
+function recordObject(schema) {
+  const item = {};
+  for (const [k, v] of Object.entries(schema)) {
+    if (!DOCUMENT_KEYS.has(k)) item[k] = clone(v);
+  }
+  const props = {};
+  for (const [k, v] of Object.entries(item.properties)) {
+    if (k !== KIND_KEY2 && !CONTROL.has(k)) props[k] = v;
+  }
+  item.properties = props;
+  const required = requiredOf(item).filter((k) => k !== KIND_KEY2 && !CONTROL.has(k));
+  if (required.length > 0) item.required = required;
+  else delete item.required;
+  return item;
+}
+function stored(schema) {
+  const out = clone(schema);
+  const item = recordObject(schema);
+  const props = out.properties;
+  props._replaces = { type: ["string", "null"], format: "uuid" };
+  props._new = { type: ["boolean", "null"] };
+  props._record_id = { type: ["string", "null"], format: "uuid" };
+  props._records = { type: ["array", "null"], items: item };
+  const rootRequired = requiredOf(out).filter((k) => !CONTROL.has(k));
+  const lifted = rootRequired.filter((k) => k !== KIND_KEY2);
+  if (lifted.length > 0) {
+    const kept = rootRequired.filter((k) => k === KIND_KEY2);
+    if (kept.length > 0) out.required = kept;
+    else delete out.required;
+    const branch = {
+      if: {
+        anyOf: [
+          { required: ["_record_id"], properties: { _record_id: { type: "string" } } },
+          { required: ["_records"], properties: { _records: { type: "array" } } }
+        ]
+      },
+      else: { required: lifted }
+    };
+    out.allOf = Array.isArray(out.allOf) ? [...out.allOf, branch] : [branch];
+  }
+  return out;
+}
+function authored(schema, many, allowEdit) {
+  const signals = {
+    _replaces: { type: "string", format: "uuid" },
+    _new: { type: "boolean" }
+  };
+  if (allowEdit) signals._record_id = { type: "string", format: "uuid" };
+  if (!many) {
+    const out2 = clone(schema);
+    Object.assign(out2.properties, clone(signals));
+    const required = requiredOf(out2).filter((k) => !CONTROL.has(k));
+    if (required.length > 0 || "required" in out2) out2.required = required;
+    return out2;
+  }
+  const out = {};
+  for (const [k, v] of Object.entries(schema)) {
+    if (DOCUMENT_KEYS.has(k)) out[k] = clone(v);
+  }
+  out.type = "object";
+  const kindProp = schema.properties[KIND_KEY2];
+  const properties = {};
+  if (kindProp !== void 0) properties[KIND_KEY2] = clone(kindProp);
+  properties._records = { type: "array", items: recordObject(schema) };
+  Object.assign(properties, clone(signals));
+  out.properties = properties;
+  out.required = [KIND_KEY2, "_records"].filter((k) => k in properties);
+  out.additionalProperties = false;
+  return out;
+}
+function withControlKeys(schema, options) {
+  const { mode, many = false, allowEdit = false } = options;
+  if (mode !== "stored" && mode !== "authored") {
+    throw new Error(`withControlKeys: mode must be "stored" or "authored", got ${String(mode)}`);
+  }
+  if (!isObjectSchema(schema)) return schema;
+  return mode === "stored" ? stored(schema) : authored(schema, many, allowEdit);
+}
+var CONTROL_KEY_FIELDS = Object.freeze({
+  _replaces: { type: "string", nullable: true },
+  _new: { type: "boolean", nullable: true },
+  _record_id: { type: "string", nullable: true },
+  // A batch's items are records of this kind WITHOUT `__kind`; the render layer reads them
+  // as opaque JSON (never stricter than the store, which validates each item).
+  _records: { type: "json[]", nullable: true }
+});
+function withControlKeyFields(schema) {
+  if (schema.root) return schema;
+  const fields = { ...schema.fields };
+  for (const key of CONTROL_KEYS) {
+    if (!(key in fields)) fields[key] = { ...CONTROL_KEY_FIELDS[key] };
+  }
+  return { ...schema, fields };
+}
+function stripControlKeys(value) {
+  const values = {};
+  const signals = {};
+  for (const [k, v] of Object.entries(value)) {
+    if (CONTROL.has(k)) signals[k] = v;
+    else values[k] = v;
+  }
+  return { values, signals };
+}
+
 // convert/json-schema-to-kind.ts
-function kindSchemaFromJsonSchema(kind, jsonSchema) {
+function kindSchemaFromJsonSchema(kind, jsonSchema, options = {}) {
   if (jsonSchema === null || jsonSchema === void 0) {
     return { schema: null, children: {}, problems: [] };
   }
@@ -4433,6 +4547,9 @@ function kindSchemaFromJsonSchema(kind, jsonSchema) {
     if (draft.slug === kind) schema = asKindSchema;
     else children[draft.slug] = asKindSchema;
   }
+  if (schema && controlKeysApplyTo(options.disposition)) {
+    schema = withControlKeyFields(schema);
+  }
   return { schema, children, problems: converted.problems };
 }
 
@@ -7943,6 +8060,8 @@ exports.BacktickRuns = BacktickRuns;
 exports.CALLOUT_NAMES = CALLOUT_NAMES;
 exports.CAPABILITY_BY_CLASS = CAPABILITY_BY_CLASS;
 exports.CLASSES = CLASSES;
+exports.CONTROL_KEYS = CONTROL_KEYS;
+exports.CONTROL_KEY_FIELDS = CONTROL_KEY_FIELDS;
 exports.DIRECTIVE_VERSION = DIRECTIVE_VERSION;
 exports.DirectiveDecodeError = DirectiveDecodeError;
 exports.FENCE_OPENER_WHITESPACE = FENCE_OPENER_WHITESPACE;
@@ -7962,6 +8081,7 @@ exports.KindStreamParser = KindStreamParser;
 exports.NESTING_FENCE_LANGUAGES = NESTING_FENCE_LANGUAGES;
 exports.NODE_OUTCOME_KIND = NODE_OUTCOME_KIND;
 exports.ParseSession = ParseSession;
+exports.RECORD_DISPOSITION = RECORD_DISPOSITION;
 exports.RESERVED_PREFIX = RESERVED_PREFIX;
 exports.ROOT_STORAGE_NAME = ROOT_STORAGE_NAME;
 exports.RUN_RESULT_KIND = RUN_RESULT_KIND;
@@ -7989,6 +8109,7 @@ exports.collectReferencedKinds = collectReferencedKinds;
 exports.collectSchemaReferencedKinds = collectSchemaReferencedKinds;
 exports.compareWithExistingKindSchema = compareWithExistingKindSchema;
 exports.continuesTable = continuesTable;
+exports.controlKeysApplyTo = controlKeysApplyTo;
 exports.convertAiSchemaToBlockFields = convertAiSchemaToBlockFields;
 exports.createFingerprinter = createFingerprinter;
 exports.createKindStreamParser = createKindStreamParser;
@@ -8075,6 +8196,7 @@ exports.opensTable = opensTable;
 exports.pairDisplayMath = pairDisplayMath;
 exports.parseDirectiveSlug = parseDirectiveSlug;
 exports.parseFenceOpener = parseFenceOpener;
+exports.pendingCodeSpanStart = pendingCodeSpanStart;
 exports.pendingDisplayMathOpener = pendingDisplayMathOpener;
 exports.readEnvelope = readEnvelope;
 exports.readNodeOutcomeValue = readNodeOutcomeValue;
@@ -8107,6 +8229,7 @@ exports.splitsSurrogatePair = splitsSurrogatePair;
 exports.startsHtmlBlock = startsHtmlBlock;
 exports.startsPipelessTable = startsPipelessTable;
 exports.storageToKindSchema = storageToKindSchema;
+exports.stripControlKeys = stripControlKeys;
 exports.stripKindDeep = stripKindDeep;
 exports.tableContainerIndent = tableContainerIndent;
 exports.tableStartsAt = tableStartsAt;
@@ -8120,6 +8243,8 @@ exports.tryDecodeDirectiveContent = tryDecodeDirectiveContent;
 exports.unescapeCellPipes = unescapeCellPipes;
 exports.validateBlockSchemaSavePlan = validateBlockSchemaSavePlan;
 exports.validateStructuralLeg = validateStructuralLeg;
+exports.withControlKeyFields = withControlKeyFields;
+exports.withControlKeys = withControlKeys;
 exports.withRootKind = withRootKind;
 exports.xmlDiscriminator = xmlDiscriminator;
 //# sourceMappingURL=index.cjs.map