@thinkingai/ae-cli 6.0.52 → 6.0.53

package/dist/{te-agent-K5MSPNHJ.js → te-agent-Z3HCTKR7.js}

@@ -11,17 +11,330 @@ import {
   putToMainApp,
   resolveTeClaudeBaseUrl,
   uploadToMainApp
-} from "./chunk-HBGADCKA.js";
+} from "./chunk-KJDOTPYU.js";
 import {
   buildCapabilityGatewayUrl,
   callCapabilityApi
-} from "./chunk-HFGZGYCG.js";
+} from "./chunk-QYXDJOLA.js";
 import "./chunk-Y74WTIKJ.js";
-import "./chunk-7XGFSUOM.js";
-import "./chunk-7FTTULED.js";
+import "./chunk-DU72X2IO.js";
+import "./chunk-IG3DYEIR.js";
 import {
   CliValidationError
-} from "./chunk-MAPZ7VB6.js";
+} from "./chunk-YVGXGTD6.js";
+
+// src/commands/te-agent/notifications.ts
+import { openSync, closeSync, fstatSync, readSync } from "fs";
+
+// src/commands/te-agent/approval-cli-client.ts
+var APPROVAL_GATEWAY_DOMAIN = "approval";
+var resolveApprovalApiBaseUrl = resolveTeClaudeBaseUrl;
+function buildApprovalCliUrl(ctx, path) {
+  return buildCapabilityGatewayUrl(resolveApprovalApiBaseUrl(ctx.host()), APPROVAL_GATEWAY_DOMAIN, path);
+}
+function requestApprovalCli(ctx, method, path, body, options = {}) {
+  return callCapabilityApi(
+    ctx.host(),
+    APPROVAL_GATEWAY_DOMAIN,
+    path,
+    method,
+    body,
+    {
+      apiBaseUrl: resolveApprovalApiBaseUrl(ctx.host()),
+      ...options,
+      retryOnInvalidTokenForbidden: false
+    }
+  );
+}
+function getApprovalCli(ctx, path) {
+  return requestApprovalCli(ctx, "GET", path);
+}
+function postApprovalCli(ctx, path, body, options = {}) {
+  return requestApprovalCli(ctx, "POST", path, body, options);
+}
+
+// src/commands/te-agent/notifications.ts
+var invalidUnicode = /[\uD800-\uDBFF](?![\uDC00-\uDFFF])|(?<![\uD800-\uDBFF])[\uDC00-\uDFFF]/u;
+var PREVIEW = "Dry-run is a local preview with zero business requests, not a permission check. Reading never marks notifications as read. Retry a send with the same client-request-id and identical content.";
+var flag = (name, desc, type = "string", required = false, sensitive = false) => ({ name, desc, type, required, sensitive });
+var validId = (value) => typeof value === "string" && value.length > 0 && value.length <= 191 && value.trim() === value && !/[\x00-\x1f\x7f]/.test(value);
+function ids(ctx, key) {
+  const value = ctx.json(key);
+  if (!Array.isArray(value) || value.length < 1 || value.length > 100 || value.some((v) => !validId(v)))
+    throw new CliValidationError(
+      "Provide a JSON array of 1-100 non-empty user or notification IDs."
+    );
+  return value;
+}
+function identifier(ctx) {
+  const value = ctx.str("notificationId");
+  if (!validId(value))
+    throw new CliValidationError(
+      "--notification-id must be a non-empty ID of at most 191 characters."
+    );
+  return encodeURIComponent(value);
+}
+function sendBody(ctx) {
+  const title = ctx.str("title");
+  if (!title.trim() || [...title].length > 200 || invalidUnicode.test(title))
+    throw new CliValidationError(
+      "--title must contain 1-200 Unicode characters."
+    );
+  const hasBody = ctx.has?.("body") ?? !!ctx.str("body");
+  const file = ctx.str("bodyFile");
+  if (file && hasBody)
+    throw new CliValidationError("Use either --body or --body-file, not both.");
+  let body = ctx.str("body");
+  if (file) {
+    let descriptor;
+    try {
+      descriptor = openSync(file, "r");
+      if (!fstatSync(descriptor).isFile())
+        throw new Error("Not a regular file");
+      const bytes = Buffer.alloc(16385);
+      let count = 0;
+      while (count < bytes.length) {
+        const n = readSync(
+          descriptor,
+          bytes,
+          count,
+          bytes.length - count,
+          null
+        );
+        if (!n) break;
+        count += n;
+      }
+      if (count > 16384) throw new Error("Too large");
+      body = new TextDecoder("utf-8", { fatal: true }).decode(
+        bytes.subarray(0, count)
+      );
+    } catch {
+      throw new CliValidationError(
+        "--body-file must be a readable UTF-8 text file of at most 16 KiB."
+      );
+    } finally {
+      if (descriptor !== void 0) closeSync(descriptor);
+    }
+  }
+  if (Buffer.byteLength(body) > 16384 || invalidUnicode.test(body))
+    throw new CliValidationError(
+      "--body must be valid Unicode text of at most 16 KiB."
+    );
+  const format = ctx.str("bodyFormat") || "text";
+  if (!["text", "markdown"].includes(format))
+    throw new CliValidationError("--body-format must be text or markdown.");
+  const key = ctx.str("clientRequestId");
+  if (!/^[\x21-\x7e]{1,128}$/.test(key))
+    throw new CliValidationError(
+      "--client-request-id must contain 1-128 printable ASCII characters without spaces."
+    );
+  return {
+    to_user_ids: ids(ctx, "toUserIds"),
+    title,
+    body,
+    body_format: format,
+    client_request_id: key
+  };
+}
+function query(ctx, mode) {
+  const params = new URLSearchParams();
+  if (mode !== "count") {
+    const limit = ctx.optionalNum("limit") ?? 20;
+    if (!Number.isInteger(limit) || limit < 1 || limit > 100)
+      throw new CliValidationError(
+        "--limit must be an integer between 1 and 100."
+      );
+    params.set("limit", String(limit));
+    const cursor = ctx.str("cursor");
+    if (cursor) {
+      if (cursor.length > (mode === "recipients" ? 191 : 2048))
+        throw new CliValidationError("--cursor is too long.");
+      params.set("cursor", cursor);
+    }
+  }
+  if (mode === "recipients") {
+    if (ctx.str("query").length > 100)
+      throw new CliValidationError("--query exceeds 100 characters.");
+    if (ctx.str("query")) params.set("query", ctx.str("query"));
+  } else {
+    for (const key of ["source", "type"]) {
+      const value = ctx.str(key);
+      if (value && (!/^[a-z][a-z0-9._-]*$/.test(value) || value.length > (key === "source" ? 64 : 128)))
+        throw new CliValidationError(`--${key} is invalid.`);
+      if (value) params.set(key, value);
+    }
+    for (const [key, name] of [
+      ["createdFrom", "created_from"],
+      ["createdBefore", "created_before"]
+    ]) {
+      const value = ctx.str(key);
+      if (value && (!/^\d{4}-\d{2}-\d{2}T.*(?:Z|[+-]\d{2}:\d{2})$/.test(value) || !Number.isFinite(Date.parse(value))))
+        throw new CliValidationError(
+          `${name} must be an ISO 8601 timestamp with a timezone.`
+        );
+      if (value) params.set(name, value);
+    }
+    if (ctx.str("createdFrom") && ctx.str("createdBefore") && Date.parse(ctx.str("createdFrom")) >= Date.parse(ctx.str("createdBefore")))
+      throw new CliValidationError(
+        "--created-from must be earlier than --created-before."
+      );
+    if (mode === "list") {
+      const status = ctx.str("readStatus") || "all";
+      if (!["all", "unread", "read"].includes(status))
+        throw new CliValidationError(
+          "--read-status must be all, unread, or read."
+        );
+      params.set("read_status", status);
+    }
+  }
+  return params.toString() ? `?${params}` : "";
+}
+function command(name, description, flags, method, path, body) {
+  return {
+    service: "agent",
+    resource: "notification",
+    command: name,
+    description,
+    helpText: PREVIEW,
+    flags,
+    risk: method === "GET" ? "read" : "write",
+    validate(ctx) {
+      path(ctx);
+      body?.(ctx);
+    },
+    dryRun(ctx) {
+      const payload = body?.(ctx);
+      return {
+        method,
+        url: buildCapabilityGatewayUrl(
+          resolveApprovalApiBaseUrl(ctx.host()),
+          "agent",
+          path(ctx)
+        ),
+        ...payload ? {
+          body: name === "send" ? { ...payload, title: "[redacted]", body: "[redacted]" } : payload
+        } : {}
+      };
+    },
+    execute(ctx) {
+      return callCapabilityApi(
+        ctx.host(),
+        "agent",
+        path(ctx),
+        method,
+        body?.(ctx),
+        {
+          apiBaseUrl: resolveApprovalApiBaseUrl(ctx.host()),
+          retryOnInvalidTokenForbidden: false,
+          retryOnUnauthorized: true
+        }
+      );
+    }
+  };
+}
+var pagination = [
+  flag("limit", "Page size, 1-100 (default 20)", "number"),
+  flag("cursor", "Opaque cursor from the previous response")
+];
+var filters = [
+  flag("source", "Exact producer filter"),
+  flag("type", "Exact notification type filter"),
+  flag("created-from", "Inclusive ISO 8601 creation timestamp"),
+  flag("created-before", "Exclusive ISO 8601 creation timestamp")
+];
+var notificationRecipients = command(
+  "recipients",
+  "Find enabled recipients in your company, including yourself",
+  [flag("query", "Search by name or display name"), ...pagination],
+  "GET",
+  (ctx) => `notifications/recipients${query(ctx, "recipients")}`
+);
+var notificationSend = command(
+  "send",
+  "Send an in-app user notification to explicit recipients",
+  [
+    flag(
+      "to-user-ids",
+      "Recipient user IDs as a JSON array, 1-100 entries",
+      "json",
+      true
+    ),
+    flag(
+      "title",
+      "Notification title, up to 200 Unicode characters",
+      "string",
+      true,
+      true
+    ),
+    flag("body", "Notification body, at most 16 KiB", "string", false, true),
+    flag(
+      "body-file",
+      "UTF-8 text file, mutually exclusive with --body",
+      "string",
+      false,
+      true
+    ),
+    flag("body-format", "text (default) or markdown"),
+    flag(
+      "client-request-id",
+      "Required stable idempotency key; reuse for identical retries",
+      "string",
+      true,
+      true
+    )
+  ],
+  "POST",
+  () => "notifications",
+  sendBody
+);
+var notificationList = command(
+  "list",
+  "List your notifications without changing read state",
+  [
+    ...filters,
+    ...pagination,
+    flag("read-status", "all (default), unread, or read")
+  ],
+  "GET",
+  (ctx) => `notifications${query(ctx, "list")}`
+);
+var notificationGet = command(
+  "get",
+  "Read a notification and its opaque business data",
+  [flag("notification-id", "Notification ID", "string", true)],
+  "GET",
+  (ctx) => `notifications/${identifier(ctx)}`
+);
+var notificationUnreadCount = command(
+  "unread-count",
+  "Count your visible unread notifications",
+  filters,
+  "GET",
+  (ctx) => `notifications/unread-count${query(ctx, "count")}`
+);
+var notificationMarkRead = command(
+  "mark-read",
+  "Mark only the specified notifications as read",
+  [
+    flag(
+      "notification-ids",
+      "Notification IDs as a JSON array, 1-100 entries",
+      "json",
+      true
+    )
+  ],
+  "POST",
+  () => "notifications/read",
+  (ctx) => ({ notification_ids: ids(ctx, "notificationIds") })
+);
+var notificationCommands = [
+  notificationRecipients,
+  notificationSend,
+  notificationList,
+  notificationGet,
+  notificationUnreadCount,
+  notificationMarkRead
+];
 
 // src/commands/te-agent/api-client.ts
 function getAgentApi(ctx, path) {
@@ -248,37 +561,10 @@ var getAgent = {
   }
 };
 
-// src/commands/te-agent/approval-cli-client.ts
-var APPROVAL_GATEWAY_DOMAIN = "approval";
-var resolveApprovalApiBaseUrl = resolveTeClaudeBaseUrl;
-function buildApprovalCliUrl(ctx, path) {
-  return buildCapabilityGatewayUrl(resolveApprovalApiBaseUrl(ctx.host()), APPROVAL_GATEWAY_DOMAIN, path);
-}
-function requestApprovalCli(ctx, method, path, body, options = {}) {
-  return callCapabilityApi(
-    ctx.host(),
-    APPROVAL_GATEWAY_DOMAIN,
-    path,
-    method,
-    body,
-    {
-      apiBaseUrl: resolveApprovalApiBaseUrl(ctx.host()),
-      ...options,
-      retryOnInvalidTokenForbidden: false
-    }
-  );
-}
-function getApprovalCli(ctx, path) {
-  return requestApprovalCli(ctx, "GET", path);
-}
-function postApprovalCli(ctx, path, body, options = {}) {
-  return requestApprovalCli(ctx, "POST", path, body, options);
-}
-
 // src/commands/te-agent/agent-context.ts
 function contextPath(ctx) {
-  const query = ctx.bool("includeMcpCredentials") ? "?include_mcp_credentials=true" : "";
-  return `agents/${encodeURIComponent(ctx.str("id"))}/context${query}`;
+  const query2 = ctx.bool("includeMcpCredentials") ? "?include_mcp_credentials=true" : "";
+  return `agents/${encodeURIComponent(ctx.str("id"))}/context${query2}`;
 }
 var getAgentContext = {
   service: "agent",
@@ -314,11 +600,11 @@ var agentIdFlag = {
   required: true,
   desc: "Personal Agent ID from agent +list-agents"
 };
-function requireId(ctx, key, flag) {
+function requireId(ctx, key, flag2) {
   const value = ctx.str(key);
   if (!value || value !== value.trim() || value.length > 191) {
     throw new CliValidationError(
-      `--${flag} must be a non-empty identifier of at most 191 characters`
+      `--${flag2} must be a non-empty identifier of at most 191 characters`
     );
   }
   return value;
@@ -536,10 +822,10 @@ function recipientsPath(ctx) {
   const limit = ctx.optionalNum("limit") ?? 20;
   if (!Number.isInteger(limit) || limit < 1 || limit > 50)
     throw new CliValidationError("--limit must be an integer between 1 and 50");
-  const query = ctx.str("query").trim();
-  if (query.length > 100) throw new CliValidationError("--query must not exceed 100 characters");
+  const query2 = ctx.str("query").trim();
+  if (query2.length > 100) throw new CliValidationError("--query must not exceed 100 characters");
   const params = new URLSearchParams({ limit: String(limit) });
-  if (query) params.set("query", query);
+  if (query2) params.set("query", query2);
   if (ctx.str("cursor")) params.set("cursor", requireId(ctx, "cursor", "cursor"));
   return `recipients?${params}`;
 }
@@ -2932,8 +3218,8 @@ function buildListPath(ctx) {
   if (status) params.set("status", status);
   if (limit) params.set("limit", String(ctx.num("limit")));
   if (agentSpaceId) params.set("agentSpaceId", agentSpaceId);
-  const query = params.toString();
-  return query ? `${BASE_PATH6}?${query}` : BASE_PATH6;
+  const query2 = params.toString();
+  return query2 ? `${BASE_PATH6}?${query2}` : BASE_PATH6;
 }
 function validateList(ctx) {
   const status = optional(ctx.str("status"));
@@ -3191,12 +3477,12 @@ var updateAutomation = {
 // src/commands/te-agent/sandbox-tools.ts
 import {
   accessSync,
-  closeSync,
+  closeSync as closeSync2,
   constants,
   existsSync as existsSync3,
   lstatSync,
-  openSync,
-  readSync,
+  openSync as openSync2,
+  readSync as readSync2,
   readdirSync,
   realpathSync
 } from "fs";
@@ -3211,12 +3497,12 @@ function hasControlCharacters(value) {
 }
 function readShimHeader(filePath, size) {
   const buffer = Buffer.alloc(Math.min(size, MAX_SHIM_BYTES));
-  const fd = openSync(filePath, "r");
+  const fd = openSync2(filePath, "r");
   try {
-    const bytesRead = readSync(fd, buffer, 0, buffer.length, 0);
+    const bytesRead = readSync2(fd, buffer, 0, buffer.length, 0);
     return buffer.toString("utf8", 0, bytesRead);
   } finally {
-    closeSync(fd);
+    closeSync2(fd);
   }
 }
 function parseShim(filePath) {
@@ -3250,11 +3536,11 @@ function parseShim(filePath) {
     }
     const tool = values.get("tool") ?? "";
     const version = values.get("version") || "unknown";
-    const command = values.get("command") ?? "";
+    const command2 = values.get("command") ?? "";
     const target = values.get("target") ?? "";
     const runtimeValue = values.get("runtime");
     const runtime = runtimeValue === "node" || runtimeValue === "native" ? runtimeValue : void 0;
-    if (!NAME_RE.test(tool) || !NAME_RE.test(command)) {
+    if (!NAME_RE.test(tool) || !NAME_RE.test(command2)) {
       return {
         ...fallback,
         managed: true,
@@ -3266,7 +3552,7 @@ function parseShim(filePath) {
         ...fallback,
         managed: true,
         tool,
-        command,
+        command: command2,
         reason: "invalid version or target marker"
       };
     }
@@ -3276,12 +3562,12 @@ function parseShim(filePath) {
         managed: true,
         tool,
         version,
-        command,
+        command: command2,
         target,
         reason: "invalid runtime marker"
       };
     }
-    return { managed: true, tool, version, command, target, runtime };
+    return { managed: true, tool, version, command: command2, target, runtime };
   } catch {
     return fallback;
   }
@@ -3678,8 +3964,8 @@ function buildQuery2(params) {
   for (const [key, value] of Object.entries(params)) {
     if (value !== void 0 && value !== "") searchParams.set(key, String(value));
   }
-  const query = searchParams.toString();
-  return query ? `?${query}` : "";
+  const query2 = searchParams.toString();
+  return query2 ? `?${query2}` : "";
 }
 function requestListPath(ctx) {
   return `requests${buildQuery2({
@@ -4089,6 +4375,7 @@ var retryApprovalEffect = {
 
 // src/commands/te-agent/index.ts
 var commands = [
+  ...notificationCommands,
   // Agent CRUD
   listAgents,
   createAgent,
@@ -4194,5 +4481,11 @@ var commands = [
 ];
 var te_agent_default = commands;
 export {
-  te_agent_default as default
+  te_agent_default as default,
+  notificationGet,
+  notificationList,
+  notificationMarkRead,
+  notificationRecipients,
+  notificationSend,
+  notificationUnreadCount
 };