agent-planner-mcp 1.5.13 → 1.5.15

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agent-planner-mcp",
-  "version": "1.5.13",
+  "version": "1.5.15",
   "description": "MCP server for AgentPlanner — AI agent orchestration with planning, dependencies, knowledge graphs, and human oversight",
   "main": "src/index.js",
   "bin": {

package/src/api-client.js

@@ -1087,6 +1087,12 @@ function createApiClient(token, options = {}) {
 // Export the axios instance for direct use
 const axiosInstance = apiClient;
 
+// ─── System ───────────────────────────────────────────────────
+// Operational metadata about the backend the MCP is talking to.
+const system = {
+  version: () => apiClient.get('/version').then(r => r.data),
+};
+
 // ─── Coherence ────────────────────────────────────────────────
 const coherence = {
   getPending: () => apiClient.get('/coherence/pending').then(r => r.data),
@@ -1112,6 +1118,7 @@ module.exports = {
   coherence,
   users,
   agentLoop,
+  system,
   v1,
   axiosInstance,  // Export for direct API calls
   createApiClient  // Factory for per-session clients (HTTP mode)

package/src/tools/bdi/desires.js

@@ -114,15 +114,15 @@ async function updateGoalHandler(args, apiClient) {
   // with the backend, but success_criteria must be camelCased to successCriteria
   // — the goal update schema is .strict(), so the snake_case key was rejected
   // with a 400 (the one multi-word field, hence "description writes but
-  // success_criteria fails"). Match the create shape: wrap a bare array as
-  // { criteria: [...] }.
+  // success_criteria fails"). Send the array shape directly: it is the backend's
+  // preferred form. (The old { criteria: [...] } wrap made the backend count
+  // Object.keys()==1 and skip per-criterion knowledge grounding.)
   const directFields = {};
   for (const k of ['title', 'description', 'priority', 'status']) {
     if (changes[k] !== undefined) directFields[k] = changes[k];
   }
   if (changes.success_criteria !== undefined) {
-    const sc = changes.success_criteria;
-    directFields.successCriteria = Array.isArray(sc) ? { criteria: sc } : sc;
+    directFields.successCriteria = changes.success_criteria;
   }
   // Map the public `committed` boolean onto the backend's commitment write
   // (the API still accepts the legacy goalType field and translates it to
@@ -245,7 +245,7 @@ async function deriveSubgoalHandler(args, apiClient) {
     parentGoalId: parent_goal_id,
     organizationId: parent.organization_id || parent.organizationId || undefined,
   };
-  if (success_criteria) payload.successCriteria = { criteria: success_criteria };
+  if (success_criteria) payload.successCriteria = success_criteria;
   if (typeof priority === 'number') payload.priority = priority;
 
   let goal;
@@ -318,7 +318,7 @@ async function createGoalHandler(args, apiClient) {
 
   const payload = { title, type, status };
   if (description) payload.description = description;
-  if (success_criteria) payload.successCriteria = { criteria: success_criteria };
+  if (success_criteria) payload.successCriteria = success_criteria;
   if (typeof priority === 'number') payload.priority = priority;
   if (workspace_id) payload.workspaceId = workspace_id;
 

package/src/tools/bdi/utility.js

@@ -19,10 +19,22 @@ const getStartedDefinition = {
   },
 };
 
-async function getStartedHandler(args) {
+async function getStartedHandler(args, apiClient) {
+  // Best-effort backend version so one call shows which builds are in play
+  // (the MCP and the API it is actually talking to are deployed separately).
+  let api = { version: 'unavailable' };
+  try {
+    if (apiClient?.system?.version) api = await apiClient.system.version();
+  } catch {
+    api = { version: 'unavailable' };
+  }
+
   return formatResponse({
     as_of: asOf(),
     mcp_version: MCP_VERSION,
+    api_url: process.env.API_URL || 'http://localhost:3000',
+    api_version: api.version,
+    api_build: api.commit ? { commit: api.commit, started_at: api.started_at } : undefined,
     overview:
       "AgentPlanner exposes a BDI-aligned MCP surface. Tools are grouped by " +
       "Beliefs (state queries), Desires (goals), and Intentions (committed actions). " +
@@ -31,7 +43,7 @@ async function getStartedHandler(args) {
       beliefs: ['briefing', 'list_plans', 'task_context', 'goal_state', 'recall_knowledge', 'search', 'plan_analysis'],
       desires: ['list_goals', 'create_goal', 'update_goal', 'derive_subgoal'],
       intentions: ['form_intention', 'extend_intention', 'link_intentions', 'propose_research_chain', 'claim_next_task', 'update_task', 'update_node', 'release_task', 'queue_decision', 'resolve_decision', 'add_learning'],
-      workspaces: ['list_workspaces', 'create_workspace', 'list_blueprints', 'fork_blueprint', 'save_as_blueprint'],
+      workspaces: ['list_workspaces', 'create_workspace', 'list_blueprints', 'fork_blueprint', 'save_as_blueprint', 'delete_blueprint'],
     },
     recommended_workflows: [
       {