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

package/dist/server.js

@@ -14,6 +14,7 @@ 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";
+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";
@@ -675,6 +676,8 @@ export function createAgentOsServer() {
     registerActionRequiredTools({ register, jsonResult, compact });
     // Operational graph insights — Agent SEE (agent_os_graph_query).
     registerGraphTools({ register, resolveToolSlug, jsonResult });
+    // Workbench view control — steer whole Command Center (agent_os_workbench_*).
+    registerWorkbenchTools({ register, resolveToolSlug, jsonResult });
     // Command Center rollup (by-id route; includes packageVersionHealth).
     registerCommandCenterTools({ register, resolveToolSlug, jsonResult });
     // Memory quality feedback (M2): record events + query status.

package/dist/tools/plan-progress.js

@@ -23,6 +23,7 @@ const rowUpsertSchema = z.object({
     title: z.string(),
     description: z.string().optional(),
     ordinal: z.number(),
+    status: progressStatus.optional(),
     stageId: z.string().optional(),
     ownerLane: roleLane.optional(),
     taskId: z.string().optional(),

package/dist/tools/workbench.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Workbench control MCP tools (M1) — steer the whole Command Center view.
+ */
+type ToolResult = {
+    content: {
+        type: "text";
+        text: string;
+    }[];
+    structuredContent?: unknown;
+};
+export interface WorkbenchToolDeps {
+    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 registerWorkbenchTools({ register, resolveToolSlug, jsonResult, }: WorkbenchToolDeps): void;
+export {};

package/dist/tools/workbench.js

@@ -0,0 +1,101 @@
+/**
+ * Workbench control MCP tools (M1) — steer the whole Command Center view.
+ */
+import { z } from "zod";
+import { get, post } from "../lib/kynver-client.js";
+const commandKind = z.enum([
+    "navigate",
+    "focus",
+    "drill",
+    "drill_pop",
+    "open_panel",
+    "open_report",
+    "open_pr_history",
+    "highlight",
+    "annotate",
+    "filter",
+    "graph",
+    "reset",
+    "yield",
+    "take",
+]);
+export function registerWorkbenchTools({ register, resolveToolSlug, jsonResult, }) {
+    register("agent_os_workbench_query", [
+        "Read the operator's current workbench focus (view mode, drilldown stack, focused entity)",
+        "plus a compact rollup digest. Use before steering so you and the operator share context.",
+        "Read-only.",
+    ].join(" "), {
+        slug: z.string().optional().describe("AgentOS slug. Defaults to env/primary."),
+    }, async (args) => {
+        const slug = await resolveToolSlug(args.slug);
+        return jsonResult(await get(`/agent-os/${slug}/workbench/focus`));
+    });
+    register("agent_os_workbench_view", [
+        "Steer the Command Center workbench (navigate, focus, drill, open panels, filter, reset).",
+        "View-control only — does not mutate tasks/plans. Delivered over SSE to open surfaces.",
+        "For 3D graph camera commands, use kind=graph or agent_os_graph_view.",
+    ].join(" "), {
+        slug: z.string().optional(),
+        kind: commandKind,
+        view: z.enum(["projects", "tasks", "goals", "dq", "web"]).optional(),
+        target: z.string().optional().describe("EntityRef e.g. task:<id>, plan:<id>"),
+        push: z.boolean().optional().describe("For drill: push onto stack (default true)"),
+        panel: z.string().optional(),
+        tab: z.string().optional(),
+        personaSlug: z.string().optional(),
+        planId: z.string().optional(),
+        prUrl: z.string().optional(),
+        chip: z.string().optional(),
+        review: z.string().optional(),
+        q: z.string().optional(),
+        sessionId: z.string().optional(),
+        nodeId: z.string().optional().describe("For kind=graph: graph node id"),
+        graphKind: z.enum(["focus", "filter", "reset", "highlight"]).optional(),
+    }, async (args) => {
+        const slug = await resolveToolSlug(args.slug);
+        const body = {
+            kind: args.kind,
+            source: "agent",
+            sessionId: args.sessionId,
+            personaSlug: args.personaSlug,
+        };
+        switch (args.kind) {
+            case "navigate":
+                body.navigate = { view: args.view };
+                break;
+            case "focus":
+                body.focus = { target: args.target };
+                break;
+            case "drill":
+                body.drill = { target: args.target, push: args.push };
+                break;
+            case "drill_pop":
+                body.drill_pop = {};
+                break;
+            case "open_panel":
+                body.open_panel = { panel: args.panel, tab: args.tab };
+                break;
+            case "open_report":
+                body.open_report = { personaSlug: args.personaSlug };
+                break;
+            case "open_pr_history":
+                body.open_pr_history = { planId: args.planId, prUrl: args.prUrl };
+                break;
+            case "filter":
+                body.filter = { chip: args.chip, review: args.review, q: args.q };
+                break;
+            case "graph":
+                body.graph = {
+                    command: {
+                        kind: args.graphKind ?? "focus",
+                        nodeId: args.nodeId,
+                        source: "agent",
+                    },
+                };
+                break;
+            default:
+                break;
+        }
+        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.23",
+  "version": "0.3.25",
   "description": "Kynver Agentic OS MCP server — slug-keyed agent identity, goals, projects, sessions, and long-term memory",
   "type": "module",
   "bin": {