@integrity-labs/agt-cli 0.28.154 → 0.28.156

package/dist/mcp/index.js

@@ -22593,7 +22593,7 @@ server.tool(
 );
 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.",
+  "List knowledge entries (ids, titles, source types, and scope) visible to this agent: both team-scoped and organization-scoped. Use before knowledge_add to check if a fact is already saved, or before knowledge_update/delete to find the target id AND its scope (you must pass the same scope to update/delete it). Returns metadata only; fetch the full content via the webapp if you need to read an entry back.",
   {},
   async () => {
     const data = await apiPost("/host/my-knowledge", {
@@ -22604,23 +22604,26 @@ server.tool(
     }
     const lines = data.items.map((k) => {
       const inactive = k.is_active ? "" : " (inactive)";
-      return `- ${k.title}${inactive} [${k.source_type}, id: ${k.id}]`;
+      return `- [${k.scope ?? "team"}] ${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.",
+  'Save a new durable fact or learning to the 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. Defaults to TEAM scope; pass scope:"org" only when the user asks for organization/company-wide knowledge (visible to every team in the org). 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"),
+    scope: external_exports.enum(["team", "org"]).optional().describe('Where to save it. "team" (default) = visible to this team only. "org" = visible to EVERY team in the organization; use ONLY when the user explicitly asks for organization-wide / company-wide knowledge. Never default to "team" when the user asked for org.'),
     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 scope = params.scope ?? "team";
     const data = await apiPost("/host/knowledge", {
       agent_id: AGT_AGENT_ID,
+      scope,
       // ENG-4538 will land a run_id column on team_knowledge; until then
       // the /host/knowledge endpoint has nowhere to stamp AGT_RUN_ID.
       add: [
@@ -22640,19 +22643,21 @@ server.tool(
         isError: true
       };
     }
+    const scopeLabel = scope === "org" ? "organization" : "team";
     return {
       content: [{
         type: "text",
-        text: `Saved "${first.title}" to team knowledge (id: ${first.id}). It will appear in future /host/refresh context.`
+        text: `Saved "${first.title}" to ${scopeLabel} knowledge (id: ${first.id}, scope: ${scope}). It will appear in future /host/refresh context once compressed.`
       }]
     };
   }
 );
 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.",
+  "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 AND its scope; you must pass the same scope the entry was listed under.",
   {
     id: external_exports.string().describe("Knowledge entry id (uuid) \u2014 from knowledge_list or knowledge_add"),
+    scope: external_exports.enum(["team", "org"]).optional().describe('Scope of the target entry as shown by knowledge_list ("team" default, "org" for organization-wide entries). Must match the entry, or the update will not find it.'),
     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")
@@ -22666,6 +22671,7 @@ server.tool(
     }
     const data = await apiPost("/host/knowledge", {
       agent_id: AGT_AGENT_ID,
+      scope: params.scope ?? "team",
       update: [
         {
           id: params.id,
@@ -22687,13 +22693,15 @@ server.tool(
 );
 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.",
+  "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. Pass the same scope the entry was listed under.",
   {
-    id: external_exports.string().describe("Knowledge entry id (uuid) to delete")
+    id: external_exports.string().describe("Knowledge entry id (uuid) to delete"),
+    scope: external_exports.enum(["team", "org"]).optional().describe('Scope of the target entry as shown by knowledge_list ("team" default, "org" for organization-wide entries). Must match the entry, or the delete will not find it.')
   },
   async (params) => {
     const data = await apiPost("/host/knowledge", {
       agent_id: AGT_AGENT_ID,
+      scope: params.scope ?? "team",
       delete: [{ id: params.id }]
     });
     if (!data.ok || data.deleted !== 1) {

package/package.json

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