deer-flow/backend/tests/test_scheduled_task_router_behavior.py
wutongyuonce 48a8978b7b
feat(scheduler): add interval schedule type (#5291)
* feat(scheduler): add interval schedule type

Allow scheduled tasks to fire every N seconds from last dispatch, not
only wall-clock cron or a single run_at. Cadence is UTC now+N with no
missed-beat catch-up, bounded by min_once_delay_seconds and 30 days.

* fix(scheduler): let interval tasks create, edit, and keep next run

Create/edit now keep every_seconds. Unchanged interval spec no longer
resets next_run_at, including timezone-only PATCH.

* fix(scheduler): keep non-minute intervals on edit

Stop rounding every_seconds to whole minutes in the form. Values that
are not whole minutes or hours now use a seconds unit so edit/duplicate
round-trips the stored cadence instead of rewriting it and resetting
next_run_at. Document that min_once_delay_seconds is also the interval
floor.

* fix(scheduler): clamp interval seconds to the default 60s floor

The new seconds unit allowed 1–59, which the API rejects under the
default min_once_delay_seconds. Clamp the form to >= 60 and show the
floor next to the preview. Also mention interval in the scheduler
field_doc, matching config.example.yaml.

* fix(scheduler): do not clamp interval amount while typing

Keystroke clamp made 90 become 9 -> 60, then 600, and backspace could
not leave 60. Keep the raw field text and apply the 60s floor on blur
and emit only.

* test(scheduler): cover interval input editing

* fix(frontend): preserve saved interval cadence until edited

* style(tests): format scheduled task router tests

---------

Co-authored-by: Willem Jiang <willem.jiang@gmail.com>
2026-09-10 16:46:01 +08:00

1312 lines
46 KiB
Python

import asyncio
from datetime import UTC, datetime, timedelta
from types import SimpleNamespace
from unittest.mock import AsyncMock, patch
import pytest
from _router_auth_helpers import call_unwrapped
from fastapi import HTTPException
from app.gateway.routers import scheduled_tasks
from deerflow.config.database_config import DatabaseConfig
from deerflow.persistence.engine import close_engine, get_session_factory, init_engine_from_config
from deerflow.persistence.scheduled_task_runs import ScheduledTaskRunRepository
from deerflow.persistence.scheduled_tasks import ScheduledTaskRepository
@pytest.mark.parametrize(
"model",
[
scheduled_tasks.ScheduledTaskCreateRequest,
scheduled_tasks.ScheduledTaskUpdateRequest,
],
)
@pytest.mark.parametrize("thread_id", ["", "thread.with.dot", "../escape", "x" * 65])
def test_scheduled_task_models_reject_invalid_thread_ids(model, thread_id):
from pydantic import ValidationError
kwargs = {"thread_id": thread_id}
if model is scheduled_tasks.ScheduledTaskCreateRequest:
kwargs.update(
title="Task",
prompt="Prompt",
schedule_type="cron",
schedule_spec={"cron": "0 * * * *"},
timezone="UTC",
)
with pytest.raises(ValidationError):
model(**kwargs)
@pytest.mark.parametrize(
("status", "offers_pause_cancellation"),
[
("queued", True),
("launching", False),
("running", False),
],
)
def test_active_occurrence_conflict_detail_only_offers_pause_for_queued(status, offers_pause_cancellation):
detail = scheduled_tasks._active_occurrence_conflict_detail(status)
assert f"active {status} occurrence" in detail
assert ("cancel the queued occurrence by pausing the task" in detail) is offers_pause_cancellation
class _Repo:
def __init__(self) -> None:
self.created = []
self.items = {}
self.active_status = None
self.cancelled_queue = False
async def list_by_user(self, user_id: str):
return [item for item in self.items.values() if item["user_id"] == user_id]
async def list_by_user_and_thread(self, user_id: str, thread_id: str):
return [item for item in self.items.values() if item["user_id"] == user_id and item["thread_id"] == thread_id]
async def create(self, **kwargs):
item = {
"id": kwargs["task_id"],
"user_id": kwargs["user_id"],
"thread_id": kwargs["thread_id"],
"context_mode": kwargs["context_mode"],
"assistant_id": kwargs.get("assistant_id"),
"title": kwargs["title"],
"prompt": kwargs["prompt"],
"schedule_type": kwargs["schedule_type"],
"schedule_spec": kwargs["schedule_spec"],
"timezone": kwargs["timezone"],
"status": "enabled",
"next_run_at": kwargs["next_run_at"],
}
self.items[item["id"]] = item
self.created.append(item)
return item
async def get(self, task_id: str, *, user_id: str):
item = self.items.get(task_id)
if item is None or item["user_id"] != user_id:
return None
return item
async def update(self, task_id: str, *, user_id: str, updates, require_mutable: bool = False):
item = await self.get(task_id, user_id=user_id)
if item is None:
return None
item.update(updates)
return item
async def get_active_run_status(self, task_id: str):
return self.active_status
async def pause_with_queue_cancellation(self, task_id: str, *, user_id: str, **_kwargs):
item = await self.get(task_id, user_id=user_id)
if item is None:
return "not_found"
if self.active_status in {"launching", "running"}:
return "executing"
if self.active_status == "queued":
self.cancelled_queue = True
self.active_status = None
item["status"] = "paused"
return "paused"
async def delete_with_queue_cancellation(self, task_id: str, *, user_id: str, **_kwargs):
item = await self.get(task_id, user_id=user_id)
if item is None:
return "not_found"
if self.active_status in {"launching", "running"}:
return "executing"
if self.active_status == "queued":
self.cancelled_queue = True
self.active_status = None
self.items.pop(task_id, None)
return "deleted"
async def delete(self, task_id: str, *, user_id: str):
item = await self.get(task_id, user_id=user_id)
if item is None:
return False
self.items.pop(task_id, None)
return True
async def list_by_task(self, task_id: str):
return []
class _Service:
def __init__(self) -> None:
self.calls = []
self.result = {"outcome": "launched"}
async def dispatch_task(self, task, *, now, trigger):
self.calls.append((task, now, trigger))
return self.result
class _RunStore:
def __init__(self, runs):
self.runs = runs
async def get(self, run_id: str, *, user_id: str):
run = self.runs.get(run_id)
if run is None or run.get("user_id") != user_id:
return None
return run
class _Config:
def __init__(self, min_once_delay_seconds: int = 60) -> None:
self.scheduler = SimpleNamespace(min_once_delay_seconds=min_once_delay_seconds)
@pytest.mark.asyncio
async def test_create_scheduled_task_uses_repo():
repo = _Repo()
request = SimpleNamespace()
body = scheduled_tasks.ScheduledTaskCreateRequest(
thread_id="thread-1",
title="Daily summary",
prompt="Summarize thread",
schedule_type="once",
schedule_spec={"run_at": "2027-01-01T01:00:00+00:00"},
timezone="UTC",
)
user = SimpleNamespace(id="user-1")
thread_store = SimpleNamespace(check_access=AsyncMock(return_value=True))
config = _Config()
old_repo = scheduled_tasks.get_scheduled_task_repo
old_thread_store = scheduled_tasks.get_thread_store
old_config = scheduled_tasks.get_config
old_user = scheduled_tasks.get_optional_user_from_request
try:
scheduled_tasks.get_scheduled_task_repo = lambda _request: repo
scheduled_tasks.get_thread_store = lambda _request: thread_store
scheduled_tasks.get_config = lambda: config
scheduled_tasks.get_optional_user_from_request = AsyncMock(return_value=user)
created = await call_unwrapped(
scheduled_tasks.create_scheduled_task,
request=request,
body=body,
)
finally:
scheduled_tasks.get_scheduled_task_repo = old_repo
scheduled_tasks.get_thread_store = old_thread_store
scheduled_tasks.get_config = old_config
scheduled_tasks.get_optional_user_from_request = old_user
assert created["title"] == "Daily summary"
assert created["user_id"] == "user-1"
assert created["assistant_id"] == "lead_agent"
assert created["next_run_at"] == datetime(2027, 1, 1, 1, 0, tzinfo=UTC)
@pytest.mark.asyncio
async def test_create_fresh_thread_task_does_not_require_thread_id():
repo = _Repo()
request = SimpleNamespace()
body = scheduled_tasks.ScheduledTaskCreateRequest(
context_mode="fresh_thread_per_run",
thread_id=None,
title="Fresh task",
prompt="Run in fresh thread",
schedule_type="cron",
schedule_spec={"cron": "0 9 * * *"},
timezone="UTC",
)
user = SimpleNamespace(id="user-1")
thread_store = SimpleNamespace(check_access=AsyncMock(return_value=True))
config = _Config()
old_repo = scheduled_tasks.get_scheduled_task_repo
old_thread_store = scheduled_tasks.get_thread_store
old_config = scheduled_tasks.get_config
old_user = scheduled_tasks.get_optional_user_from_request
try:
scheduled_tasks.get_scheduled_task_repo = lambda _request: repo
scheduled_tasks.get_thread_store = lambda _request: thread_store
scheduled_tasks.get_config = lambda: config
scheduled_tasks.get_optional_user_from_request = AsyncMock(return_value=user)
created = await call_unwrapped(
scheduled_tasks.create_scheduled_task,
request=request,
body=body,
)
finally:
scheduled_tasks.get_scheduled_task_repo = old_repo
scheduled_tasks.get_thread_store = old_thread_store
scheduled_tasks.get_config = old_config
scheduled_tasks.get_optional_user_from_request = old_user
assert created["context_mode"] == "fresh_thread_per_run"
assert created["thread_id"] is None
@pytest.mark.asyncio
async def test_trigger_scheduled_task_dispatches_manual_run():
repo = _Repo()
service = _Service()
task = await repo.create(
task_id="task-1",
user_id="user-1",
thread_id="thread-1",
context_mode="reuse_thread",
assistant_id="lead_agent",
title="Daily summary",
prompt="Summarize thread",
schedule_type="cron",
schedule_spec={"cron": "0 9 * * *"},
timezone="UTC",
next_run_at=None,
)
request = SimpleNamespace()
user = SimpleNamespace(id="user-1")
old_repo = scheduled_tasks.get_scheduled_task_repo
old_service = scheduled_tasks.get_scheduled_task_service
old_user = scheduled_tasks.get_optional_user_from_request
try:
scheduled_tasks.get_scheduled_task_repo = lambda _request: repo
scheduled_tasks.get_scheduled_task_service = lambda _request: service
scheduled_tasks.get_optional_user_from_request = AsyncMock(return_value=user)
result = await call_unwrapped(
scheduled_tasks.trigger_scheduled_task,
task_id=task["id"],
request=request,
)
finally:
scheduled_tasks.get_scheduled_task_repo = old_repo
scheduled_tasks.get_scheduled_task_service = old_service
scheduled_tasks.get_optional_user_from_request = old_user
assert result == {"id": "task-1", "triggered": True}
assert len(service.calls) == 1
assert service.calls[0][2] == "manual"
@pytest.mark.asyncio
async def test_trigger_scheduled_task_returns_conflict_when_dispatch_conflicts():
repo = _Repo()
service = _Service()
service.result = {"outcome": "conflict", "error": "Thread thread-1 already has an active run"}
task = await repo.create(
task_id="task-1",
user_id="user-1",
thread_id="thread-1",
context_mode="reuse_thread",
assistant_id="lead_agent",
title="Daily summary",
prompt="Summarize thread",
schedule_type="cron",
schedule_spec={"cron": "0 9 * * *"},
timezone="UTC",
next_run_at=None,
)
request = SimpleNamespace()
user = SimpleNamespace(id="user-1")
old_repo = scheduled_tasks.get_scheduled_task_repo
old_service = scheduled_tasks.get_scheduled_task_service
old_user = scheduled_tasks.get_optional_user_from_request
try:
scheduled_tasks.get_scheduled_task_repo = lambda _request: repo
scheduled_tasks.get_scheduled_task_service = lambda _request: service
scheduled_tasks.get_optional_user_from_request = AsyncMock(return_value=user)
with pytest.raises(Exception) as exc_info:
await call_unwrapped(
scheduled_tasks.trigger_scheduled_task,
task_id=task["id"],
request=request,
)
finally:
scheduled_tasks.get_scheduled_task_repo = old_repo
scheduled_tasks.get_scheduled_task_service = old_service
scheduled_tasks.get_optional_user_from_request = old_user
assert "already has an active run" in str(exc_info.value)
@pytest.mark.asyncio
async def test_update_scheduled_task_writes_repo():
repo = _Repo()
task = await repo.create(
task_id="task-1",
user_id="user-1",
thread_id="thread-1",
context_mode="reuse_thread",
assistant_id="lead_agent",
title="Daily summary",
prompt="Summarize thread",
schedule_type="cron",
schedule_spec={"cron": "0 9 * * *"},
timezone="UTC",
next_run_at=None,
)
request = SimpleNamespace()
user = SimpleNamespace(id="user-1")
config = _Config()
thread_store = SimpleNamespace(check_access=AsyncMock(return_value=True))
old_repo = scheduled_tasks.get_scheduled_task_repo
old_thread_store = scheduled_tasks.get_thread_store
old_config = scheduled_tasks.get_config
old_user = scheduled_tasks.get_optional_user_from_request
try:
scheduled_tasks.get_scheduled_task_repo = lambda _request: repo
scheduled_tasks.get_thread_store = lambda _request: thread_store
scheduled_tasks.get_config = lambda: config
scheduled_tasks.get_optional_user_from_request = AsyncMock(return_value=user)
result = await call_unwrapped(
scheduled_tasks.update_scheduled_task,
task_id=task["id"],
request=request,
body=scheduled_tasks.ScheduledTaskUpdateRequest(title="Updated title"),
)
finally:
scheduled_tasks.get_scheduled_task_repo = old_repo
scheduled_tasks.get_thread_store = old_thread_store
scheduled_tasks.get_config = old_config
scheduled_tasks.get_optional_user_from_request = old_user
assert result["title"] == "Updated title"
@pytest.mark.asyncio
async def test_update_rechecks_atomic_mutability_after_router_precheck(tmp_path):
await init_engine_from_config(DatabaseConfig(backend="sqlite", sqlite_dir=str(tmp_path)))
old_repo = scheduled_tasks.get_scheduled_task_repo
old_thread_store = scheduled_tasks.get_thread_store
old_config = scheduled_tasks.get_config
old_user = scheduled_tasks.get_optional_user_from_request
try:
sf = get_session_factory()
assert sf is not None
class PrecheckBarrierRepository(ScheduledTaskRepository):
def __init__(self, session_factory):
super().__init__(session_factory)
self.prechecked = asyncio.Event()
self.resume = asyncio.Event()
async def get_active_run_status(self, task_id: str):
status = await super().get_active_run_status(task_id)
if status is None:
self.prechecked.set()
await self.resume.wait()
return status
repo = PrecheckBarrierRepository(sf)
run_repo = ScheduledTaskRunRepository(sf)
task = await repo.create(
task_id="task-router-atomic-patch",
user_id="user-1",
thread_id="thread-1",
context_mode="reuse_thread",
assistant_id="lead_agent",
title="Atomic patch",
prompt="original prompt",
schedule_type="cron",
schedule_spec={"cron": "0 9 * * *"},
timezone="UTC",
next_run_at=None,
)
scheduled_tasks.get_scheduled_task_repo = lambda _request: repo
scheduled_tasks.get_thread_store = lambda _request: SimpleNamespace(check_access=AsyncMock(return_value=True))
scheduled_tasks.get_config = lambda: _Config()
scheduled_tasks.get_optional_user_from_request = AsyncMock(return_value=SimpleNamespace(id="user-1"))
patch_call = asyncio.create_task(
call_unwrapped(
scheduled_tasks.update_scheduled_task,
task_id=task["id"],
request=SimpleNamespace(),
body=scheduled_tasks.ScheduledTaskUpdateRequest(prompt="changed after admission"),
)
)
await repo.prechecked.wait()
await run_repo.create(
run_record_id="task-run-router-atomic-patch",
task_id=task["id"],
thread_id="thread-1",
scheduled_for=datetime.now(UTC),
trigger="manual",
status="queued",
)
repo.resume.set()
with pytest.raises(HTTPException) as exc_info:
await patch_call
assert exc_info.value.status_code == 409
assert "active queued occurrence" in exc_info.value.detail
current = await repo.get(task["id"], user_id="user-1")
assert current is not None
assert current["prompt"] == "original prompt"
finally:
scheduled_tasks.get_scheduled_task_repo = old_repo
scheduled_tasks.get_thread_store = old_thread_store
scheduled_tasks.get_config = old_config
scheduled_tasks.get_optional_user_from_request = old_user
await close_engine()
@pytest.mark.asyncio
async def test_delete_scheduled_task_deletes_repo_row():
repo = _Repo()
task = await repo.create(
task_id="task-1",
user_id="user-1",
thread_id="thread-1",
context_mode="reuse_thread",
assistant_id="lead_agent",
title="Daily summary",
prompt="Summarize thread",
schedule_type="cron",
schedule_spec={"cron": "0 9 * * *"},
timezone="UTC",
next_run_at=None,
)
request = SimpleNamespace()
user = SimpleNamespace(id="user-1")
old_repo = scheduled_tasks.get_scheduled_task_repo
old_user = scheduled_tasks.get_optional_user_from_request
try:
scheduled_tasks.get_scheduled_task_repo = lambda _request: repo
scheduled_tasks.get_optional_user_from_request = AsyncMock(return_value=user)
result = await call_unwrapped(
scheduled_tasks.delete_scheduled_task,
task_id=task["id"],
request=request,
)
finally:
scheduled_tasks.get_scheduled_task_repo = old_repo
scheduled_tasks.get_optional_user_from_request = old_user
assert result == {"id": "task-1", "deleted": True}
assert repo.items == {}
@pytest.mark.asyncio
async def test_pause_and_resume_scheduled_task_update_status():
repo = _Repo()
task = await repo.create(
task_id="task-1",
user_id="user-1",
thread_id="thread-1",
context_mode="reuse_thread",
assistant_id="lead_agent",
title="Daily summary",
prompt="Summarize thread",
schedule_type="cron",
schedule_spec={"cron": "0 9 * * *"},
timezone="UTC",
next_run_at=None,
)
request = SimpleNamespace()
user = SimpleNamespace(id="user-1")
old_repo = scheduled_tasks.get_scheduled_task_repo
old_user = scheduled_tasks.get_optional_user_from_request
try:
scheduled_tasks.get_scheduled_task_repo = lambda _request: repo
scheduled_tasks.get_optional_user_from_request = AsyncMock(return_value=user)
paused = await call_unwrapped(
scheduled_tasks.pause_scheduled_task,
task_id=task["id"],
request=request,
)
paused_status = paused["status"]
resumed = await call_unwrapped(
scheduled_tasks.resume_scheduled_task,
task_id=task["id"],
request=request,
)
finally:
scheduled_tasks.get_scheduled_task_repo = old_repo
scheduled_tasks.get_optional_user_from_request = old_user
assert paused_status == "paused"
assert resumed["status"] == "enabled"
@pytest.mark.asyncio
async def test_pause_cancels_waiting_occurrence_before_pausing_task():
repo = _Repo()
task = await repo.create(
task_id="task-queued",
user_id="user-1",
thread_id="thread-1",
context_mode="reuse_thread",
assistant_id="lead_agent",
title="Queued task",
prompt="Prompt",
schedule_type="cron",
schedule_spec={"cron": "0 9 * * *"},
timezone="UTC",
next_run_at=None,
)
repo.active_status = "queued"
request = SimpleNamespace()
user = SimpleNamespace(id="user-1")
old_repo = scheduled_tasks.get_scheduled_task_repo
old_user = scheduled_tasks.get_optional_user_from_request
try:
scheduled_tasks.get_scheduled_task_repo = lambda _request: repo
scheduled_tasks.get_optional_user_from_request = AsyncMock(return_value=user)
result = await call_unwrapped(
scheduled_tasks.pause_scheduled_task,
task_id=task["id"],
request=request,
)
finally:
scheduled_tasks.get_scheduled_task_repo = old_repo
scheduled_tasks.get_optional_user_from_request = old_user
assert result["status"] == "paused"
assert repo.cancelled_queue is True
@pytest.mark.asyncio
async def test_delete_rejects_occurrence_that_has_started_launching():
repo = _Repo()
task = await repo.create(
task_id="task-launching",
user_id="user-1",
thread_id="thread-1",
context_mode="reuse_thread",
assistant_id="lead_agent",
title="Launching task",
prompt="Prompt",
schedule_type="cron",
schedule_spec={"cron": "0 9 * * *"},
timezone="UTC",
next_run_at=None,
)
repo.active_status = "launching"
request = SimpleNamespace()
user = SimpleNamespace(id="user-1")
old_repo = scheduled_tasks.get_scheduled_task_repo
old_user = scheduled_tasks.get_optional_user_from_request
try:
scheduled_tasks.get_scheduled_task_repo = lambda _request: repo
scheduled_tasks.get_optional_user_from_request = AsyncMock(return_value=user)
with pytest.raises(Exception) as exc_info:
await call_unwrapped(
scheduled_tasks.delete_scheduled_task,
task_id=task["id"],
request=request,
)
finally:
scheduled_tasks.get_scheduled_task_repo = old_repo
scheduled_tasks.get_optional_user_from_request = old_user
assert "launching or running" in str(exc_info.value)
assert task["id"] in repo.items
@pytest.mark.asyncio
async def test_pause_rejects_running_task():
repo = _Repo()
task = await repo.create(
task_id="task-1",
user_id="user-1",
thread_id="thread-1",
context_mode="reuse_thread",
assistant_id="lead_agent",
title="Daily summary",
prompt="Summarize thread",
schedule_type="cron",
schedule_spec={"cron": "0 9 * * *"},
timezone="UTC",
next_run_at=None,
)
task["status"] = "running"
request = SimpleNamespace()
user = SimpleNamespace(id="user-1")
old_repo = scheduled_tasks.get_scheduled_task_repo
old_user = scheduled_tasks.get_optional_user_from_request
try:
scheduled_tasks.get_scheduled_task_repo = lambda _request: repo
scheduled_tasks.get_optional_user_from_request = AsyncMock(return_value=user)
with pytest.raises(Exception) as exc_info:
await call_unwrapped(
scheduled_tasks.pause_scheduled_task,
task_id=task["id"],
request=request,
)
finally:
scheduled_tasks.get_scheduled_task_repo = old_repo
scheduled_tasks.get_optional_user_from_request = old_user
assert "currently running" in str(exc_info.value)
@pytest.mark.asyncio
async def test_update_rejects_running_task():
repo = _Repo()
task = await repo.create(
task_id="task-1",
user_id="user-1",
thread_id="thread-1",
context_mode="reuse_thread",
assistant_id="lead_agent",
title="Daily summary",
prompt="Summarize thread",
schedule_type="cron",
schedule_spec={"cron": "0 9 * * *"},
timezone="UTC",
next_run_at=None,
)
task["status"] = "running"
request = SimpleNamespace()
user = SimpleNamespace(id="user-1")
config = _Config()
thread_store = SimpleNamespace(check_access=AsyncMock(return_value=True))
old_repo = scheduled_tasks.get_scheduled_task_repo
old_thread_store = scheduled_tasks.get_thread_store
old_config = scheduled_tasks.get_config
old_user = scheduled_tasks.get_optional_user_from_request
try:
scheduled_tasks.get_scheduled_task_repo = lambda _request: repo
scheduled_tasks.get_thread_store = lambda _request: thread_store
scheduled_tasks.get_config = lambda: config
scheduled_tasks.get_optional_user_from_request = AsyncMock(return_value=user)
with pytest.raises(Exception) as exc_info:
await call_unwrapped(
scheduled_tasks.update_scheduled_task,
task_id=task["id"],
request=request,
body=scheduled_tasks.ScheduledTaskUpdateRequest(title="Updated title"),
)
finally:
scheduled_tasks.get_scheduled_task_repo = old_repo
scheduled_tasks.get_thread_store = old_thread_store
scheduled_tasks.get_config = old_config
scheduled_tasks.get_optional_user_from_request = old_user
assert "currently running" in str(exc_info.value)
@pytest.mark.asyncio
async def test_update_rejects_queued_task_definition_until_occurrence_finishes():
repo = _Repo()
task = await repo.create(
task_id="task-queued",
user_id="user-1",
thread_id="thread-1",
context_mode="reuse_thread",
assistant_id="lead_agent",
title="Queued task",
prompt="Original prompt",
schedule_type="cron",
schedule_spec={"cron": "0 9 * * *"},
timezone="UTC",
next_run_at=None,
)
repo.active_status = "queued"
request = SimpleNamespace()
user = SimpleNamespace(id="user-1")
config = _Config()
old_repo = scheduled_tasks.get_scheduled_task_repo
old_config = scheduled_tasks.get_config
old_user = scheduled_tasks.get_optional_user_from_request
try:
scheduled_tasks.get_scheduled_task_repo = lambda _request: repo
scheduled_tasks.get_config = lambda: config
scheduled_tasks.get_optional_user_from_request = AsyncMock(return_value=user)
with pytest.raises(Exception) as exc_info:
await call_unwrapped(
scheduled_tasks.update_scheduled_task,
task_id=task["id"],
request=request,
body=scheduled_tasks.ScheduledTaskUpdateRequest(prompt="Changed while queued"),
)
finally:
scheduled_tasks.get_scheduled_task_repo = old_repo
scheduled_tasks.get_config = old_config
scheduled_tasks.get_optional_user_from_request = old_user
assert "active queued occurrence" in str(exc_info.value)
assert repo.items[task["id"]]["prompt"] == "Original prompt"
@pytest.mark.asyncio
async def test_list_thread_scheduled_tasks_filters_by_thread_id():
repo = _Repo()
await repo.create(
task_id="task-1",
user_id="user-1",
thread_id="thread-1",
context_mode="reuse_thread",
assistant_id="lead_agent",
title="Thread one task",
prompt="Prompt",
schedule_type="cron",
schedule_spec={"cron": "0 9 * * *"},
timezone="UTC",
next_run_at=None,
)
await repo.create(
task_id="task-2",
user_id="user-1",
thread_id="thread-2",
context_mode="reuse_thread",
assistant_id="lead_agent",
title="Thread two task",
prompt="Prompt",
schedule_type="cron",
schedule_spec={"cron": "0 9 * * *"},
timezone="UTC",
next_run_at=None,
)
request = SimpleNamespace()
user = SimpleNamespace(id="user-1")
old_repo = scheduled_tasks.get_scheduled_task_repo
old_user = scheduled_tasks.get_optional_user_from_request
try:
scheduled_tasks.get_scheduled_task_repo = lambda _request: repo
scheduled_tasks.get_optional_user_from_request = AsyncMock(return_value=user)
result = await call_unwrapped(
scheduled_tasks.list_thread_scheduled_tasks,
thread_id="thread-1",
request=request,
)
finally:
scheduled_tasks.get_scheduled_task_repo = old_repo
scheduled_tasks.get_optional_user_from_request = old_user
assert [task["id"] for task in result] == ["task-1"]
@pytest.mark.asyncio
async def test_list_scheduled_task_runs_returns_persisted_rows_without_side_effects():
repo = _Repo()
task = await repo.create(
task_id="task-1",
user_id="user-1",
thread_id="thread-1",
context_mode="reuse_thread",
assistant_id="lead_agent",
title="Task",
prompt="Prompt",
schedule_type="cron",
schedule_spec={"cron": "0 9 * * *"},
timezone="UTC",
next_run_at=None,
)
run_repo = SimpleNamespace(
list_by_task=AsyncMock(
return_value=[
{
"id": "task-run-1",
"task_id": "task-1",
"thread_id": "thread-1",
"run_id": "run-1",
"status": "running",
"error": None,
}
]
),
)
request = SimpleNamespace()
user = SimpleNamespace(id="user-1")
old_task_repo = scheduled_tasks.get_scheduled_task_repo
old_run_repo = scheduled_tasks.get_scheduled_task_run_repo
old_user = scheduled_tasks.get_optional_user_from_request
try:
scheduled_tasks.get_scheduled_task_repo = lambda _request: repo
scheduled_tasks.get_scheduled_task_run_repo = lambda _request: run_repo
scheduled_tasks.get_optional_user_from_request = AsyncMock(return_value=user)
result = await call_unwrapped(
scheduled_tasks.list_scheduled_task_runs,
task_id=task["id"],
request=request,
)
finally:
scheduled_tasks.get_scheduled_task_repo = old_task_repo
scheduled_tasks.get_scheduled_task_run_repo = old_run_repo
scheduled_tasks.get_optional_user_from_request = old_user
assert result[0]["status"] == "running"
@pytest.mark.asyncio
async def test_create_once_task_enforces_minimum_delay():
repo = _Repo()
request = SimpleNamespace()
body = scheduled_tasks.ScheduledTaskCreateRequest(
thread_id="thread-1",
title="Soon task",
prompt="Run soon",
schedule_type="once",
schedule_spec={"run_at": (datetime.now(UTC) + timedelta(seconds=30)).isoformat()},
timezone="UTC",
)
user = SimpleNamespace(id="user-1")
thread_store = SimpleNamespace(check_access=AsyncMock(return_value=True))
config = _Config(min_once_delay_seconds=60)
old_repo = scheduled_tasks.get_scheduled_task_repo
old_thread_store = scheduled_tasks.get_thread_store
old_config = scheduled_tasks.get_config
old_user = scheduled_tasks.get_optional_user_from_request
try:
scheduled_tasks.get_scheduled_task_repo = lambda _request: repo
scheduled_tasks.get_thread_store = lambda _request: thread_store
scheduled_tasks.get_config = lambda: config
scheduled_tasks.get_optional_user_from_request = AsyncMock(return_value=user)
with pytest.raises(Exception) as exc_info:
await call_unwrapped(
scheduled_tasks.create_scheduled_task,
request=request,
body=body,
)
finally:
scheduled_tasks.get_scheduled_task_repo = old_repo
scheduled_tasks.get_thread_store = old_thread_store
scheduled_tasks.get_config = old_config
scheduled_tasks.get_optional_user_from_request = old_user
assert "once schedule must be at least" in str(exc_info.value)
@pytest.mark.asyncio
async def test_update_terminal_once_task_with_future_run_at_rearms_it():
"""PATCHing a fresh future run_at onto a completed/failed/cancelled once
task must reset status to enabled — claim_due_tasks only admits enabled
rows, so keeping the terminal status returns a next_run_at that never fires."""
repo = _Repo()
task = await repo.create(
task_id="task-terminal",
user_id="user-1",
thread_id=None,
context_mode="fresh_thread_per_run",
assistant_id="lead_agent",
title="Once done",
prompt="p",
schedule_type="once",
schedule_spec={"run_at": "2026-07-01T00:00:00+00:00"},
timezone="UTC",
next_run_at=None,
)
task["status"] = "completed"
future_run_at = (datetime.now(UTC) + timedelta(hours=1)).isoformat()
request = SimpleNamespace()
user = SimpleNamespace(id="user-1")
old_repo = scheduled_tasks.get_scheduled_task_repo
old_config = scheduled_tasks.get_config
old_user = scheduled_tasks.get_optional_user_from_request
try:
scheduled_tasks.get_scheduled_task_repo = lambda _request: repo
scheduled_tasks.get_config = lambda: _Config()
scheduled_tasks.get_optional_user_from_request = AsyncMock(return_value=user)
result = await call_unwrapped(
scheduled_tasks.update_scheduled_task,
task_id=task["id"],
request=request,
body=scheduled_tasks.ScheduledTaskUpdateRequest(schedule_spec={"run_at": future_run_at}),
)
finally:
scheduled_tasks.get_scheduled_task_repo = old_repo
scheduled_tasks.get_config = old_config
scheduled_tasks.get_optional_user_from_request = old_user
assert result["status"] == "enabled"
assert result["next_run_at"] is not None
def _interval_create_request(**overrides):
kwargs = {
"title": "Every 90 minutes",
"prompt": "Ping",
"schedule_type": "interval",
"schedule_spec": {"every_seconds": 90},
"timezone": "UTC",
}
kwargs.update(overrides)
return scheduled_tasks.ScheduledTaskCreateRequest(**kwargs)
async def _call_create(body, repo=None, config=None):
repo = repo or _Repo()
user = SimpleNamespace(id="user-1")
thread_store = SimpleNamespace(check_access=AsyncMock(return_value=True))
old_repo = scheduled_tasks.get_scheduled_task_repo
old_thread_store = scheduled_tasks.get_thread_store
old_config = scheduled_tasks.get_config
old_user = scheduled_tasks.get_optional_user_from_request
try:
scheduled_tasks.get_scheduled_task_repo = lambda _request: repo
scheduled_tasks.get_thread_store = lambda _request: thread_store
scheduled_tasks.get_config = lambda: config or _Config()
scheduled_tasks.get_optional_user_from_request = AsyncMock(return_value=user)
return await call_unwrapped(
scheduled_tasks.create_scheduled_task,
request=SimpleNamespace(),
body=body,
)
finally:
scheduled_tasks.get_scheduled_task_repo = old_repo
scheduled_tasks.get_thread_store = old_thread_store
scheduled_tasks.get_config = old_config
scheduled_tasks.get_optional_user_from_request = old_user
async def _call_update(repo, task_id, body):
old_repo = scheduled_tasks.get_scheduled_task_repo
old_config = scheduled_tasks.get_config
old_user = scheduled_tasks.get_optional_user_from_request
try:
scheduled_tasks.get_scheduled_task_repo = lambda _request: repo
scheduled_tasks.get_config = lambda: _Config()
scheduled_tasks.get_optional_user_from_request = AsyncMock(return_value=SimpleNamespace(id="user-1"))
return await call_unwrapped(
scheduled_tasks.update_scheduled_task,
task_id=task_id,
request=SimpleNamespace(),
body=body,
)
finally:
scheduled_tasks.get_scheduled_task_repo = old_repo
scheduled_tasks.get_config = old_config
scheduled_tasks.get_optional_user_from_request = old_user
def _create_request(**overrides):
kwargs = {
"title": "Daily summary",
"prompt": "Summarize thread",
"schedule_type": "cron",
"schedule_spec": {"cron": "0 9 * * *"},
"timezone": "UTC",
}
kwargs.update(overrides)
return scheduled_tasks.ScheduledTaskCreateRequest(**kwargs)
async def _seed_task(repo: _Repo, **overrides):
kwargs = {
"task_id": "task-1",
"user_id": "user-1",
"thread_id": None,
"context_mode": "fresh_thread_per_run",
"assistant_id": "lead_agent",
"title": "Daily summary",
"prompt": "Summarize thread",
"schedule_type": "cron",
"schedule_spec": {"cron": "0 9 * * *"},
"timezone": "UTC",
"next_run_at": None,
}
kwargs.update(overrides)
return await repo.create(**kwargs)
@pytest.mark.asyncio
async def test_create_interval_task_sets_next_run_from_now():
before = datetime.now(UTC)
created = await _call_create(
_interval_create_request(
schedule_spec={"every_seconds": 90},
timezone="Asia/Shanghai",
)
)
after = datetime.now(UTC)
assert created["schedule_type"] == "interval"
assert created["schedule_spec"] == {"every_seconds": 90}
assert created["timezone"] == "Asia/Shanghai"
assert before + timedelta(seconds=90) <= created["next_run_at"] <= after + timedelta(seconds=90)
assert created["next_run_at"].utcoffset() == timedelta(0)
@pytest.mark.asyncio
async def test_create_interval_task_rejects_below_minimum_delay():
with pytest.raises(HTTPException) as exc_info:
await _call_create(_interval_create_request(schedule_spec={"every_seconds": 30}))
assert exc_info.value.status_code == 422
assert "at least 60 seconds" in exc_info.value.detail
@pytest.mark.asyncio
async def test_create_interval_task_rejects_above_maximum():
with pytest.raises(HTTPException) as exc_info:
await _call_create(_interval_create_request(schedule_spec={"every_seconds": 30 * 24 * 3600 + 1}))
assert exc_info.value.status_code == 422
assert "at most" in exc_info.value.detail
@pytest.mark.asyncio
async def test_create_interval_task_rejects_missing_every_seconds():
with pytest.raises(HTTPException) as exc_info:
await _call_create(_interval_create_request(schedule_spec={}))
assert exc_info.value.status_code == 422
assert "every_seconds" in exc_info.value.detail
@pytest.mark.asyncio
async def test_update_interval_task_recomputes_next_run():
repo = _Repo()
task = await repo.create(
task_id="task-interval",
user_id="user-1",
thread_id=None,
context_mode="fresh_thread_per_run",
assistant_id="lead_agent",
title="Interval",
prompt="p",
schedule_type="interval",
schedule_spec={"every_seconds": 90},
timezone="UTC",
next_run_at=datetime(2026, 7, 1, 0, 0, tzinfo=UTC),
)
before = datetime.now(UTC)
updated = await _call_update(
repo,
task["id"],
scheduled_tasks.ScheduledTaskUpdateRequest(schedule_spec={"every_seconds": 120}),
)
after = datetime.now(UTC)
assert updated["schedule_spec"] == {"every_seconds": 120}
assert before + timedelta(seconds=120) <= updated["next_run_at"] <= after + timedelta(seconds=120)
@pytest.mark.asyncio
async def test_update_interval_task_rejects_below_minimum_delay():
repo = _Repo()
task = await repo.create(
task_id="task-interval",
user_id="user-1",
thread_id=None,
context_mode="fresh_thread_per_run",
assistant_id="lead_agent",
title="Interval",
prompt="p",
schedule_type="interval",
schedule_spec={"every_seconds": 90},
timezone="UTC",
next_run_at=datetime(2026, 7, 1, 0, 0, tzinfo=UTC),
)
with pytest.raises(HTTPException) as exc_info:
await _call_update(
repo,
task["id"],
scheduled_tasks.ScheduledTaskUpdateRequest(schedule_spec={"every_seconds": 30}),
)
assert exc_info.value.status_code == 422
assert "at least 60 seconds" in exc_info.value.detail
@pytest.mark.asyncio
async def test_update_interval_task_keeps_next_run_when_spec_unchanged():
repo = _Repo()
original_next = datetime(2026, 7, 1, 0, 0, tzinfo=UTC)
task = await repo.create(
task_id="task-interval",
user_id="user-1",
thread_id=None,
context_mode="fresh_thread_per_run",
assistant_id="lead_agent",
title="Interval",
prompt="p",
schedule_type="interval",
schedule_spec={"every_seconds": 90},
timezone="UTC",
next_run_at=original_next,
)
updated = await _call_update(
repo,
task["id"],
scheduled_tasks.ScheduledTaskUpdateRequest(
schedule_spec={"every_seconds": 90},
timezone="Asia/Shanghai",
),
)
assert updated["timezone"] == "Asia/Shanghai"
assert updated["next_run_at"] == original_next
@pytest.mark.asyncio
async def test_create_interval_task_rejects_non_integer_every_seconds():
with pytest.raises(HTTPException) as exc_info:
await _call_create(_interval_create_request(schedule_spec={"every_seconds": True}))
assert exc_info.value.status_code == 422
assert "every_seconds" in exc_info.value.detail
@pytest.mark.asyncio
async def test_create_interval_task_uses_configured_minimum_delay():
with pytest.raises(HTTPException) as exc_info:
await _call_create(
_interval_create_request(schedule_spec={"every_seconds": 90}),
config=_Config(min_once_delay_seconds=120),
)
assert exc_info.value.status_code == 422
assert "at least 120 seconds" in exc_info.value.detail
@pytest.mark.asyncio
async def test_create_explicit_lead_agent_is_accepted():
created = await _call_create(_create_request(assistant_id="lead_agent"))
assert created["assistant_id"] == "lead_agent"
@pytest.mark.asyncio
async def test_create_lead_agent_is_accepted_case_insensitively():
# Callers writing LEAD_AGENT / lead-agent mean the default, not a custom agent.
for raw in ("LEAD_AGENT", "Lead_Agent", "lead-agent"):
created = await _call_create(_create_request(assistant_id=raw))
assert created["assistant_id"] == "lead_agent"
@pytest.mark.asyncio
async def test_create_custom_assistant_id_is_normalized_and_persisted():
with patch(
"app.gateway.routers.scheduled_tasks.load_agent_config",
return_value=object(),
) as loader:
created = await _call_create(_create_request(assistant_id="Research_Bot"))
assert created["assistant_id"] == "research-bot"
loader.assert_called_once_with("research-bot", user_id="user-1")
@pytest.mark.asyncio
async def test_create_unknown_assistant_id_is_rejected():
with patch(
"app.gateway.routers.scheduled_tasks.load_agent_config",
side_effect=FileNotFoundError("missing"),
):
with pytest.raises(HTTPException) as exc_info:
await _call_create(_create_request(assistant_id="missing-bot"))
assert exc_info.value.status_code == 422
assert "Unknown assistant_id" in exc_info.value.detail
@pytest.mark.asyncio
async def test_create_invalid_assistant_id_is_rejected():
with pytest.raises(HTTPException) as exc_info:
await _call_create(_create_request(assistant_id="bad agent"))
assert exc_info.value.status_code == 422
assert "Invalid assistant_id" in exc_info.value.detail
@pytest.mark.asyncio
async def test_update_custom_assistant_id_is_persisted():
repo = _Repo()
task = await repo.create(
task_id="task-1",
user_id="user-1",
thread_id=None,
context_mode="fresh_thread_per_run",
assistant_id="lead_agent",
title="Daily summary",
prompt="Summarize thread",
schedule_type="cron",
schedule_spec={"cron": "0 9 * * *"},
timezone="UTC",
next_run_at=None,
)
old_repo = scheduled_tasks.get_scheduled_task_repo
old_config = scheduled_tasks.get_config
old_user = scheduled_tasks.get_optional_user_from_request
try:
scheduled_tasks.get_scheduled_task_repo = lambda _request: repo
scheduled_tasks.get_config = lambda: _Config()
scheduled_tasks.get_optional_user_from_request = AsyncMock(return_value=SimpleNamespace(id="user-1"))
with patch(
"app.gateway.routers.scheduled_tasks.load_agent_config",
return_value=object(),
):
updated = await call_unwrapped(
scheduled_tasks.update_scheduled_task,
task_id=task["id"],
request=SimpleNamespace(),
body=scheduled_tasks.ScheduledTaskUpdateRequest(assistant_id="triage-bot"),
)
finally:
scheduled_tasks.get_scheduled_task_repo = old_repo
scheduled_tasks.get_config = old_config
scheduled_tasks.get_optional_user_from_request = old_user
assert updated["assistant_id"] == "triage-bot"
@pytest.mark.asyncio
async def test_update_unknown_assistant_id_is_rejected():
repo = _Repo()
task = await _seed_task(repo)
with patch(
"app.gateway.routers.scheduled_tasks.load_agent_config",
side_effect=FileNotFoundError("missing"),
):
with pytest.raises(HTTPException) as exc_info:
await _call_update(
repo,
task["id"],
scheduled_tasks.ScheduledTaskUpdateRequest(assistant_id="missing-bot"),
)
assert exc_info.value.status_code == 422
assert "Unknown assistant_id" in exc_info.value.detail
assert repo.items[task["id"]]["assistant_id"] == "lead_agent"
@pytest.mark.asyncio
async def test_update_invalid_assistant_id_is_rejected():
repo = _Repo()
task = await _seed_task(repo)
with pytest.raises(HTTPException) as exc_info:
await _call_update(
repo,
task["id"],
scheduled_tasks.ScheduledTaskUpdateRequest(assistant_id="bad agent"),
)
assert exc_info.value.status_code == 422
assert "Invalid assistant_id" in exc_info.value.detail
@pytest.mark.asyncio
async def test_update_omitting_assistant_id_keeps_existing_even_if_agent_is_gone():
# Unrelated PATCH (rename, reschedule) must not re-resolve assistant_id.
# Otherwise a since-deleted custom agent makes the task uneditable.
repo = _Repo()
task = await _seed_task(repo, assistant_id="research-bot")
with patch(
"app.gateway.routers.scheduled_tasks.load_agent_config",
side_effect=FileNotFoundError("missing"),
) as loader:
updated = await _call_update(
repo,
task["id"],
scheduled_tasks.ScheduledTaskUpdateRequest(title="Renamed"),
)
loader.assert_not_called()
assert updated["title"] == "Renamed"
assert updated["assistant_id"] == "research-bot"