mcp/tasks/apteva.yaml

1schema: apteva-app/v1
2
3name: tasks
4display_name: Tasks
5version: 3.6.0
6description: Durable work, progress, schedules, occurrences, and thread assignment for Apteva agents.
7author: Apteva
8homepage: https://github.com/apteva/apps/tree/main/mcp/tasks
9icon: /ui/icon.svg
10icon_style: monochrome
11tags: [productivity, agents, scheduling, automation]
12
13scopes: [project, global]
14min_apteva_version: "0.40.6"
15
16requires:
17  permissions:
18    - db.write.app
19    - platform.instances.read
20    - platform.instances.write
21    - platform.threads.write
22
23provides:
24  http_routes:
25    - prefix: /
26  mcp_tools:
27    - { name: process_task, description: "Private Processes execution API.", exposure: app_only }
28    - { name: create, description: "Create one durable task for a concrete work outcome. Bare waiting or agent cadence uses Core pace, not Tasks." }
29    - { name: list, description: List durable tasks visible to the calling agent. }
30    - { name: get, description: Get one task and its event history. }
31    - { name: set_progress, description: "Record one meaningful nonterminal progress milestone." }
32    - { name: edit, description: "Atomically edit a task definition while preserving omitted fields." }
33    - { name: fail, description: "Record an explicit terminal task failure." }
34    - { name: update, description: "Legacy compatibility tool; use set_progress, edit, fail, or complete." }
35    - { name: assign, description: Assign a task to an existing opaque agent thread. }
36    - { name: complete, description: Complete a task with a concrete result. }
37    - { name: cancel, description: Cancel a task or schedule. }
38    - { name: pause, description: Pause a scheduled task. }
39    - { name: resume, description: Resume a scheduled task. }
40    - { name: run_now, description: Run a scheduled task now. }
41    - { name: recover_occurrence, description: Create a linked reconciliation-only recovery attempt for a failed occurrence. }
42  ui_panels:
43    - slot: project.page
44      label: Tasks
45      icon: list-checks
46      entry: /ui/TasksPanel.mjs
47      suggested: true
48  ui_surfaces:
49    - id: tasks
50      label: Tasks
51      icon: list-checks
52      schema: apteva-native-surface/v1
53      entry: /ui/surfaces/tasks.json
54      slots: [mobile.project_app]
55  ui_components:
56    - name: task-overview
57      label: Tasks
58      description: Live work, upcoming schedules, and recent outcomes.
59      entry: /ui/TaskOverviewWidget.mjs
60      slots: [dashboard.home]