@thinkingai/ae-cli 6.1.14 → 6.1.17

package/dist/{te-kb-OIH3T6CS.js → te-kb-SQCLHG6X.js}

@@ -1,62 +1,23 @@
 import {
   kbApi,
   kbUpload
-} from "./chunk-AFXA7BRK.js";
-import "./chunk-S5NTSDBS.js";
-import "./chunk-ZQKDZXDO.js";
-import "./chunk-3FY3RJ26.js";
-import "./chunk-AXDXJTPC.js";
-import "./chunk-JHENBQ5B.js";
-
-// src/commands/te-kb/query.ts
-var API_PATH = "/agent/api/external/knowledge-bases/query";
-function buildBody(ctx) {
-  const body = {
-    query: ctx.str("query")
-  };
-  const sources = ctx.json("sources");
-  if (sources) body.sources = sources;
-  const topK = ctx.num("top-k");
-  if (topK) body.topK = topK;
-  const locale = ctx.str("locale");
-  if (locale) body.locale = locale;
-  return body;
-}
-var query = {
-  service: "kb",
-  command: "+query",
-  description: "Query knowledge bases via POST /agent/api/external/knowledge-bases/query. Returns ranked passages for a natural-language question.",
-  flags: [
-    {
-      name: "query",
-      type: "string",
-      required: true,
-      alias: "q",
-      desc: "Natural language question to query against the knowledge bases"
-    },
-    {
-      name: "sources",
-      type: "json",
-      required: false,
-      desc: 'Optional JSON array of knowledge base refs to scope the query, e.g. [{"scope":"company","name":"engineering-handbook"}]. Omit to search all accessible knowledge bases.'
-    },
-    { name: "top-k", type: "number", required: false, desc: "Max number of hits to return (1-10000, default 10)" },
-    { name: "locale", type: "string", required: false, desc: "Optional locale: zh | en | ja | ko" }
-  ],
-  risk: "read",
-  dryRun: (ctx) => ({
-    method: "POST",
-    url: `${ctx.host().replace(/\/$/, "")}${API_PATH}`,
-    body: buildBody(ctx)
-  }),
-  execute: async (ctx) => kbApi(ctx, "POST", API_PATH, {}, buildBody(ctx))
-};
+} from "./chunk-4KVPKXFX.js";
+import {
+  printError
+} from "./chunk-GT46FPXN.js";
+import "./chunk-4SGZG4XY.js";
+import "./chunk-ZZUOD757.js";
+import {
+  PermissionError
+} from "./chunk-UW5UN47B.js";
+import "./chunk-LYVNONC4.js";
+import "./chunk-QGM4M3NI.js";
 
 // src/commands/te-kb/add.ts
 import { promises as fs } from "fs";
 import * as path from "path";
 import TurndownService from "turndown";
-var API_PATH2 = "/agent/api/external/knowledge-bases/sources/upload";
+var API_PATH = "/agent/api/external/knowledge-bases/sources/upload";
 var SUPPORTED_EXTENSIONS = /* @__PURE__ */ new Set([
   ".md",
   ".markdown",
@@ -267,7 +228,7 @@ var add = {
     const items = normalizeFilesInput(ctx.json("files"));
     return {
       method: "POST",
-      url: `${ctx.host().replace(/\/$/, "")}${API_PATH2}`,
+      url: `${ctx.host().replace(/\/$/, "")}${API_PATH}`,
       body: {
         name: ctx.str("name"),
         files: items.map((item) => ({ value: item, type: classifyInput(item) })),
@@ -279,7 +240,7 @@ var add = {
     const name = ctx.str("name");
     const files = await collectFiles(ctx);
     const form = buildForm(name, files);
-    const result = await kbUpload(ctx, API_PATH2, form);
+    const result = await kbUpload(ctx, API_PATH, form);
     return {
       uploaded: files.map((f) => ({ filename: f.filename, origin: f.origin, source: f.source })),
       result
@@ -288,7 +249,7 @@ var add = {
 };
 
 // src/commands/te-kb/compile.ts
-var API_PATH3 = "/agent/api/external/knowledge-bases/compile";
+var API_PATH2 = "/agent/api/external/knowledge-bases/compile";
 var VALID_MODES = /* @__PURE__ */ new Set(["incremental", "full"]);
 function getMode(ctx) {
   const mode = ctx.str("mode") || "incremental";
@@ -297,7 +258,7 @@ function getMode(ctx) {
   }
   return mode;
 }
-function buildBody2(ctx) {
+function buildBody(ctx) {
   return {
     name: ctx.str("name"),
     mode: getMode(ctx)
@@ -317,15 +278,15 @@ var compile = {
   },
   dryRun: (ctx) => ({
     method: "POST",
-    url: `${ctx.host().replace(/\/$/, "")}${API_PATH3}`,
-    body: buildBody2(ctx)
+    url: `${ctx.host().replace(/\/$/, "")}${API_PATH2}`,
+    body: buildBody(ctx)
   }),
-  execute: async (ctx) => kbApi(ctx, "POST", API_PATH3, {}, buildBody2(ctx))
+  execute: async (ctx) => kbApi(ctx, "POST", API_PATH2, {}, buildBody(ctx))
 };
 
 // src/commands/te-kb/remove.ts
-var API_PATH4 = "/agent/api/external/knowledge-bases";
-function buildBody3(ctx) {
+var API_PATH3 = "/agent/api/external/knowledge-bases";
+function buildBody2(ctx) {
   return { name: ctx.str("name") };
 }
 var remove = {
@@ -338,14 +299,14 @@ var remove = {
   risk: "high-risk-write",
   dryRun: (ctx) => ({
     method: "DELETE",
-    url: `${ctx.host().replace(/\/$/, "")}${API_PATH4}`,
-    body: buildBody3(ctx)
+    url: `${ctx.host().replace(/\/$/, "")}${API_PATH3}`,
+    body: buildBody2(ctx)
   }),
-  execute: async (ctx) => kbApi(ctx, "DELETE", API_PATH4, {}, buildBody3(ctx))
+  execute: async (ctx) => kbApi(ctx, "DELETE", API_PATH3, {}, buildBody2(ctx))
 };
 
 // src/commands/te-kb/create.ts
-var API_PATH5 = "/agent/api/external/knowledge-bases/create";
+var API_PATH4 = "/agent/api/external/knowledge-bases/create";
 var VALID_SCOPES = /* @__PURE__ */ new Set(["personal", "company"]);
 function getScope(ctx) {
   const scope = ctx.str("scope") || "company";
@@ -372,7 +333,7 @@ function normalizeTags(raw) {
   }
   return tags;
 }
-function buildBody4(ctx) {
+function buildBody3(ctx) {
   const body = {
     scope: getScope(ctx),
     name: ctx.str("name")
@@ -406,15 +367,15 @@ var create = {
   },
   dryRun: (ctx) => ({
     method: "POST",
-    url: `${ctx.host().replace(/\/$/, "")}${API_PATH5}`,
-    body: buildBody4(ctx)
+    url: `${ctx.host().replace(/\/$/, "")}${API_PATH4}`,
+    body: buildBody3(ctx)
   }),
-  execute: async (ctx) => kbApi(ctx, "POST", API_PATH5, {}, buildBody4(ctx))
+  execute: async (ctx) => kbApi(ctx, "POST", API_PATH4, {}, buildBody3(ctx))
 };
 
 // src/commands/te-kb/rm-source.ts
-var API_PATH6 = "/agent/api/external/knowledge-bases/sources";
-function buildBody5(ctx) {
+var API_PATH5 = "/agent/api/external/knowledge-bases/sources";
+function buildBody4(ctx) {
   return {
     name: ctx.str("name"),
     displayName: ctx.str("display-name")
@@ -431,15 +392,15 @@ var rmSource = {
   risk: "write",
   dryRun: (ctx) => ({
     method: "DELETE",
-    url: `${ctx.host().replace(/\/$/, "")}${API_PATH6}`,
-    body: buildBody5(ctx)
+    url: `${ctx.host().replace(/\/$/, "")}${API_PATH5}`,
+    body: buildBody4(ctx)
   }),
-  execute: async (ctx) => kbApi(ctx, "DELETE", API_PATH6, {}, buildBody5(ctx))
+  execute: async (ctx) => kbApi(ctx, "DELETE", API_PATH5, {}, buildBody4(ctx))
 };
 
 // src/commands/te-kb/schema.ts
-var API_PATH7 = "/agent/api/external/knowledge-bases/schema";
-function buildBody6(ctx) {
+var API_PATH6 = "/agent/api/external/knowledge-bases/schema";
+function buildBody5(ctx) {
   const body = {
     name: ctx.str("name")
   };
@@ -460,15 +421,15 @@ var schema = {
   risk: "write",
   dryRun: (ctx) => ({
     method: "POST",
-    url: `${ctx.host().replace(/\/$/, "")}${API_PATH7}`,
-    body: buildBody6(ctx)
+    url: `${ctx.host().replace(/\/$/, "")}${API_PATH6}`,
+    body: buildBody5(ctx)
   }),
-  execute: async (ctx) => kbApi(ctx, "POST", API_PATH7, {}, buildBody6(ctx))
+  execute: async (ctx) => kbApi(ctx, "POST", API_PATH6, {}, buildBody5(ctx))
 };
 
 // src/commands/te-kb/status.ts
-var API_PATH8 = "/agent/api/external/knowledge-bases/status";
-function buildBody7(ctx) {
+var API_PATH7 = "/agent/api/external/knowledge-bases/status";
+function buildBody6(ctx) {
   return {
     name: ctx.str("name")
   };
@@ -483,15 +444,15 @@ var status = {
   risk: "read",
   dryRun: (ctx) => ({
     method: "POST",
-    url: `${ctx.host().replace(/\/$/, "")}${API_PATH8}`,
-    body: buildBody7(ctx)
+    url: `${ctx.host().replace(/\/$/, "")}${API_PATH7}`,
+    body: buildBody6(ctx)
   }),
-  execute: async (ctx) => kbApi(ctx, "POST", API_PATH8, {}, buildBody7(ctx))
+  execute: async (ctx) => kbApi(ctx, "POST", API_PATH7, {}, buildBody6(ctx))
 };
 
 // src/commands/te-kb/kb-index.ts
-var API_PATH9 = "/agent/api/external/knowledge-bases/index";
-function buildBody8(ctx) {
+var API_PATH8 = "/agent/api/external/knowledge-bases/index";
+function buildBody7(ctx) {
   const body = {};
   const sources = ctx.json("sources");
   if (sources) body.sources = sources;
@@ -515,19 +476,30 @@ var kbIndex = {
   risk: "read",
   dryRun: (ctx) => ({
     method: "POST",
-    url: `${ctx.host().replace(/\/$/, "")}${API_PATH9}`,
-    body: buildBody8(ctx)
+    url: `${ctx.host().replace(/\/$/, "")}${API_PATH8}`,
+    body: buildBody7(ctx)
   }),
-  execute: async (ctx) => kbApi(ctx, "POST", API_PATH9, {}, buildBody8(ctx))
+  execute: async (ctx) => kbApi(ctx, "POST", API_PATH8, {}, buildBody7(ctx))
 };
 
 // src/commands/te-kb/kb-list.ts
-var API_PATH10 = "/agent/api/external/knowledge-bases/list";
+var API_PATH9 = "/agent/api/external/knowledge-bases/list";
 var DEFAULT_BUILD_STATUS = "compiled";
+var VALID_BUILD_STATUSES = ["idle", "pending", "compiling", "compiled", "failed"];
 function getBuildStatus(ctx) {
   return ctx.str("build-status") || DEFAULT_BUILD_STATUS;
 }
-function buildBody9(ctx) {
+function validateBuildStatus(ctx) {
+  const value = ctx.str("build-status");
+  if (value && !VALID_BUILD_STATUSES.includes(value)) {
+    printError(
+      "validation",
+      `Invalid --build-status: ${value}. Valid values: ${VALID_BUILD_STATUSES.join(" | ")} (omit to default to ${DEFAULT_BUILD_STATUS}).`
+    );
+    process.exit(1);
+  }
+}
+function buildBody8(ctx) {
   const body = {
     buildStatus: getBuildStatus(ctx)
   };
@@ -545,27 +517,30 @@ var kbList = {
       type: "string",
       required: false,
       default: DEFAULT_BUILD_STATUS,
-      desc: "Filter by knowledge base build status (default: compiled)"
+      desc: `Filter by knowledge base build status: ${VALID_BUILD_STATUSES.join(" | ")} (default: ${DEFAULT_BUILD_STATUS} when omitted)`
     },
     { name: "locale", type: "string", required: false, desc: "Optional locale: zh | en | ja | ko" }
   ],
   risk: "read",
+  validate: (ctx) => {
+    validateBuildStatus(ctx);
+  },
   dryRun: (ctx) => ({
     method: "POST",
-    url: `${ctx.host().replace(/\/$/, "")}${API_PATH10}`,
-    body: buildBody9(ctx)
+    url: `${ctx.host().replace(/\/$/, "")}${API_PATH9}`,
+    body: buildBody8(ctx)
   }),
-  execute: async (ctx) => kbApi(ctx, "POST", API_PATH10, {}, buildBody9(ctx))
+  execute: async (ctx) => kbApi(ctx, "POST", API_PATH9, {}, buildBody8(ctx))
 };
 
 // src/commands/te-kb/kb-grep.ts
-var API_PATH11 = "/agent/api/external/knowledge-bases/grep";
-function buildBody10(ctx) {
+var API_PATH10 = "/agent/api/external/knowledge-bases/grep";
+function buildBody9(ctx) {
   const body = {
-    query: ctx.str("query")
+    query: ctx.str("query"),
+    sources: ctx.json("sources"),
+    paths: ctx.json("paths")
   };
-  const sources = ctx.json("sources");
-  if (sources) body.sources = sources;
   const topK = ctx.num("top-k");
   if (topK) body.topK = topK;
   const locale = ctx.str("locale");
@@ -575,7 +550,7 @@ function buildBody10(ctx) {
 var kbGrep = {
   service: "kb",
   command: "+grep",
-  description: "Keyword-search knowledge base pages via POST /agent/api/external/knowledge-bases/grep. Returns matched lines with path, line number, breadcrumb and context snippet. Use +read to open a page returned here.",
+  description: "Keyword-search knowledge base pages via POST /agent/api/external/knowledge-bases/grep. Returns matched lines with path, line number, breadcrumb, context snippet, and the section line range (sectionStartLine/sectionEndLine) of each hit. Copy --paths from +index (wiki pages or subdirectories). Use +read with the hit range to open the section.",
   flags: [
     {
       name: "query",
@@ -587,24 +562,30 @@ var kbGrep = {
     {
       name: "sources",
       type: "json",
-      required: false,
-      desc: 'Optional JSON array of knowledge base refs to scope the search, e.g. [{"scope":"company","name":"engineering-handbook"}]. Omit to search all accessible knowledge bases.'
+      required: true,
+      desc: 'JSON array of knowledge base refs, e.g. [{"scope":"company","name":"engineering-handbook"}]'
     },
-    { name: "top-k", type: "number", required: false, desc: "Max number of hits to return (1-10000, default 10)" },
+    {
+      name: "paths",
+      type: "json",
+      required: true,
+      desc: 'JSON array of wiki pages or subdirectories copied from +index, e.g. ["wiki/sandbox.md"] or ["wiki/guides"]'
+    },
+    { name: "top-k", type: "number", required: false, desc: "Max number of hits to return (1-50, default 10)" },
     { name: "locale", type: "string", required: false, desc: "Optional locale: zh | en | ja | ko" }
   ],
   risk: "read",
   dryRun: (ctx) => ({
     method: "POST",
-    url: `${ctx.host().replace(/\/$/, "")}${API_PATH11}`,
-    body: buildBody10(ctx)
+    url: `${ctx.host().replace(/\/$/, "")}${API_PATH10}`,
+    body: buildBody9(ctx)
   }),
-  execute: async (ctx) => kbApi(ctx, "POST", API_PATH11, {}, buildBody10(ctx))
+  execute: async (ctx) => kbApi(ctx, "POST", API_PATH10, {}, buildBody9(ctx))
 };
 
 // src/commands/te-kb/kb-read.ts
-var API_PATH12 = "/agent/api/external/knowledge-bases/read";
-function buildBody11(ctx) {
+var API_PATH11 = "/agent/api/external/knowledge-bases/read";
+function buildBody10(ctx) {
   const body = {
     source: ctx.json("source"),
     path: ctx.str("path")
@@ -613,6 +594,7 @@ function buildBody11(ctx) {
   if (offset) body.offset = offset;
   const limit = ctx.num("limit");
   if (limit) body.limit = limit;
+  if (ctx.bool("outline")) body.outline = true;
   const locale = ctx.str("locale");
   if (locale) body.locale = locale;
   return body;
@@ -620,7 +602,7 @@ function buildBody11(ctx) {
 var kbRead = {
   service: "kb",
   command: "+read",
-  description: "Read a full knowledge base page (or a line window) via POST /agent/api/external/knowledge-bases/read. Use after +index / +grep locate a candidate page.",
+  description: "Read a full knowledge base page (or a line window) via POST /agent/api/external/knowledge-bases/read. Use after +index / +grep locate a candidate page. Pass --outline to get only the page heading tree (no content) and pick a section to read.",
   flags: [
     {
       name: "source",
@@ -636,19 +618,90 @@ var kbRead = {
     },
     { name: "offset", type: "number", required: false, desc: "Start line (1-based). Omit to read from the beginning." },
     { name: "limit", type: "number", required: false, desc: "Max number of lines to return (1-10000)." },
+    {
+      name: "outline",
+      type: "boolean",
+      required: false,
+      desc: "Return only the page outline (headings with line numbers), no content. Use it to decide which section to read on long pages."
+    },
     { name: "locale", type: "string", required: false, desc: "Optional locale: zh | en | ja | ko" }
   ],
   risk: "read",
   dryRun: (ctx) => ({
     method: "POST",
-    url: `${ctx.host().replace(/\/$/, "")}${API_PATH12}`,
-    body: buildBody11(ctx)
+    url: `${ctx.host().replace(/\/$/, "")}${API_PATH11}`,
+    body: buildBody10(ctx)
   }),
-  execute: async (ctx) => kbApi(ctx, "POST", API_PATH12, {}, buildBody11(ctx))
+  execute: async (ctx) => kbApi(ctx, "POST", API_PATH11, {}, buildBody10(ctx))
 };
 
+// src/commands/te-kb/ask-shared.ts
+var ASK_API_PATH = "/agent/api/external/knowledge-bases/ask";
+var ASK_POLL_INTERVAL_MS = 5e3;
+var ASK_POLL_TIMEOUT_MS = 10 * 60 * 1e3;
+var ASK_MAX_TRANSIENT_POLL_FAILURES = 3;
+function isTransientAskPollError(error) {
+  if (error instanceof PermissionError) return false;
+  if (error instanceof TypeError) return true;
+  if (!(error instanceof Error)) return false;
+  if (/KB MCP token auth failed|unauthorized|Invalid access token/i.test(error.message)) {
+    return false;
+  }
+  return /fetch|network|socket|ECONNRESET|ETIMEDOUT|EAI_AGAIN|ENOTFOUND|timeout/i.test(
+    error.message
+  );
+}
+async function pollUntilSettled(getStatus, executionId, options = {}) {
+  const intervalMs = options.intervalMs ?? ASK_POLL_INTERVAL_MS;
+  const timeoutMs = options.timeoutMs ?? ASK_POLL_TIMEOUT_MS;
+  const maxTransientFailures = options.maxTransientFailures ?? ASK_MAX_TRANSIENT_POLL_FAILURES;
+  const now = options.now ?? Date.now;
+  const sleep = options.sleep ?? ((ms) => new Promise((resolve2) => setTimeout(resolve2, ms)));
+  const startTime = now();
+  let transientFailures = 0;
+  while (true) {
+    const elapsed = now() - startTime;
+    if (elapsed > timeoutMs) {
+      throw new Error(
+        `Ask execution timeout after ${Math.floor(elapsed / 1e3)} seconds (executionId: ${executionId})`
+      );
+    }
+    let response;
+    try {
+      response = await getStatus(executionId);
+      transientFailures = 0;
+    } catch (err) {
+      if (!isTransientAskPollError(err) || ++transientFailures >= maxTransientFailures) {
+        throw err;
+      }
+      await sleep(intervalMs);
+      continue;
+    }
+    if (response.status !== "running") {
+      return response;
+    }
+    await sleep(intervalMs);
+  }
+}
+function transformCompletedResponse(response) {
+  const result = {
+    executionId: response.executionId,
+    answer: response.answer ?? "",
+    sources: response.sources ?? []
+  };
+  if (response.modelId !== void 0) result.modelId = response.modelId;
+  if (response.modelUsage !== void 0) result.modelUsage = response.modelUsage;
+  if (response.toolCallCount !== void 0) result.toolCallCount = response.toolCallCount;
+  if (response.maxTurns !== void 0) result.maxTurns = response.maxTurns;
+  return result;
+}
+function buildFailedMessage(response) {
+  const type = response.error?.type || "unknown";
+  const message = response.error?.message || "Ask execution failed";
+  return `[${type}] ${message} (executionId: ${response.executionId})`;
+}
+
 // src/commands/te-kb/ask.ts
-var API_PATH13 = "/agent/api/external/knowledge-bases/ask";
 var VALID_LOCALES = /* @__PURE__ */ new Set(["zh", "en", "ja", "ko"]);
 var MIN_QUESTION_LEN = 1;
 var MAX_QUESTION_LEN = 2e3;
@@ -674,7 +727,7 @@ function validateMaxTurns(maxTurns) {
     );
   }
 }
-function buildBody12(ctx) {
+function buildBody11(ctx) {
   const body = {
     question: ctx.str("question")
   };
@@ -691,7 +744,7 @@ function buildBody12(ctx) {
 var ask = {
   service: "kb",
   command: "+ask",
-  description: "Ask knowledge bases via LLM-powered retrieval (POST /agent/api/external/knowledge-bases/ask). Consumes platform tokens. Prefer +index -> +grep -> +read for deterministic, token-free lookup.",
+  description: "Ask knowledge bases via LLM-powered retrieval (POST /agent/api/external/knowledge-bases/ask). Consumes platform tokens. Prefer +index -> +grep -> +read for deterministic, token-free lookup. By default, polls for completion; use --no-wait to return immediately with executionId.",
   flags: [
     {
       name: "question",
@@ -718,7 +771,13 @@ var ask = {
       required: false,
       desc: "Optional agent turn limit (1-100, default 50 on server when omitted)."
     },
-    { name: "locale", type: "string", required: false, desc: "Optional locale: zh | en | ja | ko" }
+    { name: "locale", type: "string", required: false, desc: "Optional locale: zh | en | ja | ko" },
+    {
+      name: "no-wait",
+      type: "boolean",
+      required: false,
+      desc: "Return immediately after submission with executionId, without polling for completion."
+    }
   ],
   risk: "read",
   validate: (ctx) => {
@@ -728,20 +787,85 @@ var ask = {
   },
   dryRun: (ctx) => ({
     method: "POST",
-    url: `${ctx.host().replace(/\/$/, "")}${API_PATH13}`,
-    body: buildBody12(ctx)
+    url: `${ctx.host().replace(/\/$/, "")}${ASK_API_PATH}`,
+    body: buildBody11(ctx)
+  }),
+  execute: async (ctx) => {
+    const noWait = ctx.bool("no-wait");
+    const submitResponse = await kbApi(ctx, "POST", ASK_API_PATH, {}, buildBody11(ctx));
+    if (!submitResponse.executionId) {
+      throw new Error("Invalid submit response: missing executionId");
+    }
+    const executionId = submitResponse.executionId;
+    if (noWait) {
+      return {
+        executionId,
+        status: submitResponse.status
+      };
+    }
+    const finalResponse = await pollUntilSettled(
+      (id) => kbApi(ctx, "GET", ASK_API_PATH, { executionId: id }),
+      executionId
+    );
+    if (finalResponse.status === "completed") {
+      return transformCompletedResponse(finalResponse);
+    }
+    if (finalResponse.status === "failed") {
+      throw new Error(buildFailedMessage(finalResponse));
+    }
+    throw new Error(`Unexpected execution status: ${finalResponse.status}`);
+  }
+};
+
+// src/commands/te-kb/ask-status.ts
+var MAX_EXECUTION_ID_LEN = 64;
+function executionIdFrom(ctx) {
+  return ctx.str("execution-id").trim();
+}
+var askStatus = {
+  service: "kb",
+  command: "+ask-status",
+  description: "Query the status of an in-progress or completed knowledge base ask execution (GET /agent/api/external/knowledge-bases/ask?executionId=<id>). Does not poll; returns the current state.",
+  flags: [
+    {
+      name: "execution-id",
+      type: "string",
+      required: true,
+      minLength: 1,
+      maxLength: MAX_EXECUTION_ID_LEN,
+      desc: "The execution ID returned by kb +ask submission."
+    }
+  ],
+  risk: "read",
+  validate: (ctx) => {
+    const executionId = executionIdFrom(ctx);
+    if (!executionId) {
+      throw new Error("Invalid --execution-id: must be non-empty.");
+    }
+    if (executionId.length > MAX_EXECUTION_ID_LEN) {
+      throw new Error(
+        `Invalid --execution-id length: ${executionId.length}. Must be at most ${MAX_EXECUTION_ID_LEN} characters.`
+      );
+    }
+  },
+  dryRun: (ctx) => ({
+    method: "GET",
+    url: `${ctx.host().replace(/\/$/, "")}${ASK_API_PATH}?executionId=${encodeURIComponent(executionIdFrom(ctx))}`
   }),
-  execute: async (ctx) => kbApi(ctx, "POST", API_PATH13, {}, buildBody12(ctx))
+  execute: async (ctx) => {
+    const executionId = executionIdFrom(ctx);
+    return await kbApi(ctx, "GET", ASK_API_PATH, { executionId });
+  }
 };
 
 // src/commands/te-kb/url.ts
-var API_PATH14 = "/agent/api/external/knowledge-bases/sources/url";
+var API_PATH12 = "/agent/api/external/knowledge-bases/sources/url";
 function validateUrl(url2) {
   if (!/^https?:\/\//i.test(url2)) {
     throw new Error(`Invalid --url: ${url2}. Must be an http(s) URL`);
   }
 }
-function buildBody13(ctx) {
+function buildBody12(ctx) {
   const body = {
     name: ctx.str("name"),
     url: ctx.str("url")
@@ -768,16 +892,16 @@ var url = {
   },
   dryRun: (ctx) => ({
     method: "POST",
-    url: `${ctx.host().replace(/\/$/, "")}${API_PATH14}`,
-    body: buildBody13(ctx)
+    url: `${ctx.host().replace(/\/$/, "")}${API_PATH12}`,
+    body: buildBody12(ctx)
   }),
-  execute: async (ctx) => kbApi(ctx, "POST", API_PATH14, {}, buildBody13(ctx))
+  execute: async (ctx) => kbApi(ctx, "POST", API_PATH12, {}, buildBody12(ctx))
 };
 
 // src/commands/te-kb/index.ts
 var commands = [
-  query,
   ask,
+  askStatus,
   add,
   url,
   compile,
@@ -795,6 +919,7 @@ var te_kb_default = commands;
 export {
   add,
   ask,
+  askStatus,
   compile,
   create,
   te_kb_default as default,
@@ -802,7 +927,6 @@ export {
   kbIndex,
   kbList,
   kbRead,
-  query,
   remove,
   rmSource,
   schema,

package/dist/{te-system-AZ3URMUO.js → te-system-YARIK4S5.js}

@@ -7,14 +7,17 @@ import {
   putToMainApp,
   tryLoadTeAgentSandboxCredentials,
   uploadToMainApp
-} from "./chunk-VLWOLBGZ.js";
+} from "./chunk-UOUS37JQ.js";
+import "./chunk-C4MGVGJW.js";
+import "./chunk-4SGZG4XY.js";
 import {
   safeJsonParse
-} from "./chunk-3FY3RJ26.js";
+} from "./chunk-ZZUOD757.js";
 import {
   CliValidationError
-} from "./chunk-AXDXJTPC.js";
-import "./chunk-JHENBQ5B.js";
+} from "./chunk-UW5UN47B.js";
+import "./chunk-LYVNONC4.js";
+import "./chunk-QGM4M3NI.js";
 
 // src/commands/te-system/shared.ts
 import { readFileSync } from "fs";