crewly 1.0.0 → 1.0.1

package/config/constants.ts

@@ -346,8 +346,8 @@ export const MESSAGE_CONSTANTS = {
  * Environment variable names used across domains
  */
 export const ENV_CONSTANTS = {
-	/** Session name (legacy: kept for compatibility with older agents) */
-	TMUX_SESSION_NAME: 'TMUX_SESSION_NAME',
+	/** PTY session name used for agent identity and heartbeat tracking */
+	CREWLY_SESSION_NAME: 'CREWLY_SESSION_NAME',
 	/** Crewly role identifier */
 	CREWLY_ROLE: 'CREWLY_ROLE',
 	/** API server port */
@@ -768,6 +768,44 @@ export const ORCHESTRATOR_RESTART_CONSTANTS = {
   RESTART_DELAY_MS: 5000,
 } as const;
 
+// ========================= ORCHESTRATOR HEARTBEAT MONITOR =========================
+
+/**
+ * Orchestrator heartbeat monitoring configuration.
+ * Used by OrchestratorHeartbeatMonitorService to detect unresponsive orchestrators,
+ * send proactive heartbeat requests, and trigger auto-restart with resume.
+ */
+export const ORCHESTRATOR_HEARTBEAT_CONSTANTS = {
+	/** Interval between heartbeat checks in milliseconds (30 seconds) */
+	CHECK_INTERVAL_MS: 30_000,
+	/** Time without API activity before sending a heartbeat request to orchestrator (5 minutes) */
+	HEARTBEAT_REQUEST_THRESHOLD_MS: 300_000,
+	/** Time after heartbeat request before triggering auto-restart (1 minute) */
+	RESTART_THRESHOLD_MS: 60_000,
+	/** Message sent to orchestrator PTY to request a heartbeat */
+	HEARTBEAT_REQUEST_MESSAGE: 'Please run your heartbeat skill now: bash config/skills/orchestrator/heartbeat/execute.sh',
+	/** Grace period after server start before monitoring begins (30 seconds) */
+	STARTUP_GRACE_PERIOD_MS: 30_000,
+} as const;
+
+/**
+ * Agent heartbeat monitor configuration.
+ * Used by AgentHeartbeatMonitorService to detect crashed/unresponsive agents
+ * and auto-restart them with task re-delivery.
+ */
+export const AGENT_HEARTBEAT_MONITOR_CONSTANTS = {
+	/** Interval between heartbeat checks in milliseconds (30 seconds) */
+	CHECK_INTERVAL_MS: 30_000,
+	/** Time without activity (both PTY and API) before checking process liveness (5 minutes) */
+	HEARTBEAT_REQUEST_THRESHOLD_MS: 300_000,
+	/** Grace period after server start before monitoring begins (1 minute) */
+	STARTUP_GRACE_PERIOD_MS: 60_000,
+	/** Maximum restarts per cooldown window per agent */
+	MAX_RESTARTS_PER_WINDOW: 3,
+	/** Cooldown window for restart tracking (1 hour) */
+	COOLDOWN_WINDOW_MS: 3_600_000,
+} as const;
+
 // ========================= AGENT SUSPEND SYSTEM =========================
 
 /**

package/config/skills/_common/lib.sh

@@ -19,7 +19,8 @@ api_call() {
   local url="${CREWLY_API_URL}/api${endpoint}"
   local args=(-s -w '\n%{http_code}' -X "$method" -H "Content-Type: application/json")
   # Include agent session identity header for heartbeat tracking
-  [ -n "$TMUX_SESSION_NAME" ] && args+=(-H "X-Agent-Session: $TMUX_SESSION_NAME")
+  # Use ${VAR:-} pattern to avoid 'unbound variable' error under set -u (nounset)
+  [ -n "${CREWLY_SESSION_NAME:-}" ] && args+=(-H "X-Agent-Session: $CREWLY_SESSION_NAME")
   [ -n "$body" ] && args+=(-d "$body")
 
   local response

package/config/skills/agent/computer-use/execute.sh

@@ -0,0 +1,151 @@
+#!/bin/bash
+# =============================================================================
+# Desktop Automation (Computer Use) Skill
+# Controls macOS desktop: screenshots, mouse, keyboard
+# Uses native macOS APIs — no external dependencies required
+# =============================================================================
+set -euo pipefail
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+source "${SCRIPT_DIR}/../_common/lib.sh"
+
+INPUT="${1:-}"
+[ -z "$INPUT" ] && error_exit "Usage: execute.sh '{\"action\":\"screenshot|move|click|type\", ...}'"
+
+ACTION=$(echo "$INPUT" | jq -r '.action // empty')
+require_param "action" "$ACTION"
+
+# -----------------------------------------------------------------------------
+# screenshot — capture the screen to a file
+# -----------------------------------------------------------------------------
+do_screenshot() {
+  local output
+  output=$(echo "$INPUT" | jq -r '.output // "/tmp/screenshot.png"')
+
+  # Ensure output directory exists
+  mkdir -p "$(dirname "$output")"
+
+  screencapture -x "$output" 2>/dev/null
+
+  if [ -f "$output" ]; then
+    local size
+    size=$(stat -f%z "$output" 2>/dev/null || stat -c%s "$output" 2>/dev/null || echo "unknown")
+    echo "{\"success\":true,\"action\":\"screenshot\",\"file\":\"$output\",\"size\":$size}"
+  else
+    error_exit "Screenshot failed — file not created"
+  fi
+}
+
+# -----------------------------------------------------------------------------
+# move — move mouse cursor to (x, y)
+# -----------------------------------------------------------------------------
+do_move() {
+  local x y
+  x=$(echo "$INPUT" | jq -r '.x // empty')
+  y=$(echo "$INPUT" | jq -r '.y // empty')
+  require_param "x" "$x"
+  require_param "y" "$y"
+
+  osascript -l JavaScript -e "
+    ObjC.import('CoreGraphics');
+    var point = $.CGPointMake($x, $y);
+    var event = $.CGEventCreateMouseEvent(null, $.kCGEventMouseMoved, point, 0);
+    $.CGEventPost($.kCGHIDEventTap, event);
+    'moved';
+  " >/dev/null 2>&1
+
+  echo "{\"success\":true,\"action\":\"move\",\"x\":$x,\"y\":$y}"
+}
+
+# -----------------------------------------------------------------------------
+# click — click at (x, y) with optional button type
+# -----------------------------------------------------------------------------
+do_click() {
+  local x y button
+  x=$(echo "$INPUT" | jq -r '.x // empty')
+  y=$(echo "$INPUT" | jq -r '.y // empty')
+  button=$(echo "$INPUT" | jq -r '.button // "left"')
+  require_param "x" "$x"
+  require_param "y" "$y"
+
+  case "$button" in
+    left)
+      osascript -l JavaScript -e "
+        ObjC.import('CoreGraphics');
+        var point = $.CGPointMake($x, $y);
+        var move = $.CGEventCreateMouseEvent(null, $.kCGEventMouseMoved, point, 0);
+        $.CGEventPost($.kCGHIDEventTap, move);
+        var down = $.CGEventCreateMouseEvent(null, $.kCGEventLeftMouseDown, point, 0);
+        $.CGEventPost($.kCGHIDEventTap, down);
+        var up = $.CGEventCreateMouseEvent(null, $.kCGEventLeftMouseUp, point, 0);
+        $.CGEventPost($.kCGHIDEventTap, up);
+        'clicked';
+      " >/dev/null 2>&1
+      ;;
+    right)
+      osascript -l JavaScript -e "
+        ObjC.import('CoreGraphics');
+        var point = $.CGPointMake($x, $y);
+        var move = $.CGEventCreateMouseEvent(null, $.kCGEventMouseMoved, point, 0);
+        $.CGEventPost($.kCGHIDEventTap, move);
+        var down = $.CGEventCreateMouseEvent(null, $.kCGEventRightMouseDown, point, $.kCGMouseButtonRight);
+        $.CGEventPost($.kCGHIDEventTap, down);
+        var up = $.CGEventCreateMouseEvent(null, $.kCGEventRightMouseUp, point, $.kCGMouseButtonRight);
+        $.CGEventPost($.kCGHIDEventTap, up);
+        'clicked';
+      " >/dev/null 2>&1
+      ;;
+    double)
+      osascript -l JavaScript -e "
+        ObjC.import('CoreGraphics');
+        var point = $.CGPointMake($x, $y);
+        var move = $.CGEventCreateMouseEvent(null, $.kCGEventMouseMoved, point, 0);
+        $.CGEventPost($.kCGHIDEventTap, move);
+        var down1 = $.CGEventCreateMouseEvent(null, $.kCGEventLeftMouseDown, point, 0);
+        $.CGEventSetIntegerValueField(down1, $.kCGMouseEventClickState, 1);
+        $.CGEventPost($.kCGHIDEventTap, down1);
+        var up1 = $.CGEventCreateMouseEvent(null, $.kCGEventLeftMouseUp, point, 0);
+        $.CGEventSetIntegerValueField(up1, $.kCGMouseEventClickState, 1);
+        $.CGEventPost($.kCGHIDEventTap, up1);
+        delay(0.05);
+        var down2 = $.CGEventCreateMouseEvent(null, $.kCGEventLeftMouseDown, point, 0);
+        $.CGEventSetIntegerValueField(down2, $.kCGMouseEventClickState, 2);
+        $.CGEventPost($.kCGHIDEventTap, down2);
+        var up2 = $.CGEventCreateMouseEvent(null, $.kCGEventLeftMouseUp, point, 0);
+        $.CGEventSetIntegerValueField(up2, $.kCGMouseEventClickState, 2);
+        $.CGEventPost($.kCGHIDEventTap, up2);
+        'double-clicked';
+      " >/dev/null 2>&1
+      ;;
+    *)
+      error_exit "Unknown button type: $button (use left, right, or double)"
+      ;;
+  esac
+
+  echo "{\"success\":true,\"action\":\"click\",\"x\":$x,\"y\":$y,\"button\":\"$button\"}"
+}
+
+# -----------------------------------------------------------------------------
+# type — simulate keyboard input
+# -----------------------------------------------------------------------------
+do_type() {
+  local text
+  text=$(echo "$INPUT" | jq -r '.text // empty')
+  require_param "text" "$text"
+
+  osascript -e "tell application \"System Events\" to keystroke \"$text\"" 2>/dev/null
+
+  local char_count=${#text}
+  echo "{\"success\":true,\"action\":\"type\",\"characters\":$char_count}"
+}
+
+# -----------------------------------------------------------------------------
+# Dispatch
+# -----------------------------------------------------------------------------
+case "$ACTION" in
+  screenshot) do_screenshot ;;
+  move)       do_move ;;
+  click)      do_click ;;
+  type)       do_type ;;
+  *)          error_exit "Unknown action: $ACTION (use screenshot, move, click, or type)" ;;
+esac

package/config/skills/agent/computer-use/instructions.md

@@ -0,0 +1,60 @@
+# Desktop Automation (Computer Use)
+
+Control the macOS desktop by taking screenshots, moving/clicking the mouse, and typing text.
+
+## Actions
+
+### Screenshot
+Capture the screen (or a region) to an image file.
+
+```bash
+bash execute.sh '{"action":"screenshot"}'
+bash execute.sh '{"action":"screenshot","output":"/tmp/my-screenshot.png"}'
+```
+
+### Move Mouse
+Move the mouse cursor to a specific coordinate.
+
+```bash
+bash execute.sh '{"action":"move","x":500,"y":300}'
+```
+
+### Click
+Click at a specific coordinate. Supports left click, right click, and double click.
+
+```bash
+bash execute.sh '{"action":"click","x":500,"y":300}'
+bash execute.sh '{"action":"click","x":500,"y":300,"button":"right"}'
+bash execute.sh '{"action":"click","x":500,"y":300,"button":"double"}'
+```
+
+### Type Text
+Type a string of text using simulated keystrokes.
+
+```bash
+bash execute.sh '{"action":"type","text":"Hello, world!"}'
+```
+
+## Parameters
+
+| Parameter | Required | Default | Description |
+|-----------|----------|---------|-------------|
+| `action`  | Yes      | -       | One of: `screenshot`, `move`, `click`, `type` |
+| `x`       | For move/click | - | X coordinate (pixels from left) |
+| `y`       | For move/click | - | Y coordinate (pixels from top) |
+| `button`  | No       | `left`  | Click button: `left`, `right`, or `double` |
+| `text`    | For type | -       | Text string to type |
+| `output`  | No       | `/tmp/screenshot.png` | Screenshot output file path |
+
+## Requirements
+
+- macOS (uses native `screencapture` and CoreGraphics)
+- Accessibility permissions must be granted to the terminal app (System Settings > Privacy & Security > Accessibility)
+
+## Typical Workflow
+
+1. Take a screenshot to see the current screen state
+2. Identify the coordinates of the target element
+3. Move the mouse and/or click on the target
+4. Optionally type text into a focused field
+5. Take another screenshot to verify the result

package/config/skills/agent/computer-use/skill.json

@@ -0,0 +1,22 @@
+{
+  "id": "computer-use",
+  "name": "Desktop Automation (Computer Use)",
+  "description": "Control the macOS desktop: take screenshots, move/click the mouse, and type text. Uses native macOS APIs (screencapture, CoreGraphics via JXA, System Events) with zero external dependencies.",
+  "category": "automation",
+  "skillType": "claude-skill",
+  "promptFile": "instructions.md",
+  "execution": {
+    "type": "script",
+    "script": {
+      "file": "execute.sh",
+      "interpreter": "bash",
+      "timeoutMs": 30000
+    }
+  },
+  "triggers": ["screenshot", "click", "mouse", "type text", "desktop automation", "computer use"],
+  "tags": ["automation", "desktop", "screenshot", "mouse", "keyboard", "macos"],
+  "assignableRoles": ["generalist", "designer", "qa"],
+  "version": "1.0.0",
+  "createdAt": "2026-02-20T00:00:00.000Z",
+  "updatedAt": "2026-02-20T00:00:00.000Z"
+}

package/config/skills/agent/heartbeat/execute.sh

@@ -0,0 +1,22 @@
+#!/bin/bash
+# =============================================================================
+# Agent Heartbeat Skill - Lightweight health check and heartbeat update
+#
+# Calls the /health endpoint to update the agent heartbeat via the
+# X-Agent-Session middleware header (set automatically by lib.sh).
+# =============================================================================
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+source "$SCRIPT_DIR/../../_common/lib.sh"
+
+# Single API call updates heartbeat via the X-Agent-Session middleware
+health_response=$(api_call GET "/health" 2>/dev/null) || health_response='{"error":"unavailable"}'
+
+cat <<EOF
+{
+  "status": "ok",
+  "timestamp": "$(date -u +%Y-%m-%dT%H:%M:%SZ)",
+  "session": "${CREWLY_SESSION_NAME:-unknown}",
+  "health": $health_response
+}
+EOF

package/config/skills/agent/heartbeat/instructions.md

@@ -0,0 +1,23 @@
+# Agent Heartbeat Skill
+
+Perform a lightweight health check to confirm that you are responsive.
+
+## When to Use
+
+Run this skill when the system asks you to perform a heartbeat check. This updates your heartbeat timestamp so the monitoring system knows you are alive and responsive.
+
+## Usage
+
+```bash
+bash config/skills/agent/heartbeat/execute.sh
+```
+
+No parameters required.
+
+## Output
+
+Returns a JSON object with:
+- `status`: "ok" if the health endpoint responded
+- `timestamp`: UTC timestamp of the check
+- `session`: your session name
+- `health`: response from the health endpoint

package/config/skills/agent/heartbeat/skill.json

@@ -0,0 +1,20 @@
+{
+  "id": "agent-heartbeat",
+  "name": "Heartbeat",
+  "description": "Perform a lightweight health check to confirm the agent is responsive. Updates the heartbeat timestamp via the API middleware.",
+  "category": "monitoring",
+  "skillType": "claude-skill",
+  "promptFile": "instructions.md",
+  "execution": {
+    "type": "script",
+    "script": {
+      "file": "execute.sh",
+      "interpreter": "bash",
+      "timeoutMs": 15000
+    }
+  },
+  "assignableRoles": ["developer", "qa", "devops", "pm", "tpm"],
+  "triggers": ["heartbeat", "health check"],
+  "tags": ["monitoring", "heartbeat", "health"],
+  "version": "1.0.0"
+}

package/config/skills/orchestrator/schedule-check/execute.sh

@@ -16,7 +16,7 @@ require_param "minutes" "$MINUTES"
 require_param "message" "$MESSAGE"
 
 # Default target to the caller's own session (orchestrator sends reminders to itself)
-TARGET_SESSION="${TARGET:-${TMUX_SESSION_NAME:-crewly-orc}}"
+TARGET_SESSION="${TARGET:-${CREWLY_SESSION_NAME:-crewly-orc}}"
 
 # API expects: targetSession, minutes, message
 # When recurring, also send isRecurring, intervalMinutes, and optional maxOccurrences

package/config/skills/orchestrator/send-pdf-to-slack/execute.sh

@@ -105,7 +105,7 @@ trap cleanup EXIT
 
 # Convert markdown to PDF using weasyprint
 if ! "$PYTHON" -c "
-import sys, markdown, weasyprint
+import sys, os, re, markdown, weasyprint
 
 md_file = sys.argv[1]
 pdf_file = sys.argv[2]
@@ -113,28 +113,51 @@ pdf_file = sys.argv[2]
 with open(md_file, 'r', encoding='utf-8') as f:
     md_content = f.read()
 
+# Resolve the base directory for relative image paths
+base_dir = os.path.dirname(os.path.abspath(md_file))
+
+# Convert local absolute image paths to file:// URLs so weasyprint can load them
+def fix_image_paths(content):
+    # Match markdown image syntax: ![alt](path)
+    def replace_path(match):
+        alt = match.group(1)
+        path = match.group(2)
+        if os.path.isabs(path) and os.path.exists(path):
+            return '![' + alt + '](file://' + path + ')'
+        elif not path.startswith(('http://', 'https://', 'file://')) and os.path.exists(os.path.join(base_dir, path)):
+            full = os.path.join(base_dir, path)
+            return '![' + alt + '](file://' + full + ')'
+        return match.group(0)
+    return re.sub(r'!\[([^\]]*)\]\(([^)]+)\)', replace_path, content)
+
+md_content = fix_image_paths(md_content)
+
 html = markdown.markdown(md_content, extensions=['tables', 'fenced_code', 'codehilite', 'toc', 'meta'])
 
 styled_html = '''<!DOCTYPE html>
 <html><head><meta charset=\"utf-8\">
 <style>
+  @page { size: A4; margin: 20mm 15mm; }
   body { font-family: -apple-system, \"Noto Sans SC\", \"PingFang SC\", \"Microsoft YaHei\", sans-serif;
-         max-width: 800px; margin: 40px auto; padding: 0 20px; line-height: 1.8;
+         max-width: 800px; margin: 0 auto; padding: 0; line-height: 1.8;
          font-size: 14px; color: #333; }
   h1 { font-size: 24px; border-bottom: 2px solid #333; padding-bottom: 8px; }
   h2 { font-size: 20px; border-bottom: 1px solid #ddd; padding-bottom: 6px; margin-top: 28px; }
   h3 { font-size: 16px; margin-top: 20px; }
-  table { border-collapse: collapse; width: 100%; margin: 16px 0; }
-  th, td { border: 1px solid #ddd; padding: 8px 12px; text-align: left; }
+  img { max-width: 100%; height: auto; display: block; margin: 16px auto;
+        border: 1px solid #e0e0e0; border-radius: 4px; }
+  table { border-collapse: collapse; width: 100%; margin: 16px 0; font-size: 12px; }
+  th, td { border: 1px solid #ddd; padding: 6px 10px; text-align: left; }
   th { background-color: #f5f5f5; font-weight: 600; }
   code { background: #f4f4f4; padding: 2px 6px; border-radius: 3px; font-size: 13px; }
   pre { background: #f4f4f4; padding: 16px; border-radius: 6px; overflow-x: auto; }
   blockquote { border-left: 4px solid #ddd; margin: 16px 0; padding: 8px 16px; color: #666; }
   ul, ol { padding-left: 24px; }
   li { margin: 4px 0; }
+  hr { border: none; border-top: 1px solid #ddd; margin: 24px 0; }
 </style></head><body>''' + html + '</body></html>'
 
-weasyprint.HTML(string=styled_html).write_pdf(pdf_file)
+weasyprint.HTML(string=styled_html, base_url='file://' + base_dir + '/').write_pdf(pdf_file)
 " "$MD_FILE" "$PDF_FILE" 2>/tmp/weasyprint-err-$$.log; then
   WP_ERR="$(cat /tmp/weasyprint-err-$$.log 2>/dev/null || echo 'unknown error')"
   error_exit "weasyprint conversion failed: ${WP_ERR}"

package/config/skills/orchestrator/send-pdf-to-slack/instructions.md

@@ -1,6 +1,16 @@
 # Send PDF to Slack
 
-Converts a markdown file to PDF using `weasyprint` (Python) and uploads it to a Slack channel via the `/api/slack/upload-file` endpoint.
+Converts a markdown file to a styled PDF and uploads it to a Slack channel via the `/api/slack/upload-file` endpoint. Supports embedding local images referenced in the markdown.
+
+## Image Support
+
+The skill automatically handles local images referenced in markdown:
+
+- **Absolute paths**: `![alt](/Users/me/images/photo.png)` — converted to `file://` URLs
+- **Relative paths**: `![alt](./images/photo.png)` — resolved relative to the markdown file's directory
+- **Remote URLs**: `![alt](https://example.com/photo.png)` — passed through as-is
+
+Images are rendered at full width (max 100% of page) with auto height scaling, centered with a subtle border.
 
 ## Prerequisites
 
@@ -10,7 +20,12 @@ Converts a markdown file to PDF using `weasyprint` (Python) and uploads it to a
 ## Usage
 
 ```bash
-bash config/skills/orchestrator/send-pdf-to-slack/execute.sh --channel C0123ABC --file /path/to/document.md --title "Weekly Report"
+bash config/skills/orchestrator/send-pdf-to-slack/execute.sh \
+  --channel C0123ABC \
+  --file /path/to/document.md \
+  --title "Weekly Report" \
+  --text "Here is the report" \
+  --thread 1707123456.789000
 ```
 
 ## Parameters
@@ -23,19 +38,43 @@ bash config/skills/orchestrator/send-pdf-to-slack/execute.sh --channel C0123ABC
 | `--text`, `-t` | No | Initial comment to include with the upload |
 | `--thread`, `-r` | No | Slack thread timestamp for threaded upload |
 
-## Examples
+## Example: Daily Report with Infographics
 
-```bash
-# Basic upload
-bash execute.sh --channel C0123ABC --file report.md
+Create a markdown file with embedded images:
+
+```markdown
+# AI Daily Report - 2026-02-21
+
+## 1. Paper Title
+Summary of the paper.
 
-# Upload with title and comment
-bash execute.sh --channel C0123ABC --file report.md --title "Q4 Report" --text "Here is the quarterly report"
+![Paper Infographic](/path/to/output/infographic-1.png)
 
-# Upload in a thread
-bash execute.sh --channel C0123ABC --file notes.md --thread 1707123456.789000
+## 2. Another Paper
+Summary here.
+
+![Another Infographic](/path/to/output/infographic-2.png)
 ```
 
+Then send it:
+
+```bash
+bash config/skills/orchestrator/send-pdf-to-slack/execute.sh \
+  --channel D0AC7NF5N7L \
+  --file /path/to/daily-report.md \
+  --title "AI Daily Report 2026-02-21" \
+  --text "Today's AI report with infographics" \
+  --thread 1771651155.079579
+```
+
+## PDF Styling
+
+- A4 page size with 20mm/15mm margins
+- System fonts with CJK support (PingFang SC, Noto Sans SC)
+- Images: max-width 100%, centered, with subtle border
+- Tables: full width, bordered cells
+- Code blocks: gray background with monospace font
+
 ## Output
 
 JSON response from the upload API with `fileId` on success. Also emits a `[NOTIFY]` block for chat service integration.

package/config/skills/orchestrator/send-pdf-to-slack/skill.json

@@ -1,7 +1,7 @@
 {
   "id": "orc-send-pdf-to-slack",
   "name": "Send PDF to Slack",
-  "description": "Convert a markdown file to PDF and upload it to a Slack channel.",
+  "description": "Convert a markdown file to a styled PDF (with embedded local images) and upload it to a Slack channel. Supports markdown image syntax ![alt](/path/to/image.png) — local absolute and relative image paths are automatically resolved and embedded in the PDF.",
   "category": "communication",
   "skillType": "claude-skill",
   "promptFile": "instructions.md",

package/config/skills/orchestrator/subscribe-event/execute.sh

@@ -10,9 +10,9 @@ INPUT="${1:-}"
 EVENT_TYPE=$(echo "$INPUT" | jq -r '.eventType // empty')
 require_param "eventType" "$EVENT_TYPE"
 
-# Inject subscriberSession from env (set by Crewly on each tmux session)
+# Inject subscriberSession from env (set by Crewly on each PTY session)
 # The API requires subscriberSession and filter but the agent doesn't need to provide them
-SUBSCRIBER_SESSION="${TMUX_SESSION_NAME:-crewly-orc}"
+SUBSCRIBER_SESSION="${CREWLY_SESSION_NAME:-crewly-orc}"
 BODY=$(echo "$INPUT" | jq --arg ss "$SUBSCRIBER_SESSION" \
   '. + {subscriberSession: $ss} | if .filter == null then .filter = {} else . end')
 

package/dist/backend/backend/src/constants.d.ts

@@ -160,6 +160,20 @@ export declare const VERSION_CHECK_CONSTANTS: {
     readonly CACHE_TTL_MS: number;
     readonly REQUEST_TIMEOUT_MS: 5000;
 };
+export declare const AGENT_HEARTBEAT_MONITOR_CONSTANTS: {
+    readonly CHECK_INTERVAL_MS: 30000;
+    readonly HEARTBEAT_REQUEST_THRESHOLD_MS: 300000;
+    readonly STARTUP_GRACE_PERIOD_MS: 60000;
+    readonly MAX_RESTARTS_PER_WINDOW: 3;
+    readonly COOLDOWN_WINDOW_MS: 3600000;
+};
+export declare const ORCHESTRATOR_HEARTBEAT_CONSTANTS: {
+    readonly CHECK_INTERVAL_MS: 30000;
+    readonly HEARTBEAT_REQUEST_THRESHOLD_MS: 300000;
+    readonly RESTART_THRESHOLD_MS: 60000;
+    readonly HEARTBEAT_REQUEST_MESSAGE: "Please run your heartbeat skill now: bash config/skills/orchestrator/heartbeat/execute.sh";
+    readonly STARTUP_GRACE_PERIOD_MS: 30000;
+};
 export declare const ORCHESTRATOR_SESSION_NAME = "crewly-orc";
 export declare const ORCHESTRATOR_ROLE = "orchestrator";
 export declare const ORCHESTRATOR_WINDOW_NAME = "Crewly Orchestrator";
@@ -229,8 +243,8 @@ export declare const CREWLY_CONSTANTS: {
     };
 };
 export declare const ENV_CONSTANTS: {
-    /** Session name (legacy: kept for compatibility with older agents) */
-    readonly TMUX_SESSION_NAME: "TMUX_SESSION_NAME";
+    /** PTY session name used for agent identity and heartbeat tracking */
+    readonly CREWLY_SESSION_NAME: "CREWLY_SESSION_NAME";
     readonly CREWLY_ROLE: "CREWLY_ROLE";
     /** Base URL for the Crewly backend API (used by orchestrator bash skills) */
     readonly CREWLY_API_URL: "CREWLY_API_URL";
@@ -553,6 +567,14 @@ export declare const RUNTIME_EXIT_CONSTANTS: {
      * normal runtime initialization output.
      */
     readonly STARTUP_GRACE_PERIOD_MS: 0;
+    /**
+     * Grace period for API activity before confirming a runtime exit (ms).
+     * If the agent made an API call within this window, the exit detection
+     * is treated as a false positive and skipped. This prevents false
+     * restarts when agents are actively calling skills/APIs but happen to
+     * produce PTY output that matches exit patterns.
+     */
+    readonly API_ACTIVITY_GRACE_PERIOD_MS: 120000;
 };
 /**
  * Constants for sub-agent message queue.

package/dist/backend/backend/src/constants.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../../../backend/src/constants.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../../../backend/src/constants.ts"],"names":[],"mappings":"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"}