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

package/dist/server.js

@@ -13,6 +13,7 @@ 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";
+import { registerGraphTools } from "./tools/graph.js";
 function jsonResult(data) {
     return {
         content: [{ type: "text", text: JSON.stringify(data, null, 2) }],
@@ -614,5 +615,7 @@ export function createAgentOsServer() {
     registerPlanProgressTools({ register, resolveToolSlug, jsonResult, compact });
     // Action Required inbox: agent_os_ask_human + agent_os_await_action (slice 1).
     registerActionRequiredTools({ register, jsonResult, compact });
+    // Operational graph insights — Agent SEE (agent_os_graph_query).
+    registerGraphTools({ register, resolveToolSlug, jsonResult });
     return server;
 }

package/dist/tools/graph.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Operational-graph MCP tools — "Agent SEE" (graph M6).
+ *
+ * agent_os_graph_query proxies to GET `/api/agent-os/{slug}/graph/query`, which
+ * returns server-computed insights (bottlenecks, per-owner load, orphans) over
+ * the operational graph. Read-only; the Kynver route enforces session +
+ * workspace scope. Kept in its own module so server.ts stays slim.
+ */
+type ToolResult = {
+    content: {
+        type: "text";
+        text: string;
+    }[];
+    structuredContent?: unknown;
+};
+export interface GraphToolDeps {
+    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 registerGraphTools({ register, resolveToolSlug, jsonResult }: GraphToolDeps): void;
+export {};

package/dist/tools/graph.js

@@ -0,0 +1,91 @@
+/**
+ * Operational-graph MCP tools — "Agent SEE" (graph M6).
+ *
+ * agent_os_graph_query proxies to GET `/api/agent-os/{slug}/graph/query`, which
+ * returns server-computed insights (bottlenecks, per-owner load, orphans) over
+ * the operational graph. Read-only; the Kynver route enforces session +
+ * workspace scope. Kept in its own module so server.ts stays slim.
+ */
+import { z } from "zod";
+import { get, post } from "../lib/kynver-client.js";
+export function registerGraphTools({ register, resolveToolSlug, jsonResult }) {
+    register("agent_os_graph_query", [
+        "Read the operational graph's computed insights for the AgentOS:",
+        "top bottlenecks (highest downstream impact among still-active or blocked work),",
+        "per-owner load (who is carrying work and who is blocked), and orphaned tasks.",
+        "Use this to answer questions like 'what is my biggest bottleneck',",
+        "'what is blocking project X', 'what is <persona> working on', or 'what is unassigned'.",
+        "Read-only — modifies nothing. Returns { available, generatedAt, stats, insights }.",
+    ].join(" "), {
+        slug: z
+            .string()
+            .optional()
+            .describe("AgentOS slug. Defaults to the configured env/primary AgentOS."),
+        bottlenecks: z
+            .number()
+            .int()
+            .min(1)
+            .max(50)
+            .optional()
+            .describe("Max bottleneck rows to return (default 10)."),
+        owners: z
+            .number()
+            .int()
+            .min(1)
+            .max(50)
+            .optional()
+            .describe("Max per-owner load rows to return (default 12)."),
+        orphans: z
+            .number()
+            .int()
+            .min(1)
+            .max(100)
+            .optional()
+            .describe("Max orphan rows to return (default 25)."),
+    }, async (args) => {
+        const slug = await resolveToolSlug(args.slug);
+        const qs = new URLSearchParams();
+        if (args.bottlenecks !== undefined)
+            qs.set("bottlenecks", String(args.bottlenecks));
+        if (args.owners !== undefined)
+            qs.set("owners", String(args.owners));
+        if (args.orphans !== undefined)
+            qs.set("orphans", String(args.orphans));
+        const suffix = qs.toString() ? "?" + qs.toString() : "";
+        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.",
+        "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)."),
+        nodeId: z
+            .string()
+            .optional()
+            .describe("Target operational-graph node id for focus/highlight (e.g. 'task:abc123')."),
+        hiddenKinds: z
+            .array(z.string())
+            .optional()
+            .describe("For kind=filter: node kinds to hide (e.g. ['repo_file']). [] clears."),
+        hiddenStatuses: z
+            .array(z.string())
+            .optional()
+            .describe("For kind=filter: statuses to hide (e.g. ['done']). [] clears."),
+    }, async (args) => {
+        const slug = await resolveToolSlug(args.slug);
+        return jsonResult(await post(`/agent-os/${slug}/graph/view`, {
+            kind: args.kind,
+            nodeId: args.nodeId,
+            hiddenKinds: args.hiddenKinds,
+            hiddenStatuses: args.hiddenStatuses,
+            source: "agent",
+        }));
+    });
+}

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.8",
+  "version": "0.3.10",
   "description": "Kynver Agentic OS MCP server — slug-keyed agent identity, goals, projects, sessions, and long-term memory",
   "type": "module",
   "bin": {