tavus-cli 0.10.0__tar.gz → 0.10.2__tar.gz

{tavus_cli-0.10.0 → tavus_cli-0.10.2}/.github/workflows/deploy-cloudflare-worker.yml

@@ -100,3 +100,31 @@ jobs:
         with:
           slack-bot-token: ${{ secrets.CVI_BOT_SLACK_TOKEN }}
           github-token: ${{ secrets.GITHUB_TOKEN }}
+
+  notify-pr-environment:
+    name: Update PR Slack deployment reactions
+    needs: [deploy]
+    runs-on: ubuntu-latest
+    timeout-minutes: 10
+    continue-on-error: true
+    concurrency:
+      group: mango-${{ github.repository }}-${{ github.sha }}
+      queue: max
+      cancel-in-progress: false
+    permissions:
+      contents: read
+      pull-requests: read
+      deployments: read
+    steps:
+      - name: Update PR Slack messages
+        uses: Tavus-Engineering/pr-changelog-action/deploy@main
+        with:
+          slack-bot-token: ${{ secrets.CVI_BOT_SLACK_TOKEN }}
+          slack-channel-id: C0AGPSMKQ3Z
+          github-token: ${{ secrets.GITHUB_TOKEN }}
+          repo: ${{ github.repository }}
+          environment: ${{ github.event_name == 'workflow_dispatch' && inputs.environment == 'test' && 'dev' || 'stg' }}
+          deploy-sha: ${{ github.sha }}
+          run-url: ${{ github.server_url }}/${{ github.repository }}/actions/runs/${{ github.run_id }}
+          deployment-environment: ${{ github.event_name == 'workflow_dispatch' && inputs.environment || 'stg' }}
+          resolve-mode: range

{tavus_cli-0.10.0 → tavus_cli-0.10.2}/.github/workflows/pr-reviews.yml

@@ -2,7 +2,10 @@ name: PR Review Notifications
 
 on:
   pull_request:
-    types: [opened, ready_for_review, closed]
+    types: [opened, ready_for_review]
+  # Closed PRs may still have conflicts; execute only this trusted action, never PR code.
+  pull_request_target:
+    types: [closed]
 
 permissions:
   pull-requests: write

{tavus_cli-0.10.0 → tavus_cli-0.10.2}/.github/workflows/pypi-cli.yml

@@ -380,3 +380,30 @@ jobs:
         with:
           slack-bot-token: ${{ secrets.CVI_BOT_SLACK_TOKEN }}
           github-token: ${{ secrets.GITHUB_TOKEN }}
+
+  notify-pr-prod:
+    name: Update PR Slack deployment reactions
+    needs: [preflight, production]
+    runs-on: ubuntu-latest
+    timeout-minutes: 10
+    continue-on-error: true
+    concurrency:
+      group: mango-${{ github.repository }}-${{ github.sha }}
+      queue: max
+      cancel-in-progress: false
+    permissions:
+      contents: read
+      pull-requests: read
+      deployments: read
+    steps:
+      - name: Update PR Slack messages
+        uses: Tavus-Engineering/pr-changelog-action/deploy@main
+        with:
+          slack-bot-token: ${{ secrets.CVI_BOT_SLACK_TOKEN }}
+          slack-channel-id: C0AGPSMKQ3Z
+          github-token: ${{ secrets.GITHUB_TOKEN }}
+          repo: ${{ github.repository }}
+          environment: prod
+          deploy-sha: ${{ needs.preflight.outputs.release_sha }}
+          run-url: ${{ github.server_url }}/${{ github.repository }}/actions/runs/${{ github.run_id }}
+          resolve-mode: range

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

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

{tavus_cli-0.10.0 → tavus_cli-0.10.2}/CHANGELOG.md

@@ -1,5 +1,20 @@
 # Changelog
 
+## [0.10.2](https://github.com/Tavus-Engineering/tavus-mcp/compare/v0.10.1...v0.10.2) (2026-10-16)
+
+
+### Bug Fixes
+
+* resume PAL Builder history across MCP sessions ([#76](https://github.com/Tavus-Engineering/tavus-mcp/issues/76)) ([b8e0263](https://github.com/Tavus-Engineering/tavus-mcp/commit/b8e0263caecf4d4c33957bdbe9019234a668f1a9))
+
+## [0.10.1](https://github.com/Tavus-Engineering/tavus-mcp/compare/v0.10.0...v0.10.1) (2026-10-15)
+
+
+### Bug Fixes
+
+* **ci:** keep PR Slack reactions aligned with deployments ([3f353af](https://github.com/Tavus-Engineering/tavus-mcp/commit/3f353af2b1816e0df41ca4126da92ff03b469d83))
+* **ci:** retain every queued PR Slack notification ([a6cfa0c](https://github.com/Tavus-Engineering/tavus-mcp/commit/a6cfa0cbf68664c203507373ea59e915c26a777e))
+
 ## [0.10.0](https://github.com/Tavus-Engineering/tavus-mcp/compare/v0.9.3...v0.10.0) (2026-10-14)
 
 

{tavus_cli-0.10.0 → tavus_cli-0.10.2}/PKG-INFO

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

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

{tavus_cli-0.10.0 → tavus_cli-0.10.2}/packages/tavus-mcp/pyproject.toml

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

{tavus_cli-0.10.0 → tavus_cli-0.10.2}/pyproject.toml

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

{tavus_cli-0.10.0 → tavus_cli-0.10.2}/src/tavus_mcp/__init__.py

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

{tavus_cli-0.10.0 → tavus_cli-0.10.2}/src/tavus_mcp/builder_guidance.json

@@ -1,7 +1,7 @@
 {
   "instructions": [
-    "Build a new PAL with tavus_pal_build_and_verify. It runs the PAL Maker pipeline that Charlie uses, then publishes and tests the PAL. Use tavus_pal_create or tavus_quickstart only when the creator hands over a finished system prompt and asks to skip the build.",
-    "For an existing PAL, read tavus_pal_capabilities_list first and preserve unrelated settings and attachments. Configure built-ins with tavus_pal_capability_attach, tavus_pal_capability_patch, and tavus_pal_capability_detach.",
+    "Build new PALs with tavus_pal_build_and_verify, which runs Charlie’s PAL Maker pipeline, publishes, and tests. Use tavus_pal_create or tavus_quickstart only for a finished system prompt when the creator asks to skip the build.",
+    "For existing PALs, read tavus_pal_builder_history and tavus_pal_capabilities_list first; preserve prior decisions and unrelated settings. Use tavus_pal_capability_attach, tavus_pal_capability_patch, and tavus_pal_capability_detach for built-ins.",
     "Magic Canvas (magic_canvas) shows scorecards, running scores, charts, quizzes, forms, contact capture, text, and links during a call. A request to show a training scorecard means enabling Magic Canvas, not creating a tool such as record_training_scorecard. The PAL's own model drives the canvas; a saved tool or API response cannot draw on it. Model-generated quiz questions, scores, dice rolls, and random picks need no custom tool. Saving results to a backend is a separate step; recording data does not display it.",
     "When the creator asks for on-screen interaction, attach magic_canvas with the needed magic_canvas_components and magic_canvas_usage_guidance in the same call: text and/or chart for a scorecard, input for forms, question for quizzes. Put one or two lines of when-to-show choreography in magic_canvas_usage_guidance, not in the system prompt. On attach, omitted components are disabled. If the use case only suggests a canvas, offer it once; a decline stays declined. Without a backend, say collection works on screen and delivery can be connected later; do not create a placeholder delivery tool.",
     "Magic Canvas calendar collects date and time preferences and books nothing. Scheduling needs the creator's real HTTPS calendly.com booking link in scheduling_url, not a placeholder or scheduling_embed. Image and map output are not available.",

{tavus_cli-0.10.0 → tavus_cli-0.10.2}/src/tavus_mcp/sdk/recipes/carrier_builder.py

@@ -125,6 +125,7 @@ async def run_carrier_build(
     if not conversation_id:
         raise TavusError("RQH did not return a headless Charlie conversation_id.")
     runtime["conversation_id"] = conversation_id
+    runtime["builder_history_context"] = str((created or {}).get("builder_history_context") or "")
     conversation_url = str((created or {}).get("conversation_url") or "")
     if not conversation_url:
         details = await client.conversations.get(conversation_id)
@@ -763,6 +764,7 @@ async def build_carrier_context(
     return "\n\n".join(
         part
         for part in (
+            str(runtime.get("builder_history_context") or ""),
             "## Live builder resources\n\nThese are the creator's current libraries.",
             _format_faces(faces),
             _format_tools(tools),

{tavus_cli-0.10.0 → tavus_cli-0.10.2}/src/tavus_mcp/server.py

@@ -80,6 +80,7 @@ _READ_ONLY_TOOL_NAMES = {
     "tavus_builder_list",
     "tavus_builder_get",
     "tavus_builder_chat_history",
+    "tavus_pal_builder_history",
 }
 
 _DESTRUCTIVE_TOOL_NAMES = {
@@ -1535,6 +1536,21 @@ async def tavus_builder_delete(builder_id: str) -> Any:
         return await client.builders.delete(builder_id)
 
 
+@mcp.tool()
+async def tavus_pal_builder_history(pal_id: str, limit: int = 40) -> Any:
+    """Read the saved creator/Charlie conversation shown in PAL Maker's Text tab.
+    Read this before resuming work on an existing PAL. Resolves its live or draft
+    ID to the same builder session; a directly created PAL may have no history.
+    This is build history, not conversations people have with the finished PAL.
+    Save new build exchanges with tavus_builder_append_messages using the returned
+    builder_id, unless tavus_pal_build_and_verify already saved those messages.
+    """
+    async with TavusClient.from_env(surface="mcp") as client:
+        return await client.request(
+            "GET", "/builder/history", params={"persona_id": pal_id, "limit": limit}
+        )
+
+
 @mcp.tool()
 async def tavus_builder_chat_history(builder_id: str, limit: int = 50) -> Any:
     async with TavusClient.from_env(surface="mcp") as client:
@@ -1545,6 +1561,10 @@ async def tavus_builder_chat_history(builder_id: str, limit: int = 50) -> Any:
 async def tavus_builder_append_messages(
     builder_id: str, messages: list[dict[str, str]]
 ) -> Any:
+    """Save actual new creator/assistant build dialogue to PAL Maker's Text tab.
+    Do not resend history, invent dialogue, or include the finished PAL's replies.
+    tavus_pal_build_and_verify already saves the exchanges it receives.
+    """
     async with TavusClient.from_env(surface="mcp") as client:
         return await client.builders.append_messages(builder_id, messages)
 

{tavus_cli-0.10.0 → tavus_cli-0.10.2}/tests/unit/test_build_and_verify.py

@@ -418,6 +418,65 @@ async def test_build_uses_headless_carrier_and_pal_maker_model(
     assert smoke_create_body == {"persona_id": "p1", "chat": True}
 
 
+@pytest.mark.asyncio
+@respx.mock
+async def test_resumed_carrier_keeps_saved_history_after_tool_context_update(
+    clean_env: Path,
+    monkeypatch: pytest.MonkeyPatch,
+) -> None:
+    """A context refresh must not erase decisions restored by RQH at call start."""
+    _write_env(clean_env)
+    routes = _register_build_routes()
+    prior = "<prior_build_conversation>CREATOR: No Memory.</prior_build_conversation>"
+    routes["headless_create"].mock(
+        return_value=Response(
+            200,
+            json={
+                "conversation_id": "c_builder",
+                "conversation_url": "https://tavus.daily.co/c_builder",
+                "builder_history_context": prior,
+            },
+        )
+    )
+    session = FakeSession(
+        "c_builder",
+        turns=[
+            {
+                "text": "Updating the greeting.",
+                "tool_calls": [
+                    {
+                        "name": "draft_pal",
+                        "tool_call_id": "call_greeting",
+                        "arguments": json.dumps({"greeting_brief": "Ask about deliveries."}),
+                    }
+                ],
+            },
+            {"text": "The greeting is updated.", "tool_calls": []},
+        ],
+    )
+
+    async def open_session(*_args: Any, **_kwargs: Any) -> FakeSession:
+        return session
+
+    monkeypatch.setattr(daily_transport, "open_conversation_session", open_session)
+    async with await _make_client() as client:
+        await carrier_builder.run_carrier_build(
+            client,
+            builder_id="b1",
+            pal_id="p1",
+            prompt="Change the greeting.",
+            max_rounds=1,
+            answers=None,
+            answer_provider=None,
+            on_builder_reply=None,
+            transcript=[],
+        )
+    assert session.contexts
+    assert all(context.count(prior) == 1 for context in session.contexts)
+    assert "<current_persona_state>" in session.contexts[-1]
+    assert session.closed
+
+
 def test_map_draft_briefs_merges_facts_into_personality() -> None:
     assert map_draft_briefs(
         {

{tavus_cli-0.10.0 → tavus_cli-0.10.2}/uv.lock

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

{tavus_cli-0.10.0 → tavus_cli-0.10.2}/workers/tavus-mcp/package-lock.json

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

{tavus_cli-0.10.0 → tavus_cli-0.10.2}/workers/tavus-mcp/package.json

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

{tavus_cli-0.10.0 → tavus_cli-0.10.2}/workers/tavus-mcp/src/tavus.ts

@@ -613,6 +613,29 @@ export function createTavusMcpServer(
       ),
   );
 
+  server.tool(
+    "tavus_pal_builder_history",
+    "Read the saved creator/Charlie conversation shown in PAL Maker's Text tab before resuming work on an existing PAL. Resolves a live or draft PAL ID to its builder session. A directly created PAL may have no builder history. This is build history, not conversations people have with the finished PAL. Save new build exchanges with tavus_builder_append_messages using the returned builder_id, unless tavus_pal_build_and_verify already saved them.",
+    { pal_id: z.string().min(1), limit: z.number().int().min(1).max(100).default(40) },
+    { title: "Read PAL build history", readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: false },
+    async ({ pal_id, limit }) => toolResult(
+      await client.getPath("builder/history", { persona_id: pal_id, limit: String(limit) }),
+    ),
+  );
+
+  server.tool(
+    "tavus_builder_append_messages",
+    "Save new creator and assistant messages to the builder conversation shown in PAL Maker's Text tab. Use the builder_id returned by tavus_pal_builder_history or tavus_pal_build_and_verify. Save only the actual build conversation, not PAL test replies or invented dialogue; do not resend history or exchanges already saved by tavus_pal_build_and_verify.",
+    {
+      builder_id: z.string().min(1),
+      messages: z.array(z.object({ role: z.enum(["user", "assistant"]), content: z.string().min(1) })).min(1),
+    },
+    writeAnnotations("Save build conversation", { destructiveHint: false, openWorldHint: false }),
+    async ({ builder_id, messages }) => toolResult(
+      await client.post(`builder/${builder_id}/append-messages`, { messages }),
+    ),
+  );
+
   server.tool(
     "tavus_pal_create",
     "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; for a new PAL, use tavus_pal_build_and_verify unless the creator hands over a finished system prompt and asks to skip the build. 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.",

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

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

{tavus_cli-0.10.0 → tavus_cli-0.10.2}/workers/tavus-mcp/test/parity.test.ts

@@ -11,7 +11,6 @@ const LOCAL_ONLY_TOOLS = [
   "tavus_pal_knowledge_upload",
   // Low-level legacy Builder routes remain local-only. Both surfaces expose
   // tavus_pal_build_and_verify through the supported headless Charlie contract.
-  "tavus_builder_append_messages",
   "tavus_builder_chat_history",
   "tavus_builder_create",
   "tavus_builder_delete",

{tavus_cli-0.10.0 → tavus_cli-0.10.2}/workers/tavus-mcp/test/tavus.test.ts

@@ -72,6 +72,38 @@ function registeredTools(
 }
 
 describe("Cloudflare Tavus MCP helpers", () => {
+  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) => {
+      const url = new URL(String(input));
+      if (url.pathname === "/v2/builder/history") {
+        expect(url.searchParams.get("persona_id")).toBe("p_live");
+        return Response.json({ builder_id: "b1", persona_id: "p_draft", messages: history });
+      }
+      if (url.pathname === "/v2/builder/b1/append-messages" && init?.method === "POST") {
+        history.push(...JSON.parse(String(init.body)).messages);
+        return Response.json(history);
+      }
+      throw new Error(`Unexpected request ${url.pathname}`);
+    }));
+    try {
+      const first = registeredTools(createTavusMcpServer({ TAVUS_API_KEY: "secret" }));
+      const before = await first.tavus_pal_builder_history.handler({ pal_id: "p_live", limit: 40 });
+      expect(JSON.parse(before.content[0].text).messages).toEqual(history);
+      await first.tavus_builder_append_messages.handler({
+        builder_id: "b1", messages: [{ role: "user", content: "No, keep it stateless." }],
+      });
+      const reopened = registeredTools(createTavusMcpServer({ TAVUS_API_KEY: "secret" }));
+      const after = await reopened.tavus_pal_builder_history.handler({ pal_id: "p_live", limit: 40 });
+      expect(JSON.parse(after.content[0].text).messages).toEqual([
+        { role: "assistant", content: "Would you like Memory?" },
+        { role: "user", content: "No, keep it stateless." },
+      ]);
+    } finally {
+      vi.unstubAllGlobals();
+    }
+  });
+
   it("publishes annotations for every hosted tool", () => {
     const server = createTavusMcpServer({ TAVUS_API_KEY: "secret" });
     const tools = registeredTools(server);

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

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

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

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