@jambonz/schema 0.1.4 → 0.1.6

package/components/recognizer.schema.json

@@ -41,9 +41,24 @@
     },
     "hints": {
       "type": "array",
-      "items": { "type": "string" },
-      "description": "An array of words or phrases that the recognizer should favor. Use this to improve accuracy for domain-specific terminology, product names, or proper nouns.",
-      "examples": [["jambonz", "drachtio", "SIP", "WebRTC"]]
+      "items": {
+        "oneOf": [
+          { "type": "string" },
+          {
+            "type": "object",
+            "properties": {
+              "phrase": { "type": "string" },
+              "boost": { "type": "number" }
+            },
+            "required": ["phrase"]
+          }
+        ]
+      },
+      "description": "An array of words or phrases that the recognizer should favor. Each item can be a plain string or an object with 'phrase' and optional 'boost' properties.",
+      "examples": [
+        ["jambonz", "drachtio", "SIP", "WebRTC"],
+        [{"phrase": "jambonz", "boost": 20}, {"phrase": "drachtio", "boost": 10}]
+      ]
     },
     "hintsBoost": {
       "type": "number",

package/lib/validator.js

@@ -87,9 +87,19 @@ function validateVerb(name, data, logger) {
   const valid = validate(verbObj);
   if (!valid) {
     const errors = validate.errors || [];
-    const messages = errors.map((e) => `${e.instancePath || '/'}: ${e.message}`).join('; ');
-    debug(`validation failed for ${name}: ${messages}`);
-    throw new Error(`${name}: ${messages}`);
+    const details = errors.map((e) => {
+      const path = e.instancePath || '(root)';
+      let msg = `'${path}': ${e.message}`;
+      if (e.params) {
+        if (e.params.type) msg += ` (expected ${e.params.type})`;
+        if (e.params.allowedValues) msg += ` (allowed: ${e.params.allowedValues.join(', ')})`;
+        if (e.params.missingProperty) msg += ` (missing: ${e.params.missingProperty})`;
+      }
+      return msg;
+    }).join('; ');
+    const errMsg = `verb '${name}' validation failed — ${details}. Schema: ${schemaId}`;
+    debug(errMsg);
+    throw new Error(errMsg);
   }
 }
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@jambonz/schema",
-  "version": "0.1.4",
+  "version": "0.1.6",
   "description": "JSON Schema definitions and validation for jambonz verb applications",
   "main": "index.js",
   "scripts": {

package/verbs/dial.schema.json

@@ -108,16 +108,19 @@
       ]
     },
     "listen": {
-      "$ref": "listen",
-      "description": "Nested listen verb — streams audio of the bridged call to a websocket endpoint."
+      "type": "object",
+      "description": "Nested listen configuration for streaming audio of the bridged call.",
+      "additionalProperties": true
     },
     "stream": {
-      "$ref": "stream",
-      "description": "Nested stream verb — streams audio of the bridged call. Alias for 'listen'."
+      "type": "object",
+      "description": "Nested stream configuration for streaming audio of the bridged call. Alias for 'listen'.",
+      "additionalProperties": true
     },
     "transcribe": {
-      "$ref": "transcribe",
-      "description": "Nested transcribe verb — enables real-time transcription of the bridged call."
+      "type": "object",
+      "description": "Nested transcribe configuration for real-time transcription of the bridged call.",
+      "additionalProperties": true
     },
     "timeLimit": {
       "type": "number",

package/verbs/gather.schema.json

@@ -117,12 +117,14 @@
       "description": "Override the session-level STT configuration for this gather."
     },
     "say": {
-      "$ref": "say",
-      "description": "A nested 'say' verb to use as the prompt. Played to the caller while listening for input."
+      "type": "object",
+      "description": "A nested say prompt played to the caller while listening for input. Accepts the same properties as the say verb (text, synthesizer, etc.) but no fields are required.",
+      "additionalProperties": true
     },
     "play": {
-      "$ref": "play",
-      "description": "A nested 'play' verb to use as the prompt. Played to the caller while listening for input."
+      "type": "object",
+      "description": "A nested play prompt played to the caller while listening for input. Accepts the same properties as the play verb (url, etc.) but no fields are required.",
+      "additionalProperties": true
     },
     "fillerNoise": {
       "$ref": "../components/fillerNoise",

package/verbs/pipeline.schema.json

@@ -76,7 +76,7 @@
           "default": false
         }
       },
-      "additionalProperties": false
+      "additionalProperties": true
     },
     "noResponseTimeout": {
       "type": "number",