devops-bot-sdk 1.4.37__tar.gz → 1.4.39__tar.gz

{devops_bot_sdk-1.4.37 → devops_bot_sdk-1.4.39}/PKG-INFO

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

{devops_bot_sdk-1.4.37 → devops_bot_sdk-1.4.39}/devops_bot_sdk.egg-info/PKG-INFO

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

{devops_bot_sdk-1.4.37 → devops_bot_sdk-1.4.39}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "devops-bot-sdk"
-version = "1.4.37"
+version = "1.4.39"
 description = "DevOps Bot Desktop SDK — thin client for the AgentOS Electron desktop app"
 readme = "README.md"
 license = "LicenseRef-Proprietary"

{devops_bot_sdk-1.4.37 → devops_bot_sdk-1.4.39}/sdk/__init__.py

@@ -1,6 +1,6 @@
 """AgentOS Desktop SDK — thin HTTPS/SSE client for the Electron app.
 
-Version: 1.4.37
+Version: 1.4.39
 
 Public surface:
   BackendClient.from_config()        — create client from ~/.agentos/config.toml
@@ -30,7 +30,7 @@ Rules:
   - All data egress through submit_webhook only
 """
 
-__version__ = "1.4.37"
+__version__ = "1.4.39"
 __author__  = "AgentOS"
 
 from sdk.client import BackendClient

{devops_bot_sdk-1.4.37 → devops_bot_sdk-1.4.39}/sdk/client.py

@@ -58,7 +58,7 @@ def _notify_status(task_id: str, status: str) -> None:
             pass
 
 
-SDK_VERSION    = "1.4.37"
+SDK_VERSION    = "1.4.39"
 _POLL_INTERVAL = 3.0
 _POLL_TIMEOUT  = 600.0
 _ORCHESTRATE_TIMEOUT      = 2700.0  # 45 min — covers approval wait + VPS execution time
@@ -803,6 +803,71 @@ class BackendClient:
             logger.warning("client.mark_in_progress error task=%s err=%s", task_id, exc)
             return False
 
+    async def update_task_ml(
+        self, task_id: str, fields: dict, model_used: list[str] | None = None,
+    ) -> bool:
+        """PUT {BE}/tasks-ml/{id} with arbitrary multipart form fields (best-effort).
+
+        Generic form-update used e.g. to mark an Epic Done while attaching the
+        generated detailed description + AI plan. `model_used` is sent as repeated
+        `modelUsed` fields. None-valued fields are dropped. Returns True on 2xx.
+        """
+        from sdk.config import BE_DEFAULT_URL
+
+        url = f"{BE_DEFAULT_URL.rstrip('/')}/tasks-ml/{task_id}"
+        headers = {k: v for k, v in self._headers.items() if k.lower() != "content-type"}
+        headers.update({"accept": "*/*", "developer-name": "null", "product": ""})
+        # httpx multipart wants a list of (name, (filename, value)) tuples so a
+        # field like `modelUsed` can repeat.
+        files = [(k, (None, str(v))) for k, v in fields.items() if v is not None]
+        for m in (model_used or []):
+            files.append(("modelUsed", (None, str(m))))
+        try:
+            async with httpx.AsyncClient(timeout=30.0) as client:
+                resp = await client.put(url, files=files, headers=headers)
+            if resp.status_code >= 400:
+                logger.warning("client.update_task_ml failed task=%s status=%s body=%s",
+                               task_id, resp.status_code, resp.text[:200])
+                return False
+            return True
+        except Exception as exc:  # noqa: BLE001
+            logger.warning("client.update_task_ml error task=%s err=%s", task_id, exc)
+            return False
+
+    async def create_task_ml(
+        self, fields: dict, model_used: list[str] | None = None,
+    ) -> str | None:
+        """POST {BE}/tasks-ml — create a task via multipart form; return its id.
+
+        Required fields per the API: projectKey, type, summary (description
+        optional but recommended). Used to spin a To Do child Task off a decomposed
+        Epic. Returns the new task id on success, else None (best-effort).
+        """
+        from sdk.config import BE_DEFAULT_URL
+
+        url = f"{BE_DEFAULT_URL.rstrip('/')}/tasks-ml"
+        headers = {k: v for k, v in self._headers.items() if k.lower() != "content-type"}
+        headers.update({"accept": "*/*", "developer-name": "null", "product": ""})
+        files = [(k, (None, str(v))) for k, v in fields.items() if v is not None]
+        for m in (model_used or []):
+            files.append(("modelUsed", (None, str(m))))
+        try:
+            async with httpx.AsyncClient(timeout=30.0) as client:
+                resp = await client.post(url, files=files, headers=headers)
+            if resp.status_code >= 400:
+                logger.warning("client.create_task_ml failed status=%s body=%s",
+                               resp.status_code, resp.text[:300])
+                return None
+            body = resp.json() or {}
+            rec = body.get("data") or body
+            # The created record's id may sit at data.id or data.record.id.
+            if isinstance(rec, dict):
+                return rec.get("id") or ((rec.get("record") or {}).get("id"))
+            return None
+        except Exception as exc:  # noqa: BLE001
+            logger.warning("client.create_task_ml error err=%s", exc)
+            return None
+
     async def log_activity(self, activity: str) -> bool:
         """POST /ml-api/agent-activity — emit an agent activity event (best-effort).
 

{devops_bot_sdk-1.4.37 → devops_bot_sdk-1.4.39}/sdk/ipc/handlers.py

@@ -351,6 +351,196 @@ def _parse_scope(recon_text: str | None) -> str:
     return "in"
 
 
+# ── Epic decomposition ────────────────────────────────────────────────────
+# An EPIC is not coded directly. It is analysed (grounded in the codebase when a
+# project path exists) into a detailed user-story description + an implementation
+# plan; the Epic is then marked Done with that content and one To Do child Task is
+# created per generated story (inheriting the Epic's project/assignee/priority/…).
+_MAX_EPIC_STORIES = int(os.getenv("AGENTOS_MAX_EPIC_STORIES", "") or 8)
+# Label recorded in the ticket's modelUsed on Epic completion.
+_EPIC_MODELS = [m.strip() for m in (os.getenv("AGENTOS_EPIC_MODELS", "") or "claude-code").split(",") if m.strip()]
+
+
+def _build_epic_prompt(jira_key: str, summary: str, description: str | None,
+                       human_instructions: str | None) -> str:
+    """Read-only prompt that turns an Epic into a decomposition JSON."""
+    parts: list[str] = [
+        "You are decomposing a JIRA EPIC into implementable work. This is ANALYSIS "
+        "ONLY — do NOT create, edit, or delete any file.",
+        f"=== EPIC {jira_key} ===\nSummary: {summary}",
+    ]
+    if description and description.strip():
+        parts.append("Description:\n" + _clip_text(description.strip()))
+    if human_instructions and human_instructions.strip():
+        parts.append(
+            "Operator instructions (authoritative — carry any project location / "
+            "constraints into each story's humanInstructions):\n"
+            + human_instructions.strip()
+        )
+    parts.append(
+        "First understand the existing codebase in this directory (read CLAUDE.md, "
+        "use graphify / Read / Glob / Grep) so the stories fit the REAL architecture. "
+        "Then produce the decomposition.\n\n"
+        "Output ONLY a single fenced ```json block and nothing after it, with shape:\n"
+        "{\n"
+        '  "epic_description": "A detailed description for the epic: a full user-story '
+        "write-up covering goal, the user stories, acceptance criteria and scope.\",\n"
+        '  "plan": "An ordered, numbered high-level implementation plan.",\n'
+        '  "stories": [\n'
+        '    {\n'
+        '      "summary": "Short imperative story title (a JIRA task summary)",\n'
+        '      "description": "Detailed description: what to build + acceptance criteria.",\n'
+        '      "humanInstructions": "Operator instructions to implement THIS story. MUST '
+        "repeat the same project location/path and constraints from the epic so the "
+        'coding run works in the right place.",\n'
+        '      "points": 5\n'
+        "    }\n"
+        "  ]\n"
+        "}\n"
+        "Create as many stories as the epic genuinely needs (do not pad or truncate "
+        "artificially); each story must be independently implementable."
+    )
+    return "\n\n".join(parts)
+
+
+def _extract_json_block(text: str | None) -> dict | None:
+    """Parse the decomposition JSON from a claude response (fenced block preferred)."""
+    if not text:
+        return None
+    import json as _json
+    candidates = re.findall(r"```(?:json)?\s*(\{.*?\})\s*```", text, re.S | re.I)
+    if not candidates:
+        start, end = text.find("{"), text.rfind("}")
+        if start != -1 and end > start:
+            candidates = [text[start:end + 1]]
+    for c in reversed(candidates):
+        try:
+            obj = _json.loads(c)
+            if isinstance(obj, dict):
+                return obj
+        except Exception:  # noqa: BLE001
+            continue
+    return None
+
+
+def _epic_inherited_fields(task: dict) -> dict:
+    """Parent-Epic fields a child Task should inherit (drops empties)."""
+    def _date(v: object) -> str | None:
+        s = str(v or "")
+        return s[:10] if s else None   # ISO datetime → YYYY-MM-DD
+
+    fields = {
+        "projectKey": task.get("projectKey"),
+        "priority": task.get("priority"),
+        "assigneeEmail": (task.get("assignee") or {}).get("email"),
+        "teamId": task.get("teamId"),
+        "startDate": _date(task.get("startDate")),
+        "dueDate": _date(task.get("dueDate")),
+        "slaTarget": task.get("slaTarget"),
+    }
+    sprint = task.get("sprint") or {}
+    if sprint.get("jiraSprintId"):
+        fields["jiraSprintId"] = sprint["jiraSprintId"]
+    return {k: v for k, v in fields.items() if v}
+
+
+async def _handle_epic(
+    client: BackendClient, task: dict, payload: dict, send: Callable, thread_id: str,
+) -> None:
+    """Decompose an Epic: generate user stor(y|ies), mark the Epic Done with the
+    detailed description + plan, then create a To Do child Task per story.
+
+    Child tasks are created in "To Do"; a later `agentos-auto` run picks them up and
+    implements them through the normal grounded pipeline. Best-effort throughout —
+    a failure returns the Epic to Backlog for human review rather than raising.
+    """
+    from sdk import local_exec, graphify
+
+    tid = str(task.get("id", ""))
+    jira_key = task.get("jiraIssueKey") or task.get("jiraKey", "") or "EPIC"
+    summary = task.get("summary", "") or ""
+    description = task.get("description")
+    human = task.get("humanInstructions")
+    project_path = _resolve_local_project_path(task, payload)
+
+    await client.mark_in_progress(tid)
+    await send(Envelope(
+        type="step_update", thread_id=thread_id,
+        data={"jira_task_id": tid, "task_id": tid,
+              "current_step": f"Epic {jira_key}: analysing & generating user stories"},
+    ).model_dump())
+
+    # 1. Generate the decomposition, grounded in the codebase where one exists.
+    try:
+        await graphify.prepare(project_path)
+    except Exception:  # noqa: BLE001
+        pass
+    gen = await local_exec.run_claude_local(
+        _build_epic_prompt(jira_key, summary, description, human),
+        project_path, allowed_tools=_RECON_ALLOWED_TOOLS,  # read-only analysis
+        github_token=await client.github_token(),
+    )
+    doc = _extract_json_block(gen.get("result")) if gen.get("ok") else None
+    stories = (doc or {}).get("stories") or []
+    if not doc or not stories:
+        reason = (gen.get("error") or "could not generate a valid decomposition")[:200]
+        await client.log_activity(f"Epic {jira_key}: decomposition failed — {reason}")
+        await client.move_to_backlog(tid)
+        await send(Envelope(
+            type=Envelope.TYPE_ERROR, thread_id=thread_id,
+            data={"code": "EPIC_DECOMPOSE_FAILED", "task_id": tid, "message": reason},
+        ).model_dump())
+        return
+
+    # 2. Mark the Epic Done with the detailed description + plan.
+    epic_desc = (doc.get("epic_description") or description or summary or "")[:20000]
+    plan = (doc.get("plan") or "")[:8000]
+    await client.update_task_ml(
+        tid, {"status": "Done", "description": epic_desc, "initialAiPlan": plan},
+        model_used=_EPIC_MODELS,
+    )
+    await send(Envelope(
+        type="step_update", thread_id=thread_id,
+        data={"jira_task_id": tid, "current_step": f"Epic {jira_key}: marked Done — "
+              f"creating {min(len(stories), _MAX_EPIC_STORIES)} child task(s)"},
+    ).model_dump())
+
+    # 3. Create a To Do child Task per story, inheriting the Epic's fields.
+    inherited = _epic_inherited_fields(task)
+    created: list[str] = []
+    for st in stories[:_MAX_EPIC_STORIES]:
+        if not isinstance(st, dict) or not (st.get("summary") or "").strip():
+            continue
+        fields = {
+            **inherited,
+            "type": "Task",
+            "status": "To Do",
+            "summary": str(st.get("summary", "")).strip()[:250],
+            "description": str(st.get("description", "") or "")[:20000],
+            "humanInstructions": str(st.get("humanInstructions") or human or "")[:20000] or None,
+            "parentTaskId": tid,
+        }
+        if st.get("points"):
+            fields["points"] = st["points"]
+        new_id = await client.create_task_ml(fields, model_used=_EPIC_MODELS)
+        if new_id:
+            created.append(new_id)
+            await send(Envelope(
+                type="step_update", thread_id=thread_id,
+                data={"current_step": f"  ↳ created To Do task: {fields['summary']}"},
+            ).model_dump())
+
+    await client.log_activity(
+        f"Epic {jira_key}: Done — created {len(created)}/{len(stories)} child To Do task(s)"
+    )
+    await send(Envelope(
+        type="step_update", thread_id=thread_id,
+        data={"jira_task_id": tid,
+              "current_step": f"Epic {jira_key} complete — {len(created)} child task(s) queued "
+                              "(run again to implement them)"},
+    ).model_dump())
+
+
 async def _run_local_pipeline(
     client: BackendClient, payload: dict, send: Callable
 ) -> None:
@@ -2189,6 +2379,27 @@ async def handle_orchestrate_auto_local_run(
                       "project_path": project_path, "jira_task_id": tid, "agent_mode": agent_mode},
             ).model_dump())
 
+            # EPIC → decompose (generate user stories, mark Done, create To Do
+            # child tasks) instead of coding it directly. Isolated like every other
+            # task: a failure here must not abort the remaining queue.
+            if str(task.get("type") or "").strip().lower() == "epic":
+                try:
+                    await _handle_epic(client, task, payload, send, thread_id)
+                except Exception as exc:  # noqa: BLE001
+                    logger.warning("auto_local.epic_failed task=%s err=%s", tid, exc)
+                    try:
+                        await client.log_activity(f"Task {tid}: epic decomposition errored — {str(exc)[:200]}")
+                        await client.move_to_backlog(tid)
+                    except Exception:  # noqa: BLE001
+                        pass
+                    await send(Envelope(
+                        type=Envelope.TYPE_ERROR, thread_id=thread_id,
+                        data={"code": "EPIC_DECOMPOSE_FAILED", "task_id": tid,
+                              "message": str(exc)[:200]},
+                    ).model_dump())
+                processed += 1
+                continue
+
             task_payload = {
                 "thread_id": thread_id,
                 "jira_task_id": tid,