@kynver-app/mcp-agent-os 0.3.10 → 0.3.14

package/dist/tools/plans.js

@@ -18,7 +18,11 @@ const planStatus = z.enum([
     "archived",
     "superseded",
 ]);
-const planPriority = z.enum(["low", "normal", "high", "critical"]);
+const planPriority = z
+    .enum(["low", "normal", "high", "critical"])
+    .describe("Priority — default 'normal'. Most plans are 'normal'; routine is 'low'. Use 'high' only for genuinely " +
+    "urgent+important plans and 'critical' ONLY for true emergencies blocking the mission now (very few). " +
+    "Over-tagging destroys the signal — if everything is critical, nothing is.");
 const planLinkTarget = z.enum([
     "goal",
     "project",

package/dist/tools/tasks.js

@@ -7,17 +7,31 @@
  */
 import { z } from "zod";
 import { get, post, patch } from "../lib/kynver-client.js";
-const taskStatus = z.enum([
-    "queued",
+const taskStatus = z
+    .enum([
+    "ready",
     "running",
+    "waiting",
+    "scheduled",
     "blocked",
     "needs_input",
     "awaiting_review",
     "done",
     "failed",
     "cancelled",
-]);
-const taskPriority = z.enum(["low", "normal", "high", "critical"]);
+])
+    .describe("Work-state lifecycle. `ready` = admitted, can start now. " +
+    "`running` = an executor holds a live lease. `waiting` = gated on upstream tasks (set dependsOnTaskIds; auto-promotes " +
+    "to ready when they're all done). `scheduled` = deferred to a time (set scheduledFor; auto-promotes to ready when it " +
+    "passes). `blocked`/`needs_input` = a human must resolve. `awaiting_review` = review gate open. Don't hand-set " +
+    "ready→running; the dispatcher/executor lease owns that.");
+const taskPriority = z
+    .enum(["low", "normal", "high", "critical"])
+    .describe("Priority — default 'normal'. Create coding/implementation tasks as 'normal' (routine/cleanup 'low'); " +
+    "do NOT inherit the parent plan's priority — a task on a critical plan is still 'normal'. A task only " +
+    "becomes 'critical' once it is actively BLOCKING progress (and the system already marks blocked tasks " +
+    "critical automatically). Reserve manual 'high'/'critical' for genuine urgency. If everything is " +
+    "critical, nothing is — keep most tasks at normal/low.");
 const taskExecutor = z.enum(["inline", "harness", "acp", "manual"]);
 const taskEventType = z.enum([
     "created",
@@ -36,12 +50,23 @@ const personaSlug = z
     .nullable()
     .optional()
     .describe("Lane-expert worker slug to attribute the task to, or null to clear/filter unassigned tasks.");
+const scheduledFor = z
+    .string()
+    .nullable()
+    .optional()
+    .describe("ISO-8601 timestamp to defer the task to. A future time creates the task as `scheduled`; the operator loop " +
+    "auto-promotes it to `ready` once the time passes. null clears the schedule.");
+const dependsOnTaskIds = z
+    .array(z.string())
+    .optional()
+    .describe("Upstream task ids this task waits on. Creates the task as `waiting`; the operator loop auto-promotes it to " +
+    "`ready` once every listed task is `done` (a failed/cancelled upstream keeps it waiting).");
 export function registerTaskTools({ register, resolveToolSlug, jsonResult, compact, }) {
     const slugField = z
         .string()
         .optional()
         .describe("AgentOS slug. Omit to use env or the server-discovered primary.");
-    register("agent_os_task_create", "Create an AgentTask on the board. Idempotent within the AgentOS: pass idempotencyKey (or requestId) from the foreground turn so a Telegram retry or Ghost restart returns the existing task instead of spawning a duplicate. Response includes `created` (false = an existing task was returned).", {
+    register("agent_os_task_create", "Create an AgentTask on the board. New tasks start `ready` (dispatchable now) unless you defer them: pass scheduledFor for a timed start (→ `scheduled`) or dependsOnTaskIds to gate on upstream work (→ `waiting`); both auto-promote to `ready` when their gate clears. Idempotent within the AgentOS: pass idempotencyKey (or requestId) from the foreground turn so a Telegram retry or Ghost restart returns the existing task instead of spawning a duplicate. Response includes `created` (false = an existing task was returned).", {
         title: z.string().describe("Short task title (required)."),
         description: z.string().optional(),
         priority: taskPriority.optional(),
@@ -51,6 +76,8 @@ export function registerTaskTools({ register, resolveToolSlug, jsonResult, compa
         goalId: z.string().optional(),
         projectId: z.string().optional(),
         personaSlug,
+        scheduledFor,
+        dependsOnTaskIds,
         idempotencyKey: z.string().optional().describe("Dedupe key from the foreground turn. Strongly recommended."),
         requestId: z.string().optional().describe("Raw foreground request id; used as the dedupe key if idempotencyKey is absent."),
         slug: slugField,
@@ -86,7 +113,7 @@ export function registerTaskTools({ register, resolveToolSlug, jsonResult, compa
         const s = await resolveToolSlug(args.slug);
         return jsonResult(await get(`/agent-os/${s}/tasks${qs ? `?${qs}` : ""}`));
     });
-    register("agent_os_task_update", "Patch an AgentTask: status, priority, executor, links, progress summary, blocker, or first-class artifact refs (branch/worktreePath/prUrl/headCommit). Does not touch lease fields — use claim/renew for those.", {
+    register("agent_os_task_update", "Patch an AgentTask: status, priority, executor, links, schedule (scheduledFor), dependencies (dependsOnTaskIds), progress summary, blocker, or first-class artifact refs (branch/worktreePath/prUrl/headCommit). Does not touch lease fields — use claim/renew for those.", {
         taskId: z.string(),
         title: z.string().optional(),
         description: z.string().optional(),
@@ -98,6 +125,8 @@ export function registerTaskTools({ register, resolveToolSlug, jsonResult, compa
         goalId: z.string().optional(),
         projectId: z.string().optional(),
         personaSlug,
+        scheduledFor,
+        dependsOnTaskIds,
         lastSummary: z.string().optional().describe("Latest progress summary."),
         blocker: z.string().optional(),
         branch: z.string().optional(),

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kynver-app/mcp-agent-os",
-  "version": "0.3.10",
+  "version": "0.3.14",
   "description": "Kynver Agentic OS MCP server — slug-keyed agent identity, goals, projects, sessions, and long-term memory",
   "type": "module",
   "bin": {