@thinkingai/ae-cli 6.1.23 → 6.1.25

package/dist/{te-kb-3TS73NO6.js → te-kb-QJLJEX5K.js}

@@ -2,23 +2,27 @@ import { createRequire as __createRequire } from 'node:module'; const require =
 import {
   kbApi,
   kbUpload
-} from "./chunk-57RRFUEZ.js";
+} from "./chunk-5XRQ3CZR.js";
 import {
   TeAgentApiError
-} from "./chunk-HBGADCKA.js";
+} from "./chunk-KJDOTPYU.js";
 import {
   CapabilityGatewayError
-} from "./chunk-HFGZGYCG.js";
+} from "./chunk-QYXDJOLA.js";
 import {
   printError
-} from "./chunk-DX5CDO34.js";
+} from "./chunk-BW7JUDEI.js";
 import "./chunk-Y74WTIKJ.js";
-import "./chunk-7XGFSUOM.js";
-import "./chunk-7FTTULED.js";
+import "./chunk-DU72X2IO.js";
+import "./chunk-IG3DYEIR.js";
 import {
   CliValidationError,
   PermissionError
-} from "./chunk-MAPZ7VB6.js";
+} from "./chunk-YVGXGTD6.js";
+
+// src/commands/te-kb/schema-import.ts
+import { promises as fs } from "fs";
+import path from "path";
 
 // src/commands/te-kb/target-scope.ts
 function getExternalKnowledgeBaseTargetScope(ctx) {
@@ -30,9 +34,131 @@ function getExternalKnowledgeBaseTargetScope(ctx) {
   );
 }
 
+// src/commands/te-kb/schema-import.ts
+var ROOT = "/agent/api/external/knowledge-bases/schema";
+var options = { preserveBusinessErrorCode: true, preserveErrorMetadata: true };
+var flag = (name, type, desc, required = false) => ({ name, type, desc, required });
+var targetFlags = [flag("name", "string", "Knowledge base name", true), flag("scope", "string", "Exact scope: personal | company")];
+var identityFlags = [flag("import-id", "string", "Stable import ID", true)];
+var mutationFlags = [flag("revision", "number", "Expected candidate revision", true), flag("request-id", "string", "Idempotency key; reuse only for identical retries", true)];
+var hashFlag = flag("hash", "string", "Expected candidate SHA256", true);
+var fileFlag = { ...flag("file", "string", "Local UTF-8 Markdown file, at most 256 KiB", true), sensitive: true };
+var waitFlags = [flag("wait", "boolean", "Poll until this task finishes; never abandon on timeout"), { ...flag("timeout", "number", "Wait timeout in seconds"), default: 300, min: 1, max: 3600 }];
+var modelFlag = flag("model", "string", "Optional stable model reference");
+function target(ctx) {
+  return { name: ctx.str("name"), scope: getExternalKnowledgeBaseTargetScope(ctx) };
+}
+function endpoint(ctx, action) {
+  if (action === "download") return ROOT;
+  if (action === "upload" || action === "list") return ROOT + "/imports";
+  const suffix = action === "status" ? "" : action === "save" ? "content" : action === "reject" ? "reject-optimization" : action;
+  return `${ROOT}/imports/${encodeURIComponent(ctx.str("import-id"))}${suffix ? "/" + suffix : ""}`;
+}
+function body(ctx, action) {
+  const result = { expectedRevision: ctx.num("revision"), requestId: ctx.str("request-id") };
+  if (["validate", "optimize", "apply"].includes(action)) result.contentHash = ctx.str("hash");
+  if (["validate", "optimize"].includes(action) && ctx.str("model")) result.model = ctx.str("model");
+  if (action === "optimize" && ctx.list("issue-id").length) result.issueIds = ctx.list("issue-id");
+  if (action === "apply") {
+    result.reportId = ctx.str("report-id");
+    result.expectedSchemaHash = ctx.bool("schema-absent") ? null : ctx.str("schema-hash");
+  }
+  return result;
+}
+function query(ctx, action) {
+  if (action === "download") return { ...target(ctx), download: "1" };
+  if (action === "list") return { ...target(ctx), limit: ctx.num("limit") || 20, cursor: ctx.str("cursor") || void 0 };
+  if (action === "content") return { target: ctx.str("target") || "current", download: ctx.str("output") ? "1" : void 0 };
+  if (action === "diff") return { baseline: ctx.str("baseline") || "current-schema" };
+  return {};
+}
+function validate(ctx, action) {
+  if (["upload", "list", "download"].includes(action)) getExternalKnowledgeBaseTargetScope(ctx);
+  for (const name of ["import-id", "request-id", "replaces-import-id"]) if (ctx.str(name) && !/^[A-Za-z0-9_-]{1,191}$/.test(ctx.str(name))) throw new CliValidationError(`Invalid --${name}`);
+  for (const name of ["hash", "schema-hash", "report-id"]) if (ctx.str(name) && !/^[a-f0-9]{64}$/.test(ctx.str(name))) throw new CliValidationError(`Invalid --${name}; expected SHA256`);
+  for (const name of ["revision", "replaced-revision"]) if (ctx.num(name) && (!Number.isInteger(ctx.num(name)) || ctx.num(name) < 1)) throw new CliValidationError(`Invalid --${name}`);
+  if (action === "apply" && Boolean(ctx.str("schema-hash")) === ctx.bool("schema-absent")) throw new CliValidationError("Specify exactly one of --schema-hash or --schema-absent");
+  if (action === "upload" && Boolean(ctx.str("replaces-import-id")) !== Boolean(ctx.num("replaced-revision"))) throw new CliValidationError("Replacement requires --replaces-import-id and --replaced-revision");
+  if (action === "content" && !["current", "original", "optimization-input", "optimized"].includes(ctx.str("target") || "current")) throw new CliValidationError("Invalid --target");
+  if (action === "diff" && !["original", "optimization-input", "current-schema"].includes(ctx.str("baseline") || "current-schema")) throw new CliValidationError("Invalid --baseline");
+}
+async function readMarkdown(ctx) {
+  const absolute = path.resolve(ctx.str("file")), stat = await fs.stat(absolute);
+  if (!stat.isFile() || stat.size > 262144 || path.extname(absolute).toLowerCase() !== ".md") throw new CliValidationError("--file must be a Markdown file of at most 256 KiB");
+  const bytes = await fs.readFile(absolute);
+  if (bytes.length > 262144) throw new CliValidationError("--file exceeds 256 KiB");
+  new TextDecoder("utf-8", { fatal: true, ignoreBOM: true }).decode(bytes);
+  return { absolute, bytes };
+}
+async function waitSchemaImport(ctx, initial, api = kbApi, sleep = (ms) => new Promise((resolve2) => setTimeout(resolve2, ms))) {
+  const deadline = Date.now() + (ctx.num("timeout") || 300) * 1e3;
+  let current = initial;
+  while (current.task && Date.now() < deadline) {
+    await sleep(Math.min(2e3, Math.max(1, deadline - Date.now())));
+    current = await api(ctx, "GET", `${ROOT}/imports/${encodeURIComponent(initial.id)}`, {}, void 0, options);
+  }
+  return { ...current, waitTimedOut: Boolean(current.task) };
+}
+async function executeSchemaImport(ctx, action, api = kbApi, upload = kbUpload) {
+  let result;
+  if (action === "upload") {
+    const { absolute, bytes } = await readMarkdown(ctx);
+    const form = new FormData();
+    form.set("file", new Blob([new Uint8Array(bytes)]), path.basename(absolute));
+    form.set("name", ctx.str("name"));
+    form.set("requestId", ctx.str("request-id"));
+    const scope = getExternalKnowledgeBaseTargetScope(ctx);
+    if (scope) form.set("scope", scope);
+    if (ctx.str("model")) form.set("model", ctx.str("model"));
+    if (ctx.str("replaces-import-id")) {
+      form.set("replacesImportId", ctx.str("replaces-import-id"));
+      form.set("expectedReplacedRevision", String(ctx.num("replaced-revision")));
+    }
+    result = await upload(ctx, endpoint(ctx, action), form, {}, options);
+  } else if (["download", "list", "status", "content", "diff"].includes(action)) {
+    const binary = action === "download" || action === "content" && Boolean(ctx.str("output"));
+    result = await api(ctx, "GET", endpoint(ctx, action), query(ctx, action), void 0, { ...options, ...binary ? { responseType: "bytes" } : {} });
+    if (binary) {
+      const output = path.resolve(ctx.str("output"));
+      const bytes = Buffer.from(result);
+      await fs.writeFile(output, bytes, { flag: "wx" });
+      return { output, sizeBytes: bytes.length };
+    }
+    if (action === "diff" && ctx.str("output")) {
+      const output = path.resolve(ctx.str("output"));
+      await fs.writeFile(output, result.diff, { flag: "wx" });
+      return { ...result, output };
+    }
+  } else {
+    const input = body(ctx, action);
+    if (action === "save") {
+      const { bytes } = await readMarkdown(ctx);
+      input.content = bytes.toString("utf8");
+    }
+    result = await api(ctx, action === "save" ? "PUT" : "POST", endpoint(ctx, action), {}, input, options);
+  }
+  return ctx.bool("wait") && result.task ? waitSchemaImport(ctx, result, api) : result;
+}
+function command(action, name, description, flags, risk) {
+  return { service: "kb", command: name, description, flags, risk, validate: (ctx) => validate(ctx, action), dryRun: (ctx) => ({ method: action === "save" ? "PUT" : ["upload", "validate", "optimize", "reject", "apply", "abandon"].includes(action) ? "POST" : "GET", url: ctx.host().replace(/\/$/, "") + endpoint(ctx, action), params: query(ctx, action), body: action === "upload" ? { ...target(ctx), requestId: ctx.str("request-id"), file: "[REDACTED]", model: ctx.str("model") || void 0, replacesImportId: ctx.str("replaces-import-id") || void 0, expectedReplacedRevision: ctx.num("replaced-revision") || void 0 } : ["save", "validate", "optimize", "reject", "apply", "abandon"].includes(action) ? { ...body(ctx, action), ...action === "save" ? { content: "[REDACTED]" } : {} } : void 0 }), execute: (ctx) => executeSchemaImport(ctx, action) };
+}
+var schemaDownload = command("download", "+schema-download", "Download formal schema bytes without rewriting.", [...targetFlags, flag("output", "string", "New destination file; never overwrite", true)], "read");
+var schemaImport = command("upload", "+schema-import", "Upload a candidate and start validation; formal schema is unchanged.", [...targetFlags, fileFlag, flag("request-id", "string", "Upload idempotency key", true), modelFlag, flag("replaces-import-id", "string", "Explicit pending import to replace"), flag("replaced-revision", "number", "Expected revision of replaced import"), ...waitFlags], "write");
+var schemaImportList = command("list", "+schema-import-list", "List your pending candidates.", [...targetFlags, { ...flag("limit", "number", "Page size, 1 to 100"), default: 20, min: 1, max: 100 }, flag("cursor", "string", "Continuation cursor")], "read");
+var schemaImportStatus = command("status", "+schema-import-status", "Read candidate status, report and durable receipt.", [...identityFlags, ...waitFlags], "read");
+var schemaImportContent = command("content", "+schema-import-content", "Read or download unmodified candidate bytes.", [...identityFlags, flag("target", "string", "current | original | optimization-input | optimized"), flag("output", "string", "Optional new destination file")], "read");
+var schemaImportDiff = command("diff", "+schema-import-diff", "Read full actual diff and current formal hash.", [...identityFlags, flag("baseline", "string", "original | optimization-input | current-schema"), flag("output", "string", "Optional new diff file")], "read");
+var schemaImportSave = command("save", "+schema-import-save", "Save edits without calling a model.", [...identityFlags, ...mutationFlags, fileFlag], "write");
+var schemaImportValidate = command("validate", "+schema-import-validate", "Validate this exact saved revision.", [...identityFlags, ...mutationFlags, hashFlag, modelFlag, ...waitFlags], "write");
+var schemaImportOptimize = command("optimize", "+schema-import-optimize", "Repair selected issues once and independently revalidate.", [...identityFlags, ...mutationFlags, hashFlag, modelFlag, { ...flag("issue-id", "string", "Repeat to select repairable issues"), variadic: true }, ...waitFlags], "write");
+var schemaImportReject = command("reject", "+schema-import-reject", "Restore the most recent repair input.", [...identityFlags, ...mutationFlags], "write");
+var schemaImportApply = command("apply", "+schema-import-apply", "Apply after reviewing full diff; BASE_CHANGED requires a new review.", [...identityFlags, ...mutationFlags, hashFlag, flag("report-id", "string", "Current passing report ID", true), flag("schema-hash", "string", "Formal hash from a recent diff"), flag("schema-absent", "boolean", "Explicitly confirm formal schema is absent")], "write");
+var schemaImportAbandon = command("abandon", "+schema-import-abandon", "Abandon candidate and invalidate pending tasks.", [...identityFlags, ...mutationFlags], "high-risk-write");
+var schemaImportCommands = [schemaDownload, schemaImport, schemaImportList, schemaImportStatus, schemaImportContent, schemaImportDiff, schemaImportSave, schemaImportValidate, schemaImportOptimize, schemaImportReject, schemaImportApply, schemaImportAbandon];
+
 // src/commands/te-kb/source-check-updates.ts
 var API_PATH = "/agent/api/external/knowledge-bases/sources/check-updates";
-function body(ctx) {
+function body2(ctx) {
   const scope = getExternalKnowledgeBaseTargetScope(ctx);
   return { name: ctx.str("name").trim(), sourceId: ctx.str("id").trim(), ...scope ? { scope } : {} };
 }
@@ -48,16 +174,16 @@ var sourceCheckUpdates = {
     { name: "scope", type: "string", desc: "Exact scope: personal | company (omit for personal then company lookup)" }
   ],
   validate: (ctx) => {
-    for (const [flag, max] of [["name", 200], ["id", 191]]) {
-      const value = ctx.str(flag).trim();
-      if (!value || value.length > max) throw new CliValidationError(`Invalid --${flag}: expected 1-${max} characters.`);
+    for (const [flag2, max] of [["name", 200], ["id", 191]]) {
+      const value = ctx.str(flag2).trim();
+      if (!value || value.length > max) throw new CliValidationError(`Invalid --${flag2}: expected 1-${max} characters.`);
     }
     getExternalKnowledgeBaseTargetScope(ctx);
   },
-  dryRun: (ctx) => ({ method: "POST", url: `${ctx.host().replace(/\/$/, "")}${API_PATH}`, body: body(ctx) }),
+  dryRun: (ctx) => ({ method: "POST", url: `${ctx.host().replace(/\/$/, "")}${API_PATH}`, body: body2(ctx) }),
   execute: async (ctx) => {
     try {
-      return await kbApi(ctx, "POST", API_PATH, {}, body(ctx), { preserveErrorMetadata: true });
+      return await kbApi(ctx, "POST", API_PATH, {}, body2(ctx), { preserveErrorMetadata: true });
     } catch (error) {
       const hint = "Read kb +list-sources to confirm the current source state before retrying.";
       if (error instanceof PermissionError) {
@@ -85,13 +211,13 @@ var sourceCheckUpdates = {
 };
 
 // src/commands/te-kb/source-mutation.ts
-import { promises as fs } from "fs";
-import path from "path";
+import { promises as fs2 } from "fs";
+import path2 from "path";
 var API = "/agent/api/external/knowledge-bases";
 var apiOptions = { preserveErrorMetadata: true };
 var maxBytes = 50 * 1024 * 1024;
 var fileExtensions = /* @__PURE__ */ new Set([".md", ".markdown", ".txt", ".csv", ".pdf", ".doc", ".docx", ".xls", ".xlsx", ".ppt", ".pptx", ".jpg", ".jpeg", ".png", ".gif", ".webp", ".bmp", ".svg"]);
-var identityFlags = [
+var identityFlags2 = [
   { name: "name", type: "string", required: true, desc: "Exact knowledge base name from kb +list" },
   { name: "scope", type: "string", required: true, desc: "Exact knowledge base scope: personal or company" },
   { name: "id", type: "string", required: true, desc: "Current stable source ID from kb +list-sources" }
@@ -100,24 +226,24 @@ var typeFlag = { name: "source-type", type: "string", required: true, desc: "Cur
 var revisionFlag = { name: "expected-revision", type: "number", required: true, min: 1, max: 2147483647, desc: "Current contentRevision from kb +list-sources; never automatically retry a conflict" };
 var previewFlag = { name: "preview-id", type: "string", required: true, desc: "Exact previewId returned by ZIP replace or restore" };
 function validateIdentity(ctx) {
-  for (const [flag, max] of [["name", 200], ["id", 191], ["preview-id", 191]]) {
-    const value = ctx.str(flag);
-    if ((flag !== "preview-id" || value) && (!value.trim() || value.length > max || /[\x00-\x1f\x7f]/.test(value))) {
-      throw new CliValidationError(`--${flag} must contain 1 to ${max} characters without control characters.`);
+  for (const [flag2, max] of [["name", 200], ["id", 191], ["preview-id", 191]]) {
+    const value = ctx.str(flag2);
+    if ((flag2 !== "preview-id" || value) && (!value.trim() || value.length > max || /[\x00-\x1f\x7f]/.test(value))) {
+      throw new CliValidationError(`--${flag2} must contain 1 to ${max} characters without control characters.`);
     }
   }
   if (!["personal", "company"].includes(ctx.str("scope"))) throw new CliValidationError("--scope must be personal or company.");
 }
-function positiveInteger(ctx, flag) {
-  const value = ctx.num(flag);
-  if (!Number.isSafeInteger(value) || value < 1 || value > 2147483647) throw new CliValidationError(`--${flag} must be an integer from 1 to 2147483647.`);
+function positiveInteger(ctx, flag2) {
+  const value = ctx.num(flag2);
+  if (!Number.isSafeInteger(value) || value < 1 || value > 2147483647) throw new CliValidationError(`--${flag2} must be an integer from 1 to 2147483647.`);
 }
 function validateMutation(ctx) {
   validateIdentity(ctx);
   positiveInteger(ctx, "expected-revision");
   if (!["file", "zip"].includes(ctx.str("source-type"))) throw new CliValidationError("--source-type must be file or zip; URL sources cannot be replaced or restored.");
 }
-function query(ctx) {
+function query2(ctx) {
   return { name: ctx.str("name").trim(), scope: ctx.str("scope") };
 }
 function sourceEndpoint(ctx, suffix) {
@@ -126,22 +252,22 @@ function sourceEndpoint(ctx, suffix) {
 function previewEndpoint(ctx) {
   return sourceEndpoint(ctx, `directory/previews/${encodeURIComponent(ctx.str("preview-id").trim())}`);
 }
-function dryRequest(ctx, method, endpoint2, body2) {
-  return { method, url: `${ctx.host().replace(/\/$/, "")}${endpoint2}`, params: query(ctx), ...body2 === void 0 ? {} : { body: body2 } };
+function dryRequest(ctx, method, endpoint3, body3) {
+  return { method, url: `${ctx.host().replace(/\/$/, "")}${endpoint3}`, params: query2(ctx), ...body3 === void 0 ? {} : { body: body3 } };
 }
 async function replacementFile(ctx, read) {
-  const file = path.resolve(ctx.str("file"));
-  const extension = path.extname(file).toLowerCase();
+  const file = path2.resolve(ctx.str("file"));
+  const extension = path2.extname(file).toLowerCase();
   if (ctx.str("source-type") === "zip" ? extension !== ".zip" : !fileExtensions.has(extension)) {
     throw new CliValidationError("--file must be a ZIP for a ZIP source, or a supported non-ZIP file for a file source. File sources must keep their original format.");
   }
-  const handle = await fs.open(file, "r");
+  const handle = await fs2.open(file, "r");
   try {
     const stat = await handle.stat();
     if (!stat.isFile() || stat.size > maxBytes) throw new CliValidationError("--file must be a regular file of at most 50 MB.");
     const content = read ? await handle.readFile() : void 0;
     if (content && content.length > maxBytes) throw new CliValidationError("--file exceeds 50 MB.");
-    return { file, filename: path.basename(file), sizeBytes: content?.length ?? stat.size, content };
+    return { file, filename: path2.basename(file), sizeBytes: content?.length ?? stat.size, content };
   } finally {
     await handle.close();
   }
@@ -158,7 +284,7 @@ var sourceReplace = {
   command: "replace",
   risk: "write",
   description: "Replace a file source draft, or prepare a ZIP archive replacement preview. ZIP changes require source commit. Does not compile or publish.",
-  flags: [...identityFlags, typeFlag, revisionFlag, { name: "file", type: "string", required: true, desc: "Local replacement file, at most 50 MB; same format, different filename allowed" }],
+  flags: [...identityFlags2, typeFlag, revisionFlag, { name: "file", type: "string", required: true, desc: "Local replacement file, at most 50 MB; same format, different filename allowed" }],
   validate: (ctx) => {
     validateMutation(ctx);
     if (!ctx.str("file").trim()) throw new CliValidationError("--file is required.");
@@ -172,7 +298,7 @@ var sourceReplace = {
     const form = new FormData();
     form.append("file", new Blob([new Uint8Array(file.content)]), file.filename);
     for (const [key, value] of Object.entries(replaceFields(ctx))) form.append(key, String(value));
-    return kbUpload(ctx, replaceEndpoint(ctx), form, query(ctx), { ...apiOptions, method: ctx.str("source-type") === "zip" ? "POST" : "PUT" });
+    return kbUpload(ctx, replaceEndpoint(ctx), form, query2(ctx), { ...apiOptions, method: ctx.str("source-type") === "zip" ? "POST" : "PUT" });
   }
 };
 function restoreEndpoint(ctx) {
@@ -188,7 +314,7 @@ var sourceRestore = {
   risk: "write",
   description: "Restore one current source draft from a published version. File sources restore immediately; ZIP source or child restores return a preview. Does not roll back the whole knowledge base or publish.",
   flags: [
-    ...identityFlags,
+    ...identityFlags2,
     typeFlag,
     revisionFlag,
     { name: "version", type: "number", required: true, min: 1, max: 2147483647, desc: "Published version number from kb +versions; use the latest number to discard unpublished changes" },
@@ -203,7 +329,7 @@ var sourceRestore = {
     }
   },
   dryRun: (ctx) => dryRequest(ctx, "POST", restoreEndpoint(ctx), restoreBody(ctx)),
-  execute: (ctx) => kbApi(ctx, "POST", restoreEndpoint(ctx), query(ctx), restoreBody(ctx), apiOptions)
+  execute: (ctx) => kbApi(ctx, "POST", restoreEndpoint(ctx), query2(ctx), restoreBody(ctx), apiOptions)
 };
 var sourcePreview = {
   service: "kb",
@@ -212,7 +338,7 @@ var sourcePreview = {
   risk: "read",
   description: "Read one page of a ZIP replacement or restore preview, including additions, modifications and deletions.",
   flags: [
-    ...identityFlags,
+    ...identityFlags2,
     previewFlag,
     { name: "cursor", type: "string", desc: "Opaque nextCursor returned by the previous preview page" },
     { name: "limit", type: "number", default: 100, min: 1, max: 200, desc: "Preview page size from 1 to 200" }
@@ -222,8 +348,8 @@ var sourcePreview = {
     if (!Number.isInteger(ctx.num("limit")) || ctx.num("limit") < 1 || ctx.num("limit") > 200) throw new CliValidationError("--limit must be an integer from 1 to 200.");
     if (ctx.str("cursor").length > 4096) throw new CliValidationError("--cursor must be at most 4096 characters.");
   },
-  dryRun: (ctx) => ({ ...dryRequest(ctx, "GET", previewEndpoint(ctx)), params: { ...query(ctx), limit: ctx.num("limit"), ...ctx.str("cursor") ? { cursor: ctx.str("cursor") } : {} } }),
-  execute: (ctx) => kbApi(ctx, "GET", previewEndpoint(ctx), { ...query(ctx), limit: ctx.num("limit"), ...ctx.str("cursor") ? { cursor: ctx.str("cursor") } : {} }, void 0, apiOptions)
+  dryRun: (ctx) => ({ ...dryRequest(ctx, "GET", previewEndpoint(ctx)), params: { ...query2(ctx), limit: ctx.num("limit"), ...ctx.str("cursor") ? { cursor: ctx.str("cursor") } : {} } }),
+  execute: (ctx) => kbApi(ctx, "GET", previewEndpoint(ctx), { ...query2(ctx), limit: ctx.num("limit"), ...ctx.str("cursor") ? { cursor: ctx.str("cursor") } : {} }, void 0, apiOptions)
 };
 var sourceCommit = {
   service: "kb",
@@ -231,13 +357,13 @@ var sourceCommit = {
   command: "commit",
   risk: "high-risk-write",
   description: "Confirm a reviewed ZIP replacement or restore preview. May delete missing files; changes only the draft. On uncertain outcome, inspect state before any retry.",
-  flags: [...identityFlags, previewFlag, revisionFlag],
+  flags: [...identityFlags2, previewFlag, revisionFlag],
   validate: (ctx) => {
     validateIdentity(ctx);
     positiveInteger(ctx, "expected-revision");
   },
   dryRun: (ctx) => dryRequest(ctx, "POST", `${previewEndpoint(ctx)}/commit`, { expectedRevision: ctx.num("expected-revision"), confirmed: true }),
-  execute: (ctx) => kbApi(ctx, "POST", `${previewEndpoint(ctx)}/commit`, query(ctx), { expectedRevision: ctx.num("expected-revision"), confirmed: true }, apiOptions)
+  execute: (ctx) => kbApi(ctx, "POST", `${previewEndpoint(ctx)}/commit`, query2(ctx), { expectedRevision: ctx.num("expected-revision"), confirmed: true }, apiOptions)
 };
 var sourceCancel = {
   service: "kb",
@@ -245,18 +371,18 @@ var sourceCancel = {
   command: "cancel",
   risk: "high-risk-write",
   description: "Discard an uncommitted ZIP replacement or restore preview; leaves the source draft unchanged.",
-  flags: [...identityFlags, previewFlag],
+  flags: [...identityFlags2, previewFlag],
   validate: validateIdentity,
   dryRun: (ctx) => dryRequest(ctx, "DELETE", previewEndpoint(ctx)),
   execute: async (ctx) => {
-    await kbApi(ctx, "DELETE", previewEndpoint(ctx), query(ctx), void 0, { ...apiOptions, responseType: "empty" });
+    await kbApi(ctx, "DELETE", previewEndpoint(ctx), query2(ctx), void 0, { ...apiOptions, responseType: "empty" });
     return { previewId: ctx.str("preview-id"), cancelled: true };
   }
 };
 
 // src/commands/te-kb/add.ts
-import { promises as fs2 } from "fs";
-import * as path2 from "path";
+import { promises as fs3 } from "fs";
+import * as path3 from "path";
 import TurndownService from "turndown";
 var API_PATH2 = "/agent/api/external/knowledge-bases/sources/upload";
 var SUPPORTED_EXTENSIONS = /* @__PURE__ */ new Set([
@@ -305,7 +431,7 @@ function sanitizeFilename(name) {
   return cleaned || "document";
 }
 function getMimeType(filename) {
-  const ext = path2.extname(filename).toLowerCase();
+  const ext = path3.extname(filename).toLowerCase();
   switch (ext) {
     case ".zip":
       return "application/zip";
@@ -348,23 +474,23 @@ function getMimeType(filename) {
   }
 }
 async function readLocalFile(filePath) {
-  const ext = path2.extname(filePath).toLowerCase();
+  const ext = path3.extname(filePath).toLowerCase();
   if (!SUPPORTED_EXTENSIONS.has(ext)) {
     throw new Error(`Unsupported file extension (${ext || "none"}): ${filePath}`);
   }
-  const content = await fs2.readFile(filePath);
-  const filename = path2.basename(filePath);
+  const content = await fs3.readFile(filePath);
+  const filename = path3.basename(filePath);
   return { filename, content, mimeType: getMimeType(filename), origin: "file", source: filePath };
 }
 async function readDirectory(dir) {
-  const entries = await fs2.readdir(dir, { withFileTypes: true });
+  const entries = await fs3.readdir(dir, { withFileTypes: true });
   const files = [];
   for (const entry of entries) {
     if (!entry.isFile()) continue;
-    const ext = path2.extname(entry.name).toLowerCase();
+    const ext = path3.extname(entry.name).toLowerCase();
     if (!SUPPORTED_EXTENSIONS.has(ext)) continue;
-    const full = path2.join(dir, entry.name);
-    const content = await fs2.readFile(full);
+    const full = path3.join(dir, entry.name);
+    const content = await fs3.readFile(full);
     files.push({ filename: entry.name, content, mimeType: getMimeType(entry.name), origin: "dir", source: full });
   }
   if (files.length === 0) {
@@ -399,10 +525,10 @@ async function fetchAsMarkdown(rawUrl) {
   };
 }
 async function resolveLocalPath(p) {
-  const abs = path2.resolve(p);
+  const abs = path3.resolve(p);
   let stat;
   try {
-    stat = await fs2.stat(abs);
+    stat = await fs3.stat(abs);
   } catch {
     throw new Error(`Path not found: ${p}`);
   }
@@ -438,7 +564,7 @@ function dedupeByFilename(files) {
     const count = used.get(f.filename) ?? 0;
     used.set(f.filename, count + 1);
     if (count === 0) return f;
-    const ext = path2.extname(f.filename);
+    const ext = path3.extname(f.filename);
     const stem = f.filename.slice(0, f.filename.length - ext.length);
     return { ...f, filename: `${stem}-${count}${ext}` };
   });
@@ -473,17 +599,17 @@ var add = {
   },
   dryRun: (ctx) => {
     const items = normalizeFilesInput(ctx.json("files"));
-    const body2 = {
+    const body3 = {
       name: ctx.str("name")
     };
     const scope = getExternalKnowledgeBaseTargetScope(ctx);
-    if (scope) body2.scope = scope;
-    body2.files = items.map((item) => ({ value: item, type: classifyInput(item) }));
-    body2.contentType = "multipart/form-data";
+    if (scope) body3.scope = scope;
+    body3.files = items.map((item) => ({ value: item, type: classifyInput(item) }));
+    body3.contentType = "multipart/form-data";
     return {
       method: "POST",
       url: `${ctx.host().replace(/\/$/, "")}${API_PATH2}`,
-      body: body2
+      body: body3
     };
   },
   execute: async (ctx) => {
@@ -510,15 +636,15 @@ function getMode(ctx) {
   return mode;
 }
 function buildBody(ctx) {
-  const body2 = {
+  const body3 = {
     name: ctx.str("name"),
     mode: getMode(ctx)
   };
   const scope = getExternalKnowledgeBaseTargetScope(ctx);
-  if (scope) body2.scope = scope;
+  if (scope) body3.scope = scope;
   const model = ctx.str("model");
-  if (model) body2.model = model;
-  return body2;
+  if (model) body3.model = model;
+  return body3;
 }
 var compile = {
   service: "kb",
@@ -546,10 +672,10 @@ var compile = {
 // src/commands/te-kb/remove.ts
 var API_PATH4 = "/agent/api/external/knowledge-bases";
 function buildBody2(ctx) {
-  const body2 = { name: ctx.str("name") };
+  const body3 = { name: ctx.str("name") };
   const scope = getExternalKnowledgeBaseTargetScope(ctx);
-  if (scope) body2.scope = scope;
-  return body2;
+  if (scope) body3.scope = scope;
+  return body3;
 }
 var remove = {
   service: "kb",
@@ -600,19 +726,19 @@ function normalizeTags(raw) {
   return tags;
 }
 function buildBody3(ctx) {
-  const body2 = {
+  const body3 = {
     scope: getScope(ctx),
     name: ctx.str("name")
   };
   const description = ctx.str("description");
-  if (description) body2.description = description;
+  if (description) body3.description = description;
   const tags = normalizeTags(ctx.json("tags"));
-  if (tags && tags.length > 0) body2.tags = tags;
+  if (tags && tags.length > 0) body3.tags = tags;
   const projectId = ctx.str("project-id");
-  if (projectId) body2.projectId = projectId;
+  if (projectId) body3.projectId = projectId;
   const projectName = ctx.str("project-name");
-  if (projectName) body2.projectName = projectName;
-  return body2;
+  if (projectName) body3.projectName = projectName;
+  return body3;
 }
 var create = {
   service: "kb",
@@ -649,12 +775,12 @@ function sourceSelector(ctx) {
   throw new CliValidationError("One of --id or --display-name is required.");
 }
 function buildBody4(ctx) {
-  const body2 = {
+  const body3 = {
     name: ctx.str("name")
   };
   const scope = getExternalKnowledgeBaseTargetScope(ctx);
-  if (scope) body2.scope = scope;
-  return { ...body2, ...sourceSelector(ctx) };
+  if (scope) body3.scope = scope;
+  return { ...body3, ...sourceSelector(ctx) };
 }
 var rmSource = {
   service: "kb",
@@ -682,8 +808,8 @@ var rmSource = {
 };
 
 // src/commands/te-kb/schema.ts
-import fs3 from "fs";
-import path3 from "path";
+import fs4 from "fs";
+import path4 from "path";
 var API_PATH7 = "/agent/api/external/knowledge-bases/schema";
 var MAX_CUSTOM_INSTRUCTIONS_CHARS = 1e4;
 function getCustomInstructions(ctx) {
@@ -692,7 +818,7 @@ function getCustomInstructions(ctx) {
   if (inline && file) {
     throw new Error("Use either --custom-instructions or --custom-instructions-file, not both.");
   }
-  const content = file ? fs3.readFileSync(path3.resolve(file), "utf8") : inline;
+  const content = file ? fs4.readFileSync(path4.resolve(file), "utf8") : inline;
   if (file && !content.trim()) {
     throw new Error("--custom-instructions-file is empty.");
   }
@@ -702,17 +828,17 @@ function getCustomInstructions(ctx) {
   return content;
 }
 function buildBody5(ctx) {
-  const body2 = {
+  const body3 = {
     name: ctx.str("name")
   };
   const scope = getExternalKnowledgeBaseTargetScope(ctx);
-  if (scope) body2.scope = scope;
-  if (ctx.bool("force")) body2.force = true;
+  if (scope) body3.scope = scope;
+  if (ctx.bool("force")) body3.force = true;
   const model = ctx.str("model");
-  if (model) body2.model = model;
+  if (model) body3.model = model;
   const customInstructions = getCustomInstructions(ctx);
-  if (customInstructions) body2.customInstructions = customInstructions;
-  return body2;
+  if (customInstructions) body3.customInstructions = customInstructions;
+  return body3;
 }
 async function executeSchema(ctx, api = kbApi) {
   return api(ctx, "POST", API_PATH7, {}, buildBody5(ctx), {
@@ -759,12 +885,12 @@ var schema = {
 // src/commands/te-kb/status.ts
 var API_PATH8 = "/agent/api/external/knowledge-bases/status";
 function buildBody6(ctx) {
-  const body2 = {
+  const body3 = {
     name: ctx.str("name")
   };
   const scope = getExternalKnowledgeBaseTargetScope(ctx);
-  if (scope) body2.scope = scope;
-  return body2;
+  if (scope) body3.scope = scope;
+  return body3;
 }
 var status = {
   service: "kb",
@@ -789,12 +915,12 @@ var status = {
 // src/commands/te-kb/kb-index.ts
 var API_PATH9 = "/agent/api/external/knowledge-bases/index";
 function buildBody7(ctx) {
-  const body2 = {};
+  const body3 = {};
   const sources = ctx.json("sources");
-  if (sources) body2.sources = sources;
+  if (sources) body3.sources = sources;
   const locale = ctx.str("locale");
-  if (locale) body2.locale = locale;
-  return body2;
+  if (locale) body3.locale = locale;
+  return body3;
 }
 var kbIndex = {
   service: "kb",
@@ -836,12 +962,12 @@ function validateBuildStatus(ctx) {
   }
 }
 function buildBody8(ctx) {
-  const body2 = {
+  const body3 = {
     buildStatus: getBuildStatus(ctx)
   };
   const locale = ctx.str("locale");
-  if (locale) body2.locale = locale;
-  return body2;
+  if (locale) body3.locale = locale;
+  return body3;
 }
 var kbList = {
   service: "kb",
@@ -933,16 +1059,16 @@ var listSources = {
 // src/commands/te-kb/kb-grep.ts
 var API_PATH12 = "/agent/api/external/knowledge-bases/grep";
 function buildBody9(ctx) {
-  const body2 = {
+  const body3 = {
     query: ctx.str("query"),
     sources: ctx.json("sources"),
     paths: ctx.json("paths")
   };
   const topK = ctx.optionalNum("top-k");
-  if (topK !== void 0) body2.topK = topK;
+  if (topK !== void 0) body3.topK = topK;
   const locale = ctx.str("locale");
-  if (locale) body2.locale = locale;
-  return body2;
+  if (locale) body3.locale = locale;
+  return body3;
 }
 var kbGrep = {
   service: "kb",
@@ -1005,20 +1131,20 @@ function readLimit(ctx) {
   return limit;
 }
 function buildBody10(ctx) {
-  const body2 = {
+  const body3 = {
     source: ctx.json("source"),
     path: ctx.str("path")
   };
   const offset = ctx.optionalNum("offset");
-  if (offset !== void 0) body2.offset = offset;
+  if (offset !== void 0) body3.offset = offset;
   const limit = ctx.optionalNum("limit");
-  if (limit !== void 0) body2.limit = limit;
+  if (limit !== void 0) body3.limit = limit;
   const expand = readExpand(ctx);
-  if (expand) body2.expand = expand;
-  if (ctx.bool("outline")) body2.outline = true;
+  if (expand) body3.expand = expand;
+  if (ctx.bool("outline")) body3.outline = true;
   const locale = ctx.str("locale");
-  if (locale) body2.locale = locale;
-  return body2;
+  if (locale) body3.locale = locale;
+  return body3;
 }
 var kbRead = {
   service: "kb",
@@ -1081,12 +1207,12 @@ function isTransientAskPollError(error) {
     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)));
+async function pollUntilSettled(getStatus, executionId, options2 = {}) {
+  const intervalMs = options2.intervalMs ?? ASK_POLL_INTERVAL_MS;
+  const timeoutMs = options2.timeoutMs ?? ASK_POLL_TIMEOUT_MS;
+  const maxTransientFailures = options2.maxTransientFailures ?? ASK_MAX_TRANSIENT_POLL_FAILURES;
+  const now = options2.now ?? Date.now;
+  const sleep = options2.sleep ?? ((ms) => new Promise((resolve2) => setTimeout(resolve2, ms)));
   const startTime = now();
   let transientFailures = 0;
   while (true) {
@@ -1143,16 +1269,16 @@ function validateLocale(locale) {
   }
 }
 function buildBody11(ctx) {
-  const body2 = {
+  const body3 = {
     question: ctx.str("question")
   };
   const sources = ctx.json("sources");
-  if (sources) body2.sources = sources;
+  if (sources) body3.sources = sources;
   const modelId = ctx.str("model-id");
-  if (modelId) body2.modelId = modelId;
+  if (modelId) body3.modelId = modelId;
   const locale = ctx.str("locale");
-  if (locale) body2.locale = locale;
-  return body2;
+  if (locale) body3.locale = locale;
+  return body3;
 }
 var ask = {
   service: "kb",
@@ -1279,17 +1405,17 @@ function validateUrl(url2) {
   }
 }
 function buildBody12(ctx) {
-  const body2 = {
+  const body3 = {
     name: ctx.str("name"),
     url: ctx.str("url")
   };
   const scope = getExternalKnowledgeBaseTargetScope(ctx);
-  if (scope) body2.scope = scope;
+  if (scope) body3.scope = scope;
   const displayName = ctx.str("display-name");
-  if (displayName) body2.displayName = displayName;
+  if (displayName) body3.displayName = displayName;
   const parseInstruction = ctx.str("parse-instruction");
-  if (parseInstruction) body2.parseInstruction = parseInstruction;
-  return body2;
+  if (parseInstruction) body3.parseInstruction = parseInstruction;
+  return body3;
 }
 var url = {
   service: "kb",
@@ -1316,8 +1442,8 @@ var url = {
 };
 
 // src/commands/te-kb/import.ts
-import { promises as fs4 } from "fs";
-import path4 from "path";
+import { promises as fs5 } from "fs";
+import path5 from "path";
 var API_PATH15 = "/agent/api/external/knowledge-bases/import";
 var MAX_SNAPSHOT_ARCHIVE_BYTES = 50 * 1024 * 1024;
 var VALID_SCOPES2 = /* @__PURE__ */ new Set(["personal", "company"]);
@@ -1354,16 +1480,16 @@ function normalizeTags2(raw) {
   return tags;
 }
 function validateArchivePath(filePath) {
-  if (path4.extname(filePath).toLocaleLowerCase("en-US") !== ".zip") {
+  if (path5.extname(filePath).toLocaleLowerCase("en-US") !== ".zip") {
     throw new Error("--file must point to a .zip archive");
   }
 }
 async function readArchive(filePath) {
   validateArchivePath(filePath);
-  const absolutePath = path4.resolve(filePath);
+  const absolutePath = path5.resolve(filePath);
   let stat;
   try {
-    stat = await fs4.stat(absolutePath);
+    stat = await fs5.stat(absolutePath);
   } catch {
     throw new Error(`File not found: ${filePath}`);
   }
@@ -1373,7 +1499,7 @@ async function readArchive(filePath) {
   if (stat.size > MAX_SNAPSHOT_ARCHIVE_BYTES) {
     throw new Error("--file must not exceed 50 MB");
   }
-  return { absolutePath, bytes: await fs4.readFile(absolutePath) };
+  return { absolutePath, bytes: await fs5.readFile(absolutePath) };
 }
 function appendOptionalFields(ctx, form) {
   const description = ctx.str("description").trim();
@@ -1440,7 +1566,7 @@ var importSnapshot = {
     form.append(
       "file",
       new Blob([Uint8Array.from(archive.bytes)], { type: "application/zip" }),
-      path4.basename(archive.absolutePath)
+      path5.basename(archive.absolutePath)
     );
     form.append("name", ctx.str("name").trim());
     form.append("scope", getScope2(ctx));
@@ -1547,8 +1673,8 @@ var importStatus = {
 };
 
 // src/commands/te-kb/source-directory.ts
-import { promises as fs5 } from "fs";
-import path5 from "path";
+import { promises as fs6 } from "fs";
+import path6 from "path";
 var sourceFlags = [
   { name: "name", type: "string", required: true, desc: "Knowledge base name (personal then company)" },
   { name: "id", type: "string", required: true, desc: "ZIP source ID copied from +list-sources" }
@@ -1564,9 +1690,9 @@ var revisionFlag2 = {
 var apiOptions2 = { preserveErrorMetadata: true, retryUnauthorized: false };
 var maxFileBytes = 50 * 1024 * 1024;
 function validateIdentity2(ctx) {
-  for (const [flag, max] of [["name", 200], ["id", 191]]) {
-    const value = ctx.str(flag).trim();
-    if (!value || value.length > max) throw new CliValidationError(`Invalid --${flag}.`);
+  for (const [flag2, max] of [["name", 200], ["id", 191]]) {
+    const value = ctx.str(flag2).trim();
+    if (!value || value.length > max) throw new CliValidationError(`Invalid --${flag2}.`);
   }
 }
 function relativePath(ctx, allowRoot = false) {
@@ -1584,14 +1710,14 @@ function validateMutation2(ctx) {
     throw new CliValidationError("--expected-revision must be a positive safe integer.");
   }
 }
-function endpoint(ctx, suffix = "directory") {
+function endpoint2(ctx, suffix = "directory") {
   return `/agent/api/external/knowledge-bases/sources/${encodeURIComponent(ctx.str("id").trim())}/${suffix}`;
 }
-function query2(ctx) {
+function query3(ctx) {
   return { name: ctx.str("name").trim(), path: ctx.str("path") };
 }
-function preview(ctx, method, suffix = "directory", body2) {
-  return { method, url: `${ctx.host().replace(/\/$/, "")}${endpoint(ctx, suffix)}`, ...body2 ? { body: body2 } : { params: query2(ctx) } };
+function preview(ctx, method, suffix = "directory", body3) {
+  return { method, url: `${ctx.host().replace(/\/$/, "")}${endpoint2(ctx, suffix)}`, ...body3 ? { body: body3 } : { params: query3(ctx) } };
 }
 function mutationBody(ctx, operation) {
   return { name: ctx.str("name").trim(), expectedRevision: ctx.num("expected-revision"), operations: [operation] };
@@ -1614,9 +1740,9 @@ var sourceLs = {
       throw new CliValidationError("--limit must be an integer from 1 to 200.");
     }
   },
-  dryRun: (ctx) => ({ ...preview(ctx, "GET"), params: { ...query2(ctx), limit: ctx.num("limit"), ...ctx.str("cursor") ? { cursor: ctx.str("cursor") } : {} } }),
-  execute: (ctx) => kbApi(ctx, "GET", endpoint(ctx), {
-    ...query2(ctx),
+  dryRun: (ctx) => ({ ...preview(ctx, "GET"), params: { ...query3(ctx), limit: ctx.num("limit"), ...ctx.str("cursor") ? { cursor: ctx.str("cursor") } : {} } }),
+  execute: (ctx) => kbApi(ctx, "GET", endpoint2(ctx), {
+    ...query3(ctx),
     limit: ctx.num("limit"),
     ...ctx.str("cursor") ? { cursor: ctx.str("cursor") } : {}
   }, void 0, apiOptions2)
@@ -1639,12 +1765,12 @@ var sourceRead = {
   },
   dryRun: (ctx) => preview(ctx, "GET", "raw"),
   execute: async (ctx) => {
-    const result = await kbApi(ctx, "GET", endpoint(ctx, "raw"), query2(ctx), void 0, { ...apiOptions2, responseType: "bytes" });
+    const result = await kbApi(ctx, "GET", endpoint2(ctx, "raw"), query3(ctx), void 0, { ...apiOptions2, responseType: "bytes" });
     const bytes = Buffer.from(result.bytes);
     const metadata = { path: ctx.str("path"), sizeBytes: bytes.length, contentType: result.contentType };
     if (ctx.str("output")) {
-      const output = path5.resolve(ctx.str("output"));
-      await fs5.writeFile(output, bytes, { flag: "wx" });
+      const output = path6.resolve(ctx.str("output"));
+      await fs6.writeFile(output, bytes, { flag: "wx" });
       return { ...metadata, output };
     }
     if (ctx.str("encoding") === "base64") return { ...metadata, encoding: "base64", content: bytes.toString("base64") };
@@ -1656,8 +1782,8 @@ var sourceRead = {
   }
 };
 async function fileOperation(ctx, dryRun) {
-  const file = path5.resolve(ctx.str("file"));
-  const handle = await fs5.open(file, "r");
+  const file = path6.resolve(ctx.str("file"));
+  const handle = await fs6.open(file, "r");
   try {
     const stat = await handle.stat();
     if (!stat.isFile() || stat.size > maxFileBytes) throw new CliValidationError("--file must be a regular file of at most 50 MB.");
@@ -1692,7 +1818,7 @@ var sourcePut = {
     if (!["add", "replace"].includes(ctx.str("action"))) throw new CliValidationError("--action must be add or replace.");
   },
   dryRun: async (ctx) => preview(ctx, "POST", "directory", mutationBody(ctx, await fileOperation(ctx, true))),
-  execute: async (ctx) => kbApi(ctx, "POST", endpoint(ctx), {}, mutationBody(ctx, await fileOperation(ctx, false)), apiOptions2)
+  execute: async (ctx) => kbApi(ctx, "POST", endpoint2(ctx), {}, mutationBody(ctx, await fileOperation(ctx, false)), apiOptions2)
 };
 function deleteOperation(ctx) {
   return { action: "delete", path: ctx.str("path"), confirmed: true, ...ctx.bool("recursive") ? { recursive: true } : {} };
@@ -1710,15 +1836,15 @@ var sourceRm = {
   ],
   validate: validateMutation2,
   dryRun: (ctx) => preview(ctx, "POST", "directory", mutationBody(ctx, deleteOperation(ctx))),
-  execute: (ctx) => kbApi(ctx, "POST", endpoint(ctx), {}, mutationBody(ctx, deleteOperation(ctx)), apiOptions2)
+  execute: (ctx) => kbApi(ctx, "POST", endpoint2(ctx), {}, mutationBody(ctx, deleteOperation(ctx)), apiOptions2)
 };
 
 // src/commands/te-kb/version-management.ts
-import { promises as fs6 } from "fs";
-import path6 from "path";
+import { promises as fs7 } from "fs";
+import path7 from "path";
 var API2 = "/agent/api/external/knowledge-bases/versions";
 var apiOptions3 = { preserveErrorMetadata: true, retryUnauthorized: false };
-var targetFlags = [
+var targetFlags2 = [
   { name: "name", type: "string", required: true, minLength: 1, maxLength: 200, desc: "Exact knowledge base name copied from +list" },
   { name: "scope", type: "string", desc: "Exact personal or company scope; omit for personal then company lookup" }
 ];
@@ -1729,9 +1855,9 @@ var pagingFlags = [
   { name: "limit", type: "number", default: 100, min: 1, max: 200, desc: "Page size from 1 to 200" }
 ];
 var pathFlag2 = { name: "path", type: "string", desc: "Exact path relative to the historical source directory" };
-function positiveInteger2(ctx, flag) {
-  const value = ctx.num(flag);
-  if (!Number.isSafeInteger(value) || value < 1 || value > 2147483647) throw new CliValidationError(`--${flag} must be a positive integer no greater than 2147483647.`);
+function positiveInteger2(ctx, flag2) {
+  const value = ctx.num(flag2);
+  if (!Number.isSafeInteger(value) || value < 1 || value > 2147483647) throw new CliValidationError(`--${flag2} must be a positive integer no greater than 2147483647.`);
   return value;
 }
 function validateTarget(ctx) {
@@ -1760,12 +1886,12 @@ function validatePath(ctx, required = false) {
     throw new CliValidationError("--path must be a normalized relative path inside the historical source.");
   }
 }
-function query3(ctx) {
+function query4(ctx) {
   const scope = getExternalKnowledgeBaseTargetScope(ctx);
   return { name: ctx.str("name").trim(), ...scope ? { scope } : {} };
 }
 function pageQuery(ctx) {
-  return { ...query3(ctx), limit: ctx.num("limit"), ...ctx.str("cursor") ? { cursor: ctx.str("cursor") } : {} };
+  return { ...query4(ctx), limit: ctx.num("limit"), ...ctx.str("cursor") ? { cursor: ctx.str("cursor") } : {} };
 }
 function versionEndpoint(ctx, suffix = "") {
   return `${API2}/${positiveInteger2(ctx, "version")}${suffix}`;
@@ -1773,15 +1899,15 @@ function versionEndpoint(ctx, suffix = "") {
 function sourceEndpoint2(ctx, action) {
   return versionEndpoint(ctx, `/sources/${encodeURIComponent(ctx.str("id").trim())}/${action}`);
 }
-function preview2(ctx, endpoint2, params, body2) {
-  return { method: body2 ? "POST" : "GET", url: `${ctx.host().replace(/\/$/, "")}${endpoint2}`, params, ...body2 ? { body: body2 } : {} };
+function preview2(ctx, endpoint3, params, body3) {
+  return { method: body3 ? "POST" : "GET", url: `${ctx.host().replace(/\/$/, "")}${endpoint3}`, params, ...body3 ? { body: body3 } : {} };
 }
 var versions = {
   service: "kb",
   command: "+versions",
   risk: "read",
   description: "List immutable published versions and the latest version ID, one page at a time.",
-  flags: [...targetFlags, ...pagingFlags],
+  flags: [...targetFlags2, ...pagingFlags],
   validate: (ctx) => {
     validateTarget(ctx);
     validatePage(ctx);
@@ -1795,17 +1921,17 @@ var versionShow = {
   command: "+version-show",
   risk: "read",
   description: "Read one published version summary without reading current sources.",
-  flags: [...targetFlags, versionFlag],
+  flags: [...targetFlags2, versionFlag],
   validate: validateVersion,
-  dryRun: (ctx) => preview2(ctx, versionEndpoint(ctx), query3(ctx)),
-  execute: (ctx) => kbApi(ctx, "GET", versionEndpoint(ctx), query3(ctx), void 0, apiOptions3)
+  dryRun: (ctx) => preview2(ctx, versionEndpoint(ctx), query4(ctx)),
+  execute: (ctx) => kbApi(ctx, "GET", versionEndpoint(ctx), query4(ctx), void 0, apiOptions3)
 };
 var versionSources = {
   service: "kb",
   command: "+version-sources",
   risk: "read",
   description: "List historical sources and stable IDs from one immutable version.",
-  flags: [...targetFlags, versionFlag, ...pagingFlags, { name: "source-type", type: "string", desc: "Optional source type filter: file | url | zip" }],
+  flags: [...targetFlags2, versionFlag, ...pagingFlags, { name: "source-type", type: "string", desc: "Optional source type filter: file | url | zip" }],
   validate: (ctx) => {
     validateVersion(ctx);
     validatePage(ctx);
@@ -1819,21 +1945,21 @@ var versionDiff = {
   command: "+version-diff",
   risk: "read",
   description: "Compare historical source additions, deletions, content, and metadata between two versions.",
-  flags: [...targetFlags, { ...versionFlag, name: "from", desc: "Before version number" }, { ...versionFlag, name: "to", desc: "After version number" }],
+  flags: [...targetFlags2, { ...versionFlag, name: "from", desc: "Before version number" }, { ...versionFlag, name: "to", desc: "After version number" }],
   validate: (ctx) => {
     validateTarget(ctx);
     positiveInteger2(ctx, "from");
     positiveInteger2(ctx, "to");
   },
-  dryRun: (ctx) => preview2(ctx, `${API2}/compare`, { ...query3(ctx), from: ctx.num("from"), to: ctx.num("to") }),
-  execute: (ctx) => kbApi(ctx, "GET", `${API2}/compare`, { ...query3(ctx), from: ctx.num("from"), to: ctx.num("to") }, void 0, apiOptions3)
+  dryRun: (ctx) => preview2(ctx, `${API2}/compare`, { ...query4(ctx), from: ctx.num("from"), to: ctx.num("to") }),
+  execute: (ctx) => kbApi(ctx, "GET", `${API2}/compare`, { ...query4(ctx), from: ctx.num("from"), to: ctx.num("to") }, void 0, apiOptions3)
 };
 var versionTree = {
   service: "kb",
   command: "+version-tree",
   risk: "read",
   description: "List a historical ZIP or URL source directory without changing current files.",
-  flags: [...targetFlags, versionFlag, sourceFlag, pathFlag2, ...pagingFlags],
+  flags: [...targetFlags2, versionFlag, sourceFlag, pathFlag2, ...pagingFlags],
   validate: (ctx) => {
     validateSource(ctx);
     validatePath(ctx);
@@ -1847,30 +1973,30 @@ var versionRead = {
   command: "+version-read",
   risk: "read",
   description: "Preview one historical directory child file; unsupported or oversized files return metadata only.",
-  flags: [...targetFlags, versionFlag, sourceFlag, { ...pathFlag2, required: true }],
+  flags: [...targetFlags2, versionFlag, sourceFlag, { ...pathFlag2, required: true }],
   validate: (ctx) => {
     validateSource(ctx);
     validatePath(ctx, true);
   },
-  dryRun: (ctx) => preview2(ctx, sourceEndpoint2(ctx, "file"), { ...query3(ctx), path: ctx.str("path") }),
-  execute: (ctx) => kbApi(ctx, "GET", sourceEndpoint2(ctx, "file"), { ...query3(ctx), path: ctx.str("path") }, void 0, apiOptions3)
+  dryRun: (ctx) => preview2(ctx, sourceEndpoint2(ctx, "file"), { ...query4(ctx), path: ctx.str("path") }),
+  execute: (ctx) => kbApi(ctx, "GET", sourceEndpoint2(ctx, "file"), { ...query4(ctx), path: ctx.str("path") }, void 0, apiOptions3)
 };
 var versionDownload = {
   service: "kb",
   command: "+version-download",
   risk: "read",
   description: "Download one ordinary historical file source to a new local file. ZIP/URL directories cannot be downloaded.",
-  flags: [...targetFlags, versionFlag, sourceFlag, { name: "output", type: "string", required: true, desc: "New local output path; existing files are never overwritten" }],
+  flags: [...targetFlags2, versionFlag, sourceFlag, { name: "output", type: "string", required: true, desc: "New local output path; existing files are never overwritten" }],
   validate: (ctx) => {
     validateSource(ctx);
     if (!ctx.str("output").trim()) throw new CliValidationError("--output is required.");
   },
-  dryRun: (ctx) => ({ ...preview2(ctx, sourceEndpoint2(ctx, "raw"), query3(ctx)), output: path6.resolve(ctx.str("output")) }),
+  dryRun: (ctx) => ({ ...preview2(ctx, sourceEndpoint2(ctx, "raw"), query4(ctx)), output: path7.resolve(ctx.str("output")) }),
   execute: async (ctx) => {
-    const result = await kbApi(ctx, "GET", sourceEndpoint2(ctx, "raw"), query3(ctx), void 0, { ...apiOptions3, responseType: "bytes" });
-    const output = path6.resolve(ctx.str("output"));
+    const result = await kbApi(ctx, "GET", sourceEndpoint2(ctx, "raw"), query4(ctx), void 0, { ...apiOptions3, responseType: "bytes" });
+    const output = path7.resolve(ctx.str("output"));
     const bytes = Buffer.from(result.bytes);
-    await fs6.writeFile(output, bytes, { flag: "wx" });
+    await fs7.writeFile(output, bytes, { flag: "wx" });
     return { versionNumber: ctx.num("version"), sourceId: ctx.str("id").trim(), sizeBytes: String(bytes.length), output };
   }
 };
@@ -1883,7 +2009,7 @@ var rollback = {
   risk: "high-risk-write",
   description: "Restore an earlier version as a new publication. Replace target-source drafts, delete other compiled sources, and preserve unpublished additions. Reuse request-id on network retries.",
   flags: [
-    ...targetFlags,
+    ...targetFlags2,
     versionFlag,
     { name: "request-id", type: "string", required: true, maxLength: 191, desc: "Caller-generated stable ASCII request ID; reuse exactly for retries of this logical operation" },
     { name: "expected-latest-version-id", type: "string", required: true, maxLength: 191, desc: "latestVersionId returned by +versions; conflicts require fresh discovery and a new intentional request" }
@@ -1894,25 +2020,26 @@ var rollback = {
     const latest = ctx.str("expected-latest-version-id");
     if (!latest || latest.length > 191) throw new CliValidationError("--expected-latest-version-id must contain 1 to 191 characters.");
   },
-  dryRun: (ctx) => preview2(ctx, versionEndpoint(ctx, "/rollback"), query3(ctx), rollbackBody(ctx)),
-  execute: (ctx) => kbApi(ctx, "POST", versionEndpoint(ctx, "/rollback"), query3(ctx), rollbackBody(ctx), apiOptions3)
+  dryRun: (ctx) => preview2(ctx, versionEndpoint(ctx, "/rollback"), query4(ctx), rollbackBody(ctx)),
+  execute: (ctx) => kbApi(ctx, "POST", versionEndpoint(ctx, "/rollback"), query4(ctx), rollbackBody(ctx), apiOptions3)
 };
 var rollbackStatus = {
   service: "kb",
   command: "+rollback-status",
   risk: "read",
   description: "Read one persisted rollback operation without polling. A running operation with errorCode requires administrator review; never retry it as a new write.",
-  flags: [...targetFlags, { name: "operation-id", type: "string", required: true, minLength: 1, maxLength: 191, desc: "operationId returned by +rollback" }],
+  flags: [...targetFlags2, { name: "operation-id", type: "string", required: true, minLength: 1, maxLength: 191, desc: "operationId returned by +rollback" }],
   validate: (ctx) => {
     validateTarget(ctx);
     if (!ctx.str("operation-id").trim() || ctx.str("operation-id").length > 191) throw new CliValidationError("--operation-id must contain 1 to 191 characters.");
   },
-  dryRun: (ctx) => preview2(ctx, `${API2}/operations/${encodeURIComponent(ctx.str("operation-id").trim())}`, query3(ctx)),
-  execute: (ctx) => kbApi(ctx, "GET", `${API2}/operations/${encodeURIComponent(ctx.str("operation-id").trim())}`, query3(ctx), void 0, apiOptions3)
+  dryRun: (ctx) => preview2(ctx, `${API2}/operations/${encodeURIComponent(ctx.str("operation-id").trim())}`, query4(ctx)),
+  execute: (ctx) => kbApi(ctx, "GET", `${API2}/operations/${encodeURIComponent(ctx.str("operation-id").trim())}`, query4(ctx), void 0, apiOptions3)
 };
 
 // src/commands/te-kb/index.ts
 var commands = [
+  ...schemaImportCommands,
   sourceCheckUpdates,
   sourceReplace,
   sourceRestore,
@@ -1958,6 +2085,7 @@ export {
   compile,
   create,
   te_kb_default as default,
+  executeSchemaImport,
   importSnapshot,
   importStatus,
   kbGrep,
@@ -1970,6 +2098,19 @@ export {
   rollback,
   rollbackStatus,
   schema,
+  schemaDownload,
+  schemaImport,
+  schemaImportAbandon,
+  schemaImportApply,
+  schemaImportCommands,
+  schemaImportContent,
+  schemaImportDiff,
+  schemaImportList,
+  schemaImportOptimize,
+  schemaImportReject,
+  schemaImportSave,
+  schemaImportStatus,
+  schemaImportValidate,
   sourceCancel,
   sourceCheckUpdates,
   sourceCommit,
@@ -1988,5 +2129,6 @@ export {
   versionShow,
   versionSources,
   versionTree,
-  versions
+  versions,
+  waitSchemaImport
 };