@kynver-app/mcp-agent-os 0.3.25 → 0.3.27

package/dist/index.js

@@ -5,7 +5,11 @@
  * Env: KYNVER_API_URL, KYNVER_API_KEY (required)
  */
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { handleCliVersionFlag } from "./lib/package-version.js";
 import { createAgentOsServer } from "./server.js";
+if (handleCliVersionFlag(process.argv.slice(2), import.meta.url, "kynver-mcp-agent-os")) {
+    // exits
+}
 const server = createAgentOsServer();
 const transport = new StdioServerTransport();
 await server.connect(transport);

package/dist/lib/package-version.d.ts

@@ -0,0 +1,7 @@
+/** Read a field from the nearest `package.json` above this module. */
+export declare function readOwnPackageJsonField(moduleUrl: string, field: "version" | "name"): string;
+export declare function readOwnPackageVersion(moduleUrl?: string): string;
+export declare function wantsCliVersion(argv: string[]): boolean;
+export declare function printCliVersionAndExit(version: string, binName?: string): never;
+/** When `--version` / `-v` is present, print package version and exit before side effects. */
+export declare function handleCliVersionFlag(argv: string[], moduleUrl?: string, binName?: string): boolean;

package/dist/lib/package-version.js

@@ -0,0 +1,44 @@
+// @generated — synced from packages/kynver-mcp-sse-lib/src/package-version.ts via scripts/sync-mcp-sse-server.mjs
+// Do not edit by hand; change the canonical file and re-run the sync script.
+import { existsSync, readFileSync } from "node:fs";
+import { dirname, join } from "node:path";
+import { fileURLToPath } from "node:url";
+function resolvePackageRoot(moduleUrl) {
+    let dir = dirname(fileURLToPath(moduleUrl));
+    for (let depth = 0; depth < 6; depth += 1) {
+        if (existsSync(join(dir, "package.json")))
+            return dir;
+        const parent = dirname(dir);
+        if (parent === dir)
+            break;
+        dir = parent;
+    }
+    throw new Error(`package.json not found above ${dirname(fileURLToPath(moduleUrl))}`);
+}
+/** Read a field from the nearest `package.json` above this module. */
+export function readOwnPackageJsonField(moduleUrl, field) {
+    const pkgPath = join(resolvePackageRoot(moduleUrl), "package.json");
+    const pkg = JSON.parse(readFileSync(pkgPath, "utf8"));
+    const value = pkg[field];
+    if (typeof value !== "string" || !value.trim()) {
+        throw new Error(`Missing package.json ${field} at ${pkgPath}`);
+    }
+    return value;
+}
+export function readOwnPackageVersion(moduleUrl = import.meta.url) {
+    return readOwnPackageJsonField(moduleUrl, "version");
+}
+export function wantsCliVersion(argv) {
+    return argv.some((arg) => arg === "--version" || arg === "-v");
+}
+export function printCliVersionAndExit(version, binName) {
+    console.log(binName ? `${binName} ${version}` : version);
+    process.exit(0);
+}
+/** When `--version` / `-v` is present, print package version and exit before side effects. */
+export function handleCliVersionFlag(argv, moduleUrl = import.meta.url, binName) {
+    if (!wantsCliVersion(argv))
+        return false;
+    printCliVersionAndExit(readOwnPackageVersion(moduleUrl), binName);
+    return true;
+}

package/dist/server.js

@@ -18,6 +18,9 @@ import { registerWorkbenchTools } from "./tools/workbench.js";
 import { registerCommandCenterTools } from "./tools/command-center.js";
 import { registerMemoryQualityFeedbackTools } from "./tools/memory-quality-feedback.js";
 import { registerOperatingRulesTools } from "./tools/operating-rules.js";
+import { registerMonitorTools } from "./tools/monitor.js";
+import { readOwnPackageVersion } from "./lib/package-version.js";
+const PACKAGE_VERSION = readOwnPackageVersion(import.meta.url);
 function jsonResult(data) {
     return {
         content: [{ type: "text", text: JSON.stringify(data, null, 2) }],
@@ -34,7 +37,7 @@ function compact(source) {
 }
 const MCP_LEGACY_SLUG_FALLBACK = "ghost";
 export function createAgentOsServer() {
-    const server = new McpServer({ name: "kynver-mcp-agent-os", version: "0.3.6" }, { capabilities: { tools: {} } });
+    const server = new McpServer({ name: "kynver-mcp-agent-os", version: PACKAGE_VERSION }, { capabilities: { tools: {} } });
     // eslint-disable-next-line @typescript-eslint/no-explicit-any
     function register(name, description, inputSchema, cb) {
         // eslint-disable-next-line @typescript-eslint/no-explicit-any
@@ -684,5 +687,6 @@ export function createAgentOsServer() {
     registerMemoryQualityFeedbackTools({ register, resolveToolSlug, jsonResult, compact });
     // Lane A instruction policy (operating rules boundary).
     registerOperatingRulesTools({ register, resolveToolSlug, jsonResult, compact });
+    registerMonitorTools({ register, resolveToolSlug, jsonResult });
     return server;
 }

package/dist/tools/command-center.d.ts

@@ -1,8 +1,12 @@
 /**
  * Command Center MCP tools — unified rollup for AgentOS operators.
  *
- * agent_os_command_center_get proxies to GET `/api/agent-os/by-id/{agentOsId}/command-center`,
- * the same payload the browser Command Center uses (includes `packageVersionHealth` since #220).
+ * agent_os_command_center_get proxies to GET `/api/agent-os/by-id/{agentOsId}/command-center`
+ * (full rollup; `countSnapshot` is the canonical badge contract aligned with the UI).
+ *
+ * agent_os_command_center_dashboard_contract_get proxies to
+ * `.../command-center/dashboard-contract` — slim verification payload (counts,
+ * packageVersionHealth, runtime capacity, activePlanRollups) without graph/hierarchy.
  */
 type ToolResult = {
     content: {

package/dist/tools/command-center.js

@@ -1,8 +1,12 @@
 /**
  * Command Center MCP tools — unified rollup for AgentOS operators.
  *
- * agent_os_command_center_get proxies to GET `/api/agent-os/by-id/{agentOsId}/command-center`,
- * the same payload the browser Command Center uses (includes `packageVersionHealth` since #220).
+ * agent_os_command_center_get proxies to GET `/api/agent-os/by-id/{agentOsId}/command-center`
+ * (full rollup; `countSnapshot` is the canonical badge contract aligned with the UI).
+ *
+ * agent_os_command_center_dashboard_contract_get proxies to
+ * `.../command-center/dashboard-contract` — slim verification payload (counts,
+ * packageVersionHealth, runtime capacity, activePlanRollups) without graph/hierarchy.
  */
 import { z } from "zod";
 import { get } from "../lib/kynver-client.js";
@@ -18,7 +22,12 @@ export function registerCommandCenterTools({ register, resolveToolSlug, jsonResu
     register("agent_os_command_center_get", [
         "Fetch the unified Command Center rollup for the AgentOS workspace:",
         "plan rollups, project hierarchy, action-required items, DQ inbox, harness summaries,",
-        "runtime capacity, and packageVersionHealth (managed npm alignment for @kynver-app/runtime).",
+        "prReadyNotifications (journal pr_ready events), dailyLandedPrs (journal merge counts:",
+        "today/yesterday, rolling 24h/48h, pace + agentReadable summary), runtime capacity, and",
+        "packageVersionHealth (managed npm alignment for @kynver-app/runtime).",
+        "Includes `countSnapshot` (canonical header-chip / saved-view / review-lane counts — same",
+        "contract the dashboard badges use). For a compact runtime verification payload without",
+        "operationalGraph/hierarchy, use agent_os_command_center_dashboard_contract_get.",
         "Same aggregate as the browser Command Center. Omit slug to use env/primary workspace;",
         "pass agentOsId when already known from a prior identity fetch.",
     ].join(" "), {
@@ -59,4 +68,40 @@ export function registerCommandCenterTools({ register, resolveToolSlug, jsonResu
         const suffix = qs.toString() ? `?${qs.toString()}` : "";
         return jsonResult(await get(`/agent-os/by-id/${encodeURIComponent(agentOsId)}/command-center${suffix}`));
     });
+    register("agent_os_command_center_dashboard_contract_get", [
+        "Fetch the slim Command Center dashboard contract for runtime verification:",
+        "countSnapshot, readiness, packageVersionHealth, runtime capacity, activePlanRollups,",
+        "and review-lane totals — same sources as the browser dashboard badges, without",
+        "operationalGraph or hierarchy payloads (avoids MCP truncation on large boards).",
+    ].join(" "), {
+        slug: z
+            .string()
+            .optional()
+            .describe("AgentOS slug. Defaults to the configured env/primary AgentOS."),
+        agentOsId: z
+            .string()
+            .optional()
+            .describe("Optional AgentOS row id. When omitted, resolved from slug."),
+        since: z
+            .string()
+            .optional()
+            .describe("ISO timestamp — only include tasks updated after this instant."),
+        limit: z
+            .number()
+            .optional()
+            .describe("Max tasks to load when building counts (server cap 10000)."),
+    }, async (args) => {
+        const slug = await resolveToolSlug(args.slug);
+        const agentOsId = typeof args.agentOsId === "string" && args.agentOsId.trim()
+            ? args.agentOsId.trim()
+            : await resolveAgentOsId(slug);
+        const qs = new URLSearchParams();
+        if (typeof args.since === "string" && args.since.trim())
+            qs.set("since", args.since.trim());
+        if (typeof args.limit === "number" && Number.isFinite(args.limit)) {
+            qs.set("limit", String(args.limit));
+        }
+        const suffix = qs.toString() ? `?${qs.toString()}` : "";
+        return jsonResult(await get(`/agent-os/by-id/${encodeURIComponent(agentOsId)}/command-center/dashboard-contract${suffix}`));
+    });
 }

package/dist/tools/graph.js

@@ -55,21 +55,40 @@ export function registerGraphTools({ register, resolveToolSlug, jsonResult }) {
         return jsonResult(await get(`/agent-os/${slug}/graph/query${suffix}`));
     });
     register("agent_os_graph_view", [
-        "Steer the human's open 3D web view (shared focus) — fly the camera to a node, filter, or reset,",
-        "so you and the user are provably looking at the same thing.",
-        "kind=focus needs nodeId (operational graph id, e.g. 'task:abc'); kind=filter sets which type/status",
-        "buckets are hidden; kind=reset clears focus + filters; kind=highlight focuses without isolating.",
+        "Steer the human's open 3D web view (shared focus) — spotlight + fly the camera to a node, a SET",
+        "of nodes, or a whole goal constellation, filter, or reset, so you and the user are provably",
+        "looking at the same thing while you narrate.",
+        "kind=focus spotlights the target(s) and DIMS the rest (isolate); kind=highlight spotlights",
+        "WITHOUT dimming. Give exactly one of: nodeId (a single node, e.g. 'task:abc'), nodeIds (an",
+        "explicit set — 'frame these three bottlenecks'), or clusterId (the BARE goalId, NOT the",
+        "'goal:abc' node id — 'frame this whole goal'). An unrecognized target is dropped silently.",
+        "frameAll=false keeps the camera put (spotlight only, no fly). kind=filter sets which type/status",
+        "buckets are hidden; kind=reset clears focus + filters + spotlight.",
         "Takes effect only while the user has the 3D Web tab open (delivered over SSE).",
         "Requires Redis in multi-instance/serverless prod to fan out; single-instance dev works without it.",
     ].join(" "), {
         slug: z.string().optional().describe("AgentOS slug. Defaults to env/primary."),
         kind: z
             .enum(["focus", "filter", "reset", "highlight"])
-            .describe("focus | highlight (camera) · filter (hide buckets) · reset (clear)."),
+            .describe("focus (spotlight + dim rest) | highlight (spotlight, no dim) | filter | reset."),
         nodeId: z
             .string()
             .optional()
-            .describe("Target operational-graph node id for focus/highlight (e.g. 'task:abc123')."),
+            .describe("focus/highlight: a single target node id (e.g. 'task:abc123')."),
+        nodeIds: z
+            .array(z.string())
+            .optional()
+            .describe("focus/highlight: an explicit SET of node ids to frame together."),
+        clusterId: z
+            .string()
+            .optional()
+            .describe("focus/highlight: a whole goal constellation = the BARE goalId (the Goal entity id, " +
+            "e.g. 'abc'; the value in each node's web3d.constellation.goalId), NOT the prefixed " +
+            "'goal:abc' graph node id. An unknown id resolves to nothing (no-op)."),
+        frameAll: z
+            .boolean()
+            .optional()
+            .describe("focus/highlight: also fly the camera to frame the set (default true)."),
         hiddenKinds: z
             .array(z.string())
             .optional()
@@ -83,6 +102,9 @@ export function registerGraphTools({ register, resolveToolSlug, jsonResult }) {
         return jsonResult(await post(`/agent-os/${slug}/graph/view`, {
             kind: args.kind,
             nodeId: args.nodeId,
+            nodeIds: args.nodeIds,
+            clusterId: args.clusterId,
+            frameAll: args.frameAll,
             hiddenKinds: args.hiddenKinds,
             hiddenStatuses: args.hiddenStatuses,
             source: "agent",

package/dist/tools/monitor.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Harness worker monitor MCP tools — backed by AgentOS harness/monitor HTTP routes.
+ */
+type ToolResult = {
+    content: {
+        type: "text";
+        text: string;
+    }[];
+    structuredContent?: unknown;
+};
+export interface MonitorToolDeps {
+    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 registerMonitorTools({ register, resolveToolSlug, jsonResult, }: MonitorToolDeps): void;
+export {};

package/dist/tools/monitor.js

@@ -0,0 +1,51 @@
+/**
+ * Harness worker monitor MCP tools — backed by AgentOS harness/monitor HTTP routes.
+ */
+import { z } from "zod";
+import { post } from "../lib/kynver-client.js";
+const slugField = z
+    .string()
+    .optional()
+    .describe("AgentOS slug. Defaults to env/primary AgentOS.");
+export function registerMonitorTools({ register, resolveToolSlug, jsonResult, }) {
+    register("agent_os_monitor_assess", [
+        "Assess harness worker health (healthy/stale/orphaned) and auto-complete eligibility",
+        "for a run on the runner host disk. Requires the harness run to exist under",
+        "KYNVER_HARNESS_ROOT on the server (or operator host posting via runner token).",
+        "Distinguishes AgentTask `running` (live executor lease) from plan-row focus.",
+    ].join(" "), {
+        slug: slugField,
+        runId: z.string(),
+        workerName: z.string().optional().describe("Scope to one worker; omit for all workers in the run."),
+    }, async (args) => {
+        const slug = await resolveToolSlug(args.slug);
+        return jsonResult(await post(`/agent-os/${encodeURIComponent(slug)}/harness/monitor/assess`, {
+            runId: args.runId,
+            workerName: args.workerName,
+        }));
+    });
+    register("agent_os_monitor_list", "List active local harness monitor sidecars on the runner host (kynver monitor list). Requires runner execution context.", {
+        slug: slugField,
+    }, async () => {
+        return jsonResult({
+            note: "Use `kynver monitor list` on the runner host; MCP list is local-disk only.",
+        });
+    });
+    register("agent_os_monitor_auto_complete", [
+        "Run verified terminal auto-complete for one harness worker (poll + POST /harness/completion).",
+        "Refuses when blockers exist (heartbeat blocker, landing gate, completionBlocker).",
+        "Prefer `kynver monitor auto-complete --run RUN --name WORKER` on the runner host;",
+        "this MCP tool documents the contract — remote auto-complete requires runner CLI.",
+    ].join(" "), {
+        slug: slugField,
+        runId: z.string(),
+        workerName: z.string(),
+    }, async (args) => {
+        await resolveToolSlug(args.slug);
+        return jsonResult({
+            ok: false,
+            reason: "Remote auto-complete must run via `kynver monitor auto-complete` on the runner host",
+            command: `kynver monitor auto-complete --run ${args.runId} --name ${args.workerName}`,
+        });
+    });
+}

package/dist/tools/tasks.js

@@ -30,8 +30,14 @@ const taskPriority = z
     .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.");
+    "critical automatically). Reserve manual 'high'/'critical' only when Will explicitly asked or there is a " +
+    "live production/security incident — pass priorityEscalationReason quoting him or the incident. The server " +
+    "downgrades unsolicited high/critical to normal. If everything is critical, nothing is — keep most tasks at normal/low.");
+const priorityEscalationReason = z
+    .string()
+    .optional()
+    .describe("Required when setting priority to high/critical: quote Will's words or name the live incident. " +
+    "Without this (and without explicit escalation in title/description), the API coerces to normal.");
 const taskExecutor = z.enum(["inline", "harness", "acp", "manual"]);
 const taskEventType = z.enum([
     "created",
@@ -70,6 +76,7 @@ export function registerTaskTools({ register, resolveToolSlug, jsonResult, compa
         title: z.string().describe("Short task title (required)."),
         description: z.string().optional(),
         priority: taskPriority.optional(),
+        priorityEscalationReason,
         executor: taskExecutor.optional().describe("How the task runs: inline | harness | acp | manual."),
         executorRef: z.string().optional().describe("Opaque ref to the executor process / unit."),
         parentTaskId: z.string().optional().describe("Parent task id when this is one of 2+ coordinated workers."),

package/package.json

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