mcp-server-appwrite 2.1.0__tar.gz → 2.1.2__tar.gz

{mcp_server_appwrite-2.1.0 → mcp_server_appwrite-2.1.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: mcp-server-appwrite
-Version: 2.1.0
+Version: 2.1.2
 Summary: Build and deploy application backends. Add authentication, PostgreSQL/MySQL databases, vector databases, storage, serverless functions, realtime, messaging, hosting, domains, CDN and firewall.
 License-File: LICENSE
 Requires-Python: >=3.12

{mcp_server_appwrite-2.1.0 → mcp_server_appwrite-2.1.2}/src/mcp_server_appwrite/apps/resource.py

@@ -2,6 +2,10 @@
 
 One HTML document (``assets/view.html``, plain JavaScript with no build step)
 renders every view; it picks one from the tool result's ``structuredContent``.
+Hosts cache UI resources by URI, so the tools point at
+``ui://appwrite/view/<hash of the HTML>``: a release that changes the view
+changes the URI, and hosts fetch it again. The bare ``ui://appwrite/view``
+still serves the current HTML for tool lists cached before versioning.
 It declares no CSP domains, so hosts apply SEP-1865's restrictive default: no
 network access and no external scripts. Every Appwrite read and write it makes
 is a ``tools/call`` the host proxies to this server under the user's own
@@ -11,6 +15,7 @@ credentials.
 from __future__ import annotations
 
 from functools import cache
+from hashlib import sha256
 from importlib.resources import files
 from typing import Any
 
@@ -23,14 +28,30 @@ from .protocol import MIME_TYPE
 META: dict[str, Any] = {"ui": {"csp": {}, "prefersBorder": True}}
 
 
+VERSION_LENGTH = 12
+"""Hex digits of the HTML's SHA-256 in the URI: enough that two releases
+never collide."""
+
+
 @cache
 def html() -> str:
     return files("mcp_server_appwrite.assets").joinpath("view.html").read_text()
 
 
+@cache
+def uri() -> str:
+    """The URI the tools point at, versioned by the HTML it serves."""
+    digest = sha256(html().encode("utf-8")).hexdigest()[:VERSION_LENGTH]
+    return f"{VIEW_URI}/{digest}"
+
+
+def serves(requested: str) -> bool:
+    return requested in (uri(), VIEW_URI)
+
+
 def resource() -> types.Resource:
     return types.Resource(
-        uri=VIEW_URI,
+        uri=uri(),
         name="Appwrite view",
         description=(
             "Interactive Appwrite view: table rows and deployment build logs."

{mcp_server_appwrite-2.1.0 → mcp_server_appwrite-2.1.2}/src/mcp_server_appwrite/apps/views.py

@@ -19,6 +19,7 @@ what such a script could do.
 from __future__ import annotations
 
 import json
+import re
 from collections.abc import Callable
 from enum import StrEnum
 from typing import Any
@@ -26,7 +27,8 @@ from typing import Any
 import mcp.types as types
 from appwrite_console.query import Query
 
-from ..constants import SHOW_TOOL_NAME, VIEW_URI, VIEW_WRITE_TOOL_NAME
+from ..constants import SHOW_TOOL_NAME, VIEW_WRITE_TOOL_NAME
+from . import resource
 
 Run = Callable[[dict[str, Any], bool], list[Any]]
 """Runs a hidden catalog tool from raw call arguments (``tool_name``,
@@ -46,6 +48,10 @@ SUMMARY_ROWS = 10
 SUMMARY_COLUMNS = 4
 SUMMARY_CELL = 24
 
+ANSI = re.compile(r"\x1b\[[0-9;?]*[ -/]*[@-~]")
+"""Terminal escape sequences (colors, cursor moves) in build logs: the view
+renders the colors, the model's summary drops them."""
+
 TERMINAL_STATUSES = frozenset({"ready", "failed", "canceled"})
 
 WRITES = (
@@ -273,10 +279,10 @@ def _show_tool() -> types.Tool:
             "additionalProperties": False,
         },
         _meta={
-            "ui": {"resourceUri": VIEW_URI, "visibility": ["model", "app"]},
+            "ui": {"resourceUri": resource.uri(), "visibility": ["model", "app"]},
             # The flat key hosts read before ``ui.resourceUri``; SEP-1865 drops
             # it at GA.
-            "ui/resourceUri": VIEW_URI,
+            "ui/resourceUri": resource.uri(),
         },
     )
 
@@ -302,7 +308,7 @@ def _write_tool() -> types.Tool:
             "required": ["tool_name", "arguments", "confirm_write"],
             "additionalProperties": False,
         },
-        _meta={"ui": {"resourceUri": VIEW_URI, "visibility": ["app"]}},
+        _meta={"ui": {"resourceUri": resource.uri(), "visibility": ["app"]}},
     )
 
 
@@ -387,5 +393,5 @@ def _deployment_summary(data: dict[str, Any]) -> str:
     logs = deployment["logs"][-SUMMARY_LOG_LINES:]
     if logs:
         lines.append("Last build log lines:")
-        lines.extend(logs)
+        lines.extend(ANSI.sub("", line) for line in logs)
     return "\n".join(lines)

{mcp_server_appwrite-2.1.0 → mcp_server_appwrite-2.1.2}/src/mcp_server_appwrite/assets/view.html

@@ -183,6 +183,14 @@ pre.logs {
 .status { padding: 32px 18px; text-align: center; color: var(--color-text-secondary); }
 .status.error { color: var(--color-text-danger); text-align: left; white-space: pre-wrap; }
 :root[data-display="fullscreen"] pre.logs { height: 60vh; }
+.ansi-bold { font-weight: var(--font-weight-semibold); }
+.ansi-dim, .ansi-gray, .ansi-black { color: var(--color-text-secondary); }
+.ansi-red { color: var(--color-text-danger); }
+.ansi-green { color: var(--color-text-success); }
+.ansi-yellow { color: var(--color-text-warning); }
+.ansi-blue, .ansi-cyan { color: light-dark(#1d5fb4, #8ab4f8); }
+.ansi-magenta { color: var(--accent); }
+.ansi-white, .ansi-bright { color: var(--color-text-primary); }
 @media (max-width: 560px) {
   .fields { grid-template-columns: minmax(0, 1fr); }
   .steps { grid-template-columns: repeat(2, minmax(0, 1fr)); }
@@ -199,6 +207,11 @@ pre.logs {
   const WRITE_TOOL = "appwrite_view_write";
   const POLL_MS = 3000;
   const PAGE_SIZE = 25;
+  const ESCAPE = /\x1b\[[0-9;?]*[ -\/]*[@-~]/g;
+  const ANSI_COLORS = {
+    30: "black", 31: "red", 32: "green", 33: "yellow", 34: "blue", 35: "magenta", 36: "cyan", 37: "white",
+    90: "gray", 91: "red", 92: "green", 93: "yellow", 94: "blue", 95: "magenta", 96: "cyan", 97: "bright",
+  };
   const TIMESTAMP = /^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}/;
   const EDITABLE = {
     string: "text", varchar: "text", text: "text", mediumtext: "text", longtext: "text",
@@ -619,6 +632,36 @@ pre.logs {
     request("ui/update-model-context", { content: [{ type: "text", text }] }).catch(() => {});
   }
 
+  // Build logs carry terminal color codes (SGR, "ESC[31m"). Each run of text
+  // becomes a span whose classes carry its color and weight; other escape
+  // sequences are dropped. Text only ever goes in as a text node.
+  function ansi(line) {
+    const parts = [];
+    const style = { color: null, bold: false, dim: false };
+    let last = 0;
+    const push = (text) => {
+      if (!text) return;
+      const classes = [style.color, style.bold && "ansi-bold", style.dim && "ansi-dim"].filter(Boolean);
+      parts.push(classes.length ? el("span", { className: classes.join(" ") }, text) : text);
+    };
+    for (const match of line.matchAll(ESCAPE)) {
+      push(line.slice(last, match.index));
+      last = match.index + match[0].length;
+      if (!match[0].endsWith("m")) continue;
+      const codes = match[0].slice(2, -1).split(";").map(Number);
+      for (const code of codes) {
+        if (code === 0) Object.assign(style, { color: null, bold: false, dim: false });
+        else if (code === 1) style.bold = true;
+        else if (code === 2) style.dim = true;
+        else if (code === 22) Object.assign(style, { bold: false, dim: false });
+        else if (code === 39) style.color = null;
+        else if (ANSI_COLORS[code]) style.color = "ansi-" + ANSI_COLORS[code];
+      }
+    }
+    push(line.slice(last));
+    return parts;
+  }
+
   function pill(status) {
     const tone = status === "ready" ? "ready"
       : status === "failed" || status === "canceled" ? "failed"
@@ -671,8 +714,10 @@ pre.logs {
       deployment.activate ? el("span", {}, "Activates when ready") : null);
 
     const logs = el("pre", { className: "logs", tabindex: "0", "aria-label": "Build logs" },
-      (deployment.truncated ? "… earlier lines omitted\n" : "") +
-      (deployment.logs.length ? deployment.logs.join("\n") : data.done ? "No build logs." : "Waiting for build output…"));
+      deployment.truncated ? el("span", { className: "ansi-dim" }, "… earlier lines omitted\n") : null,
+      deployment.logs.length
+        ? deployment.logs.flatMap((line) => [...ansi(line), "\n"])
+        : data.done ? "No build logs." : "Waiting for build output…");
 
     const footer = el("footer", { className: "bar" },
       el("span", { className: "muted", style: "font-size: var(--font-text-xs-size)" },

{mcp_server_appwrite-2.1.0 → mcp_server_appwrite-2.1.2}/src/mcp_server_appwrite/data/docs_index.npz

@@ -1,4 +1,4 @@
 [diffend] Oversized file quarantined before diffing.
-name: mcp_server_appwrite-2.1.0/src/mcp_server_appwrite/data/docs_index.npz
+name: mcp_server_appwrite-2.1.2/src/mcp_server_appwrite/data/docs_index.npz
 size: 35543664 bytes
 sha256: 61d266fdb9a958b272d1b351cc6ebd6e824b0d0fe294483703e0795e4b0580df

{mcp_server_appwrite-2.1.0 → mcp_server_appwrite-2.1.2}/src/mcp_server_appwrite/operator.py

@@ -33,7 +33,6 @@ from .constants import (
     SEARCH_TOOL_NAME,
     UPDATE_HINTS,
     VERBS,
-    VIEW_URI,
     WRITE_TOOL_NAME,
 )
 from .docs_search import DocsSearch
@@ -437,7 +436,7 @@ class Operator:
         if uri == CATALOG_URI:
             return [ReadResourceContents(self._cached_catalog_json, "application/json")]
 
-        if apps and uri == VIEW_URI:
+        if apps and view_resource.serves(uri):
             return [view_resource.read()]
 
         if (

{mcp_server_appwrite-2.1.0 → mcp_server_appwrite-2.1.2}/tests/e2e/test_apps.py

@@ -8,7 +8,9 @@ the view pages, refreshes, follows a build and saves an edit.
 checked to have reached no Appwrite write at all.
 """
 
+import hashlib
 import json
+import re
 import unittest
 from typing import Any
 
@@ -36,6 +38,11 @@ UI = {"extensions": {EXTENSION: {"mimeTypes": [MIME_TYPE]}}}
 ROWS = 30
 PAGE = 25
 LOG_LINES = 250
+# How open-runtimes colors a build log line.
+ANSI_LINE = (
+    "\x1b[90m[13:23:45] \x1b[31m[\x1b[0mopen-runtimes\x1b[31m] "
+    "\x1b[32mBuild finished. \x1b[0m"
+)
 
 cloud: Cloud
 
@@ -71,7 +78,8 @@ def setUpModule() -> None:
             "dep_new",
             FUNCTION,
             "building",
-            "\n".join(f"line {index}" for index in range(1, LOG_LINES + 1)),
+            "\n".join(f"line {index}" for index in range(1, LOG_LINES))
+            + f"\n{ANSI_LINE}",
             providerBranch="main",
             providerCommitHash="a91c3e0f00",
         ),
@@ -158,15 +166,18 @@ class AppsFlow(unittest.TestCase):
 
         listed = tools(self.host)
         show = listed["appwrite_show"]
+        # Hosts cache UI resources by URI, so the URI carries the HTML's hash:
+        # a release that changes the view makes hosts fetch it again.
+        uri = show["_meta"]["ui"]["resourceUri"]
+        self.assertRegex(uri, rf"^{re.escape(VIEW_URI)}/[0-9a-f]{{12}}$")
         self.assertEqual(
-            show["_meta"]["ui"],
-            {"resourceUri": VIEW_URI, "visibility": ["model", "app"]},
+            show["_meta"]["ui"], {"resourceUri": uri, "visibility": ["model", "app"]}
         )
-        self.assertEqual(show["_meta"]["ui/resourceUri"], VIEW_URI)
+        self.assertEqual(show["_meta"]["ui/resourceUri"], uri)
         self.assertTrue(show["annotations"]["readOnlyHint"])
         write = listed["appwrite_view_write"]
         self.assertEqual(
-            write["_meta"]["ui"], {"resourceUri": VIEW_URI, "visibility": ["app"]}
+            write["_meta"]["ui"], {"resourceUri": uri, "visibility": ["app"]}
         )
         self.assertTrue(write["annotations"]["destructiveHint"])
         # The operator tools are unchanged.
@@ -176,12 +187,13 @@ class AppsFlow(unittest.TestCase):
 
         _, response = self.host.call("resources/list")
         view = next(
-            each for each in response["result"]["resources"] if each["uri"] == VIEW_URI
+            each for each in response["result"]["resources"] if each["uri"] == uri
         )
         self.assertEqual(view["mimeType"], MIME_TYPE)
 
-        _, response = self.host.call("resources/read", {"uri": VIEW_URI})
+        _, response = self.host.call("resources/read", {"uri": uri})
         (contents,) = response["result"]["contents"]
+        self.assertEqual(contents["uri"], uri)
         self.assertEqual(contents["mimeType"], MIME_TYPE)
         # No CSP domains: the host's restrictive default, no network access.
         self.assertEqual(contents["_meta"]["ui"], {"csp": {}, "prefersBorder": True})
@@ -191,6 +203,12 @@ class AppsFlow(unittest.TestCase):
         # Appwrite data reaches the DOM as text only.
         self.assertNotIn("innerHTML", html)
         self.assertNotIn("insertAdjacentHTML", html)
+        digest = hashlib.sha256(html.encode("utf-8")).hexdigest()[:12]
+        self.assertEqual(uri, f"{VIEW_URI}/{digest}")
+
+        # Tool lists cached before the URI was versioned still resolve.
+        _, response = self.host.call("resources/read", {"uri": VIEW_URI})
+        self.assertEqual(response["result"]["contents"][0]["text"], html)
 
     def test_hosts_without_apps_are_not_offered_the_view(self):
         with self.server.client() as plain:
@@ -199,7 +217,7 @@ class AppsFlow(unittest.TestCase):
             self.assertNotIn("appwrite_view_write", listed)
             _, response = plain.call("resources/list")
             uris = {each["uri"] for each in response["result"]["resources"]}
-            self.assertNotIn(VIEW_URI, uris)
+            self.assertFalse(any(each.startswith(VIEW_URI) for each in uris))
 
         # A 2025-era client on the stateless transport lists tools without a
         # session, so its capabilities are unknown and the view is offered.
@@ -310,12 +328,16 @@ class AppsFlow(unittest.TestCase):
         self.assertFalse(data["done"])
         # Only the end of a long log is carried.
         self.assertEqual(len(build["logs"]), 200)
-        self.assertEqual(build["logs"][-1], f"line {LOG_LINES}")
+        # The view gets the colors; the model's summary gets plain text.
+        self.assertEqual(build["logs"][-1], ANSI_LINE)
         self.assertTrue(build["truncated"])
         text = result["content"][0]["text"]
         self.assertIn(f"Deployment dep_new of function {FUNCTION} is building.", text)
         self.assertIn("Source: main @ a91c3e0.", text)
-        self.assertTrue(text.endswith(f"line {LOG_LINES}"))
+        self.assertTrue(
+            text.endswith("[13:23:45] [open-runtimes] Build finished. "), text
+        )
+        self.assertNotIn("\x1b", text)
 
         status_path = rf"/v1/functions/{FUNCTION}/deployments/dep_new/status"
         result = self.call(