tavus-cli 0.4.2__tar.gz → 0.4.4__tar.gz

{tavus_cli-0.4.2 → tavus_cli-0.4.4}/.github/workflows/pypi-cli.yml

@@ -322,6 +322,52 @@ jobs:
       - name: Publish Tavus CLI and its alias packages to PyPI
         run: uv publish --trusted-publishing always --check-url https://pypi.org/simple/ dist/*
 
+  notify-cvi-automations:
+    name: 'Notify #cvi-automations (prod deploy)'
+    needs: [preflight, production]
+    if: ${{ always() && !cancelled() && needs.preflight.result == 'success' }}
+    runs-on: ubuntu-latest
+    # A Slack or mention-resolution failure must not change the deploy result.
+    continue-on-error: true
+    timeout-minutes: 5
+    steps:
+      - name: Resolve release author mentions
+        id: mentions
+        continue-on-error: true
+        timeout-minutes: 2
+        uses: Tavus-Engineering/pr-changelog-action/release-mentions@main
+        with:
+          github-token: ${{ secrets.GITHUB_TOKEN }}
+          deploy-tag: ${{ needs.preflight.outputs.release_tag }}
+          environment: prod
+
+      - name: 'Post outcome to #cvi-automations'
+        env:
+          SLACK_BOT_TOKEN: ${{ secrets.CVI_BOT_SLACK_TOKEN }}
+          MENTIONS: ${{ steps.mentions.outputs.mentions }}
+          DEPLOY_RESULT: ${{ needs.production.result }}
+          RELEASE_TAG: ${{ needs.preflight.outputs.release_tag }}
+          RUN_URL: ${{ github.server_url }}/${{ github.repository }}/actions/runs/${{ github.run_id }}
+        run: |
+          set -euo pipefail
+          AUTHOR_TAGS="${MENTIONS:+${MENTIONS} }"
+          CVI_TEAM="<!subteam^S08HUM36HMZ>"
+          if [ "$DEPLOY_RESULT" = "success" ]; then
+            TEXT=":white_check_mark: ${AUTHOR_TAGS}Tavus MCP <${RUN_URL}|${RELEASE_TAG}> is live in production."
+          else
+            TEXT=":x: ${CVI_TEAM} Tavus MCP production deploy failed — <${RUN_URL}|run>."
+          fi
+
+          RESPONSE=$(curl --fail-with-body --silent --show-error \
+            --connect-timeout 5 --max-time 30 \
+            -X POST https://slack.com/api/chat.postMessage \
+            -H "Authorization: Bearer ${SLACK_BOT_TOKEN}" \
+            -H "Content-Type: application/json; charset=utf-8" \
+            --data "$(jq -n --arg channel "C0B9S5Y556V" --arg text "$TEXT" \
+              '{channel:$channel, text:$text, unfurl_links:false}')")
+          echo "$RESPONSE" | jq .
+          echo "$RESPONSE" | jq -e '.ok == true' >/dev/null
+
   update-final-board:
     name: Refresh Slack after production
     needs: [preflight, update-pending-board, production]

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

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

{tavus_cli-0.4.2 → tavus_cli-0.4.4}/CHANGELOG.md

@@ -1,5 +1,19 @@
 # Changelog
 
+## [0.4.4](https://github.com/Tavus-Engineering/tavus-mcp/compare/v0.4.3...v0.4.4) (2026-09-10)
+
+
+### Bug Fixes
+
+* prepare hosted MCP metadata for directory review ([#47](https://github.com/Tavus-Engineering/tavus-mcp/issues/47)) ([728bd51](https://github.com/Tavus-Engineering/tavus-mcp/commit/728bd519ef48a0b8d4203926d124f4c6d2500cff))
+
+## [0.4.3](https://github.com/Tavus-Engineering/tavus-mcp/compare/v0.4.2...v0.4.3) (2026-08-28)
+
+
+### Reverts
+
+* "revert: "feat: notify cvi-automations after MCP deploys"" ([c75fdc8](https://github.com/Tavus-Engineering/tavus-mcp/commit/c75fdc850fef1873b83cb356028cb0539193c5aa))
+
 ## [0.4.2](https://github.com/Tavus-Engineering/tavus-mcp/compare/v0.4.1...v0.4.2) (2026-08-28)
 
 

{tavus_cli-0.4.2 → tavus_cli-0.4.4}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: tavus-cli
-Version: 0.4.2
+Version: 0.4.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.4.2 → tavus_cli-0.4.4}/packages/tavus/pyproject.toml

@@ -1,11 +1,11 @@
 [project]
 name = "tavus"
-version = "0.4.2" # x-release-please-version
+version = "0.4.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.4.2", # x-release-please-version
+  "tavus-cli==0.4.4", # x-release-please-version
 ]
 
 [project.urls]

{tavus_cli-0.4.2 → tavus_cli-0.4.4}/packages/tavus-mcp/pyproject.toml

@@ -1,11 +1,11 @@
 [project]
 name = "tavus-mcp"
-version = "0.4.2" # x-release-please-version
+version = "0.4.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.4.2", # x-release-please-version
+  "tavus-cli==0.4.4", # x-release-please-version
 ]
 
 [project.urls]

{tavus_cli-0.4.2 → tavus_cli-0.4.4}/pyproject.toml

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

{tavus_cli-0.4.2 → tavus_cli-0.4.4}/src/tavus_mcp/__init__.py

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

{tavus_cli-0.4.2 → tavus_cli-0.4.4}/tests/unit/test_release_versions.py

@@ -4,6 +4,8 @@ import importlib.util
 import json
 from pathlib import Path
 
+import yaml
+
 ROOT = Path(__file__).resolve().parents[2]
 SCRIPT = ROOT / "scripts" / "check_release_versions.py"
 SPEC = importlib.util.spec_from_file_location("check_release_versions", SCRIPT)
@@ -38,3 +40,31 @@ def test_release_please_updates_python_runtime_version() -> None:
     assert ci_workflow.index("python scripts/check_release_versions.py") < (
         ci_workflow.index("uv sync --extra dev")
     )
+
+
+def test_production_deploy_notifies_cvi_automations() -> None:
+    workflow = yaml.safe_load(
+        (ROOT / ".github" / "workflows" / "pypi-cli.yml").read_text()
+    )
+    notify = workflow["jobs"]["notify-cvi-automations"]
+
+    assert notify["needs"] == ["preflight", "production"]
+    assert notify["continue-on-error"] is True
+    assert "needs.preflight.result == 'success'" in notify["if"]
+
+    mention_step, post_step = notify["steps"]
+    assert (
+        mention_step["uses"]
+        == "Tavus-Engineering/pr-changelog-action/release-mentions@main"
+    )
+    assert mention_step["with"]["deploy-tag"] == (
+        "${{ needs.preflight.outputs.release_tag }}"
+    )
+    assert mention_step["with"]["environment"] == "prod"
+
+    script = post_step["run"]
+    assert "https://slack.com/api/chat.postMessage" in script
+    assert 'channel "C0B9S5Y556V"' in script
+    assert "Tavus MCP <${RUN_URL}|${RELEASE_TAG}> is live in production." in script
+    assert "Tavus MCP production deploy failed" in script
+    assert "jq -e '.ok == true'" in script

{tavus_cli-0.4.2 → tavus_cli-0.4.4}/uv.lock

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

{tavus_cli-0.4.2 → tavus_cli-0.4.4}/workers/tavus-mcp/package-lock.json

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

{tavus_cli-0.4.2 → tavus_cli-0.4.4}/workers/tavus-mcp/package.json

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

{tavus_cli-0.4.2 → tavus_cli-0.4.4}/workers/tavus-mcp/src/index.ts

@@ -17,6 +17,15 @@ const MCP_ROUTE = "/mcp";
 export default {
   async fetch(request: Request, env: Env, ctx: ExecutionContext): Promise<Response> {
     const url = new URL(request.url);
+    if (
+      url.pathname === "/.well-known/openai-apps-challenge" &&
+      (request.method === "GET" || request.method === "HEAD") &&
+      env.OPENAI_APPS_CHALLENGE
+    ) {
+      return new Response(request.method === "HEAD" ? null : env.OPENAI_APPS_CHALLENGE, {
+        headers: { "Content-Type": "text/plain; charset=utf-8" },
+      });
+    }
     const oauthResponse = await handleOAuthRequest(request, env, MCP_ROUTE);
     if (oauthResponse) {
       return oauthResponse;

{tavus_cli-0.4.2 → tavus_cli-0.4.4}/workers/tavus-mcp/src/tavus.ts

@@ -20,6 +20,7 @@ interface OAuthGrantStoreBinding {
 export type TavusEnvironment = "TEST" | "STG" | "PROD";
 
 export interface Env {
+  OPENAI_APPS_CHALLENGE?: string;
   TAVUS_ENV?: string;
   TAVUS_PUBLIC_API_BASE_URL?: string;
   TAVUS_DEV_PORTAL_URL?: string;
@@ -138,17 +139,21 @@ function readOnlyAnnotations(title: string) {
     readOnlyHint: true,
     destructiveHint: false,
     idempotentHint: true,
-    openWorldHint: true,
+    openWorldHint: false,
   };
 }
 
-function writeAnnotations(title: string) {
+function writeAnnotations(
+  title: string,
+  options: { destructiveHint?: boolean; openWorldHint?: boolean } = {},
+) {
   return {
     title,
     readOnlyHint: false,
     destructiveHint: false,
     idempotentHint: false,
-    openWorldHint: true,
+    openWorldHint: false,
+    ...options,
   };
 }
 
@@ -158,7 +163,7 @@ function destructiveAnnotations(title: string) {
     readOnlyHint: false,
     destructiveHint: true,
     idempotentHint: true,
-    openWorldHint: true,
+    openWorldHint: false,
   };
 }
 
@@ -456,7 +461,7 @@ export function createTavusMcpServer(env: Env, apiKey?: string): McpServer {
       readOnlyHint: true,
       destructiveHint: false,
       idempotentHint: true,
-      openWorldHint: true,
+      openWorldHint: false,
     },
     async ({ deep }) =>
       toolResult(
@@ -481,7 +486,7 @@ export function createTavusMcpServer(env: Env, apiKey?: string): McpServer {
       readOnlyHint: true,
       destructiveHint: false,
       idempotentHint: true,
-      openWorldHint: true,
+      openWorldHint: false,
     },
     async ({ limit, page, pal_type }) =>
       toolResult(
@@ -501,7 +506,7 @@ export function createTavusMcpServer(env: Env, apiKey?: string): McpServer {
       readOnlyHint: true,
       destructiveHint: false,
       idempotentHint: true,
-      openWorldHint: true,
+      openWorldHint: false,
     },
     async ({ pal_id, include_settings }) =>
       toolResult(
@@ -515,7 +520,7 @@ export function createTavusMcpServer(env: Env, apiKey?: string): McpServer {
 
   server.tool(
     "tavus_pal_create",
-    "Low-level raw PAL create that SKIPS the PAL Maker pipeline. For any 'build/make me a PAL' request, use tavus_pal_build_and_verify instead — it runs the same cloud PAL Maker flow as the portal (interview, sectioned prompt, objectives, guardrails, greeting, face, publish, verification). Only use this raw create when you deliberately need to bypass that pipeline and know exactly what you are doing. Returns pal_url for direct editing in the matching PAL Maker environment. Full-pipeline PALs use tavus-gemma-4 unless layers.llm.model is explicitly supplied. Tools are first-class records referenced by top-level tool_ids; never write tools inline under layers.llm.",
+    "Create a PAL directly from supplied configuration and return its PAL Maker editor URL. This low-level operation does not draft or verify the PAL through the guided PAL Maker pipeline. Full-pipeline PALs default to tavus-gemma-4 unless layers.llm.model is supplied. Tools are first-class records referenced by top-level tool_ids; inline layers.llm.tools configuration is unsupported.",
     {
       system_prompt: z.string().min(1).optional(),
       pal_name: z.string().default("Agentic Tavus PAL"),
@@ -539,7 +544,7 @@ export function createTavusMcpServer(env: Env, apiKey?: string): McpServer {
       readOnlyHint: false,
       destructiveHint: false,
       idempotentHint: false,
-      openWorldHint: true,
+      openWorldHint: false,
     },
     async ({ system_prompt, pal_name, default_face_id, layers, ...settings }) =>
       toolResult(
@@ -567,7 +572,7 @@ export function createTavusMcpServer(env: Env, apiKey?: string): McpServer {
       readOnlyHint: false,
       destructiveHint: true,
       idempotentHint: true,
-      openWorldHint: true,
+      openWorldHint: false,
     },
     async ({ pal_id }) => toolResult(await client.delete("pals", pal_id)),
   );
@@ -584,7 +589,7 @@ export function createTavusMcpServer(env: Env, apiKey?: string): McpServer {
       readOnlyHint: false,
       destructiveHint: true,
       idempotentHint: false,
-      openWorldHint: true,
+      openWorldHint: false,
     },
     async ({ pal_id, ops }) =>
       toolResult(await client.patch("pals", pal_id, validatePatchOperations(ops))),
@@ -601,7 +606,7 @@ export function createTavusMcpServer(env: Env, apiKey?: string): McpServer {
       readOnlyHint: true,
       destructiveHint: false,
       idempotentHint: true,
-      openWorldHint: true,
+      openWorldHint: false,
     },
     async ({ pal_id }) => {
       const [pal, faces, voices, guardrails, objectives, documents, tools, skills, capabilities] =
@@ -648,7 +653,7 @@ export function createTavusMcpServer(env: Env, apiKey?: string): McpServer {
       readOnlyHint: true,
       destructiveHint: false,
       idempotentHint: true,
-      openWorldHint: true,
+      openWorldHint: false,
     },
     async ({ limit }) => toolResult(await client.list("skills", { limit })),
   );
@@ -664,7 +669,7 @@ export function createTavusMcpServer(env: Env, apiKey?: string): McpServer {
       readOnlyHint: true,
       destructiveHint: false,
       idempotentHint: true,
-      openWorldHint: true,
+      openWorldHint: false,
     },
     async ({ skill_id }) => toolResult(await client.get("skills", skill_id)),
   );
@@ -680,7 +685,7 @@ export function createTavusMcpServer(env: Env, apiKey?: string): McpServer {
       readOnlyHint: true,
       destructiveHint: false,
       idempotentHint: true,
-      openWorldHint: true,
+      openWorldHint: false,
     },
     async ({ pal_id }) => toolResult(await client.getPath(`pals/${pal_id}/skills/`)),
   );
@@ -696,9 +701,9 @@ export function createTavusMcpServer(env: Env, apiKey?: string): McpServer {
     {
       title: "Attach PAL skill",
       readOnlyHint: false,
-      destructiveHint: false,
+      destructiveHint: true,
       idempotentHint: true,
-      openWorldHint: true,
+      openWorldHint: false,
     },
     async ({ pal_id, skill_id, config }) =>
       toolResult(await client.put(`pals/${pal_id}/skills/${skill_id}`, { config: config ?? {} })),
@@ -715,9 +720,9 @@ export function createTavusMcpServer(env: Env, apiKey?: string): McpServer {
     {
       title: "Patch PAL skill",
       readOnlyHint: false,
-      destructiveHint: false,
+      destructiveHint: true,
       idempotentHint: false,
-      openWorldHint: true,
+      openWorldHint: false,
     },
     async ({ pal_id, skill_id, config }) =>
       toolResult(await client.patchPath(`pals/${pal_id}/skills/${skill_id}`, { config })),
@@ -735,7 +740,7 @@ export function createTavusMcpServer(env: Env, apiKey?: string): McpServer {
       readOnlyHint: false,
       destructiveHint: true,
       idempotentHint: true,
-      openWorldHint: true,
+      openWorldHint: false,
     },
     async ({ pal_id, skill_id }) =>
       toolResult(await client.deletePath(`pals/${pal_id}/skills/${skill_id}`)),
@@ -756,7 +761,7 @@ export function createTavusMcpServer(env: Env, apiKey?: string): McpServer {
       readOnlyHint: true,
       destructiveHint: false,
       idempotentHint: true,
-      openWorldHint: true,
+      openWorldHint: false,
     },
     async ({ limit, page, search, sort, tags }) =>
       toolResult(await client.list("voices", clean({ limit, page, search, sort, tags: csv(tags) }))),
@@ -834,7 +839,7 @@ export function createTavusMcpServer(env: Env, apiKey?: string): McpServer {
       app_message: z.boolean().optional(),
       tags: z.array(z.string()).optional(),
     },
-    writeAnnotations("Update guardrail"),
+    writeAnnotations("Update guardrail", { destructiveHint: true }),
     async ({ guardrail_id, ...body }) =>
       toolResult(await client.patchPath(`guardrails/${guardrail_id}`, clean(body))),
   );
@@ -904,7 +909,7 @@ export function createTavusMcpServer(env: Env, apiKey?: string): McpServer {
       objectives_id: z.string().min(1),
       ops: z.array(JsonPatchOperationSchema).min(1),
     },
-    writeAnnotations("Update objective set"),
+    writeAnnotations("Update objective set", { destructiveHint: true }),
     async ({ objectives_id, ops }) =>
       toolResult(await client.patchPath(`objectives/${objectives_id}`, ops)),
   );
@@ -921,7 +926,7 @@ export function createTavusMcpServer(env: Env, apiKey?: string): McpServer {
     "tavus_objective_validate",
     "Validate an objective set without persisting it.",
     objectiveCreateFields,
-    writeAnnotations("Validate objective set"),
+    readOnlyAnnotations("Validate objective set"),
     async (body) => toolResult(await client.post("objectives/validate", body)),
   );
 
@@ -993,7 +998,7 @@ export function createTavusMcpServer(env: Env, apiKey?: string): McpServer {
       static_filler: z.string().optional(),
       tags: z.array(z.string()).optional(),
     },
-    writeAnnotations("Update tool"),
+    writeAnnotations("Update tool", { destructiveHint: true }),
     async ({ tool_id, ...body }) =>
       toolResult(await client.patchPath(`tools/${tool_id}`, clean(body))),
   );
@@ -1021,7 +1026,7 @@ export function createTavusMcpServer(env: Env, apiKey?: string): McpServer {
       pal_id: z.string().min(1),
       tool_ids: z.array(z.string().min(1)).min(1).max(50),
     },
-    writeAnnotations("Attach PAL tools"),
+    writeAnnotations("Attach PAL tools", { destructiveHint: true }),
     async ({ pal_id, tool_ids }) => toolResult(await attachPalTools(client, pal_id, tool_ids)),
   );
 
@@ -1075,7 +1080,7 @@ export function createTavusMcpServer(env: Env, apiKey?: string): McpServer {
       name: z.string().min(1).max(255).optional(),
       rules: z.array(z.record(z.string(), z.unknown())).max(10000).optional(),
     },
-    writeAnnotations("Update pronunciation dictionary"),
+    writeAnnotations("Update pronunciation dictionary", { destructiveHint: true }),
     async ({ dictionary_id, ...body }) =>
       toolResult(await client.patchPath(`pronunciation-dictionaries/${dictionary_id}`, clean(body))),
   );
@@ -1114,7 +1119,7 @@ export function createTavusMcpServer(env: Env, apiKey?: string): McpServer {
       readOnlyHint: true,
       destructiveHint: false,
       idempotentHint: true,
-      openWorldHint: true,
+      openWorldHint: false,
     },
     async ({ pal_id }) => toolResult(await listPalCapabilities(client, pal_id)),
   );
@@ -1144,9 +1149,9 @@ export function createTavusMcpServer(env: Env, apiKey?: string): McpServer {
     {
       title: "Attach PAL capability",
       readOnlyHint: false,
-      destructiveHint: false,
+      destructiveHint: true,
       idempotentHint: true,
-      openWorldHint: true,
+      openWorldHint: false,
     },
     async (input) => toolResult(await attachPalCapability(client, input)),
   );
@@ -1158,9 +1163,9 @@ export function createTavusMcpServer(env: Env, apiKey?: string): McpServer {
     {
       title: "Patch PAL capability",
       readOnlyHint: false,
-      destructiveHint: false,
+      destructiveHint: true,
       idempotentHint: false,
-      openWorldHint: true,
+      openWorldHint: false,
     },
     async (input) => toolResult(await attachPalCapability(client, input, true)),
   );
@@ -1177,7 +1182,7 @@ export function createTavusMcpServer(env: Env, apiKey?: string): McpServer {
       readOnlyHint: false,
       destructiveHint: true,
       idempotentHint: true,
-      openWorldHint: true,
+      openWorldHint: false,
     },
     async ({ pal_id, capability }) =>
       toolResult(await detachPalCapability(client, pal_id, capability)),
@@ -1202,7 +1207,7 @@ export function createTavusMcpServer(env: Env, apiKey?: string): McpServer {
       readOnlyHint: true,
       destructiveHint: false,
       idempotentHint: true,
-      openWorldHint: true,
+      openWorldHint: false,
     },
     async ({ limit, page, sort, status, tags, participant_tags, name_or_uuid, verbose, scope }) =>
       toolResult(
@@ -1235,7 +1240,7 @@ export function createTavusMcpServer(env: Env, apiKey?: string): McpServer {
       readOnlyHint: true,
       destructiveHint: false,
       idempotentHint: true,
-      openWorldHint: true,
+      openWorldHint: false,
     },
     async ({ document_id, verbose }) =>
       toolResult(await client.get("documents", document_id, { verbose: String(verbose) })),
@@ -1301,7 +1306,7 @@ export function createTavusMcpServer(env: Env, apiKey?: string): McpServer {
       readOnlyHint: true,
       destructiveHint: false,
       idempotentHint: true,
-      openWorldHint: true,
+      openWorldHint: false,
     },
     async ({ search, page, limit }) =>
       toolResult(await client.getPath("documents/tags", clean({ search, page, limit }))),
@@ -1321,7 +1326,7 @@ export function createTavusMcpServer(env: Env, apiKey?: string): McpServer {
       readOnlyHint: true,
       destructiveHint: false,
       idempotentHint: true,
-      openWorldHint: true,
+      openWorldHint: false,
     },
     async ({ document_id, collection, limit, offset }) =>
       toolResult(
@@ -1342,7 +1347,7 @@ export function createTavusMcpServer(env: Env, apiKey?: string): McpServer {
     {
       title: "Recrawl document",
       readOnlyHint: false,
-      destructiveHint: false,
+      destructiveHint: true,
       idempotentHint: false,
       openWorldHint: true,
     },
@@ -1361,7 +1366,7 @@ export function createTavusMcpServer(env: Env, apiKey?: string): McpServer {
       readOnlyHint: true,
       destructiveHint: false,
       idempotentHint: true,
-      openWorldHint: true,
+      openWorldHint: false,
     },
     async ({ pal_id }) => toolResult(await listPalKnowledge(client, pal_id)),
   );
@@ -1381,7 +1386,7 @@ export function createTavusMcpServer(env: Env, apiKey?: string): McpServer {
       readOnlyHint: false,
       destructiveHint: false,
       idempotentHint: true,
-      openWorldHint: true,
+      openWorldHint: false,
     },
     async ({ pal_id, document_ids, document_tags }) =>
       toolResult(
@@ -1401,7 +1406,7 @@ export function createTavusMcpServer(env: Env, apiKey?: string): McpServer {
       readOnlyHint: false,
       destructiveHint: true,
       idempotentHint: true,
-      openWorldHint: true,
+      openWorldHint: false,
     },
     async ({ pal_id, document_ids, document_tags }) =>
       toolResult(
@@ -1421,7 +1426,7 @@ export function createTavusMcpServer(env: Env, apiKey?: string): McpServer {
       readOnlyHint: false,
       destructiveHint: true,
       idempotentHint: true,
-      openWorldHint: true,
+      openWorldHint: false,
     },
     async ({ pal_id, document_ids, document_tags }) =>
       toolResult(
@@ -1446,9 +1451,9 @@ export function createTavusMcpServer(env: Env, apiKey?: string): McpServer {
     {
       title: "Patch PAL Knowledge settings",
       readOnlyHint: false,
-      destructiveHint: false,
+      destructiveHint: true,
       idempotentHint: false,
-      openWorldHint: true,
+      openWorldHint: false,
     },
     async ({ pal_id, ...settings }) =>
       toolResult(await patchPalKnowledgeSettings(client, pal_id, settings)),
@@ -1466,7 +1471,7 @@ export function createTavusMcpServer(env: Env, apiKey?: string): McpServer {
       readOnlyHint: true,
       destructiveHint: false,
       idempotentHint: true,
-      openWorldHint: true,
+      openWorldHint: false,
     },
     async ({ limit, stock }) =>
       toolResult(
@@ -1485,7 +1490,7 @@ export function createTavusMcpServer(env: Env, apiKey?: string): McpServer {
     {
       title: "Create conversation",
       readOnlyHint: false,
-      destructiveHint: false,
+      destructiveHint: true,
       idempotentHint: false,
       openWorldHint: true,
     },
@@ -1515,7 +1520,7 @@ export function createTavusMcpServer(env: Env, apiKey?: string): McpServer {
       readOnlyHint: false,
       destructiveHint: true,
       idempotentHint: true,
-      openWorldHint: true,
+      openWorldHint: false,
     },
     async ({ conversation_id }) =>
       toolResult(await client.post(`conversations/${conversation_id}/end`, {})),
@@ -1529,7 +1534,7 @@ export function createTavusMcpServer(env: Env, apiKey?: string): McpServer {
       custom_greeting: z.string().optional(),
       conversation_name: z.string().optional(),
     },
-    writeAnnotations("Start PAL text test"),
+    writeAnnotations("Start PAL text test", { destructiveHint: true, openWorldHint: true }),
     async ({ pal_id, custom_greeting, conversation_name }) =>
       toolResult(
         await client.create(
@@ -1552,7 +1557,7 @@ export function createTavusMcpServer(env: Env, apiKey?: string): McpServer {
       text: z.string().min(1),
       timeout_s: z.number().int().min(5).max(120).default(45),
     },
-    writeAnnotations("Test PAL response"),
+    writeAnnotations("Test PAL response", { destructiveHint: true, openWorldHint: true }),
     async ({ conversation_id, text, timeout_s }) =>
       toolResult({ text: await respondTurn(client, conversation_id, text, timeout_s * 1000) }),
   );
@@ -1574,7 +1579,7 @@ export function createTavusMcpServer(env: Env, apiKey?: string): McpServer {
       face_id: z.string().optional(),
       conversation_name: z.string().optional(),
     },
-    writeAnnotations("Preview PAL"),
+    writeAnnotations("Preview PAL", { destructiveHint: true, openWorldHint: true }),
     async ({ pal_id, face_id, conversation_name }) => {
       let selectedFaceId = face_id;
       if (!selectedFaceId) {
@@ -1596,7 +1601,7 @@ export function createTavusMcpServer(env: Env, apiKey?: string): McpServer {
 
   server.tool(
     "tavus_quickstart",
-    "Use this fast, unguided path only when the user wants a quick throwaway or supplies a complete system prompt. It creates a PAL, selects a stock face when needed, and starts a conversation. For every other 'build/make me a PAL' request, use tavus_pal_build_and_verify so the PAL goes through the guided PAL Maker pipeline.",
+    "Create a PAL from a complete system prompt, select a stock face when none is supplied, and start a conversation. Returns the PAL, conversation, and selected face. This quick setup does not gather an interview or run the guided PAL Maker build and verification pipeline.",
     {
       system_prompt: z.string().min(1),
       pal_name: z.string().default("Agentic Tavus PAL"),
@@ -1608,7 +1613,7 @@ export function createTavusMcpServer(env: Env, apiKey?: string): McpServer {
       readOnlyHint: false,
       destructiveHint: false,
       idempotentHint: false,
-      openWorldHint: true,
+      openWorldHint: false,
     },
     async ({ system_prompt, pal_name, face_id, conversation_name }) => {
       const selectedFaceId = face_id ?? (await firstStockFaceId(client));
@@ -1653,7 +1658,7 @@ export function createTavusMcpServer(env: Env, apiKey?: string): McpServer {
       readOnlyHint: false,
       destructiveHint: false,
       idempotentHint: false,
-      openWorldHint: true,
+      openWorldHint: false,
     },
     async ({ template, pal_name, business_context, default_face_id, layers }) =>
       toolResult(
@@ -1672,7 +1677,7 @@ export function createTavusMcpServer(env: Env, apiKey?: string): McpServer {
 
   server.tool(
     "tavus_pal_build_and_verify",
-    "Use this standard guided PAL Maker pipeline for every 'build/make me a PAL' request. Do not substitute tavus_pal_create or tavus_quickstart. Before calling it, interview the user in chat with 3-6 short questions, asked one at a time. Cover who the PAL serves, its goals, interaction style, safety constraints, knowledge sources, and any face preference. Pass the Q&A as `interview` and distill it into per-artifact `briefs`. The pipeline drafts the system prompt, objectives, guardrails, and greeting; publishes the PAL; selects a face; smoke-tests it; and returns a judged verdict. It can take one to three minutes, so tell the user before calling.",
+    "Build and publish a PAL through the guided PAL Maker pipeline from a completed brief and optional interview Q&A. Drafts the personality, objectives, guardrails, and greeting, selects a face, publishes the PAL, runs conversation probes, and returns the PAL ID, editor URL, and judged verification result. The briefs fields describe each artifact, including knowledge, tools, skills, perception, and face preferences. Connected tools or knowledge sources may access external services during building or testing. Usually takes one to three minutes.",
     {
       prompt: z.string().min(1),
       interview: z
@@ -1696,7 +1701,7 @@ export function createTavusMcpServer(env: Env, apiKey?: string): McpServer {
       pal_name: z.string().optional(),
       probes: z.array(z.string()).max(5).optional(),
     },
-    writeAnnotations("Build and verify PAL with PAL Maker"),
+    writeAnnotations("Build and verify PAL with PAL Maker", { destructiveHint: true, openWorldHint: true }),
     async ({ prompt, interview, briefs, face_id, pal_name, probes }) =>
       toolResult(
         await runGuidedBuild(client, config.palMakerUrl, {
@@ -1741,7 +1746,7 @@ export function createTavusMcpServer(env: Env, apiKey?: string): McpServer {
       readOnlyHint: true,
       destructiveHint: false,
       idempotentHint: true,
-      openWorldHint: true,
+      openWorldHint: false,
     },
     async ({ resource, limit }) => toolResult(await client.list(resourceName(resource), { limit })),
   );

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

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

{tavus_cli-0.4.2 → tavus_cli-0.4.4}/workers/tavus-mcp/wrangler.jsonc

@@ -71,7 +71,8 @@
       ],
       "vars": {
         "TAVUS_ENV": "PROD",
-        "TAVUS_PUBLIC_API_BASE_URL": "https://tavusapi.com/v2"
+        "TAVUS_PUBLIC_API_BASE_URL": "https://tavusapi.com/v2",
+        "OPENAI_APPS_CHALLENGE": "cRJob24tawhN66ab556or-qJ7hqON4c5e5hg-wrnKz4"
       }
     }
   }

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

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

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

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