@kynver-app/mcp-agent-os 0.3.49 → 0.3.52

package/dist/server.js

@@ -21,6 +21,7 @@ import { registerMemoryQualityFeedbackTools } from "./tools/memory-quality-feedb
 import { registerOperatingRulesTools } from "./tools/operating-rules.js";
 import { registerProviderEvidenceTools } from "./tools/provider-evidence.js";
 import { registerPrBacklogTools } from "./tools/pr-backlog.js";
+import { registerTaskBoardWatchdogTools } from "./tools/task-board-watchdog.js";
 import { registerMeshLivenessTools } from "./tools/mesh-liveness.js";
 import { registerDiagnosticsTools } from "./tools/diagnostics.js";
 import { registerSkillsTools } from "./tools/skills.js";
@@ -30,6 +31,8 @@ import { registerMonitorTools } from "./tools/monitor.js";
 import { registerMacroControlsTools } from "./tools/macro-controls.js";
 import { registerKariAdMarketingLoopTools } from "./tools/kariad-marketing-loop.js";
 import { registerKariAdOutcomeImportTools } from "./tools/kariad-outcome-import.js";
+import { registerCmoControlTools } from "./tools/cmo-control.js";
+import { registerCurrentFocusTools } from "./tools/current-focus.js";
 import { readOwnPackageVersion } from "./lib/package-version.js";
 const PACKAGE_VERSION = readOwnPackageVersion(import.meta.url);
 function jsonResult(data) {
@@ -172,6 +175,7 @@ export function createAgentOsServer() {
         memoryQuery: z.string().optional().describe("Override the memory search query. Defaults to a query derived from the anchor's title/summary."),
         memoryLimit: z.number().optional().describe("Max memory hits (default 5, max 20). Set 0 to skip memory recall."),
         sessionLimit: z.number().optional().describe("Max recent sessions (default 1, max 5). Set 0 to skip."),
+        resolveCurrentFocus: z.boolean().optional().describe("M2: when true and anchorType=session, resolve the most-recently-active non-terminal task as current focus. Read-only — never mutates task status. Use for agents (e.g. Hermes chat) that do not start from an explicit task anchor."),
         surface: memorySurfaceField,
         slug: slugField,
     }, async (args) => {
@@ -185,6 +189,8 @@ export function createAgentOsServer() {
             params.set("memoryLimit", String(args.memoryLimit));
         if (args.sessionLimit !== undefined)
             params.set("sessionLimit", String(args.sessionLimit));
+        if (args.resolveCurrentFocus)
+            params.set("resolveCurrentFocus", "true");
         if (args.surface)
             params.set("surface", args.surface);
         return jsonResult(await get(`/agent-os/${s}/context-envelope?${params}`));
@@ -730,6 +736,8 @@ export function createAgentOsServer() {
     registerProviderEvidenceTools({ register, resolveToolSlug, jsonResult });
     // PR backlog drain (read-only routing-funnel surface).
     registerPrBacklogTools({ register, resolveToolSlug, jsonResult });
+    // Kynver-native task board watchdog (read + tick for verify_live).
+    registerTaskBoardWatchdogTools({ register, resolveToolSlug, jsonResult });
     // Connected-box mesh liveness (heartbeats, cron lease, peer rescues).
     registerMeshLivenessTools({ register, resolveToolSlug, jsonResult });
     // Visible Diagnostics report (dispatch-funnel, closed-loop, verify-live health …).
@@ -743,5 +751,8 @@ export function createAgentOsServer() {
     registerKariAdMarketingLoopTools({ register, resolveToolSlug, jsonResult });
     // KariAd marketing loop — M6 outcome import (analytics feedback + memory learning).
     registerKariAdOutcomeImportTools({ register, resolveToolSlug, jsonResult });
+    registerCmoControlTools({ register, resolveToolSlug, jsonResult });
+    // M5: Kynver current-focus / todo adapter (agent-loop focus ≠ executor lease).
+    registerCurrentFocusTools({ register, resolveToolSlug, jsonResult, compact });
     return server;
 }

package/dist/tools/cmo-control.d.ts

@@ -0,0 +1,20 @@
+/**
+ * M7 — CMO control status MCP tool (verify-live / agent steering).
+ *
+ * Read-only customer-safe marketing rollup: connection, approvals, trend
+ * snapshot summary, campaign evidence rows, and next actions.
+ */
+type ToolResult = {
+    content: {
+        type: "text";
+        text: string;
+    }[];
+    structuredContent?: unknown;
+};
+export interface CmoControlToolDeps {
+    register: (name: string, description: string, inputSchema: Record<string, unknown>, cb: (args: any) => any) => void;
+    resolveToolSlug: (explicitSlug?: string) => Promise<string>;
+    jsonResult: (data: unknown) => ToolResult;
+}
+export declare function registerCmoControlTools({ register, resolveToolSlug, jsonResult, }: CmoControlToolDeps): void;
+export {};

package/dist/tools/cmo-control.js

@@ -0,0 +1,26 @@
+/**
+ * M7 — CMO control status MCP tool (verify-live / agent steering).
+ *
+ * Read-only customer-safe marketing rollup: connection, approvals, trend
+ * snapshot summary, campaign evidence rows, and next actions.
+ */
+import { z } from "zod";
+import { get } from "../lib/kynver-client.js";
+const slugField = z
+    .string()
+    .optional()
+    .describe("AgentOS slug. Defaults to env/primary AgentOS.");
+export function registerCmoControlTools({ register, resolveToolSlug, jsonResult, }) {
+    register("agent_os_cmo_control_status_get", [
+        "Fetch the user-facing marketing / CMO control status for Command Center.",
+        "Returns connection health, pending marketing approvals, trend snapshot summary,",
+        "recent campaign activity evidence, executive summary, and suggested next actions.",
+        "Customer-safe copy only — no credentials, lane names, or memory internals.",
+        "Read-only; safe for unattended verification.",
+        "Workbench: navigate to view=marketing or open_panel system:cmo-campaign.",
+    ].join(" "), { slug: slugField }, async ({ slug }) => {
+        const s = await resolveToolSlug(slug);
+        const payload = await get(`/agent-os/${encodeURIComponent(s)}/cmo-control`);
+        return jsonResult(payload);
+    });
+}

package/dist/tools/current-focus.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Kynver current-focus / todo-projection MCP tools (M5).
+ *
+ * kynver.focus.get    → agent_os_focus_get
+ * kynver.focus.set    → agent_os_focus_set
+ * kynver.focus.clear  → agent_os_focus_clear
+ * kynver.todo.project → agent_os_todo_project
+ *
+ * CRITICAL INVARIANT:
+ *   `in_progress` on a plan row = agent-loop current focus (set by these tools).
+ *   `running` on a task        = executor worker lease/heartbeat (never set here).
+ *
+ * Hermes `in_progress` maps ONLY to plan row `in_progress`. These tools never
+ * touch AgentTask.status — that is the dispatcher/executor's domain.
+ */
+import type { PlanToolDeps } from "./plans.js";
+export declare function registerCurrentFocusTools({ register, resolveToolSlug, jsonResult, compact, }: PlanToolDeps): void;

package/dist/tools/current-focus.js

@@ -0,0 +1,126 @@
+/**
+ * Kynver current-focus / todo-projection MCP tools (M5).
+ *
+ * kynver.focus.get    → agent_os_focus_get
+ * kynver.focus.set    → agent_os_focus_set
+ * kynver.focus.clear  → agent_os_focus_clear
+ * kynver.todo.project → agent_os_todo_project
+ *
+ * CRITICAL INVARIANT:
+ *   `in_progress` on a plan row = agent-loop current focus (set by these tools).
+ *   `running` on a task        = executor worker lease/heartbeat (never set here).
+ *
+ * Hermes `in_progress` maps ONLY to plan row `in_progress`. These tools never
+ * touch AgentTask.status — that is the dispatcher/executor's domain.
+ */
+import { z } from "zod";
+import { get, post } from "../lib/kynver-client.js";
+export function registerCurrentFocusTools({ register, resolveToolSlug, jsonResult, compact, }) {
+    const slugField = z
+        .string()
+        .optional()
+        .describe("AgentOS workspace slug. Omit to use env or the server-discovered primary.");
+    const roleLane = z
+        .enum([
+        "plan_author",
+        "plan_reviewer",
+        "implementer",
+        "report_reviewer",
+        "deep_reviewer",
+        "repair_implementer",
+        "runtime_verifier",
+        "user",
+        "system",
+    ])
+        .optional()
+        .default("implementer")
+        .describe("Role lane making this focus change. Defaults to implementer.");
+    register("agent_os_focus_get", [
+        "Get the current agent-loop focus and active executor leases for this AgentOS workspace.",
+        "Returns two separate buckets:",
+        "  agentLoopFocus   — plan rows currently marked `in_progress` (agent/Hermes focus, NOT executor state).",
+        "  executorLeases   — tasks with status `running` and an active worker lease.",
+        "Never conflate the two: in_progress = current-focus intent; running = live executor heartbeat.",
+        "Pass todos=true to also receive a projected Hermes-like todo list.",
+    ].join(" "), {
+        todos: z
+            .boolean()
+            .optional()
+            .describe("When true, also return a projected todo list of actionable tasks and in-progress rows."),
+        planId: z
+            .string()
+            .optional()
+            .describe("Scope the todo projection to a single plan. Has no effect unless todos=true."),
+        slug: slugField,
+    }, async (args) => {
+        const s = await resolveToolSlug(args.slug);
+        const params = new URLSearchParams();
+        if (args.todos)
+            params.set("todos", "true");
+        if (args.planId)
+            params.set("planId", args.planId);
+        const qs = params.toString();
+        return jsonResult(await get(`/agent-os/${s}/current-focus${qs ? `?${qs}` : ""}`));
+    });
+    register("agent_os_focus_set", [
+        "Set the agent-loop current focus to a specific plan progress row.",
+        "This marks the row as `in_progress` and updates AgentPlan.inProgressRowKey.",
+        "IMPORTANT: This does NOT set the task status to `running` — that is the executor lease.",
+        "Hermes `in_progress` semantics: focus intent, not worker heartbeat.",
+        "Any previously focused row on the same plan is demoted back to `todo`.",
+        "Precondition: the plan must have focus enabled (progressFocusEnabled not set to false in plan metadata).",
+        "When focus is disabled, returns applied:false with a reason — not an error, but the change was not applied.",
+    ].join(" "), {
+        planId: z.string().describe("The plan that owns the row to focus."),
+        rowKey: z.string().optional().describe("Progress row key to focus. One of rowKey or rowId is required."),
+        rowId: z.string().optional().describe("Progress row DB id to focus. One of rowKey or rowId is required."),
+        taskId: z.string().optional().describe("Associate a task with this focus event (metadata only — does not change task status)."),
+        roleLane,
+        note: z.string().optional().describe("Optional note recorded on the focus event."),
+        slug: slugField,
+    }, async (args) => {
+        const s = await resolveToolSlug(args.slug);
+        const { slug, ...rest } = args;
+        return jsonResult(await post(`/agent-os/${s}/current-focus`, compact(rest)));
+    });
+    register("agent_os_focus_clear", [
+        "Clear the agent-loop current focus for a plan, moving the focused row back to `todo`.",
+        "Use when the session is done with a row but not marking it complete.",
+        "Does NOT cancel or abort the associated task — task lifecycle is separate.",
+    ].join(" "), {
+        planId: z.string().describe("The plan whose current focus should be cleared."),
+        roleLane,
+        note: z.string().optional().describe("Optional note recorded on the clear event."),
+        slug: slugField,
+    }, async (args) => {
+        const s = await resolveToolSlug(args.slug);
+        const { slug, ...rest } = args;
+        // POST with clear=true — the route distinguishes set vs clear by presence
+        // of rowKey/rowId. No rowKey/rowId + clear=true = explicit clear.
+        return jsonResult(await post(`/agent-os/${s}/current-focus`, compact({ ...rest, clear: true })));
+    });
+    register("agent_os_todo_project", [
+        "Project the current AgentOS task board and plan progress rows into a Hermes-like todo list.",
+        "Returns KynverTodoItem entries with origin discriminants:",
+        "  plan_row      — an in_progress plan progress row (agent-loop focus).",
+        "  task_ready    — a task ready for dispatch.",
+        "  task_blocked  — a task blocked on external input.",
+        "  task_needs_input — a task waiting on human decision.",
+        "Includes stale detection: items not updated within 48h are flagged stale=true.",
+        "Use this as the authoritative 'what is next' readback for Kynver sessions,",
+        "replacing stale Hermes-local todos with live board state.",
+    ].join(" "), {
+        planId: z.string().optional().describe("Scope to a single plan. Omit for workspace-wide projection."),
+        limit: z.number().int().min(1).max(100).optional().describe("Max todo items (default 50, max 100)."),
+        slug: slugField,
+    }, async (args) => {
+        const s = await resolveToolSlug(args.slug);
+        const params = new URLSearchParams();
+        params.set("todos", "true");
+        if (args.planId)
+            params.set("planId", args.planId);
+        const qs = params.toString();
+        const result = await get(`/agent-os/${s}/current-focus?${qs}`);
+        return jsonResult(result.todoProjection ?? result);
+    });
+}

package/dist/tools/task-board-watchdog.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Task board watchdog MCP tools — read/trigger the Kynver-native board sweep.
+ *
+ * agent_os_task_board_watchdog_get → GET …/task-board-watchdog (last snapshot)
+ * agent_os_task_board_watchdog_tick → POST …/task-board-watchdog (run one tick)
+ */
+type ToolResult = {
+    content: {
+        type: "text";
+        text: string;
+    }[];
+    structuredContent?: unknown;
+};
+export interface TaskBoardWatchdogToolDeps {
+    register: (name: string, description: string, inputSchema: Record<string, unknown>, cb: (args: any) => any) => void;
+    resolveToolSlug: (explicitSlug?: string) => Promise<string>;
+    jsonResult: (data: unknown) => ToolResult;
+}
+export declare function registerTaskBoardWatchdogTools({ register, resolveToolSlug, jsonResult, }: TaskBoardWatchdogToolDeps): void;
+export {};

package/dist/tools/task-board-watchdog.js

@@ -0,0 +1,42 @@
+/**
+ * Task board watchdog MCP tools — read/trigger the Kynver-native board sweep.
+ *
+ * agent_os_task_board_watchdog_get → GET …/task-board-watchdog (last snapshot)
+ * agent_os_task_board_watchdog_tick → POST …/task-board-watchdog (run one tick)
+ */
+import { z } from "zod";
+import { get, post } from "../lib/kynver-client.js";
+async function resolveAgentOsId(slug) {
+    const row = await get(`/agent-os/${encodeURIComponent(slug)}`);
+    const id = typeof row.id === "string" ? row.id.trim() : "";
+    if (!id) {
+        throw new Error(`AgentOS slug "${slug}" did not resolve to an id. Pass agentOsId explicitly or ensure GET /api/agent-os/{slug} returns id.`);
+    }
+    return id;
+}
+const idSchema = {
+    agentOsId: z.string().uuid().optional().describe("AgentOS workspace id"),
+    slug: z.string().optional().describe("AgentOS slug (resolved to id when agentOsId omitted)"),
+};
+export function registerTaskBoardWatchdogTools({ register, resolveToolSlug, jsonResult, }) {
+    register("agent_os_task_board_watchdog_get", [
+        "Fetch the Kynver-native task board watchdog snapshot: last tick movement counts,",
+        "quiet flag, dispatch floor advice, and agentReadable summary.",
+        "Safe for verify_live — read-only.",
+    ].join(" "), idSchema, async (args) => {
+        const agentOsId = args.agentOsId?.trim() ||
+            (await resolveAgentOsId(args.slug ?? (await resolveToolSlug())));
+        const data = await get(`/agent-os/by-id/${encodeURIComponent(agentOsId)}/task-board-watchdog`);
+        return jsonResult(data);
+    });
+    register("agent_os_task_board_watchdog_tick", [
+        "Run one Kynver-native task board watchdog tick: board reconcile, expert supervisor,",
+        "bookkeeping drain, budget-reset PR lifecycle retry, and meaningful-change report.",
+        "Idempotent — safe for verify_live when a fresh snapshot is needed.",
+    ].join(" "), idSchema, async (args) => {
+        const agentOsId = args.agentOsId?.trim() ||
+            (await resolveAgentOsId(args.slug ?? (await resolveToolSlug())));
+        const data = await post(`/agent-os/by-id/${encodeURIComponent(agentOsId)}/task-board-watchdog`, {});
+        return jsonResult(data);
+    });
+}

package/dist/tools/workbench.js

@@ -98,4 +98,49 @@ export function registerWorkbenchTools({ register, resolveToolSlug, jsonResult,
         }
         return jsonResult(await post(`/agent-os/${slug}/workbench/command`, body));
     });
+    register("agent_os_workbench_present", [
+        "Present a full-screen slideshow on the operator's open Command Center — walk the user",
+        "through points/status/reviews as large-type slides while you narrate in chat.",
+        "action=start with your own slides, OR compose=\"working_on\" to auto-build a",
+        "'What we're working on' deck from the live rollup server-side. Drive with",
+        "action=next/prev/goto/close. Slides may carry an EntityRef (task:<id>, plan:<id>)",
+        "for a 'Show in Command Center' button. View-control only; user can dismiss (Esc).",
+    ].join(" "), {
+        slug: z.string().optional(),
+        action: z.enum(["start", "next", "prev", "goto", "close"]).optional()
+            .describe("Default start."),
+        compose: z.enum(["working_on"]).optional()
+            .describe("Auto-compose the deck from the live rollup (ignores slides)."),
+        title: z.string().optional().describe("Deck headline (start)."),
+        slides: z
+            .array(z.object({
+            title: z.string(),
+            body: z.string().optional(),
+            bullets: z.array(z.string()).optional(),
+            metric: z.object({ value: z.string(), label: z.string() }).optional(),
+            ref: z.string().optional().describe("EntityRef e.g. task:<id>, plan:<id>"),
+            tone: z.enum(["info", "good", "warn", "risk"]).optional(),
+        }))
+            .optional()
+            .describe("Slides for action=start (max 16)."),
+        index: z.number().optional().describe("Target slide for action=goto (0-based)."),
+        autoAdvanceMs: z.number().optional().describe("Optional auto-advance (3000–120000 ms)."),
+        sessionId: z.string().optional(),
+    }, async (args) => {
+        const slug = await resolveToolSlug(args.slug);
+        const body = {
+            kind: "present",
+            source: "agent",
+            sessionId: args.sessionId,
+            compose: args.compose,
+            present: {
+                action: args.action ?? "start",
+                title: args.title,
+                slides: args.slides,
+                index: args.index,
+                autoAdvanceMs: args.autoAdvanceMs,
+            },
+        };
+        return jsonResult(await post(`/agent-os/${slug}/workbench/command`, body));
+    });
 }

package/package.json

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