@misterhuydo/sentinel 1.0.86 → 1.0.88

package/.cairn/.hint-lock

@@ -1 +1 @@
-2026-03-23T05:33:10.957Z
+2026-03-23T06:03:48.001Z

package/.cairn/session.json

@@ -1,6 +1,6 @@
 {
-  "message": "Auto-checkpoint at 2026-03-23T05:31:41.079Z",
-  "checkpoint_at": "2026-03-23T05:31:41.080Z",
+  "message": "Auto-checkpoint at 2026-03-23T06:00:14.460Z",
+  "checkpoint_at": "2026-03-23T06:00:14.461Z",
   "active_files": [],
   "notes": [],
   "mtime_snapshot": {}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@misterhuydo/sentinel",
-  "version": "1.0.86",
+  "version": "1.0.88",
   "description": "Sentinel — Autonomous DevOps Agent installer and manager",
   "bin": {
     "sentinel": "./bin/sentinel.js"

package/python/sentinel/sentinel_boss.py

@@ -113,6 +113,10 @@ What you can do (tools available):
 21. tail_log         — Fetch the last N lines of a log source live, without a grep filter.
                        e.g. "show recent SSOLWA logs", "tail STS", "last 200 lines from 1881 logs"
 
+22. post_file        — Upload a text file to the Slack conversation (diff, log excerpt, report, CSV).
+                       Use when output is too large for chat, or the user asks to download/export something.
+                       e.g. "give me that as a file", "export the log", "send me the diff"
+
 When someone asks what you can do, what you support, what your capabilities are, or how you can help,
 reply with a short summary grouped by category:
 
@@ -154,6 +158,9 @@ reply with a short summary grouped by category:
 *Self-management*
 • `upgrade_sentinel` — git pull + pip install + restart — "upgrade sentinel", "update yourself"
 
+*File sharing*
+• `post_file` — upload a file to Slack — "give me that as a file", "export the log", "send me the diff"
+
 Tone: direct, professional, like a senior engineer who owns the system.
 Don't pad responses. Don't say "Great question!" or "Certainly!".
 If you don't know something, use a tool to find out before saying you don't know.
@@ -551,6 +558,34 @@ _TOOLS = [
             "required": ["source"],
         },
     },
+    {
+        "name": "post_file",
+        "description": (
+            "Upload a text file directly to the Slack conversation so the user can read or download it. "
+            "Use when: output is too large for a chat message, the user asks to 'download', 'export', or "
+            "'send as a file', or when formatted content (diffs, logs, CSVs, reports) is clearer as a file. "
+            "e.g. 'give me that as a file', 'export the log', 'send me the diff for PR #41', "
+            "'download the health report', 'export recent errors as CSV'"
+        ),
+        "input_schema": {
+            "type": "object",
+            "properties": {
+                "content": {
+                    "type": "string",
+                    "description": "The full text content of the file to upload",
+                },
+                "filename": {
+                    "type": "string",
+                    "description": "Filename with extension, e.g. 'fix-ab12.diff', 'sentinel-report.txt', 'errors.csv', 'ssolwa.log'",
+                },
+                "title": {
+                    "type": "string",
+                    "description": "Optional display title shown above the file in Slack (defaults to filename)",
+                },
+            },
+            "required": ["content", "filename"],
+        },
+    },
 ]
 
 
@@ -617,7 +652,7 @@ def _git_pull(path: Path) -> dict:
 
 # ── Tool execution ────────────────────────────────────────────────────────────
 
-async def _run_tool(name: str, inputs: dict, cfg_loader, store, slack_client=None, user_id: str = "") -> str:
+async def _run_tool(name: str, inputs: dict, cfg_loader, store, slack_client=None, user_id: str = "", channel: str = "") -> str:
     if name == "get_status":
         hours = int(inputs.get("hours", 24))
         errors = store.get_recent_errors(hours)
@@ -1206,6 +1241,27 @@ async def _run_tool(name: str, inputs: dict, cfg_loader, store, slack_client=Non
                 results.append({"source": props.stem, "error": str(e)})
         return json.dumps({"results": results})
 
+    if name == "post_file":
+        if not slack_client or not channel:
+            return json.dumps({"error": "No Slack channel context — cannot upload file"})
+        content  = inputs.get("content", "")
+        filename = inputs.get("filename", "sentinel-output.txt")
+        title    = inputs.get("title", filename)
+        if not content:
+            return json.dumps({"error": "No content provided"})
+        try:
+            await slack_client.files_upload_v2(
+                channel=channel,
+                content=content,
+                filename=filename,
+                title=title,
+            )
+            logger.info("Boss post_file: uploaded %s (%d bytes) to %s", filename, len(content), channel)
+            return json.dumps({"ok": True, "filename": filename, "bytes": len(content)})
+        except Exception as e:
+            logger.warning("Boss post_file failed: %s", e)
+            return json.dumps({"error": str(e)})
+
     if name == "my_stats":
         hours  = int(inputs.get("hours", 168))
         errors = store.get_recent_errors(hours)
@@ -1379,9 +1435,12 @@ async def _handle_with_cli(
             )
         history_text += f"\n{role}: {content}"
 
+    slack_mention = f"<@{user_id}>" if user_id else (user_name or "")
     prompt = (
         _SYSTEM
-        + (f"\nYou are speaking with: {user_name}" if user_name else "")
+        + (f"\nYou are speaking with: {user_name} (Slack mention: {slack_mention})" if user_name else "")
+        + "\nAlways start your reply by addressing the user directly using their Slack mention, e.g. \"<@U123> here is what I found...\"."
+        + " Never use their plain name — always use the <@USER_ID> format so Slack highlights it."
         + f"\n\nCurrent time: {ts}"
         + f"\nSentinel status: {'⏸ PAUSED' if paused else '▶ RUNNING'}"
         + f"\nManaged repos: {', '.join(repos) if repos else '(none configured)'}"
@@ -1464,6 +1523,7 @@ async def _handle_with_api(
     user_name: str = "",
     user_id: str = "",
     attachments: list | None = None,
+    channel: str = "",
 ) -> tuple[str, bool]:
     import anthropic
 
@@ -1475,9 +1535,12 @@ async def _handle_with_api(
     ts             = datetime.now(timezone.utc).strftime("%Y-%m-%d %H:%M UTC")
     known_projects = [_read_project_name(d) for d in _find_project_dirs()]
     log_sources    = list(cfg_loader.log_sources.keys())
+    slack_mention = f"<@{user_id}>" if user_id else (user_name or "")
     system = (
         _SYSTEM
-        + (f"\nYou are speaking with: {user_name}" if user_name else "")
+        + (f"\nYou are speaking with: {user_name} (Slack mention: {slack_mention})" if user_name else "")
+        + "\nAlways start your reply by addressing the user directly using their Slack mention, e.g. \"<@U123> here is what I found...\"."
+        + " Never use their plain name — always use the <@USER_ID> format so Slack highlights it."
         + f"\n\nCurrent time: {ts}"
         + f"\nSentinel status: {'⏸ PAUSED' if paused else '▶ RUNNING'}"
         + f"\nManaged repos: {', '.join(repos) if repos else '(none configured)'}"
@@ -1524,7 +1587,7 @@ async def _handle_with_api(
         messages.append({"role": "assistant", "content": response.content})
         tool_results = []
         for tc in tool_blocks:
-            result = await _run_tool(tc.name, tc.input, cfg_loader, store, slack_client=slack_client, user_id=user_id)
+            result = await _run_tool(tc.name, tc.input, cfg_loader, store, slack_client=slack_client, user_id=user_id, channel=channel)
             logger.info("Boss tool: %s(%s) → %s", tc.name, tc.input, result[:120])
             tool_results.append({
                 "type":        "tool_result",
@@ -1545,6 +1608,7 @@ async def handle_message(
     user_name: str = "",
     user_id: str = "",
     attachments: list | None = None,
+    channel: str = "",
 ) -> tuple[str, bool]:
     """
     Process one user message through the Sentinel Boss (Claude with tool use).
@@ -1566,7 +1630,7 @@ async def handle_message(
             import anthropic  # noqa: F401
             return await _handle_with_api(
                 message, history, cfg_loader, store, slack_client=slack_client,
-                user_name=user_name, user_id=user_id, attachments=attachments,
+                user_name=user_name, user_id=user_id, attachments=attachments, channel=channel,
             )
         except Exception as api_err:
             err_str = str(api_err)

package/python/sentinel/slack_bot.py

@@ -389,6 +389,7 @@ async def _run_turn(session: _Session, message: str, client, cfg_loader, store,
             user_name=session.user_name,
             user_id=session.user_id,
             attachments=attachments or [],
+            channel=channel,
         )
     except Exception as e:
         logger.exception("Sentinel Boss error: %s", e)