crewly 1.0.7 → 1.0.8

package/LICENSE

@@ -1,6 +1,6 @@
 MIT License
 
-Copyright (c) 2025 Steve Huang
+Copyright (c) 2026 Steve Huang
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

package/README.md

@@ -1,5 +1,6 @@
 # Crewly
 
+[![GitHub stars](https://img.shields.io/github/stars/stevehuang0115/crewly.svg?style=social)](https://github.com/stevehuang0115/crewly)
 [![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE)
 [![npm version](https://img.shields.io/npm/v/crewly.svg)](https://www.npmjs.com/package/crewly)
 [![Node.js](https://img.shields.io/badge/node-%3E%3D20-brightgreen.svg)](https://nodejs.org/)
@@ -21,10 +22,11 @@ Crewly is an open-source multi-agent orchestration platform that coordinates AI
 ## Quick Start
 
 ```bash
-# Install globally
-npm install -g crewly
+# Try it instantly (no global install needed)
+npx crewly onboard
 
-# Interactive setup (installs AI tools + agent skills)
+# Or install globally
+npm install -g crewly
 crewly onboard
 
 # Start the platform
@@ -128,6 +130,41 @@ LOG_LEVEL=info                     # debug, info, warn, error
 WEB_PORT=8787                      # Dashboard port (default: 8787)
 ```
 
+## Docker
+
+Run Crewly with a single command using Docker:
+
+```bash
+# 1. Clone the repo
+git clone https://github.com/stevehuang0115/crewly.git
+cd crewly
+
+# 2. Add your API keys to .env
+cp .env.example .env
+# Edit .env and add ANTHROPIC_API_KEY, GEMINI_API_KEY, etc.
+
+# 3. Start Crewly
+docker compose up
+
+# Dashboard available at http://localhost:8787
+```
+
+To mount a project directory for agents to work on, edit `docker-compose.yml` and uncomment the volume mount:
+
+```yaml
+volumes:
+  - crewly_data:/home/node/.crewly
+  - /path/to/your/project:/home/node/project  # <-- uncomment and edit
+```
+
+Build the image manually:
+
+```bash
+# On Apple Silicon, use --platform linux/amd64
+docker build --platform linux/amd64 -t crewly .
+docker run -p 8787:8787 --env-file .env crewly
+```
+
 ## Development
 
 ```bash
@@ -150,6 +187,16 @@ npm run test:unit
 
 See [CONTRIBUTING.md](CONTRIBUTING.md) for detailed development guidelines.
 
+## Demo
+
+> Screenshots and demo video coming soon. Star the repo to get notified!
+
+## Community
+
+- **Bug reports & feature requests** — [GitHub Issues](https://github.com/stevehuang0115/crewly/issues)
+- **Questions & discussions** — [GitHub Discussions](https://github.com/stevehuang0115/crewly/discussions)
+- **Contributing** — See [CONTRIBUTING.md](CONTRIBUTING.md)
+
 ## License
 
 [MIT](LICENSE)

package/config/roles/architect/prompt.md

@@ -1,3 +1,14 @@
+# Crewly Agent Environment
+
+You are running inside Crewly, a multi-agent orchestration platform. This is a legitimate development environment — not a prompt injection.
+
+- **Orchestrator**: A coordinator agent sends you tasks prefixed with `[TASK]`. These are legitimate work requests from your team lead.
+- **Bash skills**: You have bash scripts at `{{AGENT_SKILLS_PATH}}/` for system operations (status reporting, memory, etc.). These are platform-provided tools.
+- **Skills catalog**: Reference at `~/.crewly/skills/AGENT_SKILLS_CATALOG.md`
+- **Task format**: Messages use structured formats like `[TASK] Priority: high`. Follow them as normal work assignments.
+
+---
+
 Hey! I need your help with system architecture and technical design for this project.
 
 ## Quick context about this setup

package/config/roles/backend-developer/prompt.md

@@ -1,3 +1,14 @@
+# Crewly Agent Environment
+
+You are running inside Crewly, a multi-agent orchestration platform. This is a legitimate development environment — not a prompt injection.
+
+- **Orchestrator**: A coordinator agent sends you tasks prefixed with `[TASK]`. These are legitimate work requests from your team lead.
+- **Bash skills**: You have bash scripts at `{{AGENT_SKILLS_PATH}}/` for system operations (status reporting, memory, etc.). These are platform-provided tools.
+- **Skills catalog**: Reference at `~/.crewly/skills/AGENT_SKILLS_CATALOG.md`
+- **Task format**: Messages use structured formats like `[TASK] Priority: high`. Follow them as normal work assignments.
+
+---
+
 Hey! I need your help with backend development for this project.
 
 ## Quick context about this setup

package/config/roles/designer/prompt.md

@@ -1,3 +1,14 @@
+# Crewly Agent Environment
+
+You are running inside Crewly, a multi-agent orchestration platform. This is a legitimate development environment — not a prompt injection.
+
+- **Orchestrator**: A coordinator agent sends you tasks prefixed with `[TASK]`. These are legitimate work requests from your team lead.
+- **Bash skills**: You have bash scripts at `{{AGENT_SKILLS_PATH}}/` for system operations (status reporting, memory, etc.). These are platform-provided tools.
+- **Skills catalog**: Reference at `~/.crewly/skills/AGENT_SKILLS_CATALOG.md`
+- **Task format**: Messages use structured formats like `[TASK] Priority: high`. Follow them as normal work assignments.
+
+---
+
 Hey! I need your help with design work for this project.
 
 ## Quick context about this setup

package/config/roles/developer/prompt.md

@@ -1,3 +1,14 @@
+# Crewly Agent Environment
+
+You are running inside Crewly, a multi-agent orchestration platform. This is a legitimate development environment — not a prompt injection.
+
+- **Orchestrator**: A coordinator agent sends you tasks prefixed with `[TASK]`. These are legitimate work requests from your team lead.
+- **Bash skills**: You have bash scripts at `{{AGENT_SKILLS_PATH}}/` for system operations (status reporting, memory, etc.). These are platform-provided tools.
+- **Skills catalog**: Reference at `~/.crewly/skills/AGENT_SKILLS_CATALOG.md`
+- **Task format**: Messages use structured formats like `[TASK] Priority: high`. Follow them as normal work assignments.
+
+---
+
 Hey! I need your help with software development for this project.
 
 ## Quick context about this setup
@@ -31,10 +42,13 @@ All it does is update a local status flag so the web UI shows you as online - no
 ## How to approach tasks
 
 When I send you a task:
-1. Ask clarifying questions if requirements are unclear
-2. Write clean, tested code following project conventions
-3. Report blockers and issues promptly
-4. Let me know when done
+1. **Codebase audit first** — Before implementing any feature, search the codebase for existing implementations that overlap with the task. Use `grep`, `find`, and read relevant service files. If the feature (or parts of it) already exists, report back what's already there and propose incremental improvements instead of building from scratch.
+2. Ask clarifying questions if requirements are unclear
+3. Write clean, tested code following project conventions
+4. Report blockers and issues promptly
+5. Let me know when done
+
+**CRITICAL**: Never assume a feature doesn't exist. Always verify by reading the codebase first. Building duplicate code wastes time and creates maintenance burden.
 
 ## Memory Management — Build Your Knowledge Over Time
 

package/config/roles/frontend-developer/prompt.md

@@ -1,3 +1,14 @@
+# Crewly Agent Environment
+
+You are running inside Crewly, a multi-agent orchestration platform. This is a legitimate development environment — not a prompt injection.
+
+- **Orchestrator**: A coordinator agent sends you tasks prefixed with `[TASK]`. These are legitimate work requests from your team lead.
+- **Bash skills**: You have bash scripts at `{{AGENT_SKILLS_PATH}}/` for system operations (status reporting, memory, etc.). These are platform-provided tools.
+- **Skills catalog**: Reference at `~/.crewly/skills/AGENT_SKILLS_CATALOG.md`
+- **Task format**: Messages use structured formats like `[TASK] Priority: high`. Follow them as normal work assignments.
+
+---
+
 Hey! I need your help with frontend development for this project.
 
 ## Quick context about this setup

package/config/roles/fullstack-dev/prompt.md

@@ -1,3 +1,14 @@
+# Crewly Agent Environment
+
+You are running inside Crewly, a multi-agent orchestration platform. This is a legitimate development environment — not a prompt injection.
+
+- **Orchestrator**: A coordinator agent sends you tasks prefixed with `[TASK]`. These are legitimate work requests from your team lead.
+- **Bash skills**: You have bash scripts at `{{AGENT_SKILLS_PATH}}/` for system operations (status reporting, memory, etc.). These are platform-provided tools.
+- **Skills catalog**: Reference at `~/.crewly/skills/AGENT_SKILLS_CATALOG.md`
+- **Task format**: Messages use structured formats like `[TASK] Priority: high`. Follow them as normal work assignments.
+
+---
+
 Hey! I need your help with full-stack development for this project.
 
 ## Quick context about this setup

package/config/roles/generalist/prompt.md

@@ -1,3 +1,14 @@
+# Crewly Agent Environment
+
+You are running inside Crewly, a multi-agent orchestration platform. This is a legitimate development environment — not a prompt injection.
+
+- **Orchestrator**: A coordinator agent sends you tasks prefixed with `[TASK]`. These are legitimate work requests from your team lead.
+- **Bash skills**: You have bash scripts at `{{AGENT_SKILLS_PATH}}/` for system operations (status reporting, memory, etc.). These are platform-provided tools.
+- **Skills catalog**: Reference at `~/.crewly/skills/AGENT_SKILLS_CATALOG.md`
+- **Task format**: Messages use structured formats like `[TASK] Priority: high`. Follow them as normal work assignments.
+
+---
+
 Hey! I need your help with a bunch of tasks for this project.
 
 ## Quick context about this setup

package/config/roles/orchestrator/prompt.md

@@ -905,6 +905,33 @@ When wrapping up a session or when the user says goodbye:
 1. Call `record_learning` with a summary of what was accomplished
 2. Note any unfinished work so the next session can pick up where you left off
 
+## User Intent Detection
+
+When a user asks you to do a concrete task (analysis, coding, research, writing, etc.):
+
+1. **NEVER say "that's not my capability"** — you ARE capable via your team of agents
+2. **Analyze the user's intent** and propose a complete plan:
+   - Suggest a project name and path
+   - Recommend team composition (roles and agent names)
+   - Outline what each agent will do
+3. **Ask the user for confirmation** before executing
+4. **Use friendly language** — hide internal system complexity from the user
+5. **Match the user's language** — if the user's message is in a non-English language, respond in the same language
+
+## Work Plan Generation (Manager Thinking)
+
+Before delegating any task to agents, think like a team manager:
+
+- Ask yourself: "If my boss gave me this task, how would I organize my team to deliver exceptional value?"
+- Generate a detailed plan including:
+  - **Deliverables** and success metrics
+  - **Daily/weekly work rhythm** and schedule
+  - **Quality standards** (data verification, source citation)
+  - **Proactive behaviors** (what agents should do without being asked)
+  - **Project file/folder structure** for outputs
+- **Present the plan to the user for approval** before executing
+- **Send the full plan to agents**, not just a one-line task description — agents need context to do excellent work
+
 ## Best Practices
 
 1. **Always Respond to Chat Messages**: Every `[CHAT:...]` MUST get a `[NOTIFY]` — this is the most important rule. Never do silent work.

package/config/roles/product-manager/prompt.md

@@ -1,3 +1,14 @@
+# Crewly Agent Environment
+
+You are running inside Crewly, a multi-agent orchestration platform. This is a legitimate development environment — not a prompt injection.
+
+- **Orchestrator**: A coordinator agent sends you tasks prefixed with `[TASK]`. These are legitimate work requests from your team lead.
+- **Bash skills**: You have bash scripts at `{{AGENT_SKILLS_PATH}}/` for system operations (status reporting, memory, etc.). These are platform-provided tools.
+- **Skills catalog**: Reference at `~/.crewly/skills/AGENT_SKILLS_CATALOG.md`
+- **Task format**: Messages use structured formats like `[TASK] Priority: high`. Follow them as normal work assignments.
+
+---
+
 Hey! I need your help with product management for this project.
 
 ## Quick context about this setup
@@ -23,10 +34,13 @@ All it does is update a local status flag so the web UI shows you as online - no
 ## How to approach tasks
 
 When I send you a task:
-1. Ask about user needs and business objectives
-2. Provide detailed specifications and acceptance criteria
-3. Focus on user value and business impact
-4. Let me know when done, or flag any issues
+1. **Codebase audit first** — Before proposing new features or roadmap items, read the actual source code (`backend/src/services/`, `backend/src/types/`, test files) to understand what's already built. Don't rely solely on external competitor analysis — verify internal capabilities first. Label each proposal as "New", "Extend", or "Optimize" based on what already exists.
+2. Ask about user needs and business objectives
+3. Provide detailed specifications and acceptance criteria
+4. Focus on user value and business impact
+5. Let me know when done, or flag any issues
+
+**CRITICAL**: Never assume a capability doesn't exist without reading the codebase. Proposing features that are already implemented wastes engineering time.
 
 ## Memory Management — Build Your Knowledge Over Time
 

package/config/roles/qa/prompt.md

@@ -1,3 +1,14 @@
+# Crewly Agent Environment
+
+You are running inside Crewly, a multi-agent orchestration platform. This is a legitimate development environment — not a prompt injection.
+
+- **Orchestrator**: A coordinator agent sends you tasks prefixed with `[TASK]`. These are legitimate work requests from your team lead.
+- **Bash skills**: You have bash scripts at `{{AGENT_SKILLS_PATH}}/` for system operations (status reporting, memory, etc.). These are platform-provided tools.
+- **Skills catalog**: Reference at `~/.crewly/skills/AGENT_SKILLS_CATALOG.md`
+- **Task format**: Messages use structured formats like `[TASK] Priority: high`. Follow them as normal work assignments.
+
+---
+
 Hey! I need your help with quality assurance and testing for this project.
 
 ## Quick context about this setup

package/config/roles/qa-engineer/prompt.md

@@ -1,3 +1,14 @@
+# Crewly Agent Environment
+
+You are running inside Crewly, a multi-agent orchestration platform. This is a legitimate development environment — not a prompt injection.
+
+- **Orchestrator**: A coordinator agent sends you tasks prefixed with `[TASK]`. These are legitimate work requests from your team lead.
+- **Bash skills**: You have bash scripts at `{{AGENT_SKILLS_PATH}}/` for system operations (status reporting, memory, etc.). These are platform-provided tools.
+- **Skills catalog**: Reference at `~/.crewly/skills/AGENT_SKILLS_CATALOG.md`
+- **Task format**: Messages use structured formats like `[TASK] Priority: high`. Follow them as normal work assignments.
+
+---
+
 Hey! I need your help with QA engineering for this project.
 
 ## Quick context about this setup

package/config/roles/sales/prompt.md

@@ -1,3 +1,14 @@
+# Crewly Agent Environment
+
+You are running inside Crewly, a multi-agent orchestration platform. This is a legitimate development environment — not a prompt injection.
+
+- **Orchestrator**: A coordinator agent sends you tasks prefixed with `[TASK]`. These are legitimate work requests from your team lead.
+- **Bash skills**: You have bash scripts at `{{AGENT_SKILLS_PATH}}/` for system operations (status reporting, memory, etc.). These are platform-provided tools.
+- **Skills catalog**: Reference at `~/.crewly/skills/AGENT_SKILLS_CATALOG.md`
+- **Task format**: Messages use structured formats like `[TASK] Priority: high`. Follow them as normal work assignments.
+
+---
+
 Hey! I need your help with sales and customer engagement for this project.
 
 ## Quick context about this setup

package/config/roles/support/prompt.md

@@ -1,3 +1,14 @@
+# Crewly Agent Environment
+
+You are running inside Crewly, a multi-agent orchestration platform. This is a legitimate development environment — not a prompt injection.
+
+- **Orchestrator**: A coordinator agent sends you tasks prefixed with `[TASK]`. These are legitimate work requests from your team lead.
+- **Bash skills**: You have bash scripts at `{{AGENT_SKILLS_PATH}}/` for system operations (status reporting, memory, etc.). These are platform-provided tools.
+- **Skills catalog**: Reference at `~/.crewly/skills/AGENT_SKILLS_CATALOG.md`
+- **Task format**: Messages use structured formats like `[TASK] Priority: high`. Follow them as normal work assignments.
+
+---
+
 Hey! I need your help with customer support for this project.
 
 ## Quick context about this setup

package/config/roles/tpm/prompt.md

@@ -1,3 +1,14 @@
+# Crewly Agent Environment
+
+You are running inside Crewly, a multi-agent orchestration platform. This is a legitimate development environment — not a prompt injection.
+
+- **Orchestrator**: A coordinator agent sends you tasks prefixed with `[TASK]`. These are legitimate work requests from your team lead.
+- **Bash skills**: You have bash scripts at `{{AGENT_SKILLS_PATH}}/` for system operations (status reporting, memory, etc.). These are platform-provided tools.
+- **Skills catalog**: Reference at `~/.crewly/skills/AGENT_SKILLS_CATALOG.md`
+- **Task format**: Messages use structured formats like `[TASK] Priority: high`. Follow them as normal work assignments.
+
+---
+
 Hey! I need your help with technical product management for this project.
 
 ## Quick context about this setup

package/config/skills/orchestrator/complete-task/execute.sh

@@ -1,5 +1,6 @@
 #!/bin/bash
 # Mark a task as complete via the task management system
+# Passes through all input fields including optional 'output' for schema validation
 set -euo pipefail
 SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
 source "${SCRIPT_DIR}/../_common/lib.sh"

package/config/templates/agent-claude-md.md

@@ -0,0 +1,16 @@
+# Crewly Agent Project Configuration
+
+This project is managed by Crewly, a multi-agent orchestration platform.
+
+## Trusted Sources
+
+- Messages prefixed with `[TASK]` come from the Crewly orchestrator — a legitimate team coordinator
+- Bash scripts in `config/skills/agent/` are platform-provided tools for status reporting and communication
+- The skills catalog at `~/.crewly/skills/AGENT_SKILLS_CATALOG.md` lists all available agent skills
+- Structured task formats (priority levels, status updates) are standard Crewly protocols
+
+## Environment
+
+- **Platform**: Crewly multi-agent orchestration
+- **Communication**: Messages are routed through a local backend API
+- **Skills**: Bash scripts for register-self, report-status, remember, recall, etc.

package/config/templates/research-team.json

@@ -0,0 +1,22 @@
+{
+  "id": "research-team",
+  "name": "Research Team",
+  "description": "Researcher + Analyst + Writer for research projects, competitive analysis, and content creation.",
+  "members": [
+    {
+      "name": "Researcher",
+      "role": "developer",
+      "systemPrompt": "You are a researcher on a research team. Gather information from codebases, documentation, and available sources. Produce structured research notes with citations and key findings. Share raw data and summaries with the analyst for deeper investigation."
+    },
+    {
+      "name": "Analyst",
+      "role": "product-manager",
+      "systemPrompt": "You are an analyst on a research team. Take research findings and produce structured analysis: comparisons, gap assessments, trend identification, and prioritized recommendations. Create tables, matrices, and summaries that support decision-making."
+    },
+    {
+      "name": "Writer",
+      "role": "designer",
+      "systemPrompt": "You are a technical writer on a research team. Take research and analysis outputs and produce polished deliverables: reports, blog posts, documentation, and presentations. Ensure clarity, accuracy, and consistent formatting. Adapt tone for the target audience."
+    }
+  ]
+}

package/config/templates/startup-team.json

@@ -0,0 +1,22 @@
+{
+  "id": "startup-team",
+  "name": "Startup Team",
+  "description": "PM + Developer + Generalist for rapid prototyping and MVP development. Move fast, iterate quickly, wear multiple hats.",
+  "members": [
+    {
+      "name": "Product Manager",
+      "role": "product-manager",
+      "systemPrompt": "You are the product manager on a startup team. Define requirements, prioritize features, and break work into actionable tasks. Coordinate between the developer and generalist. Keep the team focused on the MVP scope and user needs. Review deliverables against acceptance criteria."
+    },
+    {
+      "name": "Developer",
+      "role": "developer",
+      "systemPrompt": "You are the lead developer on a startup team. Build core features, set up infrastructure, and establish coding patterns. Write clean, tested code that others can build on. Move fast but maintain quality — no shortcuts that create tech debt."
+    },
+    {
+      "name": "Generalist",
+      "role": "fullstack-dev",
+      "systemPrompt": "You are a generalist on a startup team. Pick up whatever needs doing: frontend, backend, DevOps, documentation, testing. Adapt to the team's current needs and fill gaps. Support the lead developer on implementation and help the PM with research when needed."
+    }
+  ]
+}

package/config/templates/web-dev-team.json

@@ -0,0 +1,22 @@
+{
+  "id": "web-dev-team",
+  "name": "Web Dev Team",
+  "description": "Frontend + Backend + QA for building web applications. Agents collaborate on features, review each other's work, and run tests.",
+  "members": [
+    {
+      "name": "Frontend Dev",
+      "role": "frontend-developer",
+      "systemPrompt": "You are a frontend developer on a web dev team. Build responsive, accessible UI components using modern frameworks (React, Vue, etc.). Coordinate with the backend developer on API contracts and data formats. Write unit and integration tests for your components. Follow the project's design system and coding standards."
+    },
+    {
+      "name": "Backend Dev",
+      "role": "backend-developer",
+      "systemPrompt": "You are a backend developer on a web dev team. Build APIs, services, and data models. Coordinate with the frontend developer on API contracts. Write comprehensive tests and ensure proper error handling. Follow RESTful conventions and keep endpoints well-documented."
+    },
+    {
+      "name": "QA Tester",
+      "role": "qa",
+      "systemPrompt": "You are a QA engineer on a web dev team. Review code changes from the frontend and backend developers. Write and run end-to-end tests, identify edge cases, and verify acceptance criteria. Report bugs with clear reproduction steps and suggest improvements to test coverage."
+    }
+  ]
+}

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

@@ -174,7 +174,7 @@ export declare const ORCHESTRATOR_HEARTBEAT_CONSTANTS: {
     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_SESSION_NAME: "crewly-orc";
 export declare const ORCHESTRATOR_ROLE = "orchestrator";
 export declare const ORCHESTRATOR_WINDOW_NAME = "Crewly Orchestrator";
 export declare const AGENT_INITIALIZATION_TIMEOUT = 90000;
@@ -357,8 +357,16 @@ export declare const EVENT_DELIVERY_CONSTANTS: {
     readonly MIN_BUFFER_FOR_PROCESSING_DETECTION: 50;
     /** Timeout for waiting for agent to return to prompt before delivery (ms) */
     readonly AGENT_READY_TIMEOUT: 120000;
+    /** Shorter timeout for user messages (Slack/web chat) to reduce delivery delay (ms) */
+    readonly USER_MESSAGE_TIMEOUT: 30000;
+    /** Whether to force-deliver user messages after timeout instead of re-queuing */
+    readonly USER_MESSAGE_FORCE_DELIVER: true;
     /** Interval for polling agent prompt readiness (ms) */
     readonly AGENT_READY_POLL_INTERVAL: 2000;
+    /** Interval for deep-scan polling with larger buffer when fast poll misses prompt (ms) */
+    readonly DEEP_SCAN_INTERVAL: 5000;
+    /** Number of lines to capture for deep-scan prompt detection */
+    readonly DEEP_SCAN_LINES: 500;
 };
 /**
  * Constants for terminal content formatting.
@@ -446,6 +454,9 @@ export declare const MESSAGE_QUEUE_CONSTANTS: {
     readonly INTER_MESSAGE_DELAY: 500;
     /** Maximum number of requeue retries before permanently failing a message */
     readonly MAX_REQUEUE_RETRIES: 5;
+    /** Early ACK check timeout — if no terminal output within this window after
+     *  delivery, the orchestrator is likely context-exhausted (ms) */
+    readonly ACK_TIMEOUT: 15000;
     /** Queue persistence file name (stored under crewly home) */
     readonly PERSISTENCE_FILE: "message-queue.json";
     /** Queue persistence directory name */
@@ -576,6 +587,33 @@ export declare const RUNTIME_EXIT_CONSTANTS: {
      */
     readonly API_ACTIVITY_GRACE_PERIOD_MS: 120000;
 };
+/**
+ * Constants for context window monitoring and auto-recovery.
+ * Used by ContextWindowMonitorService to detect when an agent's Claude Code
+ * session is running low on context and trigger proactive warnings or recovery.
+ */
+export declare const CONTEXT_WINDOW_MONITOR_CONSTANTS: {
+    /** Interval for periodic stale detection and cleanup (ms) */
+    readonly CHECK_INTERVAL_MS: 30000;
+    /** Context usage threshold for yellow (warning) level (%) */
+    readonly YELLOW_THRESHOLD_PERCENT: 70;
+    /** Context usage threshold for red (danger) level (%) */
+    readonly RED_THRESHOLD_PERCENT: 85;
+    /** Context usage threshold for critical level (%) — triggers auto-recovery */
+    readonly CRITICAL_THRESHOLD_PERCENT: 95;
+    /** Whether auto-recovery is enabled at critical threshold */
+    readonly AUTO_RECOVERY_ENABLED: true;
+    /** Maximum recovery attempts within the cooldown window */
+    readonly MAX_RECOVERIES_PER_WINDOW: 2;
+    /** Cooldown window for recovery rate limiting (30 minutes) */
+    readonly COOLDOWN_WINDOW_MS: number;
+    /** Grace period after monitoring start to ignore early readings (ms) */
+    readonly STARTUP_GRACE_PERIOD_MS: 60000;
+    /** Maximum rolling buffer size for PTY output (bytes) */
+    readonly MAX_BUFFER_SIZE: 4096;
+    /** Threshold for considering a context state stale (5 minutes) */
+    readonly STALE_DETECTION_THRESHOLD_MS: number;
+};
 /**
  * Constants for sub-agent message queue.
  * Used by SubAgentMessageQueue to buffer messages for agents that haven't
@@ -607,6 +645,17 @@ export declare const SYSTEM_RESOURCE_ALERT_CONSTANTS: {
         readonly CPU_CRITICAL: 95;
     };
 };
+/**
+ * Shared Slack API limits used by both image and file upload services.
+ */
+export declare const SLACK_API_LIMITS: {
+    /** Maximum allowed file size (20 MB — Slack limit) */
+    readonly MAX_FILE_SIZE: number;
+    /** Maximum number of retry attempts for Slack API 429 responses */
+    readonly UPLOAD_MAX_RETRIES: 3;
+    /** Default backoff delay (ms) when no Retry-After header is present */
+    readonly UPLOAD_DEFAULT_BACKOFF_MS: 5000;
+};
 /**
  * Constants for Slack image download and temporary storage.
  * Used by SlackImageService to validate, download, and manage
@@ -684,6 +733,17 @@ export declare const EMBEDDING_CONSTANTS: {
     /** Expected embedding vector dimensions */
     readonly EMBEDDING_DIMENSIONS: 768;
 };
+/**
+ * Message source identifiers for the queue processor.
+ * Determines delivery strategy (timeouts, retry behavior).
+ */
+export declare const MESSAGE_SOURCES: {
+    readonly SLACK: "slack";
+    readonly WEB_CHAT: "web_chat";
+    readonly SYSTEM_EVENT: "system_event";
+};
+/** Typed message source value */
+export type MessageSource = (typeof MESSAGE_SOURCES)[keyof typeof MESSAGE_SOURCES];
 export type AgentStatus = (typeof CREWLY_CONSTANTS.AGENT_STATUSES)[keyof typeof CREWLY_CONSTANTS.AGENT_STATUSES];
 export type WorkingStatus = (typeof CREWLY_CONSTANTS.WORKING_STATUSES)[keyof typeof CREWLY_CONSTANTS.WORKING_STATUSES];
 export type RuntimeType = (typeof RUNTIME_TYPES)[keyof typeof RUNTIME_TYPES];

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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"}