Skip to content

Commit fa40bc7

Browse files
committed
Clarify timeout applies to execution time, not queue wait
- Update tool docstring to clarify queue wait doesn't count - Update README Key Features and Tool Parameters table - Bump version to 0.1.2
1 parent 60aa02d commit fa40bc7

File tree

3 files changed

+5
-4
lines changed

3 files changed

+5
-4
lines changed

README.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -87,7 +87,7 @@ With the queue:
8787
## Key Features
8888

8989
- **FIFO Queuing**: Strict first-in-first-out ordering
90-
- **No Timeouts**: MCP keeps connection alive indefinitely (see [Why MCP?](#why-mcp-instead-of-a-cli-tool))
90+
- **No Queue Timeouts**: MCP keeps connection alive while waiting in queue. The `timeout_seconds` parameter only applies to execution time—tasks can wait in queue indefinitely without timing out. (see [Why MCP?](#why-mcp-instead-of-a-cli-tool))
9191
- **Environment Variables**: Pass `env_vars="ANDROID_SERIAL=emulator-5560"`
9292
- **Multiple Queues**: Isolate different workloads with `queue_name`
9393
- **Zombie Protection**: Detects dead processes, kills orphans, clears stale locks
@@ -237,7 +237,7 @@ The `run_task` tool is automatically used by agents for heavy operations:
237237
| `command` | Yes | Shell command to execute |
238238
| `working_directory` | Yes | Absolute path to run from |
239239
| `queue_name` | No | Queue identifier (default: "global") |
240-
| `timeout_seconds` | No | Max runtime before kill (default: 1200) |
240+
| `timeout_seconds` | No | Max **execution** time before kill (default: 1200). Queue wait time doesn't count. |
241241
| `env_vars` | No | Environment variables: `"KEY=val,KEY2=val2"` |
242242

243243
### Example

pyproject.toml

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
[project]
22
name = "agent-task-queue"
3-
version = "0.1.1"
3+
version = "0.1.2"
44
description = "MCP server for sequential task execution via FIFO queue"
55
readme = "README.md"
66
requires-python = ">=3.10"

task_queue.py

Lines changed: 2 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -449,7 +449,8 @@ async def run_task(
449449
command: The full shell command to run.
450450
working_directory: ABSOLUTE path to the execution root.
451451
queue_name: Queue identifier for grouping tasks (default: "global").
452-
timeout_seconds: Max runtime before killing the task (default: 1200 = 20 mins).
452+
timeout_seconds: Max **execution** time before killing the task (default: 1200 = 20 mins).
453+
Queue wait time does NOT count against this timeout.
453454
env_vars: Environment variables to set, format: "KEY1=value1,KEY2=value2"
454455
455456
Returns:

0 commit comments

Comments
 (0)