vis-agent 0.2.53.dev7787__tar.gz → 0.2.54.dev7809__tar.gz

{vis_agent-0.2.53.dev7787 → vis_agent-0.2.54.dev7809}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: vis-agent
-Version: 0.2.53.dev7787
+Version: 0.2.54.dev7809
 Summary: The Vis Python SDK — author extensions and control local or remote engines.
 Project-URL: Homepage, https://vis.blockether.com
 Project-URL: Documentation, https://vis.blockether.com

{vis_agent-0.2.53.dev7787 → vis_agent-0.2.54.dev7809}/contracts/schema/config.json

@@ -1276,7 +1276,7 @@
         ]
       },
       "additionalProperties": false,
-      "description": "Explicit extension sync declaration. Review source and run extension sync --trust; config loading never installs code. Omitted selector chooses the latest approved stable release once, retained until --refresh; version: latest rechecks it on every sync."
+      "description": "Explicit extension sync declaration. Review source and run extension sync --trust; config loading never installs code. Omitted selector chooses the latest approved stable release once, retained until --refresh; version: latest rechecks it on every sync. A local source with *, ? or [ is a glob of extension entries: it takes no other keys, loads in place at each load and /reload, and sync ignores it."
     },
     "extensions": {
       "type": "object",

{vis_agent-0.2.53.dev7787 → vis_agent-0.2.54.dev7809}/contracts/schema/gateway.json

@@ -1555,6 +1555,29 @@
       },
       "path": "/v1/voice/model"
     },
+    {
+      "audience": "administration",
+      "operations": {
+        "post": {
+          "request": "none",
+          "response": "json",
+          "response_schema": "web_launch"
+        }
+      },
+      "path": "/v1/web/launches"
+    },
+    {
+      "audience": "public",
+      "operations": {
+        "post": {
+          "request": "json",
+          "response": "json",
+          "request_schema": "web_launch_redeem",
+          "response_schema": "web_launch_grant"
+        }
+      },
+      "path": "/v1/web/launches/redeem"
+    },
     {
       "audience": "sdk",
       "path": "/v1/council/rooms",
@@ -1840,6 +1863,61 @@
     "keepalive_route": "/v1/capabilities"
   },
   "$defs": {
+    "web_launch": {
+      "description": "A one-time code that connects a browser to this gateway. `vis-agent web` puts it in the URL fragment.",
+      "type": "object",
+      "required": [
+        "code",
+        "expires_at_ms",
+        "gateway_id"
+      ],
+      "properties": {
+        "code": {
+          "type": "string",
+          "minLength": 1
+        },
+        "expires_at_ms": {
+          "type": "integer"
+        },
+        "gateway_id": {
+          "type": "string",
+          "minLength": 1
+        }
+      }
+    },
+    "web_launch_redeem": {
+      "type": "object",
+      "required": [
+        "code"
+      ],
+      "properties": {
+        "code": {
+          "type": "string",
+          "minLength": 1
+        }
+      }
+    },
+    "web_launch_grant": {
+      "description": "What a redeemed launch code gives the browser: the gateway it reached and the token for its API.",
+      "type": "object",
+      "required": [
+        "gateway_id",
+        "token",
+        "require_token"
+      ],
+      "properties": {
+        "gateway_id": {
+          "type": "string",
+          "minLength": 1
+        },
+        "token": {
+          "type": "string"
+        },
+        "require_token": {
+          "type": "boolean"
+        }
+      }
+    },
     "decision_archive_bytes": {
       "type": "integer",
       "minimum": 1,

{vis_agent-0.2.53.dev7787 → vis_agent-0.2.54.dev7809}/pyproject.toml

@@ -8,7 +8,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "vis-agent"
-version = "0.2.53.dev7787"
+version = "0.2.54.dev7809"
 description = "The Vis Python SDK — author extensions and control local or remote engines."
 readme = "README.md"
 requires-python = ">=3.12"

vis_agent-0.2.54.dev7809/release-tag

@@ -0,0 +1 @@
+beta-a0640b0341d2d74fd4b7a411ee7c82ad4f048528

{vis_agent-0.2.53.dev7787 → vis_agent-0.2.54.dev7809}/src/blockether/vis/_outside.py

@@ -1436,6 +1436,7 @@ def _live_handle(held, envelope, op, view_id):
 
 _IMPLEMENTATIONS = {
     "workspace_root": workspace_root,
+    "project_root": workspace_root,
     "python_environment": python_environment,
     "setting_declaration": setting_declaration,
     "setting": setting,

{vis_agent-0.2.53.dev7787 → vis_agent-0.2.54.dev7809}/src/blockether/vis/extension.py

@@ -57,6 +57,10 @@ class Host(Protocol):
         """Read the active session working copy, or the outside process directory."""
         ...
 
+    def project_root(self) -> str:
+        """Read this extension's project in the session working copy, or the outside process directory."""
+        ...
+
     def python_environment(self) -> str:
         """Read the project's `python.environment`: `project` or `shared`."""
         ...
@@ -3392,6 +3396,18 @@ def workspace_root() -> Path:
     return Path(_host.workspace_root())
 
 
+def project_root() -> Path:
+    """Return this extension's project root in the active session workspace.
+
+    The project root is the nearest directory above the extension entry that
+    holds a `.vis` directory, mapped into the session working copy. For an
+    extension in the workspace's own `.vis/extensions`, it is `workspace_root()`.
+    Outside Vis, it is the process directory. A hosted call without a bound
+    session fails, like `workspace_root()`.
+    """
+    return Path(_host.project_root())
+
+
 def python_environment() -> Literal["project", "shared"]:
     """Return the Python environment that the session's project selects.
 
@@ -3758,8 +3774,7 @@ def ask(title, fields, **options):
 
 
 # -- Form builders ------------------------------------------------------------
-# One helper per node type, named exactly like Clojure's
-# `com.blockether.vis.view`: the type IS the function and the name is
+# One helper per node type: the type IS the function and the name is
 # POSITIONAL, so a misspelled type is a NameError on the spot instead of a
 # refused request, and every other key stays the snake_case spelling `ask`
 # documents.
@@ -5257,8 +5272,7 @@ testing = _Testing()
 
 
 # -- Live view builders -------------------------------------------------------
-# One helper per node type, named exactly like Clojure's
-# `com.blockether.vis.view`, and the ID IS POSITIONAL because every op an
+# One helper per node type, and the ID IS POSITIONAL because every op an
 # extension writes later addresses that id. A builder is a plain dict: nothing
 # here talks to the host, and `vis.live` is what carries it to the engine that
 # judges it.

{vis_agent-0.2.53.dev7787 → vis_agent-0.2.54.dev7809}/tests/test_contracts.py

@@ -55,11 +55,11 @@ def test_gateway_routes_and_lease_policy_are_shared():
     lease = gateway["x-vis-client-lease"]
     assert 0 < lease["touch_ms"] < lease["keepalive_ms"] < lease["ttl_ms"]
     assert 0 < lease["keepalive_timeout_ms"] < lease["keepalive_ms"]
-    assert len(routes) == 162
-    assert len(operations) == 201
+    assert len(routes) == 164
+    assert len(operations) == 203
     assert Counter(operation["request"] for operation in operations) == {
-        "none": 125,
-        "json": 71,
+        "none": 126,
+        "json": 72,
         "binary": 5,
     }
     assert by_path["/v1/decisions/models"]["operations"]["get"] == {

{vis_agent-0.2.53.dev7787 → vis_agent-0.2.54.dev7809}/tests/test_outside.py

@@ -105,6 +105,13 @@ def test_workspace_root_tracks_outside_process_directory(tmp_path, monkeypatch):
     assert isinstance(vis.workspace_root(), Path)
 
 
+def test_project_root_tracks_outside_process_directory(tmp_path, monkeypatch):
+    # Regression, #399: an extension reads its project root the same way inside and outside Vis.
+    monkeypatch.chdir(tmp_path)
+    assert vis.project_root() == tmp_path
+    assert isinstance(vis.project_root(), Path)
+
+
 def test_python_environment_defaults_to_project_outside_vis():
     # Regression, #379: py tools read this value to choose the shared interpreter.
     assert vis.python_environment() == "project"

vis_agent-0.2.53.dev7787/release-tag

@@ -1 +0,0 @@
-beta-b92ec5c56e34a4d03055d8d6342055f4878eb4ed