@smooai/config 2.0.0

package/dist/schema-spec/smooai-config-schema-spec.js

@@ -0,0 +1,177 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/schema-spec/smooai-config-schema-spec.ts
+var smooai_config_schema_spec_exports = {};
+__export(smooai_config_schema_spec_exports, {
+  validateSmooaiSchema: () => validateSmooaiSchema
+});
+module.exports = __toCommonJS(smooai_config_schema_spec_exports);
+var SUPPORTED_KEYWORDS = /* @__PURE__ */ new Set([
+  // Core
+  "type",
+  "properties",
+  "required",
+  "enum",
+  "const",
+  "default",
+  // Metadata
+  "title",
+  "description",
+  "$schema",
+  // String
+  "minLength",
+  "maxLength",
+  "pattern",
+  "format",
+  // Numeric
+  "minimum",
+  "maximum",
+  "exclusiveMinimum",
+  "exclusiveMaximum",
+  "multipleOf",
+  // Array
+  "items",
+  "minItems",
+  "maxItems",
+  "uniqueItems",
+  // Object
+  "additionalProperties",
+  // Composition
+  "anyOf",
+  "oneOf",
+  "allOf",
+  // References
+  "$ref",
+  "$defs",
+  "definitions"
+]);
+var REJECTED_KEYWORDS = {
+  if: {
+    message: "Conditional schemas (if/then/else) are not supported across all SDK languages.",
+    suggestion: 'Use "oneOf" or "anyOf" with discriminator properties instead.'
+  },
+  then: {
+    message: "Conditional schemas (if/then/else) are not supported across all SDK languages.",
+    suggestion: 'Use "oneOf" or "anyOf" with discriminator properties instead.'
+  },
+  else: {
+    message: "Conditional schemas (if/then/else) are not supported across all SDK languages.",
+    suggestion: 'Use "oneOf" or "anyOf" with discriminator properties instead.'
+  },
+  patternProperties: {
+    message: '"patternProperties" is not supported across all SDK languages.',
+    suggestion: 'Use explicit "properties" with known key names, or "additionalProperties" with a type constraint.'
+  },
+  propertyNames: {
+    message: '"propertyNames" is not supported across all SDK languages.',
+    suggestion: "Validate property names in application code instead."
+  },
+  dependencies: {
+    message: '"dependencies" is not supported across all SDK languages.',
+    suggestion: 'Use "required" within "oneOf"/"anyOf" variants to express conditional requirements.'
+  },
+  contains: {
+    message: '"contains" is not supported across all SDK languages.',
+    suggestion: 'Use "items" with a union type ("anyOf") instead.'
+  },
+  not: {
+    message: '"not" is not supported across all SDK languages.',
+    suggestion: 'Express the constraint positively using "enum", "oneOf", or validation in application code.'
+  },
+  prefixItems: {
+    message: '"prefixItems" (tuple validation) is not supported across all SDK languages.',
+    suggestion: 'Use an "object" with named fields instead of a positional tuple.'
+  },
+  unevaluatedProperties: {
+    message: '"unevaluatedProperties" is not supported across all SDK languages.',
+    suggestion: 'Use "additionalProperties" instead.'
+  },
+  unevaluatedItems: {
+    message: '"unevaluatedItems" is not supported across all SDK languages.',
+    suggestion: 'Use "items" with a specific schema instead.'
+  }
+};
+var SUPPORTED_FORMATS = /* @__PURE__ */ new Set(["email", "uri", "uuid", "date-time", "ipv4", "ipv6"]);
+function validateSmooaiSchema(schema) {
+  const errors = [];
+  walkSchema(schema, "", errors);
+  return { valid: errors.length === 0, errors };
+}
+function walkSchema(node, path, errors) {
+  if (typeof node !== "object" || node === null || Array.isArray(node)) {
+    return;
+  }
+  const obj = node;
+  for (const key of Object.keys(obj)) {
+    if (key in REJECTED_KEYWORDS) {
+      const info = REJECTED_KEYWORDS[key];
+      errors.push({
+        path: path || "/",
+        keyword: key,
+        message: info.message,
+        suggestion: info.suggestion
+      });
+      continue;
+    }
+    if (SUPPORTED_KEYWORDS.has(key)) {
+      if (key === "format" && typeof obj[key] === "string" && !SUPPORTED_FORMATS.has(obj[key])) {
+        errors.push({
+          path: path || "/",
+          keyword: "format",
+          message: `Format "${obj[key]}" is not supported across all SDK languages.`,
+          suggestion: `Supported formats: ${[...SUPPORTED_FORMATS].join(", ")}. Use "pattern" for custom string validation.`
+        });
+      }
+      continue;
+    }
+  }
+  if (obj.properties && typeof obj.properties === "object") {
+    const props = obj.properties;
+    for (const [propName, propSchema] of Object.entries(props)) {
+      walkSchema(propSchema, `${path}/properties/${propName}`, errors);
+    }
+  }
+  if (obj.items && typeof obj.items === "object") {
+    walkSchema(obj.items, `${path}/items`, errors);
+  }
+  if (obj.additionalProperties && typeof obj.additionalProperties === "object") {
+    walkSchema(obj.additionalProperties, `${path}/additionalProperties`, errors);
+  }
+  for (const compKey of ["anyOf", "oneOf", "allOf"]) {
+    if (Array.isArray(obj[compKey])) {
+      obj[compKey].forEach((subSchema, i) => {
+        walkSchema(subSchema, `${path}/${compKey}/${i}`, errors);
+      });
+    }
+  }
+  for (const defsKey of ["$defs", "definitions"]) {
+    if (obj[defsKey] && typeof obj[defsKey] === "object") {
+      const defs = obj[defsKey];
+      for (const [defName, defSchema] of Object.entries(defs)) {
+        walkSchema(defSchema, `${path}/${defsKey}/${defName}`, errors);
+      }
+    }
+  }
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  validateSmooaiSchema
+});
+//# sourceMappingURL=smooai-config-schema-spec.js.map

package/dist/schema-spec/smooai-config-schema-spec.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/schema-spec/smooai-config-schema-spec.ts"],"sourcesContent":["/**\n * Cross-language JSON Schema validation for the Smoo AI config SDK.\n *\n * Validates that a JSON Schema uses only the subset of keywords that all\n * four language SDKs (TypeScript, Python, Rust, Go) can reliably support.\n */\n\nexport interface SchemaValidationError {\n    path: string;\n    keyword: string;\n    message: string;\n    suggestion: string;\n}\n\nexport interface SchemaValidationResult {\n    valid: boolean;\n    errors: SchemaValidationError[];\n}\n\n/** Keywords supported across all four SDK languages. */\nconst SUPPORTED_KEYWORDS = new Set([\n    // Core\n    'type',\n    'properties',\n    'required',\n    'enum',\n    'const',\n    'default',\n    // Metadata\n    'title',\n    'description',\n    '$schema',\n    // String\n    'minLength',\n    'maxLength',\n    'pattern',\n    'format',\n    // Numeric\n    'minimum',\n    'maximum',\n    'exclusiveMinimum',\n    'exclusiveMaximum',\n    'multipleOf',\n    // Array\n    'items',\n    'minItems',\n    'maxItems',\n    'uniqueItems',\n    // Object\n    'additionalProperties',\n    // Composition\n    'anyOf',\n    'oneOf',\n    'allOf',\n    // References\n    '$ref',\n    '$defs',\n    'definitions',\n]);\n\n/** Keywords explicitly rejected with actionable error messages. */\nconst REJECTED_KEYWORDS: Record<string, { message: string; suggestion: string }> = {\n    if: {\n        message: 'Conditional schemas (if/then/else) are not supported across all SDK languages.',\n        suggestion: 'Use \"oneOf\" or \"anyOf\" with discriminator properties instead.',\n    },\n    then: {\n        message: 'Conditional schemas (if/then/else) are not supported across all SDK languages.',\n        suggestion: 'Use \"oneOf\" or \"anyOf\" with discriminator properties instead.',\n    },\n    else: {\n        message: 'Conditional schemas (if/then/else) are not supported across all SDK languages.',\n        suggestion: 'Use \"oneOf\" or \"anyOf\" with discriminator properties instead.',\n    },\n    patternProperties: {\n        message: '\"patternProperties\" is not supported across all SDK languages.',\n        suggestion: 'Use explicit \"properties\" with known key names, or \"additionalProperties\" with a type constraint.',\n    },\n    propertyNames: {\n        message: '\"propertyNames\" is not supported across all SDK languages.',\n        suggestion: 'Validate property names in application code instead.',\n    },\n    dependencies: {\n        message: '\"dependencies\" is not supported across all SDK languages.',\n        suggestion: 'Use \"required\" within \"oneOf\"/\"anyOf\" variants to express conditional requirements.',\n    },\n    contains: {\n        message: '\"contains\" is not supported across all SDK languages.',\n        suggestion: 'Use \"items\" with a union type (\"anyOf\") instead.',\n    },\n    not: {\n        message: '\"not\" is not supported across all SDK languages.',\n        suggestion: 'Express the constraint positively using \"enum\", \"oneOf\", or validation in application code.',\n    },\n    prefixItems: {\n        message: '\"prefixItems\" (tuple validation) is not supported across all SDK languages.',\n        suggestion: 'Use an \"object\" with named fields instead of a positional tuple.',\n    },\n    unevaluatedProperties: {\n        message: '\"unevaluatedProperties\" is not supported across all SDK languages.',\n        suggestion: 'Use \"additionalProperties\" instead.',\n    },\n    unevaluatedItems: {\n        message: '\"unevaluatedItems\" is not supported across all SDK languages.',\n        suggestion: 'Use \"items\" with a specific schema instead.',\n    },\n};\n\n/** Formats supported across all four SDKs. */\nconst SUPPORTED_FORMATS = new Set(['email', 'uri', 'uuid', 'date-time', 'ipv4', 'ipv6']);\n\n/**\n * Validate that a JSON Schema uses only the cross-language-compatible subset.\n *\n * Walks the schema tree and reports unsupported keywords with actionable\n * error messages and suggestions for compatible alternatives.\n */\nexport function validateSmooaiSchema(schema: Record<string, unknown>): SchemaValidationResult {\n    const errors: SchemaValidationError[] = [];\n    walkSchema(schema, '', errors);\n    return { valid: errors.length === 0, errors };\n}\n\nfunction walkSchema(node: unknown, path: string, errors: SchemaValidationError[]): void {\n    if (typeof node !== 'object' || node === null || Array.isArray(node)) {\n        return;\n    }\n\n    const obj = node as Record<string, unknown>;\n\n    for (const key of Object.keys(obj)) {\n        // Check for rejected keywords first (specific error messages)\n        if (key in REJECTED_KEYWORDS) {\n            const info = REJECTED_KEYWORDS[key];\n            errors.push({\n                path: path || '/',\n                keyword: key,\n                message: info.message,\n                suggestion: info.suggestion,\n            });\n            continue;\n        }\n\n        // Skip known supported keywords — they're fine\n        if (SUPPORTED_KEYWORDS.has(key)) {\n            // Validate format values\n            if (key === 'format' && typeof obj[key] === 'string' && !SUPPORTED_FORMATS.has(obj[key] as string)) {\n                errors.push({\n                    path: path || '/',\n                    keyword: 'format',\n                    message: `Format \"${obj[key]}\" is not supported across all SDK languages.`,\n                    suggestion: `Supported formats: ${[...SUPPORTED_FORMATS].join(', ')}. Use \"pattern\" for custom string validation.`,\n                });\n            }\n            continue;\n        }\n\n        // Unknown keywords that aren't standard JSON Schema — ignore\n        // (could be vendor extensions like x-*, or $id, etc.)\n    }\n\n    // Recurse into sub-schemas\n    if (obj.properties && typeof obj.properties === 'object') {\n        const props = obj.properties as Record<string, unknown>;\n        for (const [propName, propSchema] of Object.entries(props)) {\n            walkSchema(propSchema, `${path}/properties/${propName}`, errors);\n        }\n    }\n\n    if (obj.items && typeof obj.items === 'object') {\n        walkSchema(obj.items, `${path}/items`, errors);\n    }\n\n    if (obj.additionalProperties && typeof obj.additionalProperties === 'object') {\n        walkSchema(obj.additionalProperties, `${path}/additionalProperties`, errors);\n    }\n\n    // Composition keywords\n    for (const compKey of ['anyOf', 'oneOf', 'allOf'] as const) {\n        if (Array.isArray(obj[compKey])) {\n            (obj[compKey] as unknown[]).forEach((subSchema, i) => {\n                walkSchema(subSchema, `${path}/${compKey}/${i}`, errors);\n            });\n        }\n    }\n\n    // $defs / definitions\n    for (const defsKey of ['$defs', 'definitions'] as const) {\n        if (obj[defsKey] && typeof obj[defsKey] === 'object') {\n            const defs = obj[defsKey] as Record<string, unknown>;\n            for (const [defName, defSchema] of Object.entries(defs)) {\n                walkSchema(defSchema, `${path}/${defsKey}/${defName}`, errors);\n            }\n        }\n    }\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAoBA,IAAM,qBAAqB,oBAAI,IAAI;AAAA;AAAA,EAE/B;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA;AAAA,EAEA;AAAA,EACA;AAAA,EACA;AAAA;AAAA,EAEA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA;AAAA,EAEA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA;AAAA,EAEA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA;AAAA,EAEA;AAAA;AAAA,EAEA;AAAA,EACA;AAAA,EACA;AAAA;AAAA,EAEA;AAAA,EACA;AAAA,EACA;AACJ,CAAC;AAGD,IAAM,oBAA6E;AAAA,EAC/E,IAAI;AAAA,IACA,SAAS;AAAA,IACT,YAAY;AAAA,EAChB;AAAA,EACA,MAAM;AAAA,IACF,SAAS;AAAA,IACT,YAAY;AAAA,EAChB;AAAA,EACA,MAAM;AAAA,IACF,SAAS;AAAA,IACT,YAAY;AAAA,EAChB;AAAA,EACA,mBAAmB;AAAA,IACf,SAAS;AAAA,IACT,YAAY;AAAA,EAChB;AAAA,EACA,eAAe;AAAA,IACX,SAAS;AAAA,IACT,YAAY;AAAA,EAChB;AAAA,EACA,cAAc;AAAA,IACV,SAAS;AAAA,IACT,YAAY;AAAA,EAChB;AAAA,EACA,UAAU;AAAA,IACN,SAAS;AAAA,IACT,YAAY;AAAA,EAChB;AAAA,EACA,KAAK;AAAA,IACD,SAAS;AAAA,IACT,YAAY;AAAA,EAChB;AAAA,EACA,aAAa;AAAA,IACT,SAAS;AAAA,IACT,YAAY;AAAA,EAChB;AAAA,EACA,uBAAuB;AAAA,IACnB,SAAS;AAAA,IACT,YAAY;AAAA,EAChB;AAAA,EACA,kBAAkB;AAAA,IACd,SAAS;AAAA,IACT,YAAY;AAAA,EAChB;AACJ;AAGA,IAAM,oBAAoB,oBAAI,IAAI,CAAC,SAAS,OAAO,QAAQ,aAAa,QAAQ,MAAM,CAAC;AAQhF,SAAS,qBAAqB,QAAyD;AAC1F,QAAM,SAAkC,CAAC;AACzC,aAAW,QAAQ,IAAI,MAAM;AAC7B,SAAO,EAAE,OAAO,OAAO,WAAW,GAAG,OAAO;AAChD;AAEA,SAAS,WAAW,MAAe,MAAc,QAAuC;AACpF,MAAI,OAAO,SAAS,YAAY,SAAS,QAAQ,MAAM,QAAQ,IAAI,GAAG;AAClE;AAAA,EACJ;AAEA,QAAM,MAAM;AAEZ,aAAW,OAAO,OAAO,KAAK,GAAG,GAAG;AAEhC,QAAI,OAAO,mBAAmB;AAC1B,YAAM,OAAO,kBAAkB,GAAG;AAClC,aAAO,KAAK;AAAA,QACR,MAAM,QAAQ;AAAA,QACd,SAAS;AAAA,QACT,SAAS,KAAK;AAAA,QACd,YAAY,KAAK;AAAA,MACrB,CAAC;AACD;AAAA,IACJ;AAGA,QAAI,mBAAmB,IAAI,GAAG,GAAG;AAE7B,UAAI,QAAQ,YAAY,OAAO,IAAI,GAAG,MAAM,YAAY,CAAC,kBAAkB,IAAI,IAAI,GAAG,CAAW,GAAG;AAChG,eAAO,KAAK;AAAA,UACR,MAAM,QAAQ;AAAA,UACd,SAAS;AAAA,UACT,SAAS,WAAW,IAAI,GAAG,CAAC;AAAA,UAC5B,YAAY,sBAAsB,CAAC,GAAG,iBAAiB,EAAE,KAAK,IAAI,CAAC;AAAA,QACvE,CAAC;AAAA,MACL;AACA;AAAA,IACJ;AAAA,EAIJ;AAGA,MAAI,IAAI,cAAc,OAAO,IAAI,eAAe,UAAU;AACtD,UAAM,QAAQ,IAAI;AAClB,eAAW,CAAC,UAAU,UAAU,KAAK,OAAO,QAAQ,KAAK,GAAG;AACxD,iBAAW,YAAY,GAAG,IAAI,eAAe,QAAQ,IAAI,MAAM;AAAA,IACnE;AAAA,EACJ;AAEA,MAAI,IAAI,SAAS,OAAO,IAAI,UAAU,UAAU;AAC5C,eAAW,IAAI,OAAO,GAAG,IAAI,UAAU,MAAM;AAAA,EACjD;AAEA,MAAI,IAAI,wBAAwB,OAAO,IAAI,yBAAyB,UAAU;AAC1E,eAAW,IAAI,sBAAsB,GAAG,IAAI,yBAAyB,MAAM;AAAA,EAC/E;AAGA,aAAW,WAAW,CAAC,SAAS,SAAS,OAAO,GAAY;AACxD,QAAI,MAAM,QAAQ,IAAI,OAAO,CAAC,GAAG;AAC7B,MAAC,IAAI,OAAO,EAAgB,QAAQ,CAAC,WAAW,MAAM;AAClD,mBAAW,WAAW,GAAG,IAAI,IAAI,OAAO,IAAI,CAAC,IAAI,MAAM;AAAA,MAC3D,CAAC;AAAA,IACL;AAAA,EACJ;AAGA,aAAW,WAAW,CAAC,SAAS,aAAa,GAAY;AACrD,QAAI,IAAI,OAAO,KAAK,OAAO,IAAI,OAAO,MAAM,UAAU;AAClD,YAAM,OAAO,IAAI,OAAO;AACxB,iBAAW,CAAC,SAAS,SAAS,KAAK,OAAO,QAAQ,IAAI,GAAG;AACrD,mBAAW,WAAW,GAAG,IAAI,IAAI,OAAO,IAAI,OAAO,IAAI,MAAM;AAAA,MACjE;AAAA,IACJ;AAAA,EACJ;AACJ;","names":[]}

package/dist/schema-spec/smooai-config-schema-spec.mjs

@@ -0,0 +1,154 @@
+import "../chunk-J5LGTIGS.mjs";
+
+// src/schema-spec/smooai-config-schema-spec.ts
+var SUPPORTED_KEYWORDS = /* @__PURE__ */ new Set([
+  // Core
+  "type",
+  "properties",
+  "required",
+  "enum",
+  "const",
+  "default",
+  // Metadata
+  "title",
+  "description",
+  "$schema",
+  // String
+  "minLength",
+  "maxLength",
+  "pattern",
+  "format",
+  // Numeric
+  "minimum",
+  "maximum",
+  "exclusiveMinimum",
+  "exclusiveMaximum",
+  "multipleOf",
+  // Array
+  "items",
+  "minItems",
+  "maxItems",
+  "uniqueItems",
+  // Object
+  "additionalProperties",
+  // Composition
+  "anyOf",
+  "oneOf",
+  "allOf",
+  // References
+  "$ref",
+  "$defs",
+  "definitions"
+]);
+var REJECTED_KEYWORDS = {
+  if: {
+    message: "Conditional schemas (if/then/else) are not supported across all SDK languages.",
+    suggestion: 'Use "oneOf" or "anyOf" with discriminator properties instead.'
+  },
+  then: {
+    message: "Conditional schemas (if/then/else) are not supported across all SDK languages.",
+    suggestion: 'Use "oneOf" or "anyOf" with discriminator properties instead.'
+  },
+  else: {
+    message: "Conditional schemas (if/then/else) are not supported across all SDK languages.",
+    suggestion: 'Use "oneOf" or "anyOf" with discriminator properties instead.'
+  },
+  patternProperties: {
+    message: '"patternProperties" is not supported across all SDK languages.',
+    suggestion: 'Use explicit "properties" with known key names, or "additionalProperties" with a type constraint.'
+  },
+  propertyNames: {
+    message: '"propertyNames" is not supported across all SDK languages.',
+    suggestion: "Validate property names in application code instead."
+  },
+  dependencies: {
+    message: '"dependencies" is not supported across all SDK languages.',
+    suggestion: 'Use "required" within "oneOf"/"anyOf" variants to express conditional requirements.'
+  },
+  contains: {
+    message: '"contains" is not supported across all SDK languages.',
+    suggestion: 'Use "items" with a union type ("anyOf") instead.'
+  },
+  not: {
+    message: '"not" is not supported across all SDK languages.',
+    suggestion: 'Express the constraint positively using "enum", "oneOf", or validation in application code.'
+  },
+  prefixItems: {
+    message: '"prefixItems" (tuple validation) is not supported across all SDK languages.',
+    suggestion: 'Use an "object" with named fields instead of a positional tuple.'
+  },
+  unevaluatedProperties: {
+    message: '"unevaluatedProperties" is not supported across all SDK languages.',
+    suggestion: 'Use "additionalProperties" instead.'
+  },
+  unevaluatedItems: {
+    message: '"unevaluatedItems" is not supported across all SDK languages.',
+    suggestion: 'Use "items" with a specific schema instead.'
+  }
+};
+var SUPPORTED_FORMATS = /* @__PURE__ */ new Set(["email", "uri", "uuid", "date-time", "ipv4", "ipv6"]);
+function validateSmooaiSchema(schema) {
+  const errors = [];
+  walkSchema(schema, "", errors);
+  return { valid: errors.length === 0, errors };
+}
+function walkSchema(node, path, errors) {
+  if (typeof node !== "object" || node === null || Array.isArray(node)) {
+    return;
+  }
+  const obj = node;
+  for (const key of Object.keys(obj)) {
+    if (key in REJECTED_KEYWORDS) {
+      const info = REJECTED_KEYWORDS[key];
+      errors.push({
+        path: path || "/",
+        keyword: key,
+        message: info.message,
+        suggestion: info.suggestion
+      });
+      continue;
+    }
+    if (SUPPORTED_KEYWORDS.has(key)) {
+      if (key === "format" && typeof obj[key] === "string" && !SUPPORTED_FORMATS.has(obj[key])) {
+        errors.push({
+          path: path || "/",
+          keyword: "format",
+          message: `Format "${obj[key]}" is not supported across all SDK languages.`,
+          suggestion: `Supported formats: ${[...SUPPORTED_FORMATS].join(", ")}. Use "pattern" for custom string validation.`
+        });
+      }
+      continue;
+    }
+  }
+  if (obj.properties && typeof obj.properties === "object") {
+    const props = obj.properties;
+    for (const [propName, propSchema] of Object.entries(props)) {
+      walkSchema(propSchema, `${path}/properties/${propName}`, errors);
+    }
+  }
+  if (obj.items && typeof obj.items === "object") {
+    walkSchema(obj.items, `${path}/items`, errors);
+  }
+  if (obj.additionalProperties && typeof obj.additionalProperties === "object") {
+    walkSchema(obj.additionalProperties, `${path}/additionalProperties`, errors);
+  }
+  for (const compKey of ["anyOf", "oneOf", "allOf"]) {
+    if (Array.isArray(obj[compKey])) {
+      obj[compKey].forEach((subSchema, i) => {
+        walkSchema(subSchema, `${path}/${compKey}/${i}`, errors);
+      });
+    }
+  }
+  for (const defsKey of ["$defs", "definitions"]) {
+    if (obj[defsKey] && typeof obj[defsKey] === "object") {
+      const defs = obj[defsKey];
+      for (const [defName, defSchema] of Object.entries(defs)) {
+        walkSchema(defSchema, `${path}/${defsKey}/${defName}`, errors);
+      }
+    }
+  }
+}
+export {
+  validateSmooaiSchema
+};
+//# sourceMappingURL=smooai-config-schema-spec.mjs.map

package/dist/schema-spec/smooai-config-schema-spec.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/schema-spec/smooai-config-schema-spec.ts"],"sourcesContent":["/**\n * Cross-language JSON Schema validation for the Smoo AI config SDK.\n *\n * Validates that a JSON Schema uses only the subset of keywords that all\n * four language SDKs (TypeScript, Python, Rust, Go) can reliably support.\n */\n\nexport interface SchemaValidationError {\n    path: string;\n    keyword: string;\n    message: string;\n    suggestion: string;\n}\n\nexport interface SchemaValidationResult {\n    valid: boolean;\n    errors: SchemaValidationError[];\n}\n\n/** Keywords supported across all four SDK languages. */\nconst SUPPORTED_KEYWORDS = new Set([\n    // Core\n    'type',\n    'properties',\n    'required',\n    'enum',\n    'const',\n    'default',\n    // Metadata\n    'title',\n    'description',\n    '$schema',\n    // String\n    'minLength',\n    'maxLength',\n    'pattern',\n    'format',\n    // Numeric\n    'minimum',\n    'maximum',\n    'exclusiveMinimum',\n    'exclusiveMaximum',\n    'multipleOf',\n    // Array\n    'items',\n    'minItems',\n    'maxItems',\n    'uniqueItems',\n    // Object\n    'additionalProperties',\n    // Composition\n    'anyOf',\n    'oneOf',\n    'allOf',\n    // References\n    '$ref',\n    '$defs',\n    'definitions',\n]);\n\n/** Keywords explicitly rejected with actionable error messages. */\nconst REJECTED_KEYWORDS: Record<string, { message: string; suggestion: string }> = {\n    if: {\n        message: 'Conditional schemas (if/then/else) are not supported across all SDK languages.',\n        suggestion: 'Use \"oneOf\" or \"anyOf\" with discriminator properties instead.',\n    },\n    then: {\n        message: 'Conditional schemas (if/then/else) are not supported across all SDK languages.',\n        suggestion: 'Use \"oneOf\" or \"anyOf\" with discriminator properties instead.',\n    },\n    else: {\n        message: 'Conditional schemas (if/then/else) are not supported across all SDK languages.',\n        suggestion: 'Use \"oneOf\" or \"anyOf\" with discriminator properties instead.',\n    },\n    patternProperties: {\n        message: '\"patternProperties\" is not supported across all SDK languages.',\n        suggestion: 'Use explicit \"properties\" with known key names, or \"additionalProperties\" with a type constraint.',\n    },\n    propertyNames: {\n        message: '\"propertyNames\" is not supported across all SDK languages.',\n        suggestion: 'Validate property names in application code instead.',\n    },\n    dependencies: {\n        message: '\"dependencies\" is not supported across all SDK languages.',\n        suggestion: 'Use \"required\" within \"oneOf\"/\"anyOf\" variants to express conditional requirements.',\n    },\n    contains: {\n        message: '\"contains\" is not supported across all SDK languages.',\n        suggestion: 'Use \"items\" with a union type (\"anyOf\") instead.',\n    },\n    not: {\n        message: '\"not\" is not supported across all SDK languages.',\n        suggestion: 'Express the constraint positively using \"enum\", \"oneOf\", or validation in application code.',\n    },\n    prefixItems: {\n        message: '\"prefixItems\" (tuple validation) is not supported across all SDK languages.',\n        suggestion: 'Use an \"object\" with named fields instead of a positional tuple.',\n    },\n    unevaluatedProperties: {\n        message: '\"unevaluatedProperties\" is not supported across all SDK languages.',\n        suggestion: 'Use \"additionalProperties\" instead.',\n    },\n    unevaluatedItems: {\n        message: '\"unevaluatedItems\" is not supported across all SDK languages.',\n        suggestion: 'Use \"items\" with a specific schema instead.',\n    },\n};\n\n/** Formats supported across all four SDKs. */\nconst SUPPORTED_FORMATS = new Set(['email', 'uri', 'uuid', 'date-time', 'ipv4', 'ipv6']);\n\n/**\n * Validate that a JSON Schema uses only the cross-language-compatible subset.\n *\n * Walks the schema tree and reports unsupported keywords with actionable\n * error messages and suggestions for compatible alternatives.\n */\nexport function validateSmooaiSchema(schema: Record<string, unknown>): SchemaValidationResult {\n    const errors: SchemaValidationError[] = [];\n    walkSchema(schema, '', errors);\n    return { valid: errors.length === 0, errors };\n}\n\nfunction walkSchema(node: unknown, path: string, errors: SchemaValidationError[]): void {\n    if (typeof node !== 'object' || node === null || Array.isArray(node)) {\n        return;\n    }\n\n    const obj = node as Record<string, unknown>;\n\n    for (const key of Object.keys(obj)) {\n        // Check for rejected keywords first (specific error messages)\n        if (key in REJECTED_KEYWORDS) {\n            const info = REJECTED_KEYWORDS[key];\n            errors.push({\n                path: path || '/',\n                keyword: key,\n                message: info.message,\n                suggestion: info.suggestion,\n            });\n            continue;\n        }\n\n        // Skip known supported keywords — they're fine\n        if (SUPPORTED_KEYWORDS.has(key)) {\n            // Validate format values\n            if (key === 'format' && typeof obj[key] === 'string' && !SUPPORTED_FORMATS.has(obj[key] as string)) {\n                errors.push({\n                    path: path || '/',\n                    keyword: 'format',\n                    message: `Format \"${obj[key]}\" is not supported across all SDK languages.`,\n                    suggestion: `Supported formats: ${[...SUPPORTED_FORMATS].join(', ')}. Use \"pattern\" for custom string validation.`,\n                });\n            }\n            continue;\n        }\n\n        // Unknown keywords that aren't standard JSON Schema — ignore\n        // (could be vendor extensions like x-*, or $id, etc.)\n    }\n\n    // Recurse into sub-schemas\n    if (obj.properties && typeof obj.properties === 'object') {\n        const props = obj.properties as Record<string, unknown>;\n        for (const [propName, propSchema] of Object.entries(props)) {\n            walkSchema(propSchema, `${path}/properties/${propName}`, errors);\n        }\n    }\n\n    if (obj.items && typeof obj.items === 'object') {\n        walkSchema(obj.items, `${path}/items`, errors);\n    }\n\n    if (obj.additionalProperties && typeof obj.additionalProperties === 'object') {\n        walkSchema(obj.additionalProperties, `${path}/additionalProperties`, errors);\n    }\n\n    // Composition keywords\n    for (const compKey of ['anyOf', 'oneOf', 'allOf'] as const) {\n        if (Array.isArray(obj[compKey])) {\n            (obj[compKey] as unknown[]).forEach((subSchema, i) => {\n                walkSchema(subSchema, `${path}/${compKey}/${i}`, errors);\n            });\n        }\n    }\n\n    // $defs / definitions\n    for (const defsKey of ['$defs', 'definitions'] as const) {\n        if (obj[defsKey] && typeof obj[defsKey] === 'object') {\n            const defs = obj[defsKey] as Record<string, unknown>;\n            for (const [defName, defSchema] of Object.entries(defs)) {\n                walkSchema(defSchema, `${path}/${defsKey}/${defName}`, errors);\n            }\n        }\n    }\n}\n"],"mappings":"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","names":[]}

package/dist/utils/fs.d.mts

@@ -0,0 +1,10 @@
+/**
+ * Check if a directory exists.
+ */
+declare function directoryExists(path: string): Promise<boolean>;
+/**
+ * Import a file. - Used to help mock imports.
+ */
+declare function importFile(path: string, errorMessage?: string): Promise<any>;
+
+export { directoryExists, importFile };

package/dist/utils/fs.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Check if a directory exists.
+ */
+declare function directoryExists(path: string): Promise<boolean>;
+/**
+ * Import a file. - Used to help mock imports.
+ */
+declare function importFile(path: string, errorMessage?: string): Promise<any>;
+
+export { directoryExists, importFile };

package/dist/utils/fs.js

@@ -0,0 +1,74 @@
+"use strict";
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/utils/fs.ts
+var fs_exports = {};
+__export(fs_exports, {
+  directoryExists: () => directoryExists,
+  importFile: () => importFile
+});
+module.exports = __toCommonJS(fs_exports);
+var import_fs = require("fs");
+var import_promises = require("fs/promises");
+
+// src/utils/index.ts
+var import_esm_utils = __toESM(require("esm-utils"));
+var SmooaiConfigError = class extends Error {
+  constructor(message, options) {
+    super(`[Smooai Config] ${message}`, options);
+  }
+};
+
+// src/utils/fs.ts
+async function directoryExists(path) {
+  try {
+    const stats = await (0, import_promises.stat)(path);
+    return stats.isDirectory();
+  } catch {
+    return false;
+  }
+}
+async function importFile(path, errorMessage) {
+  try {
+    await (0, import_promises.access)(path, import_fs.constants.R_OK);
+  } catch (e) {
+    throw new SmooaiConfigError(errorMessage ?? `Unable to read file ${path}`, { cause: e });
+  }
+  const imported = await import(path);
+  if (!imported.default) {
+    throw new SmooaiConfigError(`The config file ${path} must have a default export.`);
+  }
+  return imported.default;
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  directoryExists,
+  importFile
+});
+//# sourceMappingURL=fs.js.map

package/dist/utils/fs.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/utils/fs.ts","../../src/utils/index.ts"],"sourcesContent":["import { constants } from 'fs';\nimport { stat, access } from 'fs/promises';\nimport { SmooaiConfigError } from '.';\n\n/**\n * Check if a directory exists.\n */\nexport async function directoryExists(path: string): Promise<boolean> {\n    try {\n        const stats = await stat(path);\n        return stats.isDirectory();\n    } catch {\n        return false;\n    }\n}\n\n/**\n * Import a file. - Used to help mock imports.\n */\nexport async function importFile(path: string, errorMessage?: string) {\n    try {\n        await access(path, constants.R_OK);\n    } catch (e) {\n        throw new SmooaiConfigError(errorMessage ?? `Unable to read file ${path}`, { cause: e });\n    }\n    const imported = await import(path);\n\n    if (!imported.default) {\n        throw new SmooaiConfigError(`The config file ${path} must have a default export.`);\n    }\n\n    return imported.default;\n}\n","/* eslint-disable @typescript-eslint/no-explicit-any -- ok */\nimport createEsmUtils from 'esm-utils';\n\n/**\n * Initialize global __dirname and __filename if not already set.\n */\nexport function initEsmUtils() {\n    if (!global.__dirname || !global.__filename) {\n        const { __dirname, __filename } = import.meta.url\n            ? createEsmUtils({ url: import.meta.url, resolve: import.meta.resolve } as any)\n            : { __dirname: '', __filename: '' };\n        global.__dirname = global.__dirname ? global.__dirname : __dirname;\n        global.__filename = global.__filename ? global.__filename : __filename;\n    }\n}\n\n/**\n * Check if an object is empty.\n */\nfunction isEmpty(obj: any): boolean {\n    for (const prop in obj) {\n        if (Object.hasOwn(obj, prop)) {\n            return false;\n        }\n    }\n    return true;\n}\n\n/**\n * Get the environment variables. Works in Node and Various React Runtimes.\n */\nexport const envToUse = (): NodeJS.ProcessEnv => (!isEmpty(process?.env) ? process.env : (import.meta as unknown as { env: NodeJS.ProcessEnv }).env);\n\n/**\n * Minimal utility to detect an object (excludes arrays).\n */\nexport function isPlainObject(obj: unknown): obj is Record<string, unknown> {\n    return !!obj && typeof obj === 'object' && !Array.isArray(obj);\n}\n\nexport class SmooaiConfigError extends Error {\n    constructor(message: string, options?: ErrorOptions) {\n        super(`[Smooai Config] ${message}`, options);\n    }\n}\n\n// ——— helper: single-char step, always recursing into SnakeCase<> ———\ntype _SnakeCaseChar<S extends string> = S extends `${infer First}${infer Rest}`\n    ? First extends '_' | ' '\n        ? SnakeCase<Rest> // drop \"_\" or \" \"\n        : Rest extends Uncapitalize<Rest>\n          ? `${Lowercase<First>}${SnakeCase<Rest>}` // next is lower/non-letter → no underscore\n          : First extends Lowercase<First>\n            ? `${Lowercase<First>}_${SnakeCase<Rest>}` // lower→upper → underscore\n            : `${Lowercase<First>}${SnakeCase<Rest>}` // upper→upper → no underscore\n    : S; // empty or single character\n\n// ——— your public SnakeCase<> with 3-char look-ahead for acronyms ———\nexport type SnakeCase<S extends string> =\n    // 1⃣ Acronym boundary: Upper + Upper + lower  (e.g. \"IKey\" → \"i_key\")\n    S extends `${infer A}${infer B}${infer C}${infer Rest}`\n        ? A extends Uppercase<A>\n            ? B extends Uppercase<B>\n                ? C extends Lowercase<C>\n                    ? `${Lowercase<A>}_${SnakeCase<`${B}${C}${Rest}`>}`\n                    : _SnakeCaseChar<S>\n                : _SnakeCaseChar<S>\n            : _SnakeCaseChar<S>\n        : // 2⃣ If we don’t even have 3 chars to peek, fall back to the single-char step\n          _SnakeCaseChar<S>;\n\nexport type UpperSnakeCase<S extends string> =\n    S extends Uppercase<S>\n        ? S extends `${string} ${string}`\n            ? // if it had a space, rerun SnakeCase to turn that into \" \"\n              Uppercase<SnakeCase<S>>\n            : S\n        : Uppercase<SnakeCase<S>>;\n\nexport type UnionToUpperSnake<U> = U extends string ? UpperSnakeCase<U> : never;\n\n/**\n * One-pass, no-regex UPPER_SNAKE_CASE converter.\n * - Early exit if already UPPER_SNAKE_CASE.\n * - Drops spaces/underscores.\n * - Splits on  lower→Upper  and  Acronym→Word\n */\nexport function snakecase(input: string): string {\n    // Early return if it’s already UPPER_SNAKE_CASE\n    if (/^[A-Z0-9]+(?:_[A-Z0-9]+)*$/.test(input)) {\n        return input;\n    }\n\n    let out = '';\n    const len = input.length;\n\n    for (let i = 0; i < len; i++) {\n        const ch = input[i];\n        if (ch === '_' || ch === ' ') continue; // drop underscores/spaces\n\n        const code = input.charCodeAt(i);\n        const isUpper = code >= 65 && code <= 90; // A–Z\n        const isLower = code >= 97 && code <= 122; // a–z\n        const isDigit = code >= 48 && code <= 57; // 0–9\n\n        if (isUpper) {\n            // split on lower→upper or acronym→word\n            if (i > 0) {\n                const prev = input.charCodeAt(i - 1);\n                const prevIsLower = prev >= 97 && prev <= 122;\n                const next = i + 1 < len ? input.charCodeAt(i + 1) : NaN;\n                const nextIsLower = next >= 97 && next <= 122;\n                if (prevIsLower || nextIsLower) {\n                    out += '_';\n                }\n            }\n            out += ch; // keep uppercase\n        } else if (isLower) {\n            // lowercase → uppercase\n            out += String.fromCharCode(code - 32);\n        } else if (isDigit) {\n            // digit → append as-is\n            out += ch;\n        } else {\n            // any other character: append or drop as you see fit\n            out += ch;\n        }\n    }\n\n    return out;\n}\n\nexport function convertKeyToUpperSnakeCase(key: string): string {\n    return snakecase(key).toUpperCase();\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,gBAA0B;AAC1B,sBAA6B;;;ACA7B,uBAA2B;AAuCpB,IAAM,oBAAN,cAAgC,MAAM;AAAA,EACzC,YAAY,SAAiB,SAAwB;AACjD,UAAM,mBAAmB,OAAO,IAAI,OAAO;AAAA,EAC/C;AACJ;;;ADrCA,eAAsB,gBAAgB,MAAgC;AAClE,MAAI;AACA,UAAM,QAAQ,UAAM,sBAAK,IAAI;AAC7B,WAAO,MAAM,YAAY;AAAA,EAC7B,QAAQ;AACJ,WAAO;AAAA,EACX;AACJ;AAKA,eAAsB,WAAW,MAAc,cAAuB;AAClE,MAAI;AACA,cAAM,wBAAO,MAAM,oBAAU,IAAI;AAAA,EACrC,SAAS,GAAG;AACR,UAAM,IAAI,kBAAkB,gBAAgB,uBAAuB,IAAI,IAAI,EAAE,OAAO,EAAE,CAAC;AAAA,EAC3F;AACA,QAAM,WAAW,MAAM,OAAO;AAE9B,MAAI,CAAC,SAAS,SAAS;AACnB,UAAM,IAAI,kBAAkB,mBAAmB,IAAI,8BAA8B;AAAA,EACrF;AAEA,SAAO,SAAS;AACpB;","names":[]}

package/dist/utils/fs.mjs

@@ -0,0 +1,11 @@
+import {
+  directoryExists,
+  importFile
+} from "../chunk-ZOKHXR5I.mjs";
+import "../chunk-3SU3SMKN.mjs";
+import "../chunk-J5LGTIGS.mjs";
+export {
+  directoryExists,
+  importFile
+};
+//# sourceMappingURL=fs.mjs.map

package/dist/utils/fs.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/utils/index.d.mts

@@ -0,0 +1,29 @@
+/**
+ * Initialize global __dirname and __filename if not already set.
+ */
+declare function initEsmUtils(): void;
+/**
+ * Get the environment variables. Works in Node and Various React Runtimes.
+ */
+declare const envToUse: () => NodeJS.ProcessEnv;
+/**
+ * Minimal utility to detect an object (excludes arrays).
+ */
+declare function isPlainObject(obj: unknown): obj is Record<string, unknown>;
+declare class SmooaiConfigError extends Error {
+    constructor(message: string, options?: ErrorOptions);
+}
+type _SnakeCaseChar<S extends string> = S extends `${infer First}${infer Rest}` ? First extends '_' | ' ' ? SnakeCase<Rest> : Rest extends Uncapitalize<Rest> ? `${Lowercase<First>}${SnakeCase<Rest>}` : First extends Lowercase<First> ? `${Lowercase<First>}_${SnakeCase<Rest>}` : `${Lowercase<First>}${SnakeCase<Rest>}` : S;
+type SnakeCase<S extends string> = S extends `${infer A}${infer B}${infer C}${infer Rest}` ? A extends Uppercase<A> ? B extends Uppercase<B> ? C extends Lowercase<C> ? `${Lowercase<A>}_${SnakeCase<`${B}${C}${Rest}`>}` : _SnakeCaseChar<S> : _SnakeCaseChar<S> : _SnakeCaseChar<S> : _SnakeCaseChar<S>;
+type UpperSnakeCase<S extends string> = S extends Uppercase<S> ? S extends `${string} ${string}` ? Uppercase<SnakeCase<S>> : S : Uppercase<SnakeCase<S>>;
+type UnionToUpperSnake<U> = U extends string ? UpperSnakeCase<U> : never;
+/**
+ * One-pass, no-regex UPPER_SNAKE_CASE converter.
+ * - Early exit if already UPPER_SNAKE_CASE.
+ * - Drops spaces/underscores.
+ * - Splits on  lower→Upper  and  Acronym→Word
+ */
+declare function snakecase(input: string): string;
+declare function convertKeyToUpperSnakeCase(key: string): string;
+
+export { SmooaiConfigError, type SnakeCase, type UnionToUpperSnake, type UpperSnakeCase, convertKeyToUpperSnakeCase, envToUse, initEsmUtils, isPlainObject, snakecase };

package/dist/utils/index.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Initialize global __dirname and __filename if not already set.
+ */
+declare function initEsmUtils(): void;
+/**
+ * Get the environment variables. Works in Node and Various React Runtimes.
+ */
+declare const envToUse: () => NodeJS.ProcessEnv;
+/**
+ * Minimal utility to detect an object (excludes arrays).
+ */
+declare function isPlainObject(obj: unknown): obj is Record<string, unknown>;
+declare class SmooaiConfigError extends Error {
+    constructor(message: string, options?: ErrorOptions);
+}
+type _SnakeCaseChar<S extends string> = S extends `${infer First}${infer Rest}` ? First extends '_' | ' ' ? SnakeCase<Rest> : Rest extends Uncapitalize<Rest> ? `${Lowercase<First>}${SnakeCase<Rest>}` : First extends Lowercase<First> ? `${Lowercase<First>}_${SnakeCase<Rest>}` : `${Lowercase<First>}${SnakeCase<Rest>}` : S;
+type SnakeCase<S extends string> = S extends `${infer A}${infer B}${infer C}${infer Rest}` ? A extends Uppercase<A> ? B extends Uppercase<B> ? C extends Lowercase<C> ? `${Lowercase<A>}_${SnakeCase<`${B}${C}${Rest}`>}` : _SnakeCaseChar<S> : _SnakeCaseChar<S> : _SnakeCaseChar<S> : _SnakeCaseChar<S>;
+type UpperSnakeCase<S extends string> = S extends Uppercase<S> ? S extends `${string} ${string}` ? Uppercase<SnakeCase<S>> : S : Uppercase<SnakeCase<S>>;
+type UnionToUpperSnake<U> = U extends string ? UpperSnakeCase<U> : never;
+/**
+ * One-pass, no-regex UPPER_SNAKE_CASE converter.
+ * - Early exit if already UPPER_SNAKE_CASE.
+ * - Drops spaces/underscores.
+ * - Splits on  lower→Upper  and  Acronym→Word
+ */
+declare function snakecase(input: string): string;
+declare function convertKeyToUpperSnakeCase(key: string): string;
+
+export { SmooaiConfigError, type SnakeCase, type UnionToUpperSnake, type UpperSnakeCase, convertKeyToUpperSnakeCase, envToUse, initEsmUtils, isPlainObject, snakecase };