@kynver-app/mcp-agent-os 0.3.13 → 0.3.16

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 { registerCommandCenterTools } from "./tools/command-center.js";
 function jsonResult(data) {
     return {
         content: [{ type: "text", text: JSON.stringify(data, null, 2) }],
@@ -268,9 +269,17 @@ export function createAgentOsServer() {
         const s = await resolveToolSlug(slug);
         return jsonResult(await patch(`/agent-os/${s}/projects/${projectId}`, body));
     });
-    register("agent_os_search_memory", "Semantic + keyword hybrid search over the agent's long-term MARM memory (ownerType=agent). Use to recall specific decisions, project details, or lessons without loading full context. Replaces grep/reading MEMORY.md. Results include rrfScore — a Reciprocal Rank Fusion score where ~0.033 is a near-perfect match. Higher is better; do not treat low numbers as poor results.", {
+    register("agent_os_search_memory", "Semantic + keyword hybrid search over the agent's long-term MARM memory (ownerType=agent). Use to recall specific decisions, project details, or lessons without loading full context. Replaces grep/reading MEMORY.md. Optionally restrict to one source namespace via sourceId, or several via sourceIds (sourceId takes precedence when both are set). Results include rrfScore — a Reciprocal Rank Fusion score where ~0.033 is a near-perfect match. Higher is better; do not treat low numbers as poor results.", {
         query: z.string().describe("Natural language query to search memory."),
         k: z.number().optional().describe("Number of results (default 10, max 50)."),
+        sourceId: z
+            .string()
+            .optional()
+            .describe("Restrict search to a single memory source namespace (e.g. agent:session). Takes precedence over sourceIds when both are set."),
+        sourceIds: z
+            .array(z.string())
+            .optional()
+            .describe("Restrict search to any of these source namespaces. Ignored when sourceId is also set."),
         ticker: z.string().optional().describe("Trading desk: filter hits to this ticker symbol."),
         debatePersona: z.enum(["bull", "bear"]).optional().describe("Trading desk: filter to bull or bear advocate memories."),
         slug: slugField,
@@ -278,6 +287,12 @@ export function createAgentOsServer() {
         const params = new URLSearchParams({ q: args.query });
         if (args.k)
             params.set("k", String(args.k));
+        if (args.sourceId)
+            params.set("sourceId", args.sourceId);
+        if (args.sourceIds?.length) {
+            for (const id of args.sourceIds)
+                params.append("sourceIds", id);
+        }
         if (args.ticker)
             params.set("ticker", args.ticker);
         if (args.debatePersona)
@@ -617,5 +632,7 @@ export function createAgentOsServer() {
     registerActionRequiredTools({ register, jsonResult, compact });
     // Operational graph insights — Agent SEE (agent_os_graph_query).
     registerGraphTools({ register, resolveToolSlug, jsonResult });
+    // Command Center rollup (by-id route; includes packageVersionHealth).
+    registerCommandCenterTools({ register, resolveToolSlug, jsonResult });
     return server;
 }

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

@@ -0,0 +1,20 @@
+/**
+ * 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).
+ */
+type ToolResult = {
+    content: {
+        type: "text";
+        text: string;
+    }[];
+    structuredContent?: unknown;
+};
+export interface CommandCenterToolDeps {
+    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 registerCommandCenterTools({ register, resolveToolSlug, jsonResult, }: CommandCenterToolDeps): void;
+export {};

package/dist/tools/command-center.js

@@ -0,0 +1,62 @@
+/**
+ * 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).
+ */
+import { z } from "zod";
+import { get } 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;
+}
+export function registerCommandCenterTools({ register, resolveToolSlug, jsonResult, }) {
+    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).",
+        "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(" "), {
+        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 via GET /api/agent-os/{slug}."),
+        since: z
+            .string()
+            .optional()
+            .describe("ISO timestamp — only include tasks updated after this instant."),
+        limit: z
+            .number()
+            .optional()
+            .describe("Max tasks to load (server cap 10000)."),
+        harnessLimit: z
+            .number()
+            .optional()
+            .describe("Max harness runs in the rollup (server cap 200)."),
+    }, 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));
+        }
+        if (typeof args.harnessLimit === "number" && Number.isFinite(args.harnessLimit)) {
+            qs.set("harnessLimit", String(args.harnessLimit));
+        }
+        const suffix = qs.toString() ? `?${qs.toString()}` : "";
+        return jsonResult(await get(`/agent-os/by-id/${encodeURIComponent(agentOsId)}/command-center${suffix}`));
+    });
+}

package/dist/tools/tasks.js

@@ -9,7 +9,6 @@ import { z } from "zod";
 import { get, post, patch } from "../lib/kynver-client.js";
 const taskStatus = z
     .enum([
-    "queued",
     "ready",
     "running",
     "waiting",
@@ -21,7 +20,7 @@ const taskStatus = z
     "failed",
     "cancelled",
 ])
-    .describe("Work-state lifecycle. `ready` = admitted, can start now (the real 'queued' — which survives as a legacy alias). " +
+    .describe("Work-state lifecycle. `ready` = admitted, can start now. " +
     "`running` = an executor holds a live lease. `waiting` = gated on upstream tasks (set dependsOnTaskIds; auto-promotes " +
     "to ready when they're all done). `scheduled` = deferred to a time (set scheduledFor; auto-promotes to ready when it " +
     "passes). `blocked`/`needs_input` = a human must resolve. `awaiting_review` = review gate open. Don't hand-set " +

package/package.json

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