ragnarbot-ai 0.1.0__py3-none-any.whl

ragnarbot/skills/tmux/scripts/wait-for-text.sh

@@ -0,0 +1,83 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+usage() {
+  cat <<'USAGE'
+Usage: wait-for-text.sh -t target -p pattern [options]
+
+Poll a tmux pane for text and exit when found.
+
+Options:
+  -t, --target    tmux target (session:window.pane), required
+  -p, --pattern   regex pattern to look for, required
+  -F, --fixed     treat pattern as a fixed string (grep -F)
+  -T, --timeout   seconds to wait (integer, default: 15)
+  -i, --interval  poll interval in seconds (default: 0.5)
+  -l, --lines     number of history lines to inspect (integer, default: 1000)
+  -h, --help      show this help
+USAGE
+}
+
+target=""
+pattern=""
+grep_flag="-E"
+timeout=15
+interval=0.5
+lines=1000
+
+while [[ $# -gt 0 ]]; do
+  case "$1" in
+    -t|--target)   target="${2-}"; shift 2 ;;
+    -p|--pattern)  pattern="${2-}"; shift 2 ;;
+    -F|--fixed)    grep_flag="-F"; shift ;;
+    -T|--timeout)  timeout="${2-}"; shift 2 ;;
+    -i|--interval) interval="${2-}"; shift 2 ;;
+    -l|--lines)    lines="${2-}"; shift 2 ;;
+    -h|--help)     usage; exit 0 ;;
+    *) echo "Unknown option: $1" >&2; usage; exit 1 ;;
+  esac
+done
+
+if [[ -z "$target" || -z "$pattern" ]]; then
+  echo "target and pattern are required" >&2
+  usage
+  exit 1
+fi
+
+if ! [[ "$timeout" =~ ^[0-9]+$ ]]; then
+  echo "timeout must be an integer number of seconds" >&2
+  exit 1
+fi
+
+if ! [[ "$lines" =~ ^[0-9]+$ ]]; then
+  echo "lines must be an integer" >&2
+  exit 1
+fi
+
+if ! command -v tmux >/dev/null 2>&1; then
+  echo "tmux not found in PATH" >&2
+  exit 1
+fi
+
+# End time in epoch seconds (integer, good enough for polling)
+start_epoch=$(date +%s)
+deadline=$((start_epoch + timeout))
+
+while true; do
+  # -J joins wrapped lines, -S uses negative index to read last N lines
+  pane_text="$(tmux capture-pane -p -J -t "$target" -S "-${lines}" 2>/dev/null || true)"
+
+  if printf '%s\n' "$pane_text" | grep $grep_flag -- "$pattern" >/dev/null 2>&1; then
+    exit 0
+  fi
+
+  now=$(date +%s)
+  if (( now >= deadline )); then
+    echo "Timed out after ${timeout}s waiting for pattern: $pattern" >&2
+    echo "Last ${lines} lines from $target:" >&2
+    printf '%s\n' "$pane_text" >&2
+    exit 1
+  fi
+
+  sleep "$interval"
+done

ragnarbot/skills/weather/SKILL.md

@@ -0,0 +1,49 @@
+---
+name: weather
+description: Get current weather and forecasts (no API key required).
+homepage: https://wttr.in/:help
+metadata: {"ragnarbot":{"emoji":"🌤️","requires":{"bins":["curl"]}}}
+---
+
+# Weather
+
+Two free services, no API keys needed.
+
+## wttr.in (primary)
+
+Quick one-liner:
+```bash
+curl -s "wttr.in/London?format=3"
+# Output: London: ⛅️ +8°C
+```
+
+Compact format:
+```bash
+curl -s "wttr.in/London?format=%l:+%c+%t+%h+%w"
+# Output: London: ⛅️ +8°C 71% ↙5km/h
+```
+
+Full forecast:
+```bash
+curl -s "wttr.in/London?T"
+```
+
+Format codes: `%c` condition · `%t` temp · `%h` humidity · `%w` wind · `%l` location · `%m` moon
+
+Tips:
+- URL-encode spaces: `wttr.in/New+York`
+- Airport codes: `wttr.in/JFK`
+- Units: `?m` (metric) `?u` (USCS)
+- Today only: `?1` · Current only: `?0`
+- PNG: `curl -s "wttr.in/Berlin.png" -o /tmp/weather.png`
+
+## Open-Meteo (fallback, JSON)
+
+Free, no key, good for programmatic use:
+```bash
+curl -s "https://api.open-meteo.com/v1/forecast?latitude=51.5&longitude=-0.12&current_weather=true"
+```
+
+Find coordinates for a city, then query. Returns JSON with temp, windspeed, weathercode.
+
+Docs: https://open-meteo.com/en/docs

ragnarbot/utils/__init__.py

@@ -0,0 +1,5 @@
+"""Utility functions for ragnarbot."""
+
+from ragnarbot.utils.helpers import ensure_dir, get_workspace_path, get_data_path
+
+__all__ = ["ensure_dir", "get_workspace_path", "get_data_path"]

ragnarbot/utils/helpers.py

@@ -0,0 +1,91 @@
+"""Utility functions for ragnarbot."""
+
+from pathlib import Path
+from datetime import datetime
+
+
+def ensure_dir(path: Path) -> Path:
+    """Ensure a directory exists, creating it if necessary."""
+    path.mkdir(parents=True, exist_ok=True)
+    return path
+
+
+def get_data_path() -> Path:
+    """Get the ragnarbot data directory (~/.ragnarbot)."""
+    return ensure_dir(Path.home() / ".ragnarbot")
+
+
+def get_workspace_path(workspace: str | None = None) -> Path:
+    """
+    Get the workspace path.
+
+    Args:
+        workspace: Optional workspace path. Defaults to ~/.ragnarbot/workspace.
+
+    Returns:
+        Expanded and ensured workspace path.
+    """
+    if workspace:
+        path = Path(workspace).expanduser()
+    else:
+        path = Path.home() / ".ragnarbot" / "workspace"
+    return ensure_dir(path)
+
+
+def get_sessions_path() -> Path:
+    """Get the sessions storage directory."""
+    return ensure_dir(get_data_path() / "sessions")
+
+
+def get_memory_path(workspace: Path | None = None) -> Path:
+    """Get the memory directory within the workspace."""
+    ws = workspace or get_workspace_path()
+    return ensure_dir(ws / "memory")
+
+
+def get_skills_path(workspace: Path | None = None) -> Path:
+    """Get the skills directory within the workspace."""
+    ws = workspace or get_workspace_path()
+    return ensure_dir(ws / "skills")
+
+
+def today_date() -> str:
+    """Get today's date in YYYY-MM-DD format."""
+    return datetime.now().strftime("%Y-%m-%d")
+
+
+def timestamp() -> str:
+    """Get current timestamp in ISO format."""
+    return datetime.now().isoformat()
+
+
+def truncate_string(s: str, max_len: int = 100, suffix: str = "...") -> str:
+    """Truncate a string to max length, adding suffix if truncated."""
+    if len(s) <= max_len:
+        return s
+    return s[: max_len - len(suffix)] + suffix
+
+
+def safe_filename(name: str) -> str:
+    """Convert a string to a safe filename."""
+    # Replace unsafe characters
+    unsafe = '<>:"/\\|?*'
+    for char in unsafe:
+        name = name.replace(char, "_")
+    return name.strip()
+
+
+def parse_session_key(key: str) -> tuple[str, str]:
+    """
+    Parse a session key into channel and chat_id.
+
+    Args:
+        key: Session key in format "channel:chat_id"
+
+    Returns:
+        Tuple of (channel, chat_id)
+    """
+    parts = key.split(":", 1)
+    if len(parts) != 2:
+        raise ValueError(f"Invalid session key: {key}")
+    return parts[0], parts[1]

ragnarbot_ai-0.1.0.dist-info/METADATA

@@ -0,0 +1,28 @@
+Metadata-Version: 2.4
+Name: ragnarbot-ai
+Version: 0.1.0
+Summary: A lightweight personal AI assistant framework
+Author: BlckLvls
+License: MIT
+License-File: LICENSE
+Keywords: agent,ai,chatbot
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Requires-Python: >=3.11
+Requires-Dist: croniter>=2.0.0
+Requires-Dist: httpx>=0.25.0
+Requires-Dist: litellm>=1.0.0
+Requires-Dist: loguru>=0.7.0
+Requires-Dist: pydantic-settings>=2.0.0
+Requires-Dist: pydantic>=2.0.0
+Requires-Dist: python-telegram-bot>=21.0
+Requires-Dist: readability-lxml>=0.8.0
+Requires-Dist: rich>=13.0.0
+Requires-Dist: typer>=0.9.0
+Provides-Extra: dev
+Requires-Dist: pytest-asyncio>=0.21.0; extra == 'dev'
+Requires-Dist: pytest>=7.0.0; extra == 'dev'
+Requires-Dist: ruff>=0.1.0; extra == 'dev'

ragnarbot_ai-0.1.0.dist-info/RECORD

@@ -0,0 +1,56 @@
+ragnarbot/__init__.py,sha256=OUT1tDZljafxn5kD-Ez2nHhkI-aHTphw7xGJYm9rB_Q,94
+ragnarbot/__main__.py,sha256=2TZT_5uKLSr_Olx1L_4NnQZrNLS8QfP3fyI0suAAxnQ,153
+ragnarbot/agent/__init__.py,sha256=n6FWiCbesoGOv0NCrC2GtvgOgG08lFvFBDDtyXk5luM,289
+ragnarbot/agent/context.py,sha256=HrKoD-_H9L-pI7qLWpglOkV_UaUgpR1-L_795IMBPJg,7524
+ragnarbot/agent/loop.py,sha256=tJo2Wx1Ugo1i7HVTcBs6EhXEd-x_MntDpm1MqLWsqyo,13172
+ragnarbot/agent/memory.py,sha256=vPXLsTPjdP_NzD9a_KsAvZ4Ou4QJ9UsxP11mSpSCn1U,3441
+ragnarbot/agent/skills.py,sha256=WMTf7PjAObGLsbxI2Di6Tmj-PSSb_B3l89OFrVkfGTA,8476
+ragnarbot/agent/subagent.py,sha256=oTW2V6pvPC711jaFeACwAFtA6VreHv8BgL03ZgIBLVk,8747
+ragnarbot/agent/tools/__init__.py,sha256=9TY0QmbwRMD7FFLUgXxMrt4oOypKtbey-0nDjv9yJyk,163
+ragnarbot/agent/tools/base.py,sha256=1WHEsaXd4K2w4cZp8zWIBDKPPwNIRmWQe1RXF_cZ1E0,3665
+ragnarbot/agent/tools/cron.py,sha256=fydGyYXkqKX5etLVR2g4wT-YtaknOaJGN-B99E-jmRs,3841
+ragnarbot/agent/tools/filesystem.py,sha256=-GSUAb6FokS4jv15TYnr0V1oc4nzuy6Wiea3y3iecOw,6097
+ragnarbot/agent/tools/message.py,sha256=1OYJswx7zoMcSrfiNJM6FqpYylFX6mNF-WNzc-nzQu0,2719
+ragnarbot/agent/tools/registry.py,sha256=u-jL70bN9X2w4YVrmF0JoS8j5FAAFnuoh783TEJGeKY,2096
+ragnarbot/agent/tools/shell.py,sha256=FpKXpQINtzp-YxGUI0iZRIn96kmJyneOeAWalKa4KWo,4999
+ragnarbot/agent/tools/spawn.py,sha256=toLNP_fXISmQivXR8G7sUGHNRmkoZDDS1US1u16ob7Y,2056
+ragnarbot/agent/tools/web.py,sha256=j_DHJ1E_WX-lK6RkCgFk-FAEFkLxLegwg_UKYiDwwXE,6379
+ragnarbot/bus/__init__.py,sha256=uuPH31J1Fe8WU1ns8FHK-swj-cW2_fDGVhqXgp0CeXU,240
+ragnarbot/bus/events.py,sha256=rxV-th0uqJ5-SlXjvXusVOQvzngTTz8ZX3D8iGJA-nc,1019
+ragnarbot/bus/queue.py,sha256=k19dexFfAnT78MzdNPD9LzUERty6ZoUlvtsYD0T-RBo,2931
+ragnarbot/channels/__init__.py,sha256=pv-NQVou_1GVpDL4wCu1t1KHkg3zBvNFQRbCq130qG8,201
+ragnarbot/channels/base.py,sha256=_K1t3ZCTkx73cx1iUUfbo7TykShZ_PMjKlFygQX5GR8,3350
+ragnarbot/channels/manager.py,sha256=YOAmfhkb5nzryo-8sn3LDy_d_SaDkusQLMTm0F3Dfb4,4294
+ragnarbot/channels/telegram.py,sha256=fY3f5zZz5FBlyn9-9Sq-Wnmt8ghlB7nnaXO6FaJwru8,11328
+ragnarbot/cli/__init__.py,sha256=rl-hhW3zBjN9Po_9DVuhd-YxQxE6o7PaTSkvO1Rjxvo,32
+ragnarbot/cli/commands.py,sha256=U3rjq0XD71nztLEXsBeHE1DOazUXKV5kqcog5UGw1Y4,17689
+ragnarbot/config/__init__.py,sha256=5_p4XkzKsu3HQyrP7I9Du3_h_L1Wmq_j2oA9fTGU-LE,207
+ragnarbot/config/loader.py,sha256=-TqVy1b8VR82_ksgAIUXg-p6GTmqi8xqG8ax3cf1pJE,2698
+ragnarbot/config/schema.py,sha256=WNlQzsojEwe6U9uKLNnmKB3ynkIE-6BnXOso_FS4t34,3755
+ragnarbot/cron/__init__.py,sha256=VRDCTQb_jPSJKqklQ06IfFIK0Mye5Oqgf1JQ5cAaiVA,203
+ragnarbot/cron/service.py,sha256=6K6rmuhjThb9tub_MWp9Uvu0MuEgIIx_W17Dw-2h0nU,12033
+ragnarbot/cron/types.py,sha256=iHQPyeuVK8TD5xi9svNijFvFTkjvhmd1oMMiCWJD0hs,1586
+ragnarbot/heartbeat/__init__.py,sha256=y6Jsb38xK161gRj31uBeniHaFhxwqcQIp2Oo6UOoVsU,143
+ragnarbot/heartbeat/service.py,sha256=AndTBgyF0uWLDgbe47UW3mdHBjg28tbm0MLzh5-6uqY,4310
+ragnarbot/providers/__init__.py,sha256=HEYXA02TgsK_gj0URSVkn7jw_7TvwN3tiAAH86EQpB8,228
+ragnarbot/providers/base.py,sha256=XNPYJzTiVUwiV3GPbk-XNMlA62wIo2BeBH-j0S5tVPo,1900
+ragnarbot/providers/litellm_provider.py,sha256=1FSRmvWu-JFze84e21aRVEn1EVCWi3pmHQJBfq5Fhoc,4544
+ragnarbot/providers/transcription.py,sha256=x-ZK_XtKa0deFCAO9v91kNLTUW1wQXz952qk40R-sn0,2140
+ragnarbot/session/__init__.py,sha256=fAUCyfVS9eMs3HkIM7cs40oR_TZQ63zzTcw0xenjIs4,137
+ragnarbot/session/manager.py,sha256=QcRFmv5yAt-67hbCQFqYtY0jBXxFQPX7GaJm7SDJPEE,6329
+ragnarbot/skills/README.md,sha256=YZEM09n5cydolRep8tcf8KCjKEao482jiogsxXJDzrQ,801
+ragnarbot/skills/cron/SKILL.md,sha256=t7vA07fui1XzPXOpS_Ub5mOgdnTT-ZW5wU3Ws26FnCg,872
+ragnarbot/skills/github/SKILL.md,sha256=ZYEylTx_-_hVy3IyC43xwImFvUx0HozIULFazAh1kic,1376
+ragnarbot/skills/skill-creator/SKILL.md,sha256=yyeFoRM5BbzJUq_FABub0g-SqPRzvpM2_R-fAdsFtqA,18460
+ragnarbot/skills/summarize/SKILL.md,sha256=MC-DNvY4UElBNO7fWf0wLK1MVMVlTx_L-oi2ir-WQe0,2042
+ragnarbot/skills/tmux/SKILL.md,sha256=VBJnWpytx2Hw2wUnlFT9Xvx16jfcjDWbTi7yBzSKHV0,4081
+ragnarbot/skills/tmux/scripts/find-sessions.sh,sha256=Q62hQXa0VT5LAlWFmqsTflJ8tSb-Max2JAdenT-pQ84,2948
+ragnarbot/skills/tmux/scripts/wait-for-text.sh,sha256=lrxCcC9zU8MiM8Ij1h3RHy-ZAzJnru-sg4rqiYOmdzU,2139
+ragnarbot/skills/weather/SKILL.md,sha256=oNWG-wax_jXI30Gpmr4LJ1Kw4AnhtKDD5g5asFzcRtk,1170
+ragnarbot/utils/__init__.py,sha256=Fyk2GWFZY7fJR3eCwTTMXSXv9SakjUpRLfvig1kuunw,187
+ragnarbot/utils/helpers.py,sha256=8gLY6pPcTU7iNXXtB8NRSzLShXLqfd6Hv2Qr3yfjVBU,2420
+ragnarbot_ai-0.1.0.dist-info/METADATA,sha256=CrL_fURD7HriXz61dfFuKy8aqm2sz5xXJqwnlzdOAAc,943
+ragnarbot_ai-0.1.0.dist-info/WHEEL,sha256=WLgqFyCfm_KASv4WHyYy0P3pM_m7J5L9k2skdKLirC8,87
+ragnarbot_ai-0.1.0.dist-info/entry_points.txt,sha256=d2yHV6ULmeQBn1Iqpd5OVqDHsz7kOBqcn-qw3WneMP4,57
+ragnarbot_ai-0.1.0.dist-info/licenses/LICENSE,sha256=VUHeEuXnVpiQLDTWKv1uemFt_j8w4oin6ipM_BTBB2U,1104
+ragnarbot_ai-0.1.0.dist-info/RECORD,,

ragnarbot_ai-0.1.0.dist-info/WHEEL

@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: hatchling 1.28.0
+Root-Is-Purelib: true
+Tag: py3-none-any

ragnarbot_ai-0.1.0.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+ragnarbot = ragnarbot.cli.commands:app

ragnarbot_ai-0.1.0.dist-info/licenses/LICENSE

@@ -0,0 +1,22 @@
+MIT License
+
+Copyright (c) 2025 nanobot contributors
+Copyright (c) 2025 BlckLvls
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.