devops-bot-sdk 1.7.5__tar.gz → 1.7.6__tar.gz

{devops_bot_sdk-1.7.5 → devops_bot_sdk-1.7.6}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: devops-bot-sdk
-Version: 1.7.5
+Version: 1.7.6
 Summary: DevOps Bot Desktop SDK — thin client for the AgentOS Electron desktop app
 Author: noumanaziz2128
 License-Expression: LicenseRef-Proprietary

{devops_bot_sdk-1.7.5 → devops_bot_sdk-1.7.6}/devops_bot_sdk.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: devops-bot-sdk
-Version: 1.7.5
+Version: 1.7.6
 Summary: DevOps Bot Desktop SDK — thin client for the AgentOS Electron desktop app
 Author: noumanaziz2128
 License-Expression: LicenseRef-Proprietary

{devops_bot_sdk-1.7.5 → devops_bot_sdk-1.7.6}/sdk/__init__.py

@@ -1,6 +1,6 @@
 """AgentOS Desktop SDK — thin HTTPS/SSE client for the Electron app.
 
-Version: 1.7.5
+Version: 1.7.6
 
 Public surface:
   BackendClient.from_config()        — create client from ~/.agentos/config.toml
@@ -34,7 +34,7 @@ Rules:
   - All data egress through submit_webhook only
 """
 
-__version__ = "1.7.5"   # SINGLE SOURCE OF TRUTH — bump on every change; pyproject,
+__version__ = "1.7.6"   # SINGLE SOURCE OF TRUTH — bump on every change; pyproject,
 __author__  = "AgentOS"   # sdk.client.SDK_VERSION and the UI server version all read this.
 
 from sdk.client import BackendClient

{devops_bot_sdk-1.7.5 → devops_bot_sdk-1.7.6}/sdk/client.py

@@ -2758,7 +2758,7 @@ class BackendClient:
         url = self._url("/api/v1/agents/shared")
         async with httpx.AsyncClient(timeout=15.0) as client:
             resp = await client.get(url, headers=self._headers)
-        if resp.status_code == 404:
+        if resp.status_code in (404, 405):   # 405: an older backend's /agents/{name} catch-all
             raise BackendFeatureMissing("Agent sharing", url)
         _check_status(resp.status_code, self._base_url)
         return resp.json().get("agents", [])

{devops_bot_sdk-1.7.5 → devops_bot_sdk-1.7.6}/sdk/helpdesk_kb.md

@@ -104,6 +104,11 @@ stuck In Progress after a crash → `restore-stranded-tickets` (⚠ moves ticket
 pending invite per recipient on the AI backend (devops-bot-ai, Mongo `agent_shares`); it reaches them only
 after they `agentos agent accept ID` (or Accept on the Custom Agents page). Accepted
 shares are runnable (`sdk/agents/chat.resolve_agent` reads `GET /api/v1/agents/shared`).
+Accepted shares appear on Custom Agents next to your own (`GET /api/ui/agents` and
+`/api/ui/agents/custom` add them with `source="shared"`, `shared_by`, `via`,
+`share_id`): Run dropdown, installed cards and a "Shared with you" platform group,
+with Run / Remove only. Their inputs come from the backend row (`/api/ui/agents/vars`
+falls back to `resolve_agent`).
 The panel's Share dialog (Custom Agents → Share) has Person / Team / Department tabs;
 each lists from `GET /api/v1/agents/share-targets?kind=…` (users, teams, departments
 in the platform's SQL — names, never ids) and sends the picks as `user:<id>` /

{devops_bot_sdk-1.7.5 → devops_bot_sdk-1.7.6}/sdk/ui/api.py

@@ -466,6 +466,37 @@ async def product_agents(product_id: str = Query(...)) -> dict:
         return {"response": [], "product_id": product_id, "error": str(exc)}
 
 
+async def _shared_agent_rows(client) -> tuple[list[dict], str]:
+    """Agents others shared with you that you ACCEPTED, as ``(rows, error)``.
+
+    Each row is the backend agent row plus ``source="shared"``, ``shared_by`` (a
+    NAME), ``share_id`` (for Remove) and ``via`` ("team X" / "department X").
+    A backend without sharing has none — that is not an error to show."""
+    from sdk.exceptions import BackendFeatureMissing
+
+    fetch = getattr(client, "list_shared_agents", None)
+    if fetch is None:
+        return [], ""
+    try:
+        rows = await fetch()
+    except BackendFeatureMissing:
+        return [], ""
+    except Exception as exc:  # noqa: BLE001
+        return [], f"Couldn't load agents shared with you: {exc}"
+    out = []
+    for r in rows or []:
+        if not isinstance(r, dict) or not r.get("name"):
+            continue
+        by = r.get("shared_by") or {}
+        via = r.get("via_team") or {}
+        out.append({**r, "source": "shared",
+                    "shared_by": (by.get("name") or by.get("email") or "") if isinstance(by, dict) else str(by),
+                    "share_id": r.get("share_id") or "",
+                    "via": (f"{'department' if via.get('kind') == 'department' else 'team'} {via['name']}"
+                            if isinstance(via, dict) and via.get("name") else "")})
+    return out, ""
+
+
 @router.get("/agents", dependencies=[_auth])
 async def agents() -> dict:
     """The caller's own custom agents (``relation_type='User'``) from the backend.
@@ -480,14 +511,21 @@ async def agents() -> dict:
     from sdk.client import BackendClient
     from sdk.exceptions import BackendFeatureMissing
 
+    client = BackendClient.from_config()
+    # Accepted shares sit next to your own (source="shared"), so the Custom Agents
+    # page lists and runs them too; your own agent wins a name clash.
+    shared, shared_error = await _shared_agent_rows(client)
     try:
-        rows = await BackendClient.from_config().list_custom_agents()
+        rows = await client.list_custom_agents()
     except BackendFeatureMissing:
-        return {"agents": [], "error": ("Custom agents aren't available on this "
-                                        "backend — it may be running an older version.")}
+        return {"agents": shared, "shared_error": shared_error,
+                "error": ("Custom agents aren't available on this "
+                          "backend — it may be running an older version.")}
     except Exception as exc:  # noqa: BLE001 — degrade to empty, surface the reason
-        return {"agents": [], "error": str(exc)}
-    return {"agents": rows, "error": ""}
+        return {"agents": shared, "error": str(exc), "shared_error": shared_error}
+    own = {r.get("name") for r in rows}
+    return {"agents": rows + [s for s in shared if s["name"] not in own], "error": "",
+            "shared_error": shared_error}
 
 
 def _flat_agent(row: dict, source: str, *, chattable: bool, department_id: str = "") -> dict:
@@ -640,6 +678,14 @@ async def agent_vars(name: str = Query(...)) -> dict:
     from sdk.agents import varstore as agent_varstore
 
     manifest = next((m for m in load_agents() if m.name == name), None)
+    if manifest is None:
+        # Platform agents (yours, department, shared with you) live on the backend,
+        # not in ~/.agentos/agents — read their prompt there so the inputs render.
+        try:
+            from sdk.agents.chat import resolve_agent
+            manifest = await resolve_agent(name)
+        except Exception:  # noqa: BLE001 — unknown / unreachable: no inputs to show
+            manifest = None
     names = extract_variables(manifest.prompt) if manifest else []
     values = agent_varstore.load_vars(name)
     return {"name": name, "variables": names,
@@ -1816,11 +1862,19 @@ async def custom_agents_list() -> dict:
     backend, which decides what is yours."""
     from sdk import custom_agents
 
-    scopes, err = await custom_agents.list_agents(_ticket_client())
+    client = _ticket_client()
+    scopes, err = await custom_agents.list_agents(client)
     if scopes is None:
         raise HTTPException(status_code=502, detail=err)
-    return {scope: [custom_agents.editable_view(r) for r in rows]
-            for scope, rows in scopes.items()}
+    out = {scope: [custom_agents.editable_view(r) for r in rows]
+           for scope, rows in scopes.items()}
+    # Accepted shares: read-only here (Run / Remove), never Edit or Delete.
+    shared, shared_error = await _shared_agent_rows(client)
+    out["shared"] = [{"id": s.get("id"), "name": s["name"], "status": s.get("status"),
+                      "shared_by": s["shared_by"], "via": s["via"], "share_id": s["share_id"]}
+                     for s in shared]
+    out["shared_error"] = shared_error
+    return out
 
 
 @router.post("/agents/custom", dependencies=[_auth])

{devops_bot_sdk-1.7.5 → devops_bot_sdk-1.7.6}/sdk/ui/static/app.js

@@ -457,8 +457,10 @@
     async function act(path, method, okMsg) {
       try { await api(path, { method }); toast(okMsg, "ok"); }
       catch (e) { toast(e.message, "err"); }
-      loadShared();
+      // Accept / Remove changes which agents you have: the lists above reload too.
+      document.dispatchEvent(new CustomEvent("agentos:shares-changed"));
     }
+    document.addEventListener("agentos:shares-changed", () => loadShared());
     async function loadShared() {
       const box = $("sh-list");
       document.querySelectorAll("[data-shtab]").forEach(b => b.classList.toggle("primary", b.dataset.shtab === tab));
@@ -488,7 +490,7 @@
             return `<tr><td><div class="nm">${esc(x.agent_name)}</div>${x.message ? `<div class="sub">“${esc(x.message)}”</div>` : ""}</td>
               <td>${esc(who || "?")}${via}</td><td>${pill(x.status)}</td><td class="sub mono">${esc(when)}</td><td class="acts">${acts}</td></tr>`;
           }).join("") + `</tbody></table>`;
-        box.querySelectorAll("[data-acc]").forEach(b => b.onclick = () => act(`/api/ui/agents/shares/${b.dataset.acc}/accept`, "POST", "Accepted — it is now in your agents"));
+        box.querySelectorAll("[data-acc]").forEach(b => b.onclick = () => act(`/api/ui/agents/shares/${b.dataset.acc}/accept`, "POST", "Accepted — it's now in your custom agents"));
         box.querySelectorAll("[data-dec]").forEach(b => b.onclick = () => act(`/api/ui/agents/shares/${b.dataset.dec}/decline`, "POST", "Declined"));
         box.querySelectorAll("[data-rm]").forEach(b => b.onclick = () => {
           if (!confirm(tab === "incoming" ? "Remove this shared agent from your list?" : "Revoke this share? They lose access.")) return;
@@ -1094,17 +1096,27 @@
           return;
         }
         caMeta = {}; rows.forEach(a => { caMeta[a.name] = a; });
+        const own = rows.filter(a => a.source !== "shared"), shared = rows.filter(a => a.source === "shared");
         const kaSel = $("key-agent");
         if (kaSel) {
-          kaSel.innerHTML = rows.length
-            ? rows.map(a => `<option value="${esc(a.name)}">${esc(a.name)}</option>`).join("")
-            : `<option value="">(no agents yet)</option>`;
+          const opt = (a) => `<option value="${esc(a.name)}">${esc(a.name)}${a.shared_by ? " — from " + esc(a.shared_by) : ""}</option>`;
+          kaSel.innerHTML = !rows.length ? `<option value="">(no agents yet)</option>`
+            : !shared.length ? own.map(opt).join("")
+            : (own.length ? `<optgroup label="Your agents">${own.map(opt).join("")}</optgroup>` : "")
+              + `<optgroup label="Shared with you">${shared.map(opt).join("")}</optgroup>`;
           onAgentSelect();
         }
         // Custom agents: full control for everyone (view / Edit-content / enable /
-        // disable / delete) — RBAC applies only to department agents.
+        // disable / delete) — RBAC applies only to department agents. Agents shared
+        // with you (accepted) are someone else's: Run and Remove only.
         $("local-agents").innerHTML = rows.length ? rows.map(a => {
           const enc = encodeURIComponent(a.name);
+          if (a.source === "shared") {
+            const from = `<span class="pill shared">shared</span> <span class="muted" style="font-size:12.5px">from <b>${esc(a.shared_by || "?")}</b>${a.via ? " · via " + esc(a.via) : ""}</span>`;
+            return agentCardHTML(a, `${from}<span class="spacer" style="flex:1"></span>
+              <a class="btn primary" href="/agents.html?agent=${enc}">Run</a>
+              ${a.share_id ? `<button class="btn ghost danger" data-unshare="${esc(a.share_id)}" data-name="${esc(a.name)}">Remove</button>` : ""}`);
+          }
           const actions = [
             `<a class="btn primary" href="/agents.html?agent=${enc}">Run</a>`,
             `<button class="btn" data-edit="${esc(a.name)}">Edit</button>`,
@@ -1117,6 +1129,7 @@
           : "<div class='empty'>No custom agents assigned to you yet. Create one under <b>Your platform agents</b> below, or in the web app.</div>";
 
         wireContentToggles($("local-agents"));
+        $("local-agents").querySelectorAll("[data-unshare]").forEach(b => b.onclick = () => removeShared(b.dataset.unshare, b.dataset.name));
         $("local-agents").querySelectorAll("[data-enable]").forEach(b => b.onclick = () => setStatus(b.dataset.enable, "active"));
         $("local-agents").querySelectorAll("[data-disable]").forEach(b => b.onclick = () => setStatus(b.dataset.disable, "disabled"));
         $("local-agents").querySelectorAll("[data-del]").forEach(b => b.onclick = async () => {
@@ -1187,6 +1200,17 @@
       if ($("key-add-toggle")) $("key-add-toggle").textContent = "+ Add API key";
     }
 
+    // Drop an agent someone shared with you (they can share it again later).
+    async function removeShared(shareId, name) {
+      if (!confirm(`Remove “${name}” from your agents? The owner can share it with you again.`)) return;
+      try {
+        await api(`/api/ui/agents/shares/${encodeURIComponent(shareId)}`, { method: "DELETE" });
+        toast("Removed " + name, "ok");
+      } catch (e) { toast("Remove failed: " + (e.message || ""), "err"); }
+      document.dispatchEvent(new CustomEvent("agentos:shares-changed"));
+    }
+    document.addEventListener("agentos:shares-changed", () => { loadLocalAgents(); cfLoad(); });
+
     function onAgentSelect() {
       const m = caMeta[$("key-agent") && $("key-agent").value];
       if ($("ca-about")) $("ca-about").textContent = m ? (m.description || "No description provided.") : "Pick an agent.";
@@ -1481,10 +1505,19 @@
             <button class="btn danger cf-del" data-id="${esc(a.id)}" data-name="${esc(a.name)}">Delete</button>`
               : `<span class="muted" style="font-size:12px">read-only</span>`}
           </div>`;
-        const personal = d.personal || [], dept = d.department || [];
-        box.innerHTML = (personal.length || dept.length)
+        const personal = d.personal || [], dept = d.department || [], shared = d.shared || [];
+        const sharedRow = (a) => `<div class="cf-item">
+            <span class="n">${esc(a.name)}</span>
+            <span class="pill shared">shared</span>
+            <span class="muted" style="font-size:12.5px">from <b>${esc(a.shared_by || "?")}</b>${a.via ? " · via " + esc(a.via) : ""}</span>
+            <a class="btn" href="/agents.html?agent=${encodeURIComponent(a.name)}">Run</a>
+            ${a.share_id ? `<button class="btn ghost danger cf-unshare" data-id="${esc(a.share_id)}" data-name="${esc(a.name)}">Remove</button>` : ""}
+          </div>`;
+        box.innerHTML = (personal.length || dept.length || shared.length)
           ? personal.map(a => row(a, true)).join("") + dept.map(a => row(a, false)).join("")
+            + (shared.length ? `<div class="cf-group">Shared with you</div>` + shared.map(sharedRow).join("") : "")
           : `<div class="empty">No platform agents yet — press <b>New agent</b>.</div>`;
+        box.querySelectorAll(".cf-unshare").forEach(b => b.onclick = () => removeShared(b.dataset.id, b.dataset.name));
         box.querySelectorAll(".cf-edit").forEach(b => b.onclick = () => cfOpen(b.dataset.id));
         box.querySelectorAll(".cf-del").forEach(b => b.onclick = () => cfDelete(b.dataset.id, b.dataset.name));
       } catch (e) {

{devops_bot_sdk-1.7.5 → devops_bot_sdk-1.7.6}/sdk/ui/static/styles.css

@@ -857,3 +857,7 @@ select:focus, input[type=number]:focus, input[type=time]:focus, input[type=datet
 .hp-ask-row { display: grid; gap: 6px; font-size: 14px; }
 .hp-ask-row input { width: 100%; }
 .hp-asks-send { justify-self: start; }
+
+/* Agents shared with you, on the Custom Agents page */
+.pill.shared { background: color-mix(in srgb, var(--violet, #7c3aed) 14%, transparent); color: var(--violet, #7c3aed); }
+.cf-group { font-size: 12px; font-weight: 700; letter-spacing: .04em; text-transform: uppercase; color: var(--muted); padding: 14px 0 4px; }

{devops_bot_sdk-1.7.5 → devops_bot_sdk-1.7.6}/tests/test_agent_listing.py

@@ -168,3 +168,91 @@ class TestUiAgentsAll:
         with patch("sdk.client.BackendClient.from_config", return_value=client):
             out = await api.agents_all(department_id="d-1")
         assert [(a["name"], a["source"]) for a in out["agents"]] == [("Shared", "custom")]
+
+
+def _shared_row(name, *, by="Javaid Iqbal", via=None, share_id="sh-1"):
+    return {**_row(name, variables=("repo",)), "relation_id": "someone-else", "source": "shared",
+            "share_id": share_id, "shared_by": {"id": "u-j", "name": by, "email": "j@x"},
+            "via_team": via}
+
+
+class TestSharedAgentsOnCustomAgentsPage:
+    """Accepted shares appear on Custom Agents next to your own — by NAME, read-only."""
+
+    @pytest.mark.asyncio
+    async def test_installed_list_includes_accepted_shares(self):
+        from sdk.ui import api
+
+        client = SimpleNamespace(
+            list_custom_agents=AsyncMock(return_value=[_row("mine"), _row("clash")]),
+            list_shared_agents=AsyncMock(return_value=[
+                _shared_row("release-notes", via={"id": "d1", "name": "Machine Learning", "kind": "department"}),
+                _shared_row("clash")]),
+        )
+        with patch("sdk.client.BackendClient.from_config", return_value=client):
+            out = await api.agents()
+        names = [(a["name"], a.get("source")) for a in out["agents"]]
+        assert names == [("mine", None), ("clash", None), ("release-notes", "shared")]
+        shared = out["agents"][-1]
+        assert shared["shared_by"] == "Javaid Iqbal" and shared["share_id"] == "sh-1"
+        assert shared["via"] == "department Machine Learning"
+        assert out["shared_error"] == ""
+
+    @pytest.mark.asyncio
+    async def test_backend_without_sharing_is_not_an_error(self):
+        from sdk.exceptions import BackendFeatureMissing
+        from sdk.ui import api
+
+        client = SimpleNamespace(
+            list_custom_agents=AsyncMock(return_value=[_row("mine")]),
+            list_shared_agents=AsyncMock(side_effect=BackendFeatureMissing("Agent sharing", "u")),
+        )
+        with patch("sdk.client.BackendClient.from_config", return_value=client):
+            out = await api.agents()
+        assert [a["name"] for a in out["agents"]] == ["mine"] and out["shared_error"] == ""
+
+    @pytest.mark.asyncio
+    async def test_platform_list_has_a_shared_group(self):
+        from sdk.ui import api
+
+        client = SimpleNamespace(
+            list_gateway_agents_by_scope=AsyncMock(return_value={"personal": [], "department": []}),
+            list_shared_agents=AsyncMock(return_value=[_shared_row("release-notes", via={"id": "t", "name": "AI Team"})]),
+        )
+        with patch("sdk.client.BackendClient.from_config", return_value=client):
+            out = await api.custom_agents_list()
+        assert out["shared"] == [{"id": "id-release-notes", "name": "release-notes", "status": "active",
+                                  "shared_by": "Javaid Iqbal", "via": "team AI Team", "share_id": "sh-1"}]
+
+    @pytest.mark.asyncio
+    async def test_inputs_of_a_platform_or_shared_agent_render(self):
+        from sdk.ui import api
+
+        client = SimpleNamespace(
+            list_custom_agents=AsyncMock(return_value=[]),
+            list_department_agents=AsyncMock(return_value=[]),
+            list_shared_agents=AsyncMock(return_value=[
+                {**_shared_row("release-notes"),
+                 "prompt": {"system_prompt": "Write notes for {{repo}} since {{tag}}.",
+                            "variables": [{"name": "repo"}, {"name": "tag"}]}}]),
+        )
+        with patch("sdk.client.BackendClient.from_config", return_value=client), \
+             patch("sdk.agents.manifest.load_agents", return_value=[]), \
+             patch("sdk.agents.chat._find_agent", return_value=None):
+            out = await api.agent_vars(name="release-notes")
+        assert out["variables"] == ["repo", "tag"]
+
+    @pytest.mark.asyncio
+    async def test_405_from_an_old_backend_means_not_deployed(self):
+        from sdk.client import BackendClient
+        from sdk.exceptions import BackendFeatureMissing
+
+        client = BackendClient.__new__(BackendClient)
+        client._base_url, client._headers = "https://b", {}
+        client._url = lambda p: "https://b" + p
+        resp = SimpleNamespace(status_code=405, json=lambda: {})
+        http = AsyncMock()
+        http.__aenter__.return_value.get = AsyncMock(return_value=resp)
+        with patch("sdk.client.httpx.AsyncClient", return_value=http):
+            with pytest.raises(BackendFeatureMissing):
+                await client.list_shared_agents()