@jsonfirst/sdk 1.0.1 → 1.1.0

package/index.js

@@ -85,20 +85,73 @@
     }
 
     /**
-     * Validate a JSON object against the JSONFIRST spec.
-     * @param {Object} json - The JSON to validate
-     * @returns {{ valid: boolean, errors: string[] }}
+     * Validate a JSONFIRST output JSON against the JSONFIRST v2 spec.
+     * @param {Object} json - The JSONFIRST JSON to validate
+     * @returns {{ valid: boolean, errors: string[], warnings: string[] }}
      */
     validate(json) {
       const errors = [];
+      const warnings = [];
       if (!json || typeof json !== 'object') {
-        return { valid: false, errors: ['Input must be a JSON object'] };
+        return { valid: false, errors: ['Input must be a JSON object'], warnings: [] };
       }
       if (json.spec !== 'JSONFIRST') errors.push('Missing or incorrect "spec" field (expected "JSONFIRST")');
       if (!json.version) errors.push('Missing "version" field');
-      if (!json.jdons || !Array.isArray(json.jdons)) errors.push('Missing "jdons" array');
+      if (!json.jdons || !Array.isArray(json.jdons)) {
+        errors.push('Missing "jdons" array');
+      } else if (json.jdons.length === 0) {
+        warnings.push('"jdons" array is empty — no intents parsed');
+      }
       if (!json.execution || typeof json.execution !== 'object') errors.push('Missing "execution" object');
-      return { valid: errors.length === 0, errors };
+      return { valid: errors.length === 0, errors, warnings };
+    }
+
+    /**
+     * Validate a single JDON intent for completeness and executability.
+     * Checks required params, confidence threshold, and executable flag.
+     * @param {Object} intent - A single JDON object from jdons[]
+     * @param {Object} [options]
+     * @param {number} [options.minConfidence=0.5] - Minimum confidence threshold (0-1)
+     * @param {string[]} [options.requiredParams=[]] - List of required param keys in intent.object
+     * @returns {{ valid: boolean, executable: boolean, missing_params: string[], errors: string[], confidence: number }}
+     */
+    validateIntent(intent, options = {}) {
+      const { minConfidence = 0.5, requiredParams = [] } = options;
+      const errors = [];
+      const missing_params = [];
+
+      if (!intent || typeof intent !== 'object') {
+        return { valid: false, executable: false, missing_params: [], errors: ['Intent must be a JSON object'], confidence: 0 };
+      }
+
+      // Action check
+      if (!intent.action || !intent.action.normalized) errors.push('Missing action.normalized');
+
+      // Confidence check
+      const confidence = intent.confidence || 0;
+      if (confidence < minConfidence) {
+        errors.push(`Confidence ${(confidence * 100).toFixed(0)}% is below minimum ${(minConfidence * 100).toFixed(0)}%`);
+      }
+
+      // Required params check
+      const obj = intent.object || {};
+      for (const param of requiredParams) {
+        if (obj[param] === undefined || obj[param] === null) {
+          missing_params.push(param);
+          errors.push(`Missing required param: ${param}`);
+        }
+      }
+
+      // Missing params from JSONFIRST spec
+      if (intent.missing_params && intent.missing_params.length > 0) {
+        for (const p of intent.missing_params) {
+          if (!missing_params.includes(p)) missing_params.push(p);
+        }
+      }
+
+      const executable = intent.executable === true && missing_params.length === 0 && errors.length === 0;
+
+      return { valid: errors.length === 0, executable, missing_params, errors, confidence };
     }
 
     /**

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@jsonfirst/sdk",
-  "version": "1.0.1",
+  "version": "1.1.0",
   "description": "Official JavaScript/Node.js SDK for the JSONFIRST Protocol — Universal Intent Protocol for AI governance",
   "main": "index.js",
   "files": [