agentenv-framework-protocol 0.1.501__tar.gz → 0.1.504__tar.gz

{agentenv_framework_protocol-0.1.501 → agentenv_framework_protocol-0.1.504}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: agentenv-framework-protocol
-Version: 0.1.501
+Version: 0.1.504
 Summary: Open data-plane protocol and server SDK for agent environments.
 Project-URL: Homepage, https://www.agentenvframework.com
 Project-URL: Documentation, https://www.agentenvframework.com/docs
@@ -652,8 +652,9 @@ driver has them, through the `served_tools`, `served_extensions` and `served_ope
   features, among them `screen`: `desktop`, or `page` for a driver whose screen is a website
   browser's active tab, which a computer env pairs with exactly one website browser. The driver serves its skill through `skill/v1` (an `@agent_skill` handler on the base
   class): a SKILL.md written from the computer as it booted (its platform, session user and home,
-  the live screen size, what its input takes, its OS's shortcuts) and ending with the driver
-  class's `notes`, markdown for what its card can't say. A driver whose software ships a skill of
+  the live screen size, what its input takes, its platform's shortcuts, a distribution's where it
+  has its own, as Omarchy does) and ending with the driver class's `notes`, markdown for what its
+  card can't say. A driver whose software ships a skill of
   its own returns it from `bundled_skill()` (its description, body and other files), and the
   computer skill leads with it, the computer's part following.
 - **Framework extensions.** `computer-ready/v1` (`status`: real checks of the display and a
@@ -844,8 +845,10 @@ class MailApp(ComputerAppEnvironment):
   installed into the venv every app gets beside them; `sources`, extra apt repositories
   (`AptSource`, with a key file in the folder); `downloads`, files fetched by URL and checked by
   sha256 (`Download`); `run`, scripts of the folder run as root or the session user (`RunScript`);
-  `services`, programs the computer's init runs from the prefix as the session user; and `ports`,
-  those it listens on. Packages, requirements and downloads are resolved and fetched once, when the
+  `services`, programs the computer's init runs from the prefix as the session user; `ports`,
+  those it listens on; and `shm_mb`, the shared memory it needs in `/dev/shm`, in MiB, which a
+  computer of it gets, the most its apps ask for, where its sandbox can size it (Chrome, say, which
+  keeps its renderers' memory there). Packages, requirements and downloads are resolved and fetched once, when the
   computer env is put, and every build installs only those stored files, with the network closed.
   Each value is checked as the class is defined: a URL, a sha256, a path that stays in the folder.
   Installs are exact: apt installs each package without its recommends, and the venv gets exactly

{agentenv_framework_protocol-0.1.501 → agentenv_framework_protocol-0.1.504}/README.md

@@ -587,8 +587,9 @@ driver has them, through the `served_tools`, `served_extensions` and `served_ope
   features, among them `screen`: `desktop`, or `page` for a driver whose screen is a website
   browser's active tab, which a computer env pairs with exactly one website browser. The driver serves its skill through `skill/v1` (an `@agent_skill` handler on the base
   class): a SKILL.md written from the computer as it booted (its platform, session user and home,
-  the live screen size, what its input takes, its OS's shortcuts) and ending with the driver
-  class's `notes`, markdown for what its card can't say. A driver whose software ships a skill of
+  the live screen size, what its input takes, its platform's shortcuts, a distribution's where it
+  has its own, as Omarchy does) and ending with the driver class's `notes`, markdown for what its
+  card can't say. A driver whose software ships a skill of
   its own returns it from `bundled_skill()` (its description, body and other files), and the
   computer skill leads with it, the computer's part following.
 - **Framework extensions.** `computer-ready/v1` (`status`: real checks of the display and a
@@ -779,8 +780,10 @@ class MailApp(ComputerAppEnvironment):
   installed into the venv every app gets beside them; `sources`, extra apt repositories
   (`AptSource`, with a key file in the folder); `downloads`, files fetched by URL and checked by
   sha256 (`Download`); `run`, scripts of the folder run as root or the session user (`RunScript`);
-  `services`, programs the computer's init runs from the prefix as the session user; and `ports`,
-  those it listens on. Packages, requirements and downloads are resolved and fetched once, when the
+  `services`, programs the computer's init runs from the prefix as the session user; `ports`,
+  those it listens on; and `shm_mb`, the shared memory it needs in `/dev/shm`, in MiB, which a
+  computer of it gets, the most its apps ask for, where its sandbox can size it (Chrome, say, which
+  keeps its renderers' memory there). Packages, requirements and downloads are resolved and fetched once, when the
   computer env is put, and every build installs only those stored files, with the network closed.
   Each value is checked as the class is defined: a URL, a sha256, a path that stays in the folder.
   Installs are exact: apt installs each package without its recommends, and the venv gets exactly

{agentenv_framework_protocol-0.1.501 → agentenv_framework_protocol-0.1.504}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "agentenv-framework-protocol"
-version = "0.1.501"
+version = "0.1.504"
 description = "Open data-plane protocol and server SDK for agent environments."
 readme = "README.md"
 license = "Apache-2.0"

{agentenv_framework_protocol-0.1.501 → agentenv_framework_protocol-0.1.504}/src/agentenv_protocol/computer/app.py

@@ -134,7 +134,9 @@ class Linux(BaseModel):
     """How a Linux computer installs the app: ``files``, a folder of the app's copied under its prefix; ``packages``,
     the OS's; ``python``, a requirements file in that folder installed into a venv beside them; ``sources``, extra apt
     repositories; ``downloads``, files fetched by URL; ``run``, scripts run once those are in; ``services``, programs
-    its init runs; ``ports``, those it listens on. Everything is fetched once at put, and builds install only that."""
+    its init runs; ``ports``, those it listens on; ``shm_mb``, the shared memory it needs in ``/dev/shm``, in MiB, which
+    a computer of it gets where its sandbox can size it. Everything is fetched once at put, and builds install only
+    that."""
 
     model_config = ConfigDict(extra="forbid")
 
@@ -146,6 +148,7 @@ class Linux(BaseModel):
     run: Optional[list[RunScript]] = None
     services: list[Service] = Field(default_factory=list)
     ports: Optional[list[int]] = None
+    shm_mb: Optional[int] = None
 
 
 class Windows(BaseModel):
@@ -349,13 +352,13 @@ def install(os_type: str, spec: BaseModel, *, launch: Optional[Launch] = None, p
 def linux(*, distribution: Optional[str] = None, files: str = ".", packages: Optional[Packages] = None,
           python: Optional[str] = None, sources: Optional[list[AptSource]] = None,
           downloads: Optional[list[Download]] = None, run: Optional[list[RunScript]] = None,
-          services: Optional[list[Service]] = None, ports: Optional[list[int]] = None, launch: Optional[Launch] = None,
-          paths: Optional[list[str]] = None, skill: Optional[str] = None, settings: Optional[type[BaseModel]] = None,
-          build_settings: Optional[type[BaseModel]] = None) -> Callable:
+          services: Optional[list[Service]] = None, ports: Optional[list[int]] = None, shm_mb: Optional[int] = None,
+          launch: Optional[Launch] = None, paths: Optional[list[str]] = None, skill: Optional[str] = None,
+          settings: Optional[type[BaseModel]] = None, build_settings: Optional[type[BaseModel]] = None) -> Callable:
     """``@install`` for Linux, or with ``distribution`` for that distribution alone: how such a computer installs the
     app, ``Linux``'s fields, and what is its own there."""
     spec = Linux(files=files, packages=packages, python=python, sources=sources, downloads=downloads, run=run,
-                 services=services or [], ports=ports)
+                 services=services or [], ports=ports, shm_mb=shm_mb)
     return install(platform_key("linux", distribution), spec, launch=launch, paths=paths, skill=skill,
                    settings=settings, build_settings=build_settings)
 

{agentenv_framework_protocol-0.1.501 → agentenv_framework_protocol-0.1.504}/src/agentenv_protocol/computer/skill.py

@@ -10,18 +10,35 @@ from pathlib import Path
 from typing import TYPE_CHECKING
 
 from .keys import PRINTABLE_KEYS
+from .platform import entry_for, platform_key
 
 if TYPE_CHECKING:
     from .driver import ComputerDriverEnvironment
 
-#: The chords each OS's desktops keep for the everyday actions, as ``computer_key`` takes them.
-SHORTCUTS = {
-    "linux": """\
+#: The chords Linux apps keep for editing, whatever their desktop.
+_LINUX_APPS = """\
 - Copy, cut and paste: `['Control', 'c']`, `['Control', 'x']`, `['Control', 'v']`; in a terminal, with `'Shift'` too.
 - Undo `['Control', 'z']`, save `['Control', 's']`, select all `['Control', 'a']`, find `['Control', 'f']`.
+"""
+#: The chords each platform's desktops keep for the everyday actions, as ``computer_key`` takes them, by platform key: a
+#: distribution's replace its OS type's.
+SHORTCUTS = {
+    "linux": _LINUX_APPS + """\
 - Switch windows `['Alt', 'Tab']`; close the focused one `['Alt', 'F4']`.
 - In a file manager, `['Control', 'l']` takes a typed path, `['F2']` renames and `['Control', 'Shift', 'n']` makes a
   folder.
+""",
+    "linux/omarchy": """\
+- Workspaces: `['Super', '1']` to `['Super', '9']` switch to one; `['Super', 'Shift', '1']` to `['Super', 'Shift', '9']`
+  move the focused window there.
+- Windows tile side by side. `['Super', 'ArrowLeft']` and the other arrows focus the window that way, and with
+  `'Shift'` too move it there; `['Super', 'w']` closes the focused window, `['Super', 'f']` makes it full screen and
+  `['Super', 't']` floats or tiles it.
+- `['Super', 'Enter']` opens a terminal, `['Super', 'Shift', 'f']` the file manager and `['Super', 'Shift', 'b']` the
+  browser; `['Super', 'Alt', ' ']` the app launcher, where a typed name and Enter start an app; `['Super', ' ']`
+  Omarchy's menu; `['Super', 'k']` the list of every shortcut.
+""" + _LINUX_APPS + """\
+- `['Super', 'c']`, `['Super', 'x']` and `['Super', 'v']` copy, cut and paste in any window, a terminal too.
 """,
 }
 _SESSIONS = {"x11": "an X11 session", "wayland": "a Wayland session"}
@@ -56,7 +73,7 @@ async def skill(driver: ComputerDriverEnvironment) -> tuple[str, str, dict[str,
         "## Input",
         _input(driver),
     ]
-    if shortcuts := SHORTCUTS.get(platform.os or ""):
+    if shortcuts := entry_for(SHORTCUTS, platform_key(platform.os, platform.distribution)):
         sections += ["## Shortcuts", shortcuts.rstrip()]
     if notes := driver.notes.strip():
         sections += ["## Notes", notes]

{agentenv_framework_protocol-0.1.501 → agentenv_framework_protocol-0.1.504}/tests/test_computer_driver.py

@@ -221,6 +221,18 @@ async def test_the_skill_is_written_from_the_computer_as_it_booted_under_the_nam
     assert refused.status_code == 400 and "lowercase letters, digits and single hyphens" in refused.text
 
 
+@pytest.mark.asyncio
+async def test_the_skills_shortcuts_are_its_distributions_own_where_it_has_them(monkeypatch):
+    monkeypatch.setattr("agentenv_protocol.computer.skill.getpass.getuser", lambda: "omarchy")
+    omarchy = Platform(os="linux", distribution="omarchy", version="4.5.0", arch="amd64", display="wayland")
+    async with http_client(FakeDriver(platform=omarchy)) as http:
+        skill_md = (await http.get("/agentenv/ext/skill/get", params={"name": "computer-desktop"})).json()["skill_md"]
+
+    shortcuts = skill_md.partition("## Shortcuts")[2]
+    assert "- Omarchy 4.5.0 (amd64), a Wayland session" in skill_md
+    assert "`['Super', 'Alt', ' ']` the app launcher" in shortcuts and "`['Alt', 'Tab']`" not in skill_md
+
+
 @pytest.mark.asyncio
 async def test_a_driver_whose_software_ships_a_skill_leads_with_it_and_the_computers_part_follows(monkeypatch):
     class Bundling(FakeDriver):