@integrity-labs/agt-cli 0.14.14 → 0.14.16

package/mcp/index.js

@@ -21719,6 +21719,119 @@ server.tool(
     return { content: [{ type: "text", text: summary }] };
   }
 );
+server.tool(
+  "knowledge.list",
+  "List team knowledge entries (ids, titles, source types). Use before knowledge.add to check if a fact is already saved, or before knowledge.update/delete to find the target id. Returns metadata only \u2014 fetch the full content via the webapp if you need to read an entry back.",
+  {},
+  async () => {
+    const data = await apiPost("/host/my-knowledge", {
+      agent_id: AGT_AGENT_ID
+    });
+    if (!data.items.length) {
+      return { content: [{ type: "text", text: "No knowledge entries yet." }] };
+    }
+    const lines = data.items.map((k) => {
+      const inactive = k.is_active ? "" : " (inactive)";
+      return `- ${k.title}${inactive} [${k.source_type}, id: ${k.id}]`;
+    });
+    return { content: [{ type: "text", text: lines.join("\n") }] };
+  }
+);
+server.tool(
+  "knowledge.add",
+  "Save a new durable fact or learning to the team knowledge base. Use when the user explicitly asks you to save/remember something, or when you discover information that will be useful on future runs (e.g. a tenant id, an API key name, a company policy). Do NOT use for tasks (use kanban.add) or trivial one-off answers. Returns the new entry id so you can target it with knowledge.update / knowledge.delete.",
+  {
+    title: external_exports.string().describe("Short title summarising the entry (max 200 chars)"),
+    content: external_exports.string().describe("The knowledge content \u2014 the actual fact, learning, or reference material"),
+    source_type: external_exports.enum(["manual", "url", "upload"]).optional().describe('How the entry was sourced \u2014 default "manual" for agent-created entries'),
+    source_url: external_exports.string().optional().describe("Optional URL the content was derived from")
+  },
+  async (params) => {
+    const data = await apiPost("/host/knowledge", {
+      agent_id: AGT_AGENT_ID,
+      add: [
+        {
+          title: params.title,
+          raw_content: params.content,
+          source_type: params.source_type ?? "manual",
+          source_url: params.source_url
+        }
+      ]
+    });
+    const first = data.added_items?.[0];
+    if (!data.ok || !first) {
+      const reason = data.errors?.[0] ?? "unknown error";
+      return {
+        content: [{ type: "text", text: `Failed to save knowledge entry: ${reason}` }],
+        isError: true
+      };
+    }
+    return {
+      content: [{
+        type: "text",
+        text: `Saved "${first.title}" to team knowledge (id: ${first.id}). It will appear in future /host/refresh context.`
+      }]
+    };
+  }
+);
+server.tool(
+  "knowledge.update",
+  "Edit an existing knowledge entry by id. Use to correct a saved fact or refine its wording. Only the fields you pass are changed; others are left alone. Call knowledge.list first if you need to find the target id.",
+  {
+    id: external_exports.string().describe("Knowledge entry id (uuid) \u2014 from knowledge.list or knowledge.add"),
+    title: external_exports.string().optional().describe("New title (max 200 chars). Regenerates the slug."),
+    content: external_exports.string().optional().describe("Replacement content for the entry"),
+    is_active: external_exports.boolean().optional().describe("Set false to soft-disable without deleting")
+  },
+  async (params) => {
+    if (params.title === void 0 && params.content === void 0 && params.is_active === void 0) {
+      return {
+        content: [{ type: "text", text: "Error: knowledge.update needs at least one of title, content, or is_active." }],
+        isError: true
+      };
+    }
+    const data = await apiPost("/host/knowledge", {
+      agent_id: AGT_AGENT_ID,
+      update: [
+        {
+          id: params.id,
+          title: params.title,
+          raw_content: params.content,
+          is_active: params.is_active
+        }
+      ]
+    });
+    if (!data.ok || data.updated !== 1) {
+      const reason = data.errors?.[0] ?? "unknown error";
+      return {
+        content: [{ type: "text", text: `Failed to update knowledge entry ${params.id}: ${reason}` }],
+        isError: true
+      };
+    }
+    return { content: [{ type: "text", text: `Updated knowledge entry ${params.id}.` }] };
+  }
+);
+server.tool(
+  "knowledge.delete",
+  "Remove a knowledge entry permanently. Prefer knowledge.update with is_active=false for temporary hides; use delete only when the fact was wrong or no longer applies.",
+  {
+    id: external_exports.string().describe("Knowledge entry id (uuid) to delete")
+  },
+  async (params) => {
+    const data = await apiPost("/host/knowledge", {
+      agent_id: AGT_AGENT_ID,
+      delete: [{ id: params.id }]
+    });
+    if (!data.ok || data.deleted !== 1) {
+      const reason = data.errors?.[0] ?? "unknown error";
+      return {
+        content: [{ type: "text", text: `Failed to delete knowledge entry ${params.id}: ${reason}` }],
+        isError: true
+      };
+    }
+    return { content: [{ type: "text", text: `Deleted knowledge entry ${params.id}.` }] };
+  }
+);
 server.tool(
   "plugin.list",
   `List the plugins currently installed on this agent, with their current typed context values and a preview of any freeform overrides. Use this when the user asks "what plugins do I have?", "show me the plugins", "what is the Coding plugin configured with?", or before calling plugin.improve to see what fields exist and what they're set to.`,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@integrity-labs/agt-cli",
-  "version": "0.14.14",
+  "version": "0.14.16",
   "description": "Augmented Team CLI — agent provisioning and management",
   "type": "module",
   "engines": {