@kynver-app/mcp-agent-os 0.3.7 → 0.3.9

package/dist/server.js

@@ -10,6 +10,7 @@ import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 import { z } from "zod";
 import { get, post, patch } from "./lib/kynver-client.js";
 import { registerPlanTools } from "./tools/plans.js";
+import { registerPlanProgressTools } from "./tools/plan-progress.js";
 import { registerTaskTools } from "./tools/tasks.js";
 import { registerActionRequiredTools } from "./tools/action-required.js";
 function jsonResult(data) {
@@ -610,6 +611,7 @@ export function createAgentOsServer() {
     registerTaskTools({ register, resolveToolSlug, jsonResult, compact });
     // First-class AgentOS plans (Phase 5A): versioned operational artifacts.
     registerPlanTools({ register, resolveToolSlug, jsonResult, compact });
+    registerPlanProgressTools({ register, resolveToolSlug, jsonResult, compact });
     // Action Required inbox: agent_os_ask_human + agent_os_await_action (slice 1).
     registerActionRequiredTools({ register, jsonResult, compact });
     return server;

package/dist/tools/plan-progress.d.ts

@@ -0,0 +1,2 @@
+import type { PlanToolDeps } from "./plans.js";
+export declare function registerPlanProgressTools({ register, resolveToolSlug, jsonResult, compact, }: PlanToolDeps): void;

package/dist/tools/plan-progress.js

@@ -0,0 +1,113 @@
+import { z } from "zod";
+import { get, post } from "../lib/kynver-client.js";
+const progressStatus = z.enum(["todo", "running", "partial", "blocked", "done"]);
+const roleLane = z.enum([
+    "plan_author",
+    "plan_reviewer",
+    "implementer",
+    "report_reviewer",
+    "deep_reviewer",
+    "repair_implementer",
+    "runtime_verifier",
+    "user",
+    "system",
+]);
+const evidenceSchema = z.object({
+    type: z.enum(["path", "pr", "commit", "command", "url", "note"]),
+    value: z.string(),
+    exitCode: z.number().optional(),
+    stdoutTail: z.string().optional(),
+});
+const rowUpsertSchema = z.object({
+    rowKey: z.string(),
+    title: z.string(),
+    description: z.string().optional(),
+    ordinal: z.number(),
+    stageId: z.string().optional(),
+    ownerLane: roleLane.optional(),
+    taskId: z.string().optional(),
+});
+export function registerPlanProgressTools({ register, resolveToolSlug, jsonResult, compact, }) {
+    const slugField = z
+        .string()
+        .optional()
+        .describe("AgentOS workspace slug. Omit to use env or the server-discovered primary.");
+    register("agent_os_plan_progress_rows_upsert", "Seed or update structured plan progress rows (canonical checklist state).", {
+        planId: z.string(),
+        rows: z.array(rowUpsertSchema),
+        slug: slugField,
+    }, async (args) => {
+        const s = await resolveToolSlug(args.slug);
+        return jsonResult(await post(`/agent-os/${s}/plans/${args.planId}/progress-rows`, {
+            rows: args.rows,
+        }));
+    });
+    register("agent_os_plan_progress_event_append", "Append a role-lane progress event and apply allowed row transition rules.", {
+        planId: z.string(),
+        rowKey: z.string().optional(),
+        rowId: z.string().optional(),
+        taskId: z.string().optional(),
+        reviewTaskId: z.string().optional(),
+        roleLane,
+        status: progressStatus,
+        note: z.string().optional(),
+        remainingWork: z.string().optional(),
+        evidence: z.array(evidenceSchema).optional(),
+        proposed: z.boolean().optional(),
+        executorRef: z.string().optional(),
+        slug: slugField,
+    }, async (args) => {
+        const s = await resolveToolSlug(args.slug);
+        const { slug, planId, remainingWork, ...rest } = args;
+        return jsonResult(await post(`/agent-os/${s}/plans/${planId}/progress-events`, compact({
+            ...rest,
+            ...(remainingWork !== undefined ? { remaining: remainingWork } : {}),
+        })));
+    });
+    register("agent_os_plan_review_task_create", "Create a discovery review/decision AgentTask linked to a progress row.", {
+        planId: z.string(),
+        title: z.string(),
+        description: z.string().optional(),
+        rowKey: z.string().optional(),
+        rowId: z.string().optional(),
+        forWill: z.boolean().optional(),
+        parentTaskId: z.string().optional(),
+        idempotencyKey: z.string().optional(),
+        slug: slugField,
+    }, async (args) => {
+        const s = await resolveToolSlug(args.slug);
+        const { slug, planId, ...rest } = args;
+        return jsonResult(await post(`/agent-os/${s}/plans/${planId}/review-tasks`, compact(rest)));
+    });
+    register("agent_os_plan_progress_rows_list", "List structured progress rows for a plan.", { planId: z.string(), slug: slugField }, async (args) => {
+        const s = await resolveToolSlug(args.slug);
+        return jsonResult(await get(`/agent-os/${s}/plans/${args.planId}/progress-rows`));
+    });
+    register("agent_os_plan_progress_events_list", "List append-only progress events for a plan (audit trail).", {
+        planId: z.string(),
+        rowId: z.string().optional(),
+        limit: z.number().int().min(1).max(500).optional(),
+        slug: slugField,
+    }, async (args) => {
+        const s = await resolveToolSlug(args.slug);
+        const qs = new URLSearchParams();
+        if (args.rowId)
+            qs.set("rowId", args.rowId);
+        if (args.limit)
+            qs.set("limit", String(args.limit));
+        const q = qs.toString();
+        return jsonResult(await get(`/agent-os/${s}/plans/${args.planId}/progress-events${q ? `?${q}` : ""}`));
+    });
+    register("agent_os_plan_verify", "Run automated runtime verification (typecheck + test) or operator override for plan closure.", {
+        planId: z.string(),
+        worktreePath: z.string().optional(),
+        taskId: z.string().optional(),
+        humanOverride: z.boolean().optional(),
+        overrideReason: z.string().optional(),
+        slug: slugField,
+    }, async (args) => {
+        const s = await resolveToolSlug(args.slug);
+        const { slug, planId, ...rest } = args;
+        return jsonResult(await post(`/agent-os/${s}/plans/${planId}/verify`, compact(rest)));
+    });
+}

package/dist/tools/tasks.js

@@ -31,6 +31,11 @@ const taskEventType = z.enum([
     "failed",
 ]);
 const artifactVisibility = z.enum(["internal", "telegram_safe", "public_pr_safe"]);
+const personaSlug = z
+    .string()
+    .nullable()
+    .optional()
+    .describe("Lane-expert worker slug to attribute the task to, or null to clear/filter unassigned tasks.");
 export function registerTaskTools({ register, resolveToolSlug, jsonResult, compact, }) {
     const slugField = z
         .string()
@@ -45,6 +50,7 @@ export function registerTaskTools({ register, resolveToolSlug, jsonResult, compa
         parentTaskId: z.string().optional().describe("Parent task id when this is one of 2+ coordinated workers."),
         goalId: z.string().optional(),
         projectId: z.string().optional(),
+        personaSlug,
         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,
@@ -61,6 +67,7 @@ export function registerTaskTools({ register, resolveToolSlug, jsonResult, compa
         status: taskStatus.optional(),
         executor: taskExecutor.optional(),
         parentTaskId: z.string().optional(),
+        personaSlug,
         limit: z.number().optional().describe("Max rows (default 50, max 200)."),
         slug: slugField,
     }, async (args) => {
@@ -71,6 +78,8 @@ export function registerTaskTools({ register, resolveToolSlug, jsonResult, compa
             params.set("executor", args.executor);
         if (args.parentTaskId)
             params.set("parentTaskId", args.parentTaskId);
+        if (args.personaSlug !== undefined)
+            params.set("personaSlug", args.personaSlug ?? "");
         if (args.limit)
             params.set("limit", String(args.limit));
         const qs = params.toString();
@@ -88,6 +97,7 @@ export function registerTaskTools({ register, resolveToolSlug, jsonResult, compa
         parentTaskId: z.string().optional(),
         goalId: z.string().optional(),
         projectId: z.string().optional(),
+        personaSlug,
         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.7",
+  "version": "0.3.9",
   "description": "Kynver Agentic OS MCP server — slug-keyed agent identity, goals, projects, sessions, and long-term memory",
   "type": "module",
   "bin": {