devops-bot-sdk 1.7.36__tar.gz → 1.7.43__tar.gz

{devops_bot_sdk-1.7.36 → devops_bot_sdk-1.7.43}/PKG-INFO

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

{devops_bot_sdk-1.7.36 → devops_bot_sdk-1.7.43}/devops_bot_sdk.egg-info/PKG-INFO

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

{devops_bot_sdk-1.7.36 → devops_bot_sdk-1.7.43}/devops_bot_sdk.egg-info/SOURCES.txt

@@ -60,6 +60,7 @@ sdk/swagger.py
 sdk/task_file.py
 sdk/task_types.py
 sdk/test.py
+sdk/test_env.py
 sdk/test_pipeline.py
 sdk/ticket_board.py
 sdk/ticket_bulk.py
@@ -120,6 +121,12 @@ sdk/design_verify/bootstrap.py
 sdk/design_verify/browser.py
 sdk/design_verify/compare.py
 sdk/design_verify/loop.py
+sdk/help_data/areas.json
+sdk/help_data/commands.json
+sdk/help_data/help.json
+sdk/help_data/pages.json
+sdk/help_data/releases.json
+sdk/help_data/snapshot.json
 sdk/hooks/__init__.py
 sdk/hooks/crucial_guard.py
 sdk/ipc/__init__.py
@@ -201,6 +208,7 @@ tests/test_epic_session_isolation.py
 tests/test_estimator.py
 tests/test_fallback_cli.py
 tests/test_fallback_cli_upgrade.py
+tests/test_fallback_rate_limit.py
 tests/test_faqs.py
 tests/test_firewall_open_on_update.py
 tests/test_formats.py
@@ -231,6 +239,7 @@ tests/test_panel_help.py
 tests/test_panel_ticket_schedules.py
 tests/test_parallel_tickets.py
 tests/test_phase_timer.py
+tests/test_plan_ahead.py
 tests/test_plan_new_command.py
 tests/test_plan_run_activity.py
 tests/test_pool_pr_modes.py
@@ -279,6 +288,7 @@ tests/test_updater_ignores_cwd.py
 tests/test_updater_pep668.py
 tests/test_updater_reports_the_truth.py
 tests/test_url_access.py
+tests/test_version_flag.py
 tests/test_vps_health.py
 tests/test_vps_only_reporting.py
 tests/test_windows_loop_identity.py

{devops_bot_sdk-1.7.36 → devops_bot_sdk-1.7.43}/sdk/__init__.py

@@ -1,6 +1,6 @@
 """AgentOS Desktop SDK — thin HTTPS/SSE client for the Electron app.
 
-Version: 1.7.36
+Version: 1.7.43
 
 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.36"   # SINGLE SOURCE OF TRUTH — bump on every change; pyproject,
+__version__ = "1.7.43"   # 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.36 → devops_bot_sdk-1.7.43}/sdk/cli.py

@@ -174,6 +174,11 @@ def main() -> None:
 
     noun, rest = argv[0], argv[1:]
 
+    if noun == "version" or noun in ("--version", "-V"):
+        from sdk.platform_compat import version_line
+        print(version_line())
+        return
+
     if noun == "configure":
         from sdk.config import configure_cli
         configure_cli(rotate="--rotate" in sys.argv)
@@ -261,6 +266,7 @@ def main() -> None:
 def _print_usage() -> None:
     print("usage: agentos <configure|chat|agent|ticket|integration|default-agents|agentd|github|report|browser|fallback|help|doctor|firewall|activity-setup|swagger> ...")
     print()
+    print('  agentos version (or --version)     # installed SDK version, Python and install path')
     print('  agentos help "<your problem>" [--file PATH]…  # DevOps Bot Help: reads your logs + the SDK (+ screenshots/logs you attach)')
     print("  agentos doctor                     # collect a diagnostics bundle to send to your admin (no AI)")
     print("  agentos configure [--rotate]")

{devops_bot_sdk-1.7.36 → devops_bot_sdk-1.7.43}/sdk/faqs.py

@@ -18,6 +18,30 @@ FAQS: list[tuple[str, str, str]] = [
      "`agentos fallback install`, then `agentos fallback login`\n"
      "7. **Your co_ API token** — `agentos configure`\n"
      "Then `agentos doctor` checks the lot."),
+    ("Basics", "How do I open the control panel from another machine?",
+     "**Easiest — an SSH tunnel (nothing to open):** on your machine run "
+     "`ssh -L 8765:127.0.0.1:8765 you@SERVER`, then browse `http://127.0.0.1:8765`.\n"
+     "**Directly by IP:**\n"
+     "1. On YOUR machine, find your public IP: `curl -s https://api.ipify.org; echo` → prints e.g. `203.0.113.7`\n"
+     "2. On the SERVER, allowlist it: `echo 'AGENTOS_UI_ALLOWED_IPS=203.0.113.7' >> ~/.agentos/.env` — if that "
+     "line is already there, add the IP to it instead (only the first line counts): "
+     "`sed -i 's/^AGENTOS_UI_ALLOWED_IPS=.*/&,203.0.113.7/' ~/.agentos/.env`\n"
+     "3. Check it: `grep AGENTOS_UI_ALLOWED_IPS ~/.agentos/.env` → `AGENTOS_UI_ALLOWED_IPS=203.0.113.7` "
+     "(or your earlier IPs, then `,203.0.113.7`)\n"
+     "4. Open the port: `agentos firewall --apply` (needs sudo rights; if it can't, it prints the `ufw` command to run)\n"
+     "**On a Windows server** (PowerShell): `(Invoke-RestMethod https://api.ipify.org)` for your IP; "
+     "`Add-Content \"$env:USERPROFILE\\.agentos\\.env\" \"AGENTOS_UI_ALLOWED_IPS=203.0.113.7\"` the first time, or "
+     "`(Get-Content $f) -replace '^(AGENTOS_UI_ALLOWED_IPS=.*)$','$1,203.0.113.7' | Set-Content $f` "
+     "(with `$f = \"$env:USERPROFILE\\.agentos\\.env\"`) to add to an existing line; "
+     "`agentos firewall --apply` in an Administrator PowerShell. In cmd: "
+     "`echo AGENTOS_UI_ALLOWED_IPS=203.0.113.7>> \"%USERPROFILE%\\.agentos\\.env\"` (no space before `>>`).\n"
+     "5. Browse `http://SERVER-IP:8765` and paste your co_ token. It works at once — no restart. "
+     "`agentos swagger` shows whether the port is reachable and which allowlisted IPs the firewall still blocks."),
+    ("Basics", "How do I use devops-bot-sdk on another machine?",
+     "Install it there too — the same checklist (Python, git, SSH key, repo access, claude or ad), then "
+     "`pip install \"git+ssh://git@github.com/consultancy-outfit/DevOpsBot-SDK.git\"` and `agentos configure` "
+     "with your co_ token. Each machine runs its own loop on its own clones; two loops on one board share the "
+     "To Do queue, so give each machine its own tickets or pools. Check what is installed with `agentos version`."),
     ("Basics", "Can I run tickets without the claude CLI?",
      "Yes. Install and log in the AI Draftsman CLI (agentos fallback install, agentos fallback login --browser; "
      "check with agentos fallback status --verify). The loop refuses to start only when neither claude nor ad "
@@ -36,6 +60,13 @@ FAQS: list[tuple[str, str, str]] = [
     ("Updates", "Can I choose when updates happen, or stop them?",
      "Yes. On Linux a drop-in under agentos-update.timer.d with its own OnCalendar is respected (e.g. "
      "after nightly scans). AGENTOS_NO_UPDATE_SCHEDULE=1 stops the schedule; AGENTOS_NO_UPDATE=1 stops updating."),
+    ("Updates", "Which SDK version do I have?",
+     "agentos version (or agentos --version, agentos-auto --version) prints the version, the Python "
+     "running it and where it is installed — useful when there are several venvs. It never starts the loop."),
+    ("Updates", "How is a new version published to PyPI?",
+     "By hand: scripts/publish_pypi.sh --version X.Y.Z (add --dry-run first; --ref picks a commit). The GitHub "
+     "workflow is manual only — Actions → Publish to PyPI → Run workflow — once PyPI's trusted publisher names "
+     "OrcaloHoldings/DevOpsBot-SDK."),
     ("Updates", "Why does a run still use the old version after an update?",
      "A running loop keeps its version until it is restarted. Stop and start it, or use the panel's restart prompt."),
     ("Running work", "The loop seems stuck. What first?",
@@ -69,6 +100,10 @@ FAQS: list[tuple[str, str, str]] = [
      "agentos agent share NAME --to a person, team or department; they accept, then it appears on their Custom Agents page."),
     ("Help", "What if claude is out of usage?",
      "Tickets re-run on the AI Draftsman fallback: agentos fallback install, then agentos fallback login."),
+    ("Help", "The AI Draftsman says 429 / RESOURCE_EXHAUSTED. Will my ticket fail?",
+     "No — it waits and tries again (the server's retry-after, else 30 s, 60 s, 120 s … up to 5 min a wait), "
+     "6 times and 30 minutes of waiting by default (AGENTOS_FALLBACK_429_RETRIES, AGENTOS_FALLBACK_429_MAX_WAIT_S). "
+     "The log shows each wait."),
     ("Help", "No colours in my Windows console?",
      "A very old console refuses colour mode, or NO_COLOR is set. Try AGENTOS_COLOR=always."),
     ("Help", "Where do settings and logs live?",

devops_bot_sdk-1.7.43/sdk/help_data/areas.json

@@ -0,0 +1,137 @@
+[
+ {
+  "area": "Control panel",
+  "changes_30d": 6,
+  "features_30d": 2,
+  "fixes_30d": 1,
+  "latest": "security: stop tracking .env (PyPI token) + FAQ: panel/SDK from another machine, Linux & Windows IP commands",
+  "latest_pr": 187,
+  "latest_date": "2026-10-28"
+ },
+ {
+  "area": "Help",
+  "changes_30d": 6,
+  "features_30d": 5,
+  "fixes_30d": 0,
+  "latest": "panel redesign, parallel tickets, Help fixes + follow-ups, agent sharing (person/team/department), ticket board, coloured CLI log",
+  "latest_pr": 179,
+  "latest_date": "2026-10-27"
+ },
+ {
+  "area": "Activity",
+  "changes_30d": 5,
+  "features_30d": 1,
+  "fixes_30d": 4,
+  "latest": "record every claude run; run tickets on the installed ad CLI",
+  "latest_pr": 157,
+  "latest_date": "2026-10-23"
+ },
+ {
+  "area": "Updates",
+  "changes_30d": 5,
+  "features_30d": 0,
+  "fixes_30d": 3,
+  "latest": "Ticket pools, bulk update, plans with modules / Epics → Stories, instruction placeholders + Generate with AI, 6-hourly self-update, FAQs page, test-suite isolation",
+  "latest_pr": 183,
+  "latest_date": "2026-10-28"
+ },
+ {
+  "area": "Windows",
+  "changes_30d": 4,
+  "features_30d": 0,
+  "fixes_30d": 3,
+  "latest": "agentos-auto stop, agentd stale pidfile, stuck In Progress tickets",
+  "latest_pr": 165,
+  "latest_date": "2026-10-24"
+ },
+ {
+  "area": "AI fallback",
+  "changes_30d": 3,
+  "features_30d": 2,
+  "fixes_30d": 1,
+  "latest": "continue a limit-hit ticket on the AI Draftsman CLI with its context",
+  "latest_pr": 164,
+  "latest_date": "2026-10-24"
+ },
+ {
+  "area": "Schedules",
+  "changes_30d": 2,
+  "features_30d": 1,
+  "fixes_30d": 1,
+  "latest": "skip scheduled runs when Claude plan usage is high",
+  "latest_pr": 163,
+  "latest_date": "2026-10-23"
+ },
+ {
+  "area": "Agents",
+  "changes_30d": 1,
+  "features_30d": 0,
+  "fixes_30d": 0,
+  "latest": "APPR-539: [ST0135] Early years educator - Course Orchestrator + 69 item agents",
+  "latest_pr": 146,
+  "latest_date": "2026-10-20"
+ },
+ {
+  "area": "Daemon",
+  "changes_30d": 1,
+  "features_30d": 0,
+  "fixes_30d": 1,
+  "latest": "re-exec after double-fork so macOS daemons don't SIGSEGV in getaddrinfo",
+  "latest_pr": 143,
+  "latest_date": "2026-10-16"
+ },
+ {
+  "area": "Local Exec",
+  "changes_30d": 1,
+  "features_30d": 1,
+  "fixes_30d": 0,
+  "latest": "fall back to the bundled AI Draftsman CLI when claude is not working",
+  "latest_pr": 145,
+  "latest_date": "2026-10-19"
+ },
+ {
+  "area": "Paths",
+  "changes_30d": 1,
+  "features_30d": 0,
+  "fixes_30d": 1,
+  "latest": "don't read the `s:` of an https:// link as drive S:",
+  "latest_pr": 144,
+  "latest_date": "2026-10-19"
+ },
+ {
+  "area": "Queue",
+  "changes_30d": 1,
+  "features_30d": 0,
+  "fixes_30d": 1,
+  "latest": "an unanswered approval parks its ticket instead of blocking the queue",
+  "latest_pr": 178,
+  "latest_date": "2026-10-26"
+ },
+ {
+  "area": "Reporting",
+  "changes_30d": 1,
+  "features_30d": 0,
+  "fixes_30d": 1,
+  "latest": "only the assigned VPS reports health + activity; audit flag under sudo; 2000-char activity",
+  "latest_pr": 153,
+  "latest_date": "2026-10-22"
+ },
+ {
+  "area": "Tickets",
+  "changes_30d": 1,
+  "features_30d": 0,
+  "fixes_30d": 0,
+  "latest": "Faster tickets (plan ahead + cached test env), ad waits on 429, version command, manual publishing",
+  "latest_pr": 186,
+  "latest_date": "2026-10-28"
+ },
+ {
+  "area": "VPS",
+  "changes_30d": 1,
+  "features_30d": 0,
+  "fixes_30d": 1,
+  "latest": "re-ask a \"no VPS assigned\" answer after 10 min, not 6 h",
+  "latest_pr": 161,
+  "latest_date": "2026-10-23"
+ }
+]