@misterhuydo/sentinel 1.0.85 → 1.0.87

package/.cairn/.hint-lock

@@ -1 +1 @@
-2026-03-23T05:01:48.297Z
+2026-03-23T05:33:10.957Z

package/.cairn/session.json

@@ -1,6 +1,6 @@
 {
-  "message": "Auto-checkpoint at 2026-03-23T05:25:59.517Z",
-  "checkpoint_at": "2026-03-23T05:25:59.518Z",
+  "message": "Auto-checkpoint at 2026-03-23T05:55:20.486Z",
+  "checkpoint_at": "2026-03-23T05:55:20.487Z",
   "active_files": [],
   "notes": [],
   "mtime_snapshot": {}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@misterhuydo/sentinel",
-  "version": "1.0.85",
+  "version": "1.0.87",
   "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)
@@ -1464,6 +1520,7 @@ async def _handle_with_api(
     user_name: str = "",
     user_id: str = "",
     attachments: list | None = None,
+    channel: str = "",
 ) -> tuple[str, bool]:
     import anthropic
 
@@ -1524,7 +1581,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 +1602,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 +1624,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)

package/python/sentinel/state_store.py

@@ -391,7 +391,7 @@ class StateStore:
                 ).fetchall()
             return [dict(r) for r in rows]
 
-        def save_conversation(self, user_id: str, history: list):
+    def save_conversation(self, user_id: str, history: list):
         """Persist the last N messages of a user conversation to SQLite."""
         trimmed = history[-self._MAX_HISTORY_MESSAGES:]
         with self._conn() as conn: