tavus-cli 0.10.3__tar.gz → 0.10.4__tar.gz

tavus_cli-0.10.4/.release-please-manifest.json

@@ -0,0 +1,3 @@
+{
+  ".": "0.10.4"
+}

{tavus_cli-0.10.3 → tavus_cli-0.10.4}/CHANGELOG.md

@@ -1,5 +1,12 @@
 # Changelog
 
+## [0.10.4](https://github.com/Tavus-Engineering/tavus-mcp/compare/v0.10.3...v0.10.4) (2026-10-19)
+
+
+### Bug Fixes
+
+* support PAL meeting setup, dispatch, and all verification probes ([#80](https://github.com/Tavus-Engineering/tavus-mcp/issues/80)) ([c635462](https://github.com/Tavus-Engineering/tavus-mcp/commit/c635462493098269f3361c2f0ff2d2fc3869bece))
+
 ## [0.10.3](https://github.com/Tavus-Engineering/tavus-mcp/compare/v0.10.2...v0.10.3) (2026-10-16)
 
 

{tavus_cli-0.10.3 → tavus_cli-0.10.4}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: tavus-cli
-Version: 0.10.3
+Version: 0.10.4
 Summary: Tavus CLI and MCP server for agentic PAL creation and editing.
 Requires-Python: >=3.11
 Requires-Dist: fastmcp>=2.0.0

{tavus_cli-0.10.3 → tavus_cli-0.10.4}/packages/tavus/pyproject.toml

@@ -1,11 +1,11 @@
 [project]
 name = "tavus"
-version = "0.10.3" # x-release-please-version
+version = "0.10.4" # x-release-please-version
 description = "Official alias for tavus-cli, the Tavus CLI and MCP server."
 readme = "README.md"
 requires-python = ">=3.11"
 dependencies = [
-  "tavus-cli==0.10.3", # x-release-please-version
+  "tavus-cli==0.10.4", # x-release-please-version
 ]
 
 [project.urls]

{tavus_cli-0.10.3 → tavus_cli-0.10.4}/packages/tavus-mcp/pyproject.toml

@@ -1,11 +1,11 @@
 [project]
 name = "tavus-mcp"
-version = "0.10.3" # x-release-please-version
+version = "0.10.4" # x-release-please-version
 description = "Official alias for tavus-cli, which provides the tavus-mcp MCP server."
 readme = "README.md"
 requires-python = ">=3.11"
 dependencies = [
-  "tavus-cli==0.10.3", # x-release-please-version
+  "tavus-cli==0.10.4", # x-release-please-version
 ]
 
 [project.urls]

{tavus_cli-0.10.3 → tavus_cli-0.10.4}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "tavus-cli"
-version = "0.10.3"
+version = "0.10.4"
 description = "Tavus CLI and MCP server for agentic PAL creation and editing."
 readme = "README.md"
 requires-python = ">=3.11"

{tavus_cli-0.10.3 → tavus_cli-0.10.4}/skills/tavus-agentic-pals/SKILL.md

@@ -136,7 +136,7 @@ Knowledge document tools:
 Conversation and resource tools:
 
 - `tavus_face_list(limit, stock)`
-- `tavus_conversation_create(pal_id, face_id, conversation_name)`
+- `tavus_conversation_create(pal_id?, face_id?, conversation_name?, meeting_url?)`
 - `tavus_conversation_end(conversation_id)`
 - `tavus_quickstart(system_prompt, pal_name, face_id)`
 - `tavus_resource_list(resource, limit)` for `guardrails`, `objectives`, `documents`, `voices`, `skills`, or `tools`
@@ -279,6 +279,20 @@ Prefer focused patches over full rebuilds:
 
 Common patch targets include `/system_prompt`, `/greeting`, `/context`, `/pal_name`, `/default_face_id`, `/objectives_id`, `/guardrail_ids`, `/guardrail_tags`, `/document_ids`, `/document_tags`, and nested layer paths under `/layers/llm`, `/layers/tts`, `/layers/stt`, `/layers/perception`, `/layers/conversational_flow`, `/layers/capabilities`, and `/layers/knowledge_base`.
 
+For meeting participation, set `wake_phrase` and `sleep_phrase` under
+`/layers/conversational_flow`. Save both phrases together; a sleep phrase
+requires a wake phrase. Configure `/layers/conferencing` in a separate patch
+with `username`, `allowlist`, and `whitelabel`. The API rejects a patch that
+mixes conferencing with behavior settings. A default face must be selected
+before claiming a conferencing identity. Read back `layers.conferencing.email`
+for the invite address; do not construct it yourself. Before joining a meeting,
+ask the creator for its link and confirm that the PAL is expected there.
+Creating a conferencing identity does not join a call. Test waking and sleeping
+in a real voice call before claiming the meeting behavior works.
+To send the PAL to the supplied meeting link, call `tavus_conversation_create`
+with `pal_id` and `meeting_url`. A successful response confirms dispatch, not
+admission. Check the meeting participant list before saying the PAL joined.
+
 ## Creation Patterns
 
 Use `tavus_quickstart` or `uv run tavus quickstart` when the user wants a pal plus a conversation quickly. It uses the first stock face unless a face ID is provided.

{tavus_cli-0.10.3 → tavus_cli-0.10.4}/skills/tavus-agentic-pals/references/build-and-verify.md

@@ -47,6 +47,10 @@ tavus_pal_build_and_verify(
 )
 ```
 
+The hosted connector accepts up to five supplied probes and retains all of
+them. Generated probes are capped at three. The smoke test has a shared time
+budget; a probe that cannot run is reported in the transcript with an error.
+
 ### Changing an existing PAL (hosted connector)
 
 Pass `pal_id` to run the same drafters on an existing PAL. Put the requested

{tavus_cli-0.10.3 → tavus_cli-0.10.4}/src/tavus_mcp/__init__.py

@@ -1,4 +1,4 @@
 """Tavus CLI and MCP server package."""
 
 __all__ = ["__version__"]
-__version__ = "0.10.3"  # x-release-please-version
+__version__ = "0.10.4"  # x-release-please-version

{tavus_cli-0.10.3 → tavus_cli-0.10.4}/src/tavus_mcp/sdk/schemas/pal.py

@@ -74,9 +74,18 @@ class ConversationalFlowLayerPatchModel(BaseModel):
     voice_isolation: str | None = None
     noise_cancellation: str | None = None
     wake_phrase: str | None = None
+    sleep_phrase: str | None = None
     idle_engagement: str | None = None
 
 
+class ConferencingLayerPatchModel(BaseModel):
+    model_config = ConfigDict(extra="forbid")
+
+    username: str | None = None
+    allowlist: list[str] | None = None
+    whitelabel: bool | None = None
+
+
 class CapabilitiesLayerPatchModel(BaseModel):
     model_config = ConfigDict(extra="forbid")
 
@@ -106,6 +115,7 @@ class LayersPatchModel(BaseModel):
     transport: dict[str, Any] | None = None
     perception: PerceptionLayerPatchModel | None = None
     conversational_flow: ConversationalFlowLayerPatchModel | None = None
+    conferencing: ConferencingLayerPatchModel | None = None
     capabilities: CapabilitiesLayerPatchModel | None = None
     knowledge_base: KnowledgeBaseLayerPatchModel | None = None
 

{tavus_cli-0.10.3 → tavus_cli-0.10.4}/src/tavus_mcp/server.py

@@ -427,7 +427,12 @@ async def tavus_patch_pal(pal_id: str, ops: list[dict[str, Any]]) -> Any:
 
     Tools are first-class now: prefer tavus_tool_create + tavus_pal_tools_attach
     over writing tools inline here. Inline layer tool paths are rejected by the
-    patch validator."""
+    patch validator. Set wake_phrase and sleep_phrase under
+    /layers/conversational_flow. Patch /layers/conferencing separately from
+    behavior settings; it accepts username, allowlist, and whitelabel.
+    Configuring an identity does not join a call. Ask the creator for the
+    meeting link before joining.
+    """
     async with TavusClient.from_env(surface="mcp") as client:
         return await client.pals.patch(pal_id, ops)
 
@@ -853,13 +858,21 @@ async def tavus_conversation_create(
     pal_id: str | None = None,
     face_id: str | None = None,
     conversation_name: str | None = None,
+    meeting_url: str | None = None,
 ) -> Any:
+    """Create a conversation, or send a PAL to an existing meeting.
+
+    Ask the creator for the meeting link before setting meeting_url. The PAL
+    needs a conferencing identity and a default face. Creation confirms the
+    request was sent; verify admission in the meeting before reporting joined.
+    """
     # /v2/conversations is not part of the pal/face alias, so the body keeps the
     # underlying persona_id/replica_id wire fields (id values are identical).
     body = {
         "persona_id": pal_id,
         "replica_id": face_id,
         "conversation_name": conversation_name,
+        "meeting_url": meeting_url,
     }
     async with TavusClient.from_env(surface="mcp") as client:
         return await client.conversations.create({k: v for k, v in body.items() if v})

{tavus_cli-0.10.3 → tavus_cli-0.10.4}/tests/integration/test_mcp_server.py

@@ -23,6 +23,27 @@ from tavus_mcp.server import (
 )
 
 
+@pytest.mark.asyncio
+@respx.mock
+async def test_mcp_dispatches_pal_to_requested_meeting(clean_env: Path) -> None:
+    (clean_env / ".env").write_text(
+        "TAVUS_ENV=TEST\nTAVUS_API_KEY=test-key\n"
+        "TAVUS_PUBLIC_API_BASE_URL=https://api.example.test/v2\n"
+    )
+    route = respx.post("https://api.example.test/v2/conversations").respond(
+        200, json={"conversation_id": "c-meeting", "status": "active"}
+    )
+    async with Client(mcp) as client:
+        await client.call_tool("tavus_conversation_create", {
+            "pal_id": "p-meeting",
+            "meeting_url": "https://meet.google.com/abc-defg-hij",
+        })
+    assert json.loads(route.calls.last.request.content) == {
+        "persona_id": "p-meeting",
+        "meeting_url": "https://meet.google.com/abc-defg-hij",
+    }
+
+
 @pytest.mark.asyncio
 async def test_builder_guidance_reaches_mcp_clients() -> None:
     async with Client(mcp) as client:

{tavus_cli-0.10.3 → tavus_cli-0.10.4}/tests/unit/test_pal_schema.py

@@ -3,9 +3,33 @@ from __future__ import annotations
 import pytest
 from pydantic import ValidationError
 
+from tavus_mcp.sdk.patch import validate_patch_operations
 from tavus_mcp.sdk.schemas.pal import PalCreate
 
 
+def test_meeting_pal_accepts_activation_phrases_and_conferencing_settings() -> None:
+    layers = {
+        "conversational_flow": {"wake_phrase": "Hey Morgan", "sleep_phrase": "Goodbye Morgan"},
+        "conferencing": {
+            "username": "morgan-rehearsal",
+            "allowlist": ["host@example.com"],
+            "whitelabel": False,
+        },
+    }
+    pal = PalCreate.model_validate({"system_prompt": "Be a skeptical customer.", "layers": layers})
+    saved = pal.model_dump(exclude_none=True)["layers"]
+    assert saved["conversational_flow"] == layers["conversational_flow"]
+    assert saved["conferencing"] == layers["conferencing"]
+    for layer, fields in layers.items():
+        for field, value in fields.items():
+            validate_patch_operations(
+                [{"op": "add", "path": f"/layers/{layer}/{field}", "value": value}]
+            )
+    validate_patch_operations(
+        [{"op": "add", "path": "/layers/conferencing/allowlist/-", "value": "other@example.com"}]
+    )
+
+
 def test_full_pipeline_requires_system_prompt() -> None:
     with pytest.raises(ValidationError, match="system_prompt is required"):
         PalCreate.model_validate({"pal_name": "p"})

{tavus_cli-0.10.3 → tavus_cli-0.10.4}/uv.lock

@@ -1303,7 +1303,7 @@ wheels = [
 
 [[package]]
 name = "tavus-cli"
-version = "0.10.3"
+version = "0.10.4"
 source = { editable = "." }
 dependencies = [
     { name = "fastmcp" },

{tavus_cli-0.10.3 → tavus_cli-0.10.4}/workers/tavus-mcp/package-lock.json

@@ -1,12 +1,12 @@
 {
   "name": "@tavus/tavus-mcp-worker",
-  "version": "0.10.3",
+  "version": "0.10.4",
   "lockfileVersion": 3,
   "requires": true,
   "packages": {
     "": {
       "name": "@tavus/tavus-mcp-worker",
-      "version": "0.10.3",
+      "version": "0.10.4",
       "dependencies": {
         "@modelcontextprotocol/sdk": "^1.29.0",
         "agents": "^0.12.2",

{tavus_cli-0.10.3 → tavus_cli-0.10.4}/workers/tavus-mcp/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tavus/tavus-mcp-worker",
-  "version": "0.10.3",
+  "version": "0.10.4",
   "private": true,
   "type": "module",
   "scripts": {

{tavus_cli-0.10.3 → tavus_cli-0.10.4}/workers/tavus-mcp/src/tavus.ts

@@ -385,6 +385,12 @@ const PATCHABLE_PATHS = [
   "/layers/capabilities/mcp_enabled",
   "/layers/capabilities/search_enabled",
   "/layers/capabilities/search_results_prompt_injection_prevention_enabled",
+  "/layers/conferencing",
+  "/layers/conferencing/allowlist",
+  "/layers/conferencing/allowlist/-",
+  "/layers/conferencing/allowlist/0",
+  "/layers/conferencing/username",
+  "/layers/conferencing/whitelabel",
   "/layers/conversational_flow",
   "/layers/conversational_flow/active_listening",
   "/layers/conversational_flow/idle_engagement",
@@ -395,6 +401,7 @@ const PATCHABLE_PATHS = [
   "/layers/conversational_flow/turn_taking_patience",
   "/layers/conversational_flow/voice_isolation",
   "/layers/conversational_flow/wake_phrase",
+  "/layers/conversational_flow/sleep_phrase",
   "/layers/knowledge_base",
   "/layers/knowledge_base/enable_rag_observability_app_messages",
   "/layers/knowledge_base/rag_n_chunks",
@@ -696,7 +703,7 @@ export function createTavusMcpServer(
 
   server.tool(
     "tavus_patch_pal",
-    "Patch a PAL with validated JSON Patch operations for an exact field edit. To change what a PAL does or shows, such as adding an on-screen scorecard, use tavus_pal_build_and_verify with pal_id instead. Attach first-class tools through top-level tool_ids or tavus_pal_tools_attach; legacy layers.llm.tools writes are rejected.",
+    "Patch a PAL with validated JSON Patch operations for an exact field edit. To change what a PAL does or shows, such as adding an on-screen scorecard, use tavus_pal_build_and_verify with pal_id instead. Set wake_phrase and sleep_phrase under /layers/conversational_flow. Patch /layers/conferencing separately from behavior settings; it accepts username, allowlist, and whitelabel. Configuring an identity does not join a call. Ask the creator for the meeting link before joining. Attach first-class tools through top-level tool_ids or tavus_pal_tools_attach; legacy layers.llm.tools writes are rejected.",
     {
       pal_id: z.string().min(1),
       ops: z.array(JsonPatchOperationSchema).min(1),
@@ -1671,11 +1678,12 @@ export function createTavusMcpServer(
 
   server.tool(
     "tavus_conversation_create",
-    "Create a Tavus conversation for a pal and/or face.",
+    "Create a Tavus conversation for a PAL and/or face, or send a PAL to an existing meeting. Ask the creator for the meeting link before setting meeting_url. The PAL needs a conferencing identity and a default face. Creation confirms the request was sent; verify admission in the meeting before reporting joined.",
     {
       pal_id: z.string().optional(),
       face_id: z.string().optional(),
       conversation_name: z.string().optional(),
+      meeting_url: z.string().optional(),
     },
     {
       title: "Create conversation",
@@ -1686,7 +1694,7 @@ export function createTavusMcpServer(
     },
     // /v2/conversations is not part of the pal/face alias, so the body keeps the
     // underlying persona_id/replica_id wire fields (id values are identical).
-    async ({ pal_id, face_id, conversation_name }) =>
+    async ({ pal_id, face_id, conversation_name, meeting_url }) =>
       toolResult(
         await client.create(
           "conversations",
@@ -1694,6 +1702,7 @@ export function createTavusMcpServer(
             persona_id: pal_id,
             replica_id: face_id,
             conversation_name,
+            meeting_url,
           }),
         ),
       ),
@@ -3130,8 +3139,7 @@ async function runGuidedBuild(
 
   let probes = (options.probes ?? [])
     .map((probe) => probe.trim())
-    .filter(Boolean)
-    .slice(0, MAX_SMOKE_PROBES);
+    .filter(Boolean);
   if (!probes.length) {
     const generated = await safeCall(() =>
       client.post("persona-builder/llm/generate-probes", { persona_spec: spec }),

tavus_cli-0.10.4/workers/tavus-mcp/src/version.ts

@@ -0,0 +1 @@
+export const VERSION = "0.10.4"; // x-release-please-version

{tavus_cli-0.10.3 → tavus_cli-0.10.4}/workers/tavus-mcp/test/tavus.test.ts

@@ -72,6 +72,25 @@ function registeredTools(
 }
 
 describe("Cloudflare Tavus MCP helpers", () => {
+  it("dispatches a PAL to the requested meeting through the hosted tool", async () => {
+    const requests: Array<{ url: string; body: unknown }> = [];
+    vi.stubGlobal("fetch", vi.fn(async (input: string | URL | Request, init?: RequestInit) => {
+      requests.push({ url: String(input), body: JSON.parse(String(init?.body)) });
+      return Response.json({ conversation_id: "c-meeting", status: "active" });
+    }));
+    try {
+      const tool = registeredTools(createTavusMcpServer({ TAVUS_API_KEY: "secret" }))
+        .tavus_conversation_create;
+      await tool.handler({ pal_id: "p-meeting", meeting_url: "https://meet.google.com/abc-defg-hij" });
+      expect(requests).toEqual([{
+        url: "https://tavusapi.com/v2/conversations",
+        body: { persona_id: "p-meeting", meeting_url: "https://meet.google.com/abc-defg-hij" },
+      }]);
+    } finally {
+      vi.unstubAllGlobals();
+    }
+  });
+
   it("reads RQH builder history across MCP sessions and saves creator turns there", async () => {
     const history = [{ role: "assistant", content: "Would you like Memory?" }];
     vi.stubGlobal("fetch", vi.fn(async (input: string | URL | Request, init?: RequestInit) => {
@@ -591,7 +610,8 @@ describe("Cloudflare Tavus MCP helpers", () => {
       await expect(build({ pal_id: "p_live", prompt: request })).rejects.toThrow(/at least one brief/);
       expect(calls).toEqual([]);
 
-      const pending = build({ pal_id: "p_live", prompt: request, briefs: { skills: request }, probes: ["Score me."] });
+      const probes = ["Start practice.", "My first answer.", "My second answer.", "Score me.", "Wrap up."];
+      const pending = build({ pal_id: "p_live", prompt: request, briefs: { skills: request }, probes });
       let settled = false;
       void pending.finally(() => {
         settled = true;
@@ -600,6 +620,9 @@ describe("Cloudflare Tavus MCP helpers", () => {
         await vi.advanceTimersByTimeAsync(500);
       }
       const result = JSON.parse((await pending).content[0].text);
+      expect(result.probes).toEqual(probes);
+      expect(result.smoke_transcript.filter((turn: { role: string }) => turn.role === "user")
+        .map((turn: { text: string }) => turn.text)).toEqual(probes);
 
       expect(calls.find((call) => call.path === "/builder")?.body).toEqual({
         name: "Leasing Coach",
@@ -648,6 +671,24 @@ describe("Cloudflare Tavus MCP helpers", () => {
     ).toThrow(/Unsupported pal patch path/);
   });
 
+  it("accepts meeting settings and rejects unsupported leaf paths", () => {
+    const ops = [
+      { op: "add" as const, path: "/layers/conversational_flow/wake_phrase", value: "Hey Morgan" },
+      { op: "add" as const, path: "/layers/conversational_flow/sleep_phrase", value: "Goodbye Morgan" },
+      { op: "add" as const, path: "/layers/conferencing", value: { username: "morgan-rehearsal" } },
+      { op: "replace" as const, path: "/layers/conferencing/username", value: "morgan-demo" },
+      { op: "replace" as const, path: "/layers/conferencing/allowlist", value: ["host@example.com"] },
+      { op: "add" as const, path: "/layers/conferencing/allowlist/-", value: "other@example.com" },
+      { op: "replace" as const, path: "/layers/conferencing/whitelabel", value: false },
+    ];
+    expect(validatePatchOperations(ops)).toEqual(ops);
+    for (const field of ["email", "aliased_from", "usernmae"]) {
+      expect(() => validatePatchOperations([
+        { op: "replace", path: `/layers/conferencing/${field}`, value: "invalid" },
+      ])).toThrow(/Unsupported pal patch path/);
+    }
+  });
+
   it("patches guardrails by id and tag, not by the removed grouped id", () => {
     expect(
       validatePatchOperations([

tavus_cli-0.10.3/.release-please-manifest.json

@@ -1,3 +0,0 @@
-{
-  ".": "0.10.3"
-}

tavus_cli-0.10.3/workers/tavus-mcp/src/version.ts

@@ -1 +0,0 @@
-export const VERSION = "0.10.3"; // x-release-please-version