agentenv-framework-protocol 0.1.500__tar.gz → 0.1.502__tar.gz

{agentenv_framework_protocol-0.1.500 → agentenv_framework_protocol-0.1.502}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: agentenv-framework-protocol
-Version: 0.1.500
+Version: 0.1.502
 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

{agentenv_framework_protocol-0.1.500 → agentenv_framework_protocol-0.1.502}/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

{agentenv_framework_protocol-0.1.500 → agentenv_framework_protocol-0.1.502}/pyproject.toml

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

{agentenv_framework_protocol-0.1.500 → agentenv_framework_protocol-0.1.502}/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.500 → agentenv_framework_protocol-0.1.502}/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):