operator-agent 0.2.0__tar.gz → 0.4.0__tar.gz

{operator_agent-0.2.0/src/operator_agent.egg-info → operator_agent-0.4.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: operator-agent
-Version: 0.2.0
+Version: 0.4.0
 Summary: Personal AI agent that bridges Telegram to CLI agents (Claude, Codex, Gemini) running on your machine.
 Author-email: Gavin Vickery <gavin@geekforbrains.com>
 License-Expression: MIT

{operator_agent-0.2.0 → operator_agent-0.4.0}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "operator-agent"
-version = "0.2.0"
+version = "0.4.0"
 description = "Personal AI agent that bridges Telegram to CLI agents (Claude, Codex, Gemini) running on your machine."
 readme = "README.md"
 license = "MIT"
@@ -40,6 +40,9 @@ build-backend = "setuptools.build_meta"
 [tool.setuptools.packages.find]
 where = ["src"]
 
+[tool.setuptools.package-data]
+operator_agent = ["system_prompt.md"]
+
 [tool.ruff]
 target-version = "py310"
 line-length = 100

{operator_agent-0.2.0 → operator_agent-0.4.0}/src/operator_agent/cli.py

@@ -540,6 +540,7 @@ def serve(
 
     runtime = Runtime(config)
     runtime.init_config_dir()
+    runtime.install_system_prompts()
     runtime.load_state()
 
     log = logging.getLogger("operator_agent")

{operator_agent-0.2.0 → operator_agent-0.4.0}/src/operator_agent/core.py

@@ -4,6 +4,7 @@ from __future__ import annotations
 
 import asyncio
 import contextlib
+import importlib.resources
 import json
 import logging
 import os
@@ -65,6 +66,28 @@ class Runtime:
         """Ensure config directory exists."""
         os.makedirs(CONFIG_DIR, exist_ok=True)
 
+    def install_system_prompts(self):
+        """Write CLAUDE.md / AGENTS.md / GEMINI.md into the working directory.
+
+        Each CLI agent reads its own convention file from the cwd to understand
+        its role and behaviour.  We ship the canonical prompt as package data
+        and materialise it on every ``serve`` so it stays current across
+        package upgrades.
+        """
+        source = importlib.resources.files("operator_agent").joinpath("system_prompt.md")
+        content = source.read_text(encoding="utf-8")
+
+        for name in ("CLAUDE.md", "AGENTS.md", "GEMINI.md"):
+            target = os.path.join(self.working_dir, name)
+            if os.path.exists(target):
+                continue
+            try:
+                with open(target, "w") as f:
+                    f.write(content)
+                log.info("Wrote %s to %s", name, self.working_dir)
+            except OSError:
+                log.warning("Could not write %s to %s", name, self.working_dir, exc_info=True)
+
     # --- State persistence ---
 
     def save_state(self):

{operator_agent-0.2.0 → operator_agent-0.4.0}/src/operator_agent/providers/codex.py

@@ -111,5 +111,8 @@ class CodexProvider(BaseProvider):
 
         return events
 
+    def stdout_limit(self):
+        return 10 * 1024 * 1024
+
     def stderr_to_stdout(self):
         return True

{operator_agent-0.2.0 → operator_agent-0.4.0}/src/operator_agent/providers/gemini.py

@@ -49,6 +49,9 @@ def _format_status(event: dict) -> str | None:
 class GeminiProvider(BaseProvider):
     name = "gemini"
 
+    def stdout_limit(self):
+        return 10 * 1024 * 1024
+
     def build_command(self, prompt, model, session_id=None):
         cmd = [
             self.path,

operator_agent-0.4.0/src/operator_agent/system_prompt.md

@@ -0,0 +1,19 @@
+# Operator
+
+Operator proxies messages from a chat platform (Telegram, Slack, etc.)
+to a CLI agent (Claude, Codex, Gemini) running on the user's machine.
+The user sends a message, Operator invokes your CLI, and your response
+is sent back to the chat. You have full access to the machine you're
+running on — act accordingly.
+
+## Behaviour
+
+- **Bias to action.** Attempt the task first; only ask questions when
+  you genuinely cannot proceed or when the action is destructive.
+- **Confirm before destructive/irreversible actions only:** deleting
+  files or data, security-sensitive changes (credentials, permissions,
+  keys), force-pushing, or anything that affects shared/remote state.
+- **Everything else:** just do it. Don't ask for permission to read
+  files, run commands, install tools, or explore the system.
+- Get creative with shell commands or install new tools as needed.
+- Control the desktop, keyboard and mouse if you have to. Take screenshots.

{operator_agent-0.2.0 → operator_agent-0.4.0}/src/operator_agent/transports/telegram.py

@@ -150,6 +150,7 @@ class TelegramTransport:
                 "!clear - Clear current provider session\n"
                 "!clear all - Clear all provider sessions\n"
                 "!restart - Restart the bot\n"
+                "!logs - Show last 25 log entries\n"
                 "!help - Show this message"
             )
             return
@@ -159,6 +160,10 @@ class TelegramTransport:
             asyncio.get_event_loop().call_later(1, _restart)
             return
 
+        if text == "!logs":
+            await self._handle_logs(update)
+            return
+
         if text.startswith("!"):
             await update.message.reply_text("Unknown command. Try !help")
             return
@@ -414,3 +419,26 @@ class TelegramTransport:
         rt.save_state()
         msg = "Cleared all providers!" if clear_all else "Cleared current provider!"
         await update.message.reply_text(f"{msg}\n" + "\n".join(parts))
+
+    async def _handle_logs(self, update: Update):
+        log_path = os.path.join(os.path.expanduser("~/.operator"), "operator.log")
+        if not os.path.exists(log_path):
+            await update.message.reply_text("No log file found.")
+            return
+
+        try:
+            with open(log_path, "rb") as f:
+                # Read last ~32KB to find the last 25 lines
+                f.seek(0, 2)
+                size = f.tell()
+                f.seek(max(0, size - 32768))
+                tail = f.read().decode(errors="replace")
+
+            lines = tail.splitlines()[-25:]
+            text = "\n".join(lines) if lines else "(empty)"
+            # Telegram message limit is 4096 chars
+            if len(text) > 4000:
+                text = text[-4000:]
+            await update.message.reply_text(text)
+        except Exception as exc:
+            await update.message.reply_text(f"Error reading logs: {exc}")

{operator_agent-0.2.0 → operator_agent-0.4.0/src/operator_agent.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: operator-agent
-Version: 0.2.0
+Version: 0.4.0
 Summary: Personal AI agent that bridges Telegram to CLI agents (Claude, Codex, Gemini) running on your machine.
 Author-email: Gavin Vickery <gavin@geekforbrains.com>
 License-Expression: MIT

{operator_agent-0.2.0 → operator_agent-0.4.0}/src/operator_agent.egg-info/SOURCES.txt

@@ -5,6 +5,7 @@ src/operator_agent/__init__.py
 src/operator_agent/cli.py
 src/operator_agent/config.py
 src/operator_agent/core.py
+src/operator_agent/system_prompt.md
 src/operator_agent.egg-info/PKG-INFO
 src/operator_agent.egg-info/SOURCES.txt
 src/operator_agent.egg-info/dependency_links.txt