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

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: devops-bot-sdk
-Version: 1.6.93
+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.6.93 → 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.6.93
+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.6.93 → devops_bot_sdk-1.7.6}/devops_bot_sdk.egg-info/SOURCES.txt

@@ -7,6 +7,7 @@ devops_bot_sdk.egg-info/entry_points.txt
 devops_bot_sdk.egg-info/requires.txt
 devops_bot_sdk.egg-info/top_level.txt
 sdk/__init__.py
+sdk/agent_sharing.py
 sdk/agentd.py
 sdk/browser_profile.py
 sdk/claude_usage.py
@@ -15,6 +16,7 @@ sdk/client.py
 sdk/config.py
 sdk/crucial.py
 sdk/custom_agents.py
+sdk/deferred_tickets.py
 sdk/departments.py
 sdk/estimator.py
 sdk/exceptions.py
@@ -26,12 +28,15 @@ sdk/github_fetch.py
 sdk/github_ingest.py
 sdk/graph_recon.py
 sdk/graphify.py
+sdk/help_actions.py
 sdk/helpdesk.py
 sdk/helpdesk_kb.md
 sdk/intake.py
 sdk/journal.py
 sdk/local_exec.py
+sdk/log_colors.py
 sdk/memory_guard.py
+sdk/model_policy.py
 sdk/phase_timer.py
 sdk/plan_run.py
 sdk/platform_compat.py
@@ -52,6 +57,7 @@ sdk/task_file.py
 sdk/task_types.py
 sdk/test.py
 sdk/test_pipeline.py
+sdk/ticket_board.py
 sdk/ticket_fields.py
 sdk/tickets.py
 sdk/updater.py
@@ -162,6 +168,7 @@ tests/test_agent_prompt_async.py
 tests/test_agent_prompt_models.py
 tests/test_agent_run_ticket.py
 tests/test_agent_schedules.py
+tests/test_agent_sharing.py
 tests/test_agent_workspace_settings.py
 tests/test_agents_connectors_builder.py
 tests/test_allowed_tools_config.py
@@ -177,6 +184,7 @@ tests/test_configure_token_owner.py
 tests/test_console_encoding.py
 tests/test_crash_recovery.py
 tests/test_create_safe_retry.py
+tests/test_deferred_tickets.py
 tests/test_departments.py
 tests/test_done_transition.py
 tests/test_epic_decompose_run.py
@@ -194,7 +202,9 @@ tests/test_graph_recon.py
 tests/test_graphify_build.py
 tests/test_graphify_hook_install.py
 tests/test_health.py
+tests/test_help_actions.py
 tests/test_help_attachments.py
+tests/test_help_questions.py
 tests/test_helpdesk.py
 tests/test_infographic_data.py
 tests/test_intake_job_outcome.py
@@ -202,10 +212,13 @@ tests/test_intake_plan_review.py
 tests/test_journal.py
 tests/test_limit_fallback_handoff.py
 tests/test_local_exec_provider.py
+tests/test_log_colors_backlog.py
 tests/test_mcp_route_contract.py
 tests/test_memory_guard.py
+tests/test_model_policy.py
 tests/test_panel_help.py
 tests/test_panel_ticket_schedules.py
+tests/test_parallel_tickets.py
 tests/test_phase_timer.py
 tests/test_plan_new_command.py
 tests/test_plan_run_activity.py
@@ -231,6 +244,7 @@ tests/test_stale_panel_restart.py
 tests/test_swagger_command.py
 tests/test_task_file_and_plan_run.py
 tests/test_task_file_format_doc.py
+tests/test_ticket_board.py
 tests/test_ticket_cli.py
 tests/test_ticket_fields.py
 tests/test_ticket_run_resolve_by_id.py

{devops_bot_sdk-1.6.93 → 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.6.93
+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.6.93"   # 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.6.93 → devops_bot_sdk-1.7.6}/sdk/activity/collectors/windows_eventlog.py

@@ -80,12 +80,45 @@ class WinEvent:
     data: dict[str, str]
 
 
+#: Characters XML 1.0 forbids. ``wevtutil`` writes them unescaped — most often an ESC
+#: from coloured terminal output in a 4688 command line — and expat rejects the whole
+#: document with "not well-formed (invalid token)".
+_XML_INVALID = re.compile(r"[\x00-\x08\x0b\x0c\x0e-\x1f￾￿]")
+#: Start of each top-level record; the ``[\s>]`` keeps ``<EventID>`` / ``<EventData>`` out.
+_EVENT_START = re.compile(r"(?=<Event[\s>])")
+
+
 def parse_events(xml_text: str | None) -> list[WinEvent]:
-    """Parse ``wevtutil qe ... /f:xml`` output (a bare run of ``<Event>`` elements)."""
-    xml_text = (xml_text or "").strip()
+    """Parse ``wevtutil qe ... /f:xml`` output (a bare run of ``<Event>`` elements).
+
+    Never lets one bad record poison the batch. The poll loop only advances its
+    bookmark past records that parsed, so a batch that failed as a whole was re-read
+    and re-failed every poll forever — the machine silently stopped reporting.
+    Characters XML forbids are replaced first; if the batch still does not parse,
+    each record is parsed on its own and the unparseable ones are skipped.
+    """
+    xml_text = _XML_INVALID.sub("�", (xml_text or "").strip())
     if not xml_text:
         return []
-    root = ET.fromstring(f"<Events>{xml_text}</Events>")
+    try:
+        return _parse_root(ET.fromstring(f"<Events>{xml_text}</Events>"))
+    except ET.ParseError as exc:
+        logger.warning("eventlog: batch did not parse (%s); parsing records one by one", exc)
+    out: list[WinEvent] = []
+    skipped = 0
+    for chunk in _EVENT_START.split(xml_text):
+        if not chunk.strip():
+            continue
+        try:
+            out.extend(_parse_root(ET.fromstring(f"<Events>{chunk}</Events>")))
+        except ET.ParseError:
+            skipped += 1
+    if skipped:
+        logger.warning("eventlog: skipped %d unparseable record(s)", skipped)
+    return out
+
+
+def _parse_root(root: ET.Element) -> list[WinEvent]:
     out: list[WinEvent] = []
     for ev in root.iter(f"{_NS}Event"):
         sysnode = ev.find(f"{_NS}System")

devops_bot_sdk-1.7.6/sdk/agent_sharing.py

@@ -0,0 +1,138 @@
+"""Share your custom agents with a person or a team — they accept before it appears.
+
+The one implementation behind ``agentos agent share|shares|accept|decline|unshare``
+and the Custom Agents page. State lives on the AI backend (devops-bot-ai, Mongo
+``agent_shares``); the SDK never stores a share.
+
+Lifecycle: the OWNER shares an agent ``--to`` people (email or name) and/or a team
+by name ("AI Team" → one invite per member). Each recipient gets a ``pending``
+invite and ACCEPTS or DECLINES it; only accepted shares show up in their "Shared
+with me" list and become runnable (``sdk.agents.chat.resolve_agent`` reads them).
+It is a live reference, not a copy: the owner's later edits reach recipients, and
+the owner can revoke at any time. Secret NAMES travel with the agent; values never
+do — a recipient stores their own keys (``agentos agent set-key``).
+
+Every function returns a dict with ``ok`` and, on failure, ``error``; none raise.
+"""
+from __future__ import annotations
+
+from typing import Any
+
+_NOT_DEPLOYED = ("agent sharing isn't available on the AI backend yet — it ships with "
+                 "the devops-bot-ai update; ask your admin to deploy it")
+
+
+def _fail(client, fallback: str) -> dict:
+    err = getattr(client, "last_share_error", None) or {}
+    status = err.get("statusCode") if isinstance(err, dict) else None
+    detail = err.get("detail") if isinstance(err, dict) else None
+    if isinstance(detail, dict):
+        detail = detail.get("message") or detail.get("detail") or str(detail)
+    if detail is None and isinstance(err, dict):
+        detail = err.get("error")
+    text = str(detail or "").strip()
+    # A backend without sharing answers 404, or 405 where an older `/agents/{name}`
+    # route swallows the path — FastAPI's own bodies, not a real share error.
+    if status in (404, 405) and (not text or text.lower() in ("not found", "method not allowed")):
+        return {"ok": False, "error": _NOT_DEPLOYED, "status": status}
+    return {"ok": False, "error": text or fallback, "status": status}
+
+
+async def targets(client, q: str = "", kind: str = "all") -> dict:
+    """People, teams and departments (names, emails, member counts) for the picker."""
+    res = await client.share_targets(q, kind)
+    if res is None:
+        return _fail(client, "could not search people, teams and departments")
+    return {"ok": True, "people": res.get("people") or [], "teams": res.get("teams") or [],
+            "departments": res.get("departments") or []}
+
+
+async def share(client, agent: str, to: list[str], message: str = "") -> dict:
+    to = [t.strip() for t in to if t and t.strip()]
+    if not to:
+        return {"ok": False, "error": "say who to share with: --to \"Name\" or --to \"Team name\""}
+    res = await client.share_agent(agent, to, message)
+    if res is None:
+        return _fail(client, "share failed")
+    return {"ok": True, "shared": res.get("shared") or [], "skipped": res.get("skipped") or [],
+            "unresolved": res.get("unresolved") or []}
+
+
+async def shares(client, direction: str = "incoming", status: str = "all") -> dict:
+    res = await client.list_shares(direction, status)
+    if res is None:
+        return _fail(client, "could not list shares")
+    return {"ok": True, "shares": res.get("shares") or []}
+
+
+async def _resolve_id(client, ref: str, direction: str) -> tuple[str | None, str]:
+    """A share id, or a unique prefix of one (the CLI shows 8 characters)."""
+    ref = (ref or "").strip()
+    listed = await shares(client, direction, "all")
+    if not listed["ok"]:
+        return None, listed["error"]
+    hits = [s for s in listed["shares"] if str(s.get("id", "")).startswith(ref)]
+    if len(hits) == 1:
+        return str(hits[0]["id"]), ""
+    if not hits:
+        return None, f"no share {ref!r} — see `agentos agent shares`"
+    return None, f"{ref!r} matches {len(hits)} shares — give more of the id"
+
+
+async def respond(client, ref: str, accept: bool) -> dict:
+    """Accept or decline one incoming invite (``ref`` = id or unique prefix)."""
+    share_id, err = await _resolve_id(client, ref, "incoming")
+    if not share_id:
+        return {"ok": False, "error": err}
+    res = await client.respond_share(share_id, "accept" if accept else "decline")
+    if res is None:
+        return _fail(client, "could not " + ("accept" if accept else "decline"))
+    return {"ok": True, "share": res}
+
+
+async def accept_all(client) -> dict:
+    pending = await shares(client, "incoming", "pending")
+    if not pending["ok"]:
+        return pending
+    done, failed = [], []
+    for s in pending["shares"]:
+        res = await client.respond_share(str(s["id"]), "accept")
+        (done if res is not None else failed).append(s)
+    return {"ok": not failed, "accepted": done, "failed": failed,
+            **({"error": f"{len(failed)} could not be accepted"} if failed else {})}
+
+
+async def revoke(client, ref: str) -> dict:
+    """Owner revokes a share they made, or a recipient removes one they hold."""
+    share_id, err = await _resolve_id(client, ref, "outgoing")
+    if not share_id:
+        share_id, err = await _resolve_id(client, ref, "incoming")
+    if not share_id:
+        return {"ok": False, "error": err}
+    res = await client.revoke_share(share_id)
+    if res is None:
+        return _fail(client, "could not remove the share")
+    return {"ok": True, "share": res}
+
+
+def who(share: dict[str, Any], direction: str) -> str:
+    """The other party of a share, for display."""
+    if direction == "incoming":
+        name, email = share.get("owner_name"), share.get("owner_email")
+    else:
+        name, email = share.get("recipient_name"), share.get("recipient_email")
+    via = share.get("via_team") or {}
+    label = name or email or "?"
+    if email and name:
+        label = f"{name} <{email}>"
+    if not via.get("name"):
+        return label
+    return label + f" (via {'department' if via.get('kind') == 'department' else 'team'} {via['name']})"
+
+
+def recipient_label(item: dict[str, Any]) -> str:
+    """A skipped/unresolved row's person by NAME — never the raw record or id."""
+    r = item.get("recipient") or {}
+    if isinstance(r, dict) and (r.get("name") or r.get("email")):
+        return r.get("name") or r.get("email")
+    return str(item.get("to") or "?")

{devops_bot_sdk-1.6.93 → devops_bot_sdk-1.7.6}/sdk/agents/chat.py

@@ -25,6 +25,7 @@ from sdk.agents.prompt_vars import substitute_variables
 from sdk.agents import secrets as agent_secrets
 from sdk.agents import varstore as agent_varstore
 from sdk.agents import run_log
+from sdk.exceptions import BackendFeatureMissing
 
 logger = logging.getLogger("sdk.agents.chat")
 
@@ -58,6 +59,8 @@ async def _fetch_rows(fetch) -> list[dict]:
             await asyncio.sleep(delay)
         try:
             return await fetch() or []
+        except BackendFeatureMissing:
+            raise   # the endpoint is absent: retrying cannot change that
         except Exception as exc:  # noqa: BLE001 — classified by the caller
             last = exc
     assert last is not None
@@ -129,13 +132,17 @@ async def resolve_agent(name: str, client=None) -> AgentManifest:
     reasons: list[str] = []
     unreadable = False
     for label, attr in (("your agents", "list_custom_agents"),
-                        ("department defaults", "list_department_agents")):
+                        ("department defaults", "list_department_agents"),
+                        # Accepted shares (sdk/agent_sharing.py): runnable like your own.
+                        ("agents shared with you", "list_shared_agents")):
         fetch = getattr(client, attr, None)
         if fetch is None:
             continue
         try:
             rows = await _fetch_rows(fetch)
         except Exception as exc:  # noqa: BLE001 — a fetch failure is not "not found"
+            if attr == "list_shared_agents" and isinstance(exc, BackendFeatureMissing):
+                continue   # a backend without sharing has none to offer — not "unreadable"
             unreadable = True
             reasons.append(f"{label} could not be fetched ({str(exc) or type(exc).__name__})")
             continue
@@ -150,7 +157,8 @@ async def resolve_agent(name: str, client=None) -> AgentManifest:
                 )
 
     detail = "; ".join(reasons) if reasons else (
-        "not in ~/.agentos/agents/, your backend agents, or your department defaults"
+        "not in ~/.agentos/agents/, your backend agents, your department defaults, "
+        "or agents shared with you"
     )
     if unreadable:
         manifest = await _gateway_manifest(client, name)
@@ -267,6 +275,7 @@ async def run_agent(
     trigger: str = "",
     kind: str = "run",
     client=None,
+    extra_env: dict[str, str] | None = None,
 ) -> dict:
     """Run an agent once against its own standing prompt — NOT a chat turn.
 
@@ -285,7 +294,8 @@ async def run_agent(
     ``trigger`` / ``kind`` are recorded in the run's output file so a reader can
     tell a cron firing from someone pressing Run. ``client`` lets a caller that
     already has a :class:`BackendClient` reuse it instead of having one built per
-    run (see :func:`resolve_agent`).
+    run (see :func:`resolve_agent`). ``extra_env`` is added to the agent process's
+    environment on top of its stored keys (the scheduler marks its runs this way).
 
     Returns the engine's normalized result dict. Raises ``ValueError`` if any
     ``{{variable}}`` is left unfilled — the UI gates the Run button on this, and
@@ -324,14 +334,15 @@ async def run_agent(
         variables=variables, trigger=trigger,
     )
     teed = _tee_events(log_path, on_event)
+    run_env = {**(stored_secrets or {}), **(extra_env or {})} or None
 
     if manifest.engine in ("claude_code", "model"):
         result = await claude_code_engine.run(
             turn, skill_text, mcp_config, project_path=project_path,
-            on_event=teed, extra_env=stored_secrets or None,
+            on_event=teed, extra_env=run_env,
         )
     elif manifest.engine == "shell":
-        result = await shell_engine.run(turn, extra_env=stored_secrets or None)
+        result = await shell_engine.run(turn, extra_env=run_env)
     else:
         result = {
             "ok": False,