@thinkingai/ae-cli 6.1.19 → 6.1.21

package/dist/te-kb-BUD6N3NI.js

@@ -1,1222 +0,0 @@
-import { createRequire as __createRequire } from 'node:module'; const require = __createRequire(import.meta.url);
-import {
-  kbApi,
-  kbUpload
-} from "./chunk-JYMGHGCE.js";
-import {
-  printError
-} from "./chunk-KEWVSO64.js";
-import {
-  CapabilityGatewayError
-} from "./chunk-GJXRF7Y6.js";
-import "./chunk-Y74WTIKJ.js";
-import "./chunk-RWXIXOZG.js";
-import "./chunk-O6K2ODUE.js";
-import "./chunk-KZ6ZHF5J.js";
-import {
-  CliValidationError,
-  PermissionError
-} from "./chunk-533JK3YX.js";
-import "./chunk-FR2EDAQM.js";
-
-// src/commands/te-kb/add.ts
-import { promises as fs } from "fs";
-import * as path from "path";
-import TurndownService from "turndown";
-var API_PATH = "/agent/api/external/knowledge-bases/sources/upload";
-var SUPPORTED_EXTENSIONS = /* @__PURE__ */ new Set([
-  ".md",
-  ".markdown",
-  ".txt",
-  ".csv",
-  ".pdf",
-  ".doc",
-  ".docx",
-  ".xls",
-  ".xlsx",
-  ".ppt",
-  ".pptx",
-  ".jpg",
-  ".jpeg",
-  ".png",
-  ".gif",
-  ".webp",
-  ".bmp",
-  ".svg"
-]);
-function normalizeFilesInput(raw) {
-  if (!Array.isArray(raw)) {
-    throw new Error(`--files must be a JSON array of strings, e.g. '["./a.md","./docs","https://example.com/page"]'`);
-  }
-  const items = [];
-  for (const v of raw) {
-    if (typeof v !== "string") {
-      throw new Error(`--files entries must be strings (got: ${JSON.stringify(v)})`);
-    }
-    const trimmed = v.trim();
-    if (trimmed) items.push(trimmed);
-  }
-  return items;
-}
-function isUrl(s) {
-  return /^https?:\/\//i.test(s);
-}
-function classifyInput(item) {
-  return isUrl(item) ? "url" : "path";
-}
-function sanitizeFilename(name) {
-  const cleaned = name.replace(/[\\/:*?"<>|\s]+/g, "-").replace(/^-+|-+$/g, "");
-  return cleaned || "document";
-}
-function getMimeType(filename) {
-  const ext = path.extname(filename).toLowerCase();
-  switch (ext) {
-    case ".md":
-    case ".markdown":
-      return "text/markdown";
-    case ".txt":
-      return "text/plain";
-    case ".csv":
-      return "text/csv";
-    case ".pdf":
-      return "application/pdf";
-    case ".doc":
-      return "application/msword";
-    case ".docx":
-      return "application/vnd.openxmlformats-officedocument.wordprocessingml.document";
-    case ".xls":
-      return "application/vnd.ms-excel";
-    case ".xlsx":
-      return "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet";
-    case ".ppt":
-      return "application/vnd.ms-powerpoint";
-    case ".pptx":
-      return "application/vnd.openxmlformats-officedocument.presentationml.presentation";
-    case ".jpg":
-    case ".jpeg":
-      return "image/jpeg";
-    case ".png":
-      return "image/png";
-    case ".gif":
-      return "image/gif";
-    case ".webp":
-      return "image/webp";
-    case ".bmp":
-      return "image/bmp";
-    case ".svg":
-      return "image/svg+xml";
-    default:
-      return "application/octet-stream";
-  }
-}
-async function readLocalFile(filePath) {
-  const ext = path.extname(filePath).toLowerCase();
-  if (!SUPPORTED_EXTENSIONS.has(ext)) {
-    throw new Error(`Unsupported file extension (${ext || "none"}): ${filePath}`);
-  }
-  const content = await fs.readFile(filePath);
-  const filename = path.basename(filePath);
-  return { filename, content, mimeType: getMimeType(filename), origin: "file", source: filePath };
-}
-async function readDirectory(dir) {
-  const entries = await fs.readdir(dir, { withFileTypes: true });
-  const files = [];
-  for (const entry of entries) {
-    if (!entry.isFile()) continue;
-    const ext = path.extname(entry.name).toLowerCase();
-    if (!SUPPORTED_EXTENSIONS.has(ext)) continue;
-    const full = path.join(dir, entry.name);
-    const content = await fs.readFile(full);
-    files.push({ filename: entry.name, content, mimeType: getMimeType(entry.name), origin: "dir", source: full });
-  }
-  if (files.length === 0) {
-    throw new Error(`No supported files found in directory: ${dir}`);
-  }
-  return files;
-}
-function deriveFilenameFromUrl(rawUrl) {
-  try {
-    const u = new URL(rawUrl);
-    const lastSeg = u.pathname.split("/").filter(Boolean).pop();
-    const base = lastSeg ? lastSeg.replace(/\.[^.]+$/, "") : u.hostname;
-    return `${sanitizeFilename(base)}.md`;
-  } catch {
-    return `${sanitizeFilename(rawUrl)}.md`;
-  }
-}
-async function fetchAsMarkdown(rawUrl) {
-  const resp = await fetch(rawUrl);
-  if (!resp.ok) {
-    throw new Error(`Failed to fetch ${rawUrl}: HTTP ${resp.status}`);
-  }
-  const html = await resp.text();
-  const turndown = new TurndownService({ headingStyle: "atx", codeBlockStyle: "fenced" });
-  const markdown = turndown.turndown(html);
-  return {
-    filename: deriveFilenameFromUrl(rawUrl),
-    content: markdown,
-    mimeType: "text/markdown",
-    origin: "url",
-    source: rawUrl
-  };
-}
-async function resolveLocalPath(p) {
-  const abs = path.resolve(p);
-  let stat;
-  try {
-    stat = await fs.stat(abs);
-  } catch {
-    throw new Error(`Path not found: ${p}`);
-  }
-  if (stat.isDirectory()) {
-    return readDirectory(abs);
-  }
-  if (stat.isFile()) {
-    return [await readLocalFile(abs)];
-  }
-  throw new Error(`Unsupported path (not file or directory): ${p}`);
-}
-async function collectFiles(ctx) {
-  const items = normalizeFilesInput(ctx.json("files"));
-  if (items.length === 0) {
-    throw new Error("--files must contain at least one entry");
-  }
-  const collected = [];
-  for (const item of items) {
-    if (classifyInput(item) === "url") {
-      collected.push(await fetchAsMarkdown(item));
-    } else {
-      collected.push(...await resolveLocalPath(item));
-    }
-  }
-  if (collected.length === 0) {
-    throw new Error("No supported files collected from the given inputs");
-  }
-  return dedupeByFilename(collected);
-}
-function dedupeByFilename(files) {
-  const used = /* @__PURE__ */ new Map();
-  return files.map((f) => {
-    const count = used.get(f.filename) ?? 0;
-    used.set(f.filename, count + 1);
-    if (count === 0) return f;
-    const ext = path.extname(f.filename);
-    const stem = f.filename.slice(0, f.filename.length - ext.length);
-    return { ...f, filename: `${stem}-${count}${ext}` };
-  });
-}
-function buildForm(name, files) {
-  const form = new FormData();
-  form.append("name", name);
-  for (const f of files) {
-    form.append("files", new Blob([f.content], { type: f.mimeType }), f.filename);
-  }
-  return form;
-}
-var add = {
-  service: "kb",
-  command: "+add",
-  description: "Upload sources to a knowledge. --files accepts a JSON array; each entry can be a supported file path, a directory path (supported files inside, non-recursive), or an http(s) URL (HTML auto-converted to markdown).",
-  flags: [
-    { name: "name", type: "string", required: true, desc: "Knowledge base name" },
-    {
-      name: "files",
-      type: "json",
-      required: true,
-      desc: `JSON array of strings. Each entry can be a supported file path, a directory path, or an http(s) URL. Example: '["./a.md","./docs","https://example.com/page"]'`
-    }
-  ],
-  risk: "write",
-  validate: (ctx) => {
-    normalizeFilesInput(ctx.json("files"));
-  },
-  dryRun: (ctx) => {
-    const items = normalizeFilesInput(ctx.json("files"));
-    return {
-      method: "POST",
-      url: `${ctx.host().replace(/\/$/, "")}${API_PATH}`,
-      body: {
-        name: ctx.str("name"),
-        files: items.map((item) => ({ value: item, type: classifyInput(item) })),
-        contentType: "multipart/form-data"
-      }
-    };
-  },
-  execute: async (ctx) => {
-    const name = ctx.str("name");
-    const files = await collectFiles(ctx);
-    const form = buildForm(name, files);
-    const result = await kbUpload(ctx, API_PATH, form);
-    return {
-      uploaded: files.map((f) => ({ filename: f.filename, origin: f.origin, source: f.source })),
-      result
-    };
-  }
-};
-
-// src/commands/te-kb/compile.ts
-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";
-  if (!VALID_MODES.has(mode)) {
-    throw new Error(`Invalid --mode: ${mode}. Must be one of: incremental | full`);
-  }
-  return mode;
-}
-function buildBody(ctx) {
-  return {
-    name: ctx.str("name"),
-    mode: getMode(ctx)
-  };
-}
-var compile = {
-  service: "kb",
-  command: "+compile",
-  description: "Compile a knowledge.",
-  flags: [
-    { name: "name", type: "string", required: true, desc: "Knowledge base name" },
-    { name: "mode", type: "string", required: false, default: "incremental", desc: "Compile mode: incremental | full (default: incremental)" }
-  ],
-  risk: "write",
-  validate: (ctx) => {
-    getMode(ctx);
-  },
-  dryRun: (ctx) => ({
-    method: "POST",
-    url: `${ctx.host().replace(/\/$/, "")}${API_PATH2}`,
-    body: buildBody(ctx)
-  }),
-  execute: async (ctx) => kbApi(ctx, "POST", API_PATH2, {}, buildBody(ctx))
-};
-
-// src/commands/te-kb/remove.ts
-var API_PATH3 = "/agent/api/external/knowledge-bases";
-function buildBody2(ctx) {
-  return { name: ctx.str("name") };
-}
-var remove = {
-  service: "kb",
-  command: "+remove",
-  description: "Delete an entire knowledge.",
-  flags: [
-    { name: "name", type: "string", required: true, desc: "Knowledge base name to delete" }
-  ],
-  risk: "high-risk-write",
-  dryRun: (ctx) => ({
-    method: "DELETE",
-    url: `${ctx.host().replace(/\/$/, "")}${API_PATH3}`,
-    body: buildBody2(ctx)
-  }),
-  execute: async (ctx) => kbApi(ctx, "DELETE", API_PATH3, {}, buildBody2(ctx))
-};
-
-// src/commands/te-kb/create.ts
-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";
-  validateScope(scope);
-  return scope;
-}
-function validateScope(scope) {
-  if (!VALID_SCOPES.has(scope)) {
-    throw new Error(`Invalid --scope: ${scope}. Must be one of: personal | company`);
-  }
-}
-function normalizeTags(raw) {
-  if (raw === void 0 || raw === null) return void 0;
-  if (!Array.isArray(raw)) {
-    throw new Error(`--tags must be a JSON array of strings, e.g. '["t1","t2"]'`);
-  }
-  const tags = [];
-  for (const v of raw) {
-    if (typeof v !== "string") {
-      throw new Error(`--tags entries must be strings (got: ${JSON.stringify(v)})`);
-    }
-    const t = v.trim();
-    if (t) tags.push(t);
-  }
-  return tags;
-}
-function buildBody3(ctx) {
-  const body = {
-    scope: getScope(ctx),
-    name: ctx.str("name")
-  };
-  const description = ctx.str("description");
-  if (description) body.description = description;
-  const tags = normalizeTags(ctx.json("tags"));
-  if (tags && tags.length > 0) body.tags = tags;
-  const projectId = ctx.str("project-id");
-  if (projectId) body.projectId = projectId;
-  const projectName = ctx.str("project-name");
-  if (projectName) body.projectName = projectName;
-  return body;
-}
-var create = {
-  service: "kb",
-  command: "+new",
-  description: "Create a new knowledge.",
-  flags: [
-    { name: "scope", type: "string", required: false, default: "company", desc: "Knowledge base scope: personal | company (default: company)" },
-    { name: "name", type: "string", required: true, desc: "Knowledge base name (\u226430 chars, unique per scope)" },
-    { name: "description", type: "string", required: false, desc: "Optional description (\u2264200 chars)" },
-    { name: "tags", type: "json", required: false, desc: `Optional JSON array of tags (max 2, each \u226415 chars). Example: '["t1","t2"]'` },
-    { name: "project-id", type: "string", required: false, desc: "Optional project ID to bind" },
-    { name: "project-name", type: "string", required: false, desc: "Optional project display name" }
-  ],
-  risk: "write",
-  validate: (ctx) => {
-    getScope(ctx);
-    normalizeTags(ctx.json("tags"));
-  },
-  dryRun: (ctx) => ({
-    method: "POST",
-    url: `${ctx.host().replace(/\/$/, "")}${API_PATH4}`,
-    body: buildBody3(ctx)
-  }),
-  execute: async (ctx) => kbApi(ctx, "POST", API_PATH4, {}, buildBody3(ctx))
-};
-
-// src/commands/te-kb/rm-source.ts
-var API_PATH5 = "/agent/api/external/knowledge-bases/sources";
-function sourceSelector(ctx) {
-  const id = ctx.str("id").trim();
-  if (id) return { id };
-  const displayName = ctx.str("display-name").trim();
-  if (displayName) return { displayName };
-  throw new CliValidationError("One of --id or --display-name is required.");
-}
-function buildBody4(ctx) {
-  return {
-    name: ctx.str("name"),
-    ...sourceSelector(ctx)
-  };
-}
-var rmSource = {
-  service: "kb",
-  command: "+rm-source",
-  description: "Delete one source from a knowledge base by ID or exact display name.",
-  flags: [
-    { name: "name", type: "string", required: true, desc: "Knowledge base name (looked up personal \u2192 company)" },
-    { name: "id", type: "string", required: false, desc: "Source ID copied from +list-sources (preferred)" },
-    { name: "display-name", type: "string", required: false, desc: "Exact source display name for legacy compatibility" }
-  ],
-  risk: "high-risk-write",
-  validate: (ctx) => {
-    sourceSelector(ctx);
-  },
-  dryRun: (ctx) => ({
-    method: "DELETE",
-    url: `${ctx.host().replace(/\/$/, "")}${API_PATH5}`,
-    body: buildBody4(ctx)
-  }),
-  execute: async (ctx) => kbApi(ctx, "DELETE", API_PATH5, {}, buildBody4(ctx), {
-    preserveErrorMetadata: true,
-    retryUnauthorized: true
-  })
-};
-
-// src/commands/te-kb/schema.ts
-var API_PATH6 = "/agent/api/external/knowledge-bases/schema";
-function buildBody5(ctx) {
-  const body = {
-    name: ctx.str("name")
-  };
-  if (ctx.bool("force")) body.force = true;
-  const model = ctx.str("model");
-  if (model) body.model = model;
-  const customInstructions = ctx.str("custom-instructions");
-  if (customInstructions) body.customInstructions = customInstructions;
-  return body;
-}
-async function executeSchema(ctx, api = kbApi) {
-  return api(ctx, "POST", API_PATH6, {}, buildBody5(ctx), {
-    preserveBusinessErrorCode: true
-  });
-}
-var schema = {
-  service: "kb",
-  command: "+schema",
-  description: "Generate the compile schema for a knowledge base via POST /agent/api/external/knowledge-bases/schema.",
-  flags: [
-    { name: "name", type: "string", required: true, desc: "Knowledge base name (looked up personal \u2192 company)" },
-    { name: "force", type: "boolean", required: false, desc: "Preempt generation even when status is `generating` (use only for stuck recovery)" },
-    { name: "model", type: "string", required: false, desc: "Optional model displayName to use for schema generation" },
-    {
-      name: "custom-instructions",
-      type: "string",
-      required: false,
-      sensitive: true,
-      desc: "Optional per-run instructions for generating this knowledge base schema"
-    }
-  ],
-  risk: "write",
-  dryRun: (ctx) => ({
-    method: "POST",
-    url: `${ctx.host().replace(/\/$/, "")}${API_PATH6}`,
-    body: buildBody5(ctx)
-  }),
-  execute: executeSchema
-};
-
-// src/commands/te-kb/status.ts
-var API_PATH7 = "/agent/api/external/knowledge-bases/status";
-function buildBody6(ctx) {
-  return {
-    name: ctx.str("name")
-  };
-}
-var status = {
-  service: "kb",
-  command: "+status",
-  description: "Query knowledge base status.",
-  flags: [
-    { name: "name", type: "string", required: true, desc: "Knowledge base name" }
-  ],
-  risk: "read",
-  dryRun: (ctx) => ({
-    method: "POST",
-    url: `${ctx.host().replace(/\/$/, "")}${API_PATH7}`,
-    body: buildBody6(ctx)
-  }),
-  execute: async (ctx) => kbApi(ctx, "POST", API_PATH7, {}, buildBody6(ctx))
-};
-
-// src/commands/te-kb/kb-index.ts
-var API_PATH8 = "/agent/api/external/knowledge-bases/index";
-function buildBody7(ctx) {
-  const body = {};
-  const sources = ctx.json("sources");
-  if (sources) body.sources = sources;
-  const locale = ctx.str("locale");
-  if (locale) body.locale = locale;
-  return body;
-}
-var kbIndex = {
-  service: "kb",
-  command: "+index",
-  description: "List accessible knowledge bases and their index.md navigation maps via POST /agent/api/external/knowledge-bases/index. Call this first to see the layout, then use +grep to locate and +read to open pages.",
-  flags: [
-    {
-      name: "sources",
-      type: "json",
-      required: false,
-      desc: 'Optional JSON array of knowledge base refs to scope the index, e.g. [{"scope":"company","name":"engineering-handbook"}]. Omit to list all accessible knowledge bases.'
-    },
-    { name: "locale", type: "string", required: false, desc: "Optional locale: zh | en | ja | ko" }
-  ],
-  risk: "read",
-  dryRun: (ctx) => ({
-    method: "POST",
-    url: `${ctx.host().replace(/\/$/, "")}${API_PATH8}`,
-    body: buildBody7(ctx)
-  }),
-  execute: async (ctx) => kbApi(ctx, "POST", API_PATH8, {}, buildBody7(ctx))
-};
-
-// src/commands/te-kb/kb-list.ts
-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 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)
-  };
-  const locale = ctx.str("locale");
-  if (locale) body.locale = locale;
-  return body;
-}
-var kbList = {
-  service: "kb",
-  command: "+list",
-  description: "List accessible knowledge bases via POST /agent/api/external/knowledge-bases/list. Filters by buildStatus (default: compiled). Returns KB metadata including buildStatus, without index.md navigation maps.",
-  flags: [
-    {
-      name: "build-status",
-      type: "string",
-      required: false,
-      default: DEFAULT_BUILD_STATUS,
-      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_PATH9}`,
-    body: buildBody8(ctx)
-  }),
-  execute: async (ctx) => kbApi(ctx, "POST", API_PATH9, {}, buildBody8(ctx))
-};
-
-// src/commands/te-kb/list-sources.ts
-var API_PATH10 = "/agent/api/external/knowledge-bases/sources";
-var MAX_KNOWLEDGE_BASE_NAME_LENGTH = 200;
-function knowledgeBaseName(ctx) {
-  return ctx.str("name").trim();
-}
-function buildUrl(ctx) {
-  const url2 = new URL(`${ctx.host().replace(/\/$/, "")}${API_PATH10}`);
-  url2.searchParams.set("name", knowledgeBaseName(ctx));
-  return url2.toString();
-}
-var listSources = {
-  service: "kb",
-  command: "+list-sources",
-  description: "List source metadata for a knowledge base via GET /agent/api/external/knowledge-bases/sources?name=<name>. Copy the stable source ID from this output before using +rm-source.",
-  flags: [
-    {
-      name: "name",
-      type: "string",
-      required: true,
-      minLength: 1,
-      maxLength: MAX_KNOWLEDGE_BASE_NAME_LENGTH,
-      desc: "Knowledge base name"
-    }
-  ],
-  risk: "read",
-  validate: (ctx) => {
-    const name = knowledgeBaseName(ctx);
-    if (!name) {
-      throw new CliValidationError("Invalid --name: must be non-empty.");
-    }
-    if (name.length > MAX_KNOWLEDGE_BASE_NAME_LENGTH) {
-      throw new CliValidationError(
-        `Invalid --name length: ${name.length}. Must be at most ${MAX_KNOWLEDGE_BASE_NAME_LENGTH} characters.`
-      );
-    }
-  },
-  dryRun: (ctx) => ({
-    method: "GET",
-    url: buildUrl(ctx)
-  }),
-  execute: async (ctx) => kbApi(
-    ctx,
-    "GET",
-    API_PATH10,
-    { name: knowledgeBaseName(ctx) },
-    void 0,
-    { preserveErrorMetadata: true, retryUnauthorized: true }
-  )
-};
-
-// src/commands/te-kb/kb-grep.ts
-var API_PATH11 = "/agent/api/external/knowledge-bases/grep";
-function buildBody9(ctx) {
-  const body = {
-    query: ctx.str("query"),
-    sources: ctx.json("sources"),
-    paths: ctx.json("paths")
-  };
-  const topK = ctx.num("top-k");
-  if (topK) body.topK = topK;
-  const locale = ctx.str("locale");
-  if (locale) body.locale = locale;
-  return body;
-}
-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, 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",
-      type: "string",
-      required: true,
-      alias: "q",
-      desc: "Keywords to search across the knowledge bases"
-    },
-    {
-      name: "sources",
-      type: "json",
-      required: true,
-      desc: 'JSON array of knowledge base refs, e.g. [{"scope":"company","name":"engineering-handbook"}]'
-    },
-    {
-      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: buildBody9(ctx)
-  }),
-  execute: async (ctx) => kbApi(ctx, "POST", API_PATH11, {}, buildBody9(ctx))
-};
-
-// src/commands/te-kb/kb-read.ts
-var API_PATH12 = "/agent/api/external/knowledge-bases/read";
-function buildBody10(ctx) {
-  const body = {
-    source: ctx.json("source"),
-    path: ctx.str("path")
-  };
-  const offset = ctx.num("offset");
-  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;
-}
-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. Pass --outline to get only the page heading tree (no content) and pick a section to read.",
-  flags: [
-    {
-      name: "source",
-      type: "json",
-      required: true,
-      desc: 'Knowledge base ref pointing to exactly one base, e.g. {"scope":"company","name":"engineering-handbook"}'
-    },
-    {
-      name: "path",
-      type: "string",
-      required: true,
-      desc: "Page path relative to the knowledge base root, e.g. wiki/concepts/data-model.md or index.md"
-    },
-    { 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: buildBody10(ctx)
-  }),
-  execute: async (ctx) => kbApi(ctx, "POST", API_PATH12, {}, 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 VALID_LOCALES = /* @__PURE__ */ new Set(["zh", "en", "ja", "ko"]);
-var MIN_QUESTION_LEN = 1;
-var MAX_QUESTION_LEN = 2e3;
-var MIN_MAX_TURNS = 1;
-var MAX_MAX_TURNS = 100;
-function validateQuestion(question) {
-  const len = question.length;
-  if (len < MIN_QUESTION_LEN || len > MAX_QUESTION_LEN) {
-    throw new Error(
-      `Invalid --question length: ${len}. Must be between ${MIN_QUESTION_LEN} and ${MAX_QUESTION_LEN} characters.`
-    );
-  }
-}
-function validateLocale(locale) {
-  if (locale && !VALID_LOCALES.has(locale)) {
-    throw new Error(`Invalid --locale: ${locale}. Must be one of: zh | en | ja | ko`);
-  }
-}
-function validateMaxTurns(maxTurns) {
-  if (maxTurns !== 0 && (maxTurns < MIN_MAX_TURNS || maxTurns > MAX_MAX_TURNS)) {
-    throw new Error(
-      `Invalid --max-turns: ${maxTurns}. Must be between ${MIN_MAX_TURNS} and ${MAX_MAX_TURNS}.`
-    );
-  }
-}
-function buildBody11(ctx) {
-  const body = {
-    question: ctx.str("question")
-  };
-  const sources = ctx.json("sources");
-  if (sources) body.sources = sources;
-  const modelId = ctx.str("model-id");
-  if (modelId) body.modelId = modelId;
-  const maxTurns = ctx.num("max-turns");
-  if (maxTurns) body.maxTurns = maxTurns;
-  const locale = ctx.str("locale");
-  if (locale) body.locale = locale;
-  return body;
-}
-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. By default, polls for completion; use --no-wait to return immediately with executionId.",
-  flags: [
-    {
-      name: "question",
-      type: "string",
-      required: true,
-      alias: "q",
-      desc: "Natural-language question (1-2000 characters). Required."
-    },
-    {
-      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.'
-    },
-    {
-      name: "model-id",
-      type: "string",
-      required: false,
-      desc: "Optional LLM model ID (e.g. claude-sonnet-4-6). Omit to use the platform default model."
-    },
-    {
-      name: "max-turns",
-      type: "number",
-      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: "no-wait",
-      type: "boolean",
-      required: false,
-      desc: "Return immediately after submission with executionId, without polling for completion."
-    }
-  ],
-  risk: "read",
-  validate: (ctx) => {
-    validateQuestion(ctx.str("question"));
-    validateLocale(ctx.str("locale"));
-    validateMaxTurns(ctx.num("max-turns"));
-  },
-  dryRun: (ctx) => ({
-    method: "POST",
-    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) => {
-    const executionId = executionIdFrom(ctx);
-    return await kbApi(ctx, "GET", ASK_API_PATH, { executionId });
-  }
-};
-
-// src/commands/te-kb/url.ts
-var API_PATH13 = "/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 buildBody12(ctx) {
-  const body = {
-    name: ctx.str("name"),
-    url: ctx.str("url")
-  };
-  const displayName = ctx.str("display-name");
-  if (displayName) body.displayName = displayName;
-  const parseInstruction = ctx.str("parse-instruction");
-  if (parseInstruction) body.parseInstruction = parseInstruction;
-  return body;
-}
-var url = {
-  service: "kb",
-  command: "+url",
-  description: "Upload a URL source to a knowledge base.",
-  flags: [
-    { name: "name", type: "string", required: true, desc: "Knowledge base name" },
-    { name: "url", type: "string", required: true, desc: "Source URL to upload" },
-    { name: "display-name", type: "string", required: false, desc: "Optional display name for the URL source" },
-    { name: "parse-instruction", type: "string", required: false, desc: "Optional parsing instruction for the URL source; ignored for Lark/Feishu doc URLs (the server applies its own Feishu parsing)" }
-  ],
-  risk: "write",
-  validate: (ctx) => {
-    validateUrl(ctx.str("url"));
-  },
-  dryRun: (ctx) => ({
-    method: "POST",
-    url: `${ctx.host().replace(/\/$/, "")}${API_PATH13}`,
-    body: buildBody12(ctx)
-  }),
-  execute: async (ctx) => kbApi(ctx, "POST", API_PATH13, {}, buildBody12(ctx))
-};
-
-// src/commands/te-kb/import.ts
-import { promises as fs2 } from "fs";
-import path2 from "path";
-var API_PATH14 = "/agent/api/external/knowledge-bases/import";
-var MAX_SNAPSHOT_ARCHIVE_BYTES = 50 * 1024 * 1024;
-function normalizeTags2(raw) {
-  if (raw === void 0 || raw === null) return [];
-  if (!Array.isArray(raw)) {
-    throw new Error(
-      `--tags must be a JSON array of strings, e.g. '["docs","product"]'`
-    );
-  }
-  const tags = [];
-  for (const value of raw) {
-    if (typeof value !== "string") {
-      throw new Error(
-        `--tags entries must be strings (got: ${JSON.stringify(value)})`
-      );
-    }
-    const tag = value.trim();
-    if (tag && !tags.includes(tag)) tags.push(tag);
-  }
-  if (tags.length > 2) throw new Error("--tags accepts at most 2 unique tags");
-  if (tags.some((tag) => tag.length > 15)) {
-    throw new Error("--tags entries must be at most 15 characters");
-  }
-  return tags;
-}
-function validateArchivePath(filePath) {
-  if (path2.extname(filePath).toLocaleLowerCase("en-US") !== ".zip") {
-    throw new Error("--file must point to a .zip archive");
-  }
-}
-async function readArchive(filePath) {
-  validateArchivePath(filePath);
-  const absolutePath = path2.resolve(filePath);
-  let stat;
-  try {
-    stat = await fs2.stat(absolutePath);
-  } catch {
-    throw new Error(`File not found: ${filePath}`);
-  }
-  if (!stat.isFile())
-    throw new Error(`--file must point to a file: ${filePath}`);
-  if (stat.size === 0) throw new Error(`ZIP archive is empty: ${filePath}`);
-  if (stat.size > MAX_SNAPSHOT_ARCHIVE_BYTES) {
-    throw new Error("--file must not exceed 50 MB");
-  }
-  return { absolutePath, bytes: await fs2.readFile(absolutePath) };
-}
-function appendOptionalFields(ctx, form) {
-  const description = ctx.str("description").trim();
-  if (description) form.append("description", description);
-  for (const tag of normalizeTags2(ctx.json("tags"))) form.append("tags", tag);
-  const projectId = ctx.str("project-id").trim();
-  if (projectId) form.append("projectId", projectId);
-}
-var importSnapshot = {
-  service: "kb",
-  command: "+import",
-  description: "Import a compiled Markdown ZIP snapshot as a personal read-only knowledge base.",
-  flags: [
-    {
-      name: "file",
-      type: "string",
-      required: true,
-      desc: "Local .zip snapshot containing root index.md and wiki/**/*.md"
-    },
-    {
-      name: "name",
-      type: "string",
-      required: true,
-      maxLength: 30,
-      desc: "Personal knowledge base name (max 30 characters)"
-    },
-    {
-      name: "description",
-      type: "string",
-      required: false,
-      maxLength: 200,
-      desc: "Optional description (max 200 characters)"
-    },
-    {
-      name: "tags",
-      type: "json",
-      required: false,
-      desc: "Optional JSON array of tags (max 2, each max 15 characters)"
-    },
-    {
-      name: "project-id",
-      type: "string",
-      required: false,
-      maxLength: 128,
-      desc: "Optional project ID to bind"
-    }
-  ],
-  risk: "write",
-  validate: (ctx) => {
-    validateArchivePath(ctx.str("file"));
-    normalizeTags2(ctx.json("tags"));
-  },
-  execute: async (ctx) => {
-    const archive = await readArchive(ctx.str("file"));
-    const form = new FormData();
-    form.append(
-      "file",
-      new Blob([Uint8Array.from(archive.bytes)], { type: "application/zip" }),
-      path2.basename(archive.absolutePath)
-    );
-    form.append("name", ctx.str("name").trim());
-    appendOptionalFields(ctx, form);
-    try {
-      return await kbUpload(
-        ctx,
-        API_PATH14,
-        form,
-        {},
-        { preserveErrorMetadata: true, retryUnauthorized: true }
-      );
-    } catch (error) {
-      const hint = "If a requestId was returned, run ae-cli kb +import-status --request-id <requestId>; otherwise run ae-cli kb +list before retrying the same name.";
-      if (error instanceof CapabilityGatewayError) {
-        throw new CapabilityGatewayError(
-          `${error.message} ${hint}`,
-          error.code,
-          error.httpStatus,
-          error.hint ?? hint,
-          error.meta
-        );
-      }
-      if (error instanceof Error) {
-        error.message = `${error.message} ${hint}`;
-        throw error;
-      }
-      throw new Error(`${String(error)} ${hint}`);
-    }
-  }
-};
-
-// src/commands/te-kb/import-status.ts
-var API_PATH15 = "/agent/api/external/knowledge-bases/import";
-var MAX_REQUEST_ID_LENGTH = 191;
-function requestIdFrom(ctx) {
-  return ctx.str("request-id").trim();
-}
-var importStatus = {
-  service: "kb",
-  command: "+import-status",
-  description: "Query one asynchronous knowledge-base snapshot import by its request ID without polling.",
-  flags: [
-    {
-      name: "request-id",
-      type: "string",
-      required: true,
-      minLength: 1,
-      maxLength: MAX_REQUEST_ID_LENGTH,
-      desc: "The requestId returned by kb +import."
-    }
-  ],
-  risk: "read",
-  validate: (ctx) => {
-    const requestId = requestIdFrom(ctx);
-    if (!requestId) throw new Error("Invalid --request-id: must be non-empty.");
-    if (requestId.length > MAX_REQUEST_ID_LENGTH) {
-      throw new Error(
-        `Invalid --request-id length: ${requestId.length}. Must be at most ${MAX_REQUEST_ID_LENGTH} characters.`
-      );
-    }
-  },
-  dryRun: (ctx) => ({
-    method: "GET",
-    url: `${ctx.host().replace(/\/$/, "")}${API_PATH15}?requestId=${encodeURIComponent(requestIdFrom(ctx))}`
-  }),
-  execute: async (ctx) => {
-    try {
-      return await kbApi(
-        ctx,
-        "GET",
-        API_PATH15,
-        { requestId: requestIdFrom(ctx) },
-        void 0,
-        { preserveErrorMetadata: true, retryUnauthorized: true }
-      );
-    } catch (error) {
-      if (!(error instanceof CapabilityGatewayError) || error.hint) throw error;
-      throw new CapabilityGatewayError(
-        error.message,
-        error.code,
-        error.httpStatus,
-        "Verify the request ID and that the server supports kb +import-status. Do not retry the import until its status is known.",
-        error.meta
-      );
-    }
-  }
-};
-
-// src/commands/te-kb/index.ts
-var commands = [
-  ask,
-  askStatus,
-  add,
-  url,
-  compile,
-  remove,
-  create,
-  listSources,
-  rmSource,
-  schema,
-  status,
-  kbList,
-  kbIndex,
-  kbGrep,
-  kbRead,
-  importSnapshot,
-  importStatus
-];
-var te_kb_default = commands;
-export {
-  add,
-  ask,
-  askStatus,
-  compile,
-  create,
-  te_kb_default as default,
-  importSnapshot,
-  importStatus,
-  kbGrep,
-  kbIndex,
-  kbList,
-  kbRead,
-  listSources,
-  remove,
-  rmSource,
-  schema,
-  status,
-  url
-};