@integrity-labs/agt-cli 0.28.184 → 0.28.186

package/dist/mcp/augmented-support.js

@@ -21154,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);
@@ -21176,6 +21180,23 @@ var searchKbSchema = external_exports.object({
 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]+)*$/,
@@ -21382,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/index.js

@@ -22389,6 +22389,71 @@ server.tool(
     return { content: [{ type: "text", text }], ...isError ? { isError: true } : {} };
   }
 );
+server.tool(
+  "request_buttons",
+  'Ask a user to pick ONE option by tapping a button, then END YOUR TURN. Posts a small button card (2-4 choices) into a Slack channel; the platform delivers the tapped choice back to you later as a direct-chat message (payload.kind = "button_click", payload.value / payload.label), carrying source_channel so you reply in the original conversation. Use this for a quick one-of-N decision ("merge it?", "which environment?", "approve copy A/B/C?") when your turn can end rather than block. Buttons only COLLECT a choice; they grant no permission, and any privileged action you take in response runs under your own authority. Slack channels only for now.',
+  {
+    channel_id: external_exports.string().min(1).describe("Slack channel id (C.../G..., NOT a name) to post the buttons into. Resolve names via slack.list_channels first."),
+    thread_ts: external_exports.string().optional().describe("Optional Slack thread_ts to post inside a thread; omit to post top-level in the channel."),
+    prompt_text: external_exports.string().min(1).max(3e3).describe("The question / context shown above the buttons."),
+    options: external_exports.array(
+      external_exports.object({
+        label: external_exports.string().min(1).max(75).describe("Button text the user sees."),
+        value: external_exports.string().min(1).max(2e3).describe("Machine value returned to you on tap (payload.value).")
+      })
+    ).min(2).max(4).describe("2-4 button options. Labels and values must each be unique."),
+    request_id: external_exports.string().max(200).optional().describe("Optional correlation id you choose; it comes back on the button_click so you can match the tap. If omitted, the platform assigns one and returns it.")
+  },
+  async (params) => {
+    if (!AGT_AGENT_CODE_NAME) {
+      return {
+        content: [{ type: "text", text: "Error: AGT_AGENT_CODE_NAME not configured." }],
+        isError: true
+      };
+    }
+    let resp;
+    try {
+      resp = await apiPost("/host/request-buttons", {
+        agent_code_name: AGT_AGENT_CODE_NAME,
+        channel_id: params.channel_id,
+        ...params.thread_ts ? { thread_ts: params.thread_ts } : {},
+        prompt_text: params.prompt_text,
+        options: params.options,
+        ...params.request_id ? { request_id: params.request_id } : {}
+      });
+    } catch (err) {
+      const msg = err instanceof Error ? err.message : String(err);
+      if (/returned\s+[45]\d\d/.test(msg)) {
+        let detail = msg;
+        const jsonStart = msg.indexOf("{");
+        if (jsonStart !== -1) {
+          try {
+            const parsedErr = JSON.parse(msg.slice(jsonStart));
+            if (parsedErr.error) detail = parsedErr.error;
+          } catch {
+          }
+        }
+        return {
+          content: [{ type: "text", text: `Buttons request rejected: ${detail}` }],
+          isError: true
+        };
+      }
+      return {
+        content: [{ type: "text", text: `Could not reach the buttons service (${msg}). Tell your operator.` }],
+        isError: true
+      };
+    }
+    const rid = resp.request_id ?? resp.interaction_id ?? "(unknown)";
+    return {
+      content: [
+        {
+          type: "text",
+          text: `Posted ${params.options.length} buttons to ${params.channel_id} (request \`${rid}\`). END YOUR TURN now \u2014 the user's tap arrives later as a direct-chat message (payload.kind = "button_click", payload.value / payload.label) carrying source_channel so you reply in the original conversation. Do not wait or poll.`
+        }
+      ]
+    };
+  }
+);
 server.tool(
   "drift_report",
   "Report configuration drift detected in local agent files (CHARTER.md, TOOLS.md, etc.). Compares local file hashes against API-side versions and reports any differences.",
@@ -23311,7 +23376,10 @@ var LOCAL_TOOL_NAMES = /* @__PURE__ */ new Set([
   "request_channel_access",
   // ENG-7041 (ADR-0034): author + post a structured Slack form, await the typed
   // answer via direct-chat. Always registered; no API tool shares this name.
-  "request_form"
+  "request_form",
+  // ENG-7144 (ADR-0036): post a button card, end the turn, await the tap via
+  // direct-chat (button_click). Always registered; no API tool shares this name.
+  "request_buttons"
 ]);
 async function registerForwardedApiTools() {
   const apiTools = await discoverApiTools();

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

@@ -34,8 +34,8 @@ import {
   writeDirectChatSessionState,
   writeEgressAllowlist,
   writePersistentClaudeWrapper
-} from "./chunk-RLDZLSML.js";
-import "./chunk-K2N44EUC.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-KBZFQ7SX.js.map
+//# sourceMappingURL=persistent-session-SNLNY2VB.js.map

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

@@ -1,7 +1,7 @@
 import {
   paneLogPath
-} from "./chunk-RLDZLSML.js";
-import "./chunk-K2N44EUC.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-O4F7H7IB.js.map
+//# sourceMappingURL=responsiveness-probe-6HC3PENG.js.map

package/package.json

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