@jambonz/schema 0.3.16 → 0.3.18

package/components/hangup.schema.json

@@ -0,0 +1,14 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://jambonz.org/schema/components/hangup",
+  "title": "Hangup",
+  "description": "Enable the built-in hangup tool for conversational verbs (agent and s2s). When present, the runtime injects a 'hangup' tool; when the model calls it, the call is ended with a reason placed in an X-Reason SIP header. The LLM-supplied reason wins, falling back to the app-supplied default below.",
+  "type": "object",
+  "properties": {
+    "reason": {
+      "type": "string",
+      "description": "Default reason placed in the X-Reason SIP header when the call is hung up. Used as a fallback when the LLM does not supply its own reason."
+    }
+  },
+  "additionalProperties": false
+}

package/components/llm-base.schema.json

@@ -89,10 +89,29 @@
       "$ref": "handoff",
       "description": "Declarative transfer-to-human config for s2s verbs. When present, the runtime injects a 'transfer_to_human' tool and runs the packaged transfer choreography when the model calls it."
     },
+    "hangup": {
+      "$ref": "hangup",
+      "description": "Enable the built-in hangup tool for s2s verbs. When present, the runtime injects a 'hangup' tool; when the model calls it, the call is ended with a reason placed in an X-Reason SIP header (LLM-supplied reason wins, falling back to hangup.reason)."
+    },
     "events": {
       "type": "array",
       "items": { "type": "string" },
       "description": "List of event types to receive via the eventHook."
+    },
+    "responseTimeoutMs": {
+      "type": "integer",
+      "minimum": 1,
+      "description": "Opt-in per-response stall watchdog (s2s vendors that support app-driven turn-taking, e.g. openai). Milliseconds to wait for a solicited response to be acknowledged before declaring a stall. When the timer expires a '{type:\"response.timeout\"}' event is sent to the eventHook. Omit or set to 0 to disable (the default)."
+    },
+    "cancelOnResponseTimeout": {
+      "type": "boolean",
+      "default": false,
+      "description": "When a response stall is detected (see responseTimeoutMs), cancel the in-progress server-side response so the next turn does not collide with an active response. Has no effect unless responseTimeoutMs is set."
+    },
+    "cancelOnBargeIn": {
+      "type": "boolean",
+      "default": false,
+      "description": "On caller barge-in, cancel the in-progress server-side response. Intended for app-driven turn-taking configurations where the vendor does not cancel the response itself (server-VAD configurations are unaffected)."
     }
   }
 }

package/package.json

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

package/verbs/agent.schema.json

@@ -140,7 +140,9 @@
             "baseten",
             "azure-openai",
             "groq",
-            "huggingface"
+            "huggingface",
+            "moonshot",
+            "zai"
           ],
           "description": "LLM vendor id. Must match a `@jambonz/llm` registered adapter."
         },
@@ -305,6 +307,10 @@
       "$ref": "../components/handoff",
       "description": "Declarative transfer-to-human config. When present, the runtime injects a 'transfer_to_human' tool into the agent's toolset and runs the packaged transfer choreography (blind/warm) when the LLM calls it."
     },
+    "hangup": {
+      "$ref": "../components/hangup",
+      "description": "Enable the built-in hangup tool. When present, the runtime injects a 'hangup' tool into the agent's toolset; when the LLM calls it, the call is ended with a reason placed in an X-Reason SIP header (LLM-supplied reason wins, falling back to hangup.reason)."
+    },
     "toolFiller": {
       "oneOf": [
         { "type": "boolean", "const": false },