@dudamel/mcp-knowledge 2026.928.1 → 2026.930.1

package/dist/index.js

@@ -158,7 +158,7 @@ function registerKnowledgeTools(server, client, ctx) {
   server.registerTool(
     "list-knowledge-sources",
     {
-      description: "List knowledge sources configured for agents. Shows name, sync type, status, integration, and last sync info.",
+      description: "List knowledge sources configured for agents: name, sync type, integration, sync interval and last-sync info. A source is failing when lastSyncError is set, syncing while syncing is true, and never syncs automatically when syncIntervalSeconds is null.",
       annotations: { readOnlyHint: true }
     },
     async () => {
@@ -213,7 +213,7 @@ function registerKnowledgeTools(server, client, ctx) {
   server.registerTool(
     "sync-knowledge-source",
     {
-      description: "Trigger a sync for a knowledge source. Fetches the latest content from the remote source.",
+      description: "Trigger a sync for a knowledge source. Returns as soon as the sync is queued; it runs in the background (minutes for a large repo). Check the outcome afterwards with get-knowledge-source (syncing, lastSyncAt, lastSyncError).",
       inputSchema: {
         id: z.string().describe("Knowledge source ID (UUID)")
       },
@@ -254,16 +254,19 @@ function registerKnowledgeTools(server, client, ctx) {
   server.registerTool(
     "update-knowledge-source",
     {
-      description: "Update a knowledge source (toggle useAll, change status).",
+      description: "Update a knowledge source: toggle useAll, or set how often it syncs automatically (syncIntervalSeconds; null = never, manual syncs only).",
       inputSchema: {
         id: z.string().describe("Knowledge source ID (UUID)"),
         useAll: z.boolean().optional().describe("Whether to include all files"),
-        status: z.enum(["active", "inactive"]).optional().describe("Source status")
+        syncIntervalSeconds: z.number().int().min(60).nullable().optional().describe("Seconds between automatic syncs (min 60); null = never sync automatically")
       },
       annotations: { readOnlyHint: false, destructiveHint: false }
     },
-    async ({ id, useAll, status }) => {
-      const result = await client.put(`/api/knowledge-sources/${id}`, { useAll, status });
+    async ({ id, useAll, syncIntervalSeconds }) => {
+      const result = await client.put(`/api/knowledge-sources/${id}`, {
+        useAll,
+        syncIntervalSeconds
+      });
       return jsonResult(result);
     }
   );

package/dist/stdio-server.js

@@ -201,7 +201,7 @@ function registerKnowledgeTools(server2, client, ctx2) {
   server2.registerTool(
     "list-knowledge-sources",
     {
-      description: "List knowledge sources configured for agents. Shows name, sync type, status, integration, and last sync info.",
+      description: "List knowledge sources configured for agents: name, sync type, integration, sync interval and last-sync info. A source is failing when lastSyncError is set, syncing while syncing is true, and never syncs automatically when syncIntervalSeconds is null.",
       annotations: { readOnlyHint: true }
     },
     async () => {
@@ -256,7 +256,7 @@ function registerKnowledgeTools(server2, client, ctx2) {
   server2.registerTool(
     "sync-knowledge-source",
     {
-      description: "Trigger a sync for a knowledge source. Fetches the latest content from the remote source.",
+      description: "Trigger a sync for a knowledge source. Returns as soon as the sync is queued; it runs in the background (minutes for a large repo). Check the outcome afterwards with get-knowledge-source (syncing, lastSyncAt, lastSyncError).",
       inputSchema: {
         id: z.string().describe("Knowledge source ID (UUID)")
       },
@@ -297,16 +297,19 @@ function registerKnowledgeTools(server2, client, ctx2) {
   server2.registerTool(
     "update-knowledge-source",
     {
-      description: "Update a knowledge source (toggle useAll, change status).",
+      description: "Update a knowledge source: toggle useAll, or set how often it syncs automatically (syncIntervalSeconds; null = never, manual syncs only).",
       inputSchema: {
         id: z.string().describe("Knowledge source ID (UUID)"),
         useAll: z.boolean().optional().describe("Whether to include all files"),
-        status: z.enum(["active", "inactive"]).optional().describe("Source status")
+        syncIntervalSeconds: z.number().int().min(60).nullable().optional().describe("Seconds between automatic syncs (min 60); null = never sync automatically")
       },
       annotations: { readOnlyHint: false, destructiveHint: false }
     },
-    async ({ id, useAll, status }) => {
-      const result = await client.put(`/api/knowledge-sources/${id}`, { useAll, status });
+    async ({ id, useAll, syncIntervalSeconds }) => {
+      const result = await client.put(`/api/knowledge-sources/${id}`, {
+        useAll,
+        syncIntervalSeconds
+      });
       return jsonResult(result);
     }
   );

package/dist/tools/knowledge.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"knowledge.d.ts","sourceRoot":"","sources":["../../src/tools/knowledge.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAEzE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAC5D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAGvD,wBAAgB,sBAAsB,CACpC,MAAM,EAAE,SAAS,EACjB,MAAM,EAAE,gBAAgB,EACxB,GAAG,EAAE,WAAW,GACf,IAAI,CAqLN"}
+{"version":3,"file":"knowledge.d.ts","sourceRoot":"","sources":["../../src/tools/knowledge.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAEzE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAC5D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAGvD,wBAAgB,sBAAsB,CACpC,MAAM,EAAE,SAAS,EACjB,MAAM,EAAE,gBAAgB,EACxB,GAAG,EAAE,WAAW,GACf,IAAI,CAoMN"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dudamel/mcp-knowledge",
-  "version": "2026.928.1",
+  "version": "2026.930.1",
   "description": "Dudamel knowledge MCP — stdio client for Dudamel's knowledge management surface over its REST API.",
   "license": "SEE LICENSE IN LICENSE.md",
   "type": "module",
@@ -32,8 +32,8 @@
   },
   "devDependencies": {
     "esbuild": "^0.25.0",
-    "@dudamel/contracts": "0.1.0",
     "@dudamel/mcp-common": "0.1.0",
+    "@dudamel/contracts": "0.1.0",
     "@dudamel/mcp-tool-contract": "0.1.0"
   },
   "scripts": {