@integrity-labs/agt-cli 0.28.183 → 0.28.185

package/dist/mcp/augmented-support.js

@@ -21138,6 +21138,15 @@ var SupportClient = class _SupportClient {
   listAudit(args = {}) {
     return this.get("/host/support/audit", _SupportClient.cleanQuery(args));
   }
+  // ─────────────────────── knowledge base (ENG-7119) ───────────────────────
+  // Org-lock EXEMPT: these hit /host/kb (hostAuth, NOT org-locked) — the shared,
+  // published, org-neutral help. No argument names a scope.
+  searchKnowledgeBase(args) {
+    return this.get("/host/kb/search", _SupportClient.cleanQuery({ q: args.query, limit: args.limit }));
+  }
+  readKbArticle(args) {
+    return this.get(`/host/kb/article/${encodeURIComponent(args.slug)}`);
+  }
   // ─────────────────────── intake + writes (ENG-7000/7001) ───────────────────────
   fileSupportRequest(args) {
     return this.post("/host/support/file_support_request", args, true);
@@ -21145,6 +21154,10 @@ var SupportClient = class _SupportClient {
   fileFeatureRequest(args) {
     return this.post("/host/support/file_feature_request", args, true);
   }
+  /** Report a KB gap (redacted + deduped + classified server-side). */
+  requestKbArticle(args) {
+    return this.post("/host/support/request_kb_article", args, true);
+  }
   /** Propose creating an agent in the caller's OWN org (HITL-gated server-side). */
   createAgent(args) {
     return this.post("/host/support/create_agent", args, true);
@@ -21160,6 +21173,30 @@ var fileRequestSchema = external_exports.object({
   description: external_exports.string().min(1).describe("Full detail: what happened / what is wanted, and any reproduction steps."),
   provider: external_exports.string().optional().describe('Optional provider/service name when asking for a new integration (e.g. "notion").')
 });
+var searchKbSchema = external_exports.object({
+  query: external_exports.string().trim().min(1).describe('What to look up in the knowledge base (e.g. "agent keeps restarting", "connect Slack").'),
+  limit: external_exports.number().int().positive().optional().describe("Max results to return (page size, clamped server-side).")
+});
+var readKbSchema = external_exports.object({
+  slug: external_exports.string().trim().min(1).describe("The kebab-case article slug returned by search_knowledge_base.")
+});
+var requestKbArticleSchema = external_exports.object({
+  question: external_exports.string().trim().min(1).describe("The user question the knowledge base could not answer. Plain text; do NOT paste the conversation."),
+  reason_codes: external_exports.array(
+    external_exports.enum([
+      "no_results",
+      "low_relevance",
+      "partial_answer",
+      "outdated",
+      "ambiguous_question",
+      "out_of_scope"
+    ])
+  ).optional().describe("Why the KB fell short (one or more): no_results, low_relevance, partial_answer, outdated, ambiguous_question, out_of_scope."),
+  tsquery: external_exports.string().trim().optional().describe("The search terms you actually queried (so curation can see what was tried)."),
+  rejected_slugs: external_exports.array(
+    external_exports.string().trim().regex(/^[a-z0-9]+(?:-[a-z0-9]+)*$/, "must be a kebab-case article slug")
+  ).optional().describe("Slugs (kebab-case) of articles you looked at but that did not answer the question.")
+});
 var createAgentSchema = external_exports.object({
   code_name: external_exports.string().regex(
     /^[a-z0-9]+(?:-[a-z0-9]+)*$/,
@@ -21318,6 +21355,30 @@ server.tool(
     }
   }
 );
+server.tool(
+  "search_knowledge_base",
+  "Search the Augmented knowledge base for help on a question BEFORE answering from memory or filing a request \u2014 it is the curated, up-to-date source of answers (how-tos, common fixes, FAQs). Returns ranked hits with { slug, title, tags, snippet }; call read_kb_article with a slug to get the full article. The KB is shared platform help, the same for every organization (it holds nothing org-specific), so this takes no scope. Pass { query, limit? }.",
+  searchKbSchema.shape,
+  async (args) => {
+    try {
+      return ok(await client.searchKnowledgeBase(args));
+    } catch (err) {
+      return fail(err);
+    }
+  }
+);
+server.tool(
+  "read_kb_article",
+  "Fetch the full published knowledge-base article for a slug returned by search_knowledge_base. Returns { article: { slug, title, body_md, tags, published_at } } or a 404 if no published article has that slug. Use the body to answer the user. Pass { slug }.",
+  readKbSchema.shape,
+  async (args) => {
+    try {
+      return ok(await client.readKbArticle(args));
+    } catch (err) {
+      return fail(err);
+    }
+  }
+);
 server.tool(
   "support_file_support_request",
   "File a BUG report to Augmented Team support when you hit a platform problem you cannot resolve from your own org (it goes to the Augmented Team support queue, not your org). Pass { title, description }. Returns { ok, status } - relay the outcome to the user.",
@@ -21342,6 +21403,18 @@ server.tool(
     }
   }
 );
+server.tool(
+  "request_kb_article",
+  'Report a knowledge-base GAP after search_knowledge_base did not answer the user. Call this at most once per distinct question, AFTER searching \u2014 the server may tell you the question is already covered (status:"answerable" with a slug to read instead), needs clarifying (status:"needs_clarification" with a question to ask the user), was filed (status:"filed"), matched a known gap (status:"duplicate"), or that your org hit its daily gap limit (status:"rate_limited" with retry_after_seconds \u2014 stop filing and tell the user to try later). Provide structured context, NOT a transcript: { question, reason_codes?, tsquery? (the terms you searched), rejected_slugs? (articles that did not fit) }. Carries no scope \u2014 your org is server-derived and never stored in clear. Returns { ok, status, message }.',
+  requestKbArticleSchema.shape,
+  async (args) => {
+    try {
+      return ok(await client.requestKbArticle(args));
+    } catch (err) {
+      return fail(err);
+    }
+  }
+);
 server.tool(
   "support_create_agent",
   'PROPOSE creating a new agent in YOUR organization. This does NOT create the agent directly - it files a request that a human owner approves via a server-rendered diff in Slack; the agent is created (as a draft) only after approval. Use it to set up a new agent a user asked for. Returns a structured envelope: `status:"proposed"` (with request_id + expires_at - tell the user it was sent for approval and when it expires), `status:"feature_disabled"` (self-remediation writes are off for this org - tell the user to ask their operator to enable them), `status:"no_approver"` (no approval channel is configured - relay the setup hint), or `status:"rate_limited"` (too many pending - relay retry_after_seconds). Org/team are set server-side from your host - you cannot create an agent in another org. Pass { code_name (kebab-case), display_name, description?, role?, host_id?, reason? }.',

package/dist/mcp/telegram-channel.js

@@ -19631,6 +19631,10 @@ async function handleCallbackQuery(cb) {
     });
     return;
   }
+  if (decoded.token.startsWith(PERF_REVIEW_TOKEN_PREFIX)) {
+    await handlePerfReviewTap(cb, decoded.callbackId, decoded.token);
+    return;
+  }
   await ackCallbackQuery(cb.id, "Got it").catch(() => {
   });
   const apiCallRuntime = await Promise.resolve().then(() => (init_ask_user_runtime(), ask_user_runtime_exports));
@@ -19696,6 +19700,81 @@ async function handleCallbackQuery(cb) {
     void confirmationLabel;
   }
 }
+var PERF_REVIEW_TOKEN_PREFIX = "pr_";
+var PERF_REVIEW_COMMENT_TOKEN = "pr_comment";
+var PERF_REVIEW_REF_RE = /\[review:([0-9a-f-]{36})\]/;
+function perfReviewRefMarker(reviewId) {
+  return `[review:${reviewId}]`;
+}
+async function handlePerfReviewTap(cb, reviewId, token) {
+  if (token === PERF_REVIEW_COMMENT_TOKEN) {
+    await ackCallbackQuery(cb.id, "Reply with your feedback").catch(() => {
+    });
+    if (cb.message) {
+      try {
+        const resp = await telegramApiCall(
+          "sendMessage",
+          {
+            chat_id: cb.message.chat.id,
+            text: `Reply to this message with any feedback for me.
+
+${perfReviewRefMarker(reviewId)}`,
+            reply_markup: { force_reply: true, input_field_placeholder: "Your feedback\u2026" }
+          },
+          5e3
+        );
+        if (!resp.ok) {
+          process.stderr.write(
+            `telegram-channel(${AGENT_CODE_NAME}): perf-review comment prompt non-ok (review_id=${reviewId}): ${resp.description ?? "unknown"}
+`
+          );
+        }
+      } catch (err) {
+        process.stderr.write(
+          `telegram-channel(${AGENT_CODE_NAME}): perf-review comment prompt threw (review_id=${reviewId}): ${err.message}
+`
+        );
+      }
+    }
+    return;
+  }
+  const ok = await postPerfReviewResolve(reviewId, token, String(cb.from.id));
+  await ackCallbackQuery(cb.id, ok ? "Recorded \u2713" : "Could not record your rating").catch(() => {
+  });
+}
+async function postPerfReviewResolve(reviewId, token, respondedByUser, comment) {
+  if (!channelRequestInputAvailable()) return false;
+  const apiCallRuntime = await Promise.resolve().then(() => (init_ask_user_runtime(), ask_user_runtime_exports));
+  const cfg = {
+    apiHost: AGT_HOST,
+    apiKey: AGT_API_KEY,
+    agentId: AGT_AGENT_ID
+  };
+  try {
+    const res = await apiCallRuntime.apiCall(cfg, "POST", "/host/perf-review/resolve", {
+      agent_id: cfg.agentId,
+      review_id: reviewId,
+      token,
+      ...comment !== void 0 ? { comment } : {},
+      responded_by_user: respondedByUser
+    });
+    const j = await res.json().catch(() => ({}));
+    if (!res.ok || !j.ok) {
+      process.stderr.write(
+        `telegram-channel(${AGENT_CODE_NAME}): /host/perf-review/resolve non-ok (review_id=${reviewId}, http=${res.status}, reason=${j.reason ?? "unknown"})
+`
+      );
+      return false;
+    }
+    return j.recorded === true;
+  } catch (err) {
+    process.stderr.write(
+      `telegram-channel(${AGENT_CODE_NAME}): /host/perf-review/resolve threw (review_id=${reviewId}): ${err.message}
+`
+    );
+    return false;
+  }
+}
 async function ackCallbackQuery(callbackQueryId, text) {
   try {
     const resp = await telegramApiCall(
@@ -19923,6 +20002,16 @@ async function pollLoop() {
         }
         const msg = update.message;
         if (!msg) continue;
+        const perfReplyRef = typeof msg.text === "string" && msg.text.trim().length > 0 && msg.reply_to_message?.from?.is_bot === true && msg.reply_to_message?.text ? PERF_REVIEW_REF_RE.exec(msg.reply_to_message.text) : null;
+        if (perfReplyRef && msg.from?.id != null) {
+          await postPerfReviewResolve(
+            perfReplyRef[1],
+            PERF_REVIEW_COMMENT_TOKEN,
+            String(msg.from.id),
+            msg.text.trim()
+          );
+          continue;
+        }
         const classifiedAttachments = classifyTelegramAttachments(msg);
         const content = typeof msg.text === "string" && msg.text.length > 0 ? msg.text : typeof msg.caption === "string" && msg.caption.length > 0 ? msg.caption : "";
         if (content.length === 0 && classifiedAttachments.length === 0) continue;

package/dist/{persistent-session-2TNWAAKT.js → persistent-session-SNLNY2VB.js}

@@ -34,8 +34,8 @@ import {
   writeDirectChatSessionState,
   writeEgressAllowlist,
   writePersistentClaudeWrapper
-} from "./chunk-KE4NYCEP.js";
-import "./chunk-IDAJRLPK.js";
+} from "./chunk-ORO4YLTN.js";
+import "./chunk-ERHHYBVS.js";
 import "./chunk-XWVM4KPK.js";
 export {
   EGRESS_BASELINE_DOMAINS,
@@ -74,4 +74,4 @@ export {
   writeEgressAllowlist,
   writePersistentClaudeWrapper
 };
-//# sourceMappingURL=persistent-session-2TNWAAKT.js.map
+//# sourceMappingURL=persistent-session-SNLNY2VB.js.map

package/dist/{responsiveness-probe-VCFRALHX.js → responsiveness-probe-6HC3PENG.js}

@@ -1,7 +1,7 @@
 import {
   paneLogPath
-} from "./chunk-KE4NYCEP.js";
-import "./chunk-IDAJRLPK.js";
+} from "./chunk-ORO4YLTN.js";
+import "./chunk-ERHHYBVS.js";
 import "./chunk-XWVM4KPK.js";
 
 // src/lib/responsiveness-probe.ts
@@ -304,4 +304,4 @@ export {
   readAndResetChannelDeflections,
   readAndResetChannelLaneClassifications
 };
-//# sourceMappingURL=responsiveness-probe-VCFRALHX.js.map
+//# sourceMappingURL=responsiveness-probe-6HC3PENG.js.map

package/package.json

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