@thinkingai/ae-cli 6.1.18 → 6.1.19

package/dist/capability-HYVVPG25.js

@@ -1,352 +0,0 @@
-import {
-  normalizeRiskLevel,
-  requiresConfirmation
-} from "./chunk-OO6XR6LK.js";
-import {
-  findGatewayDomain,
-  listRegisteredCapabilityDomains,
-  resolveGatewayDomain
-} from "./chunk-3KWQYGYI.js";
-import {
-  printError,
-  printOutput
-} from "./chunk-BYYS3ANB.js";
-import {
-  CapabilityGatewayError,
-  dryRunCapability,
-  executeCapability,
-  inspectCapability,
-  listCapabilities,
-  validateCapability
-} from "./chunk-OMPRXM3V.js";
-import "./chunk-6EIJSNBD.js";
-import "./chunk-J2DEBMRF.js";
-import {
-  SecureStoreAuthError,
-  resolveHost
-} from "./chunk-ZQKDZXDO.js";
-import {
-  safeJsonParse
-} from "./chunk-3FY3RJ26.js";
-import {
-  PermissionError
-} from "./chunk-UW5UN47B.js";
-import "./chunk-JHENBQ5B.js";
-
-// src/commands/capability/index.ts
-import * as readline from "readline";
-
-// src/commands/capability/helpers.ts
-import { readFileSync } from "fs";
-var CapabilityCommandValidationError = class extends Error {
-  constructor(message, hint, code) {
-    super(message);
-    this.hint = hint;
-    this.code = code;
-    this.name = "CapabilityCommandValidationError";
-  }
-  hint;
-  code;
-};
-function capabilityNamespace(capabilityId) {
-  return capabilityId.split(".")[0] ?? "";
-}
-function resolveCapabilityGatewayDomain(capabilityId, domainOverride) {
-  const cliDomain = domainOverride?.trim() || capabilityNamespace(capabilityId);
-  if (!cliDomain) {
-    throw new CapabilityCommandValidationError(
-      "Cannot determine the capability domain.",
-      "Pass --domain <domain>."
-    );
-  }
-  return resolveGatewayDomain(cliDomain, findGatewayDomain(cliDomain) ?? cliDomain);
-}
-function resolveCapabilityListDomain(cliDomain) {
-  if (!cliDomain) {
-    throw new CapabilityCommandValidationError(
-      "Cannot determine the capability domain.",
-      "Pass --domain <domain>."
-    );
-  }
-  const gatewayDomain = findGatewayDomain(cliDomain);
-  if (gatewayDomain === void 0) {
-    const registeredDomains = listRegisteredCapabilityDomains();
-    const registeredHint = registeredDomains.length > 0 ? `Registered domains: ${registeredDomains.join(", ")}.` : "No capability domains are registered in this ae-cli process.";
-    throw new CapabilityCommandValidationError(
-      `Capability domain '${cliDomain}' is not registered.`,
-      `${registeredHint} Do not guess domain names.`,
-      "CAPABILITY_DOMAIN_NOT_REGISTERED"
-    );
-  }
-  return resolveGatewayDomain(cliDomain, gatewayDomain);
-}
-function emptyCapabilityCatalogWarning(capabilities) {
-  if (capabilities.length > 0) {
-    return void 0;
-  }
-  return "No capabilities were returned. This does not prove that the project permission is missing. Stop discovery instead of guessing other domains or retrying. If capabilities are expected, verify the capability deployment, enabled features, and permissions.";
-}
-function parseOptionalProjectId(raw) {
-  if (raw === void 0) {
-    return void 0;
-  }
-  const value = raw.trim();
-  if (!/^[1-9]\d*$/.test(value)) {
-    throw new CapabilityCommandValidationError(
-      "--project-id must be a positive integer.",
-      "Example: --project-id 1"
-    );
-  }
-  const projectId = Number(value);
-  if (!Number.isSafeInteger(projectId)) {
-    throw new CapabilityCommandValidationError(
-      "--project-id is outside the supported integer range.",
-      "Pass a positive safe integer."
-    );
-  }
-  return projectId;
-}
-function normalizeCapabilityList(value) {
-  if (!Array.isArray(value)) {
-    throw new Error("Capability gateway returned an invalid catalog: expected an array.");
-  }
-  return value.filter((item) => {
-    return item !== null && typeof item === "object" && typeof item.id === "string";
-  });
-}
-function filterCapabilities(capabilities, domain, query) {
-  const prefix = `${domain.toLowerCase()}.`;
-  const terms = query?.trim().toLowerCase().split(/\s+/).filter(Boolean) ?? [];
-  return capabilities.filter((capability) => {
-    if (!capability.id.toLowerCase().startsWith(prefix)) {
-      return false;
-    }
-    if (terms.length === 0) {
-      return true;
-    }
-    const searchable = `${capability.id} ${capability.description ?? ""}`.toLowerCase();
-    return terms.every((term) => searchable.includes(term));
-  });
-}
-function parseCapabilityInput(raw) {
-  if (!raw) {
-    return {};
-  }
-  const trimmed = raw.trim();
-  let parsed;
-  try {
-    if (trimmed === "-") {
-      parsed = safeJsonParse(readFileSync(0, "utf8"));
-    } else if (trimmed.startsWith("{") || trimmed.startsWith("[")) {
-      parsed = safeJsonParse(trimmed);
-    } else {
-      const path = trimmed.startsWith("@") ? trimmed.slice(1) : trimmed;
-      parsed = safeJsonParse(readFileSync(path, "utf8"));
-    }
-  } catch (error) {
-    const message = error instanceof Error ? error.message : String(error);
-    throw new CapabilityCommandValidationError(
-      `Invalid capability input: ${message}`,
-      "Pass an inline JSON object, a JSON file path, @<path>, or - for stdin."
-    );
-  }
-  if (parsed === null || typeof parsed !== "object" || Array.isArray(parsed)) {
-    throw new CapabilityCommandValidationError(
-      "Capability input must be a JSON object.",
-      `Example: --input '{"project_id":1}'`
-    );
-  }
-  const input = parsed;
-  if (Object.prototype.hasOwnProperty.call(input, "projectId")) {
-    throw new CapabilityCommandValidationError(
-      "Unsupported capability input field: projectId.",
-      "Use the canonical snake_case field project_id.",
-      "UNSUPPORTED_INPUT_FIELDS"
-    );
-  }
-  return input;
-}
-
-// src/commands/capability/index.ts
-function registerCapability(program) {
-  const capability = program.command("capability").description("Discover and invoke capability gateway operations").action(() => {
-    printError("validation", "Missing subcommand.", "Run: ae-cli capability --help");
-    process.exitCode = 1;
-  });
-  capability.command("list").description("List capability summaries in a domain").requiredOption("--domain <domain>", "Capability namespace, such as analysis or metadata").option("--project-id <project-id>", "Filter by project membership, permissions, and enabled features").action(async (opts) => {
-    await executeAndPrint(program, async (host) => {
-      const gatewayDomain = resolveCapabilityListDomain(opts.domain);
-      const projectId = parseOptionalProjectId(opts.projectId);
-      const catalog = normalizeCapabilityList(await listCapabilities(host, gatewayDomain, projectId));
-      const capabilities = filterCapabilities(catalog, opts.domain);
-      const warning = emptyCapabilityCatalogWarning(catalog);
-      return {
-        domain: opts.domain,
-        count: capabilities.length,
-        capabilities,
-        ...warning ? { warning } : {}
-      };
-    });
-  }).addHelpText(
-    "after",
-    "\nExamples:\n  ae-cli capability list --domain analysis\n  ae-cli capability list --domain analysis --project-id 1"
-  );
-  capability.command("search").description("Search capability IDs and descriptions in a domain").argument("<query>", "Case-insensitive search terms").requiredOption(
-    "--domain <domain>",
-    "Capability namespace. One of: analysis, project, system, tracking, metadata, experiment, engage-flow, engage-task, engage-setting, engage-scene, engage-activity, engage-workbench, community"
-  ).option("--project-id <project-id>", "Filter by project membership, permissions, and enabled features").action(async (query, opts) => {
-    await executeAndPrint(program, async (host) => {
-      const gatewayDomain = resolveCapabilityListDomain(opts.domain);
-      const projectId = parseOptionalProjectId(opts.projectId);
-      const catalog = normalizeCapabilityList(await listCapabilities(host, gatewayDomain, projectId));
-      const capabilities = filterCapabilities(catalog, opts.domain, query);
-      const warning = emptyCapabilityCatalogWarning(catalog);
-      return {
-        domain: opts.domain,
-        query,
-        count: capabilities.length,
-        capabilities,
-        ...warning ? { warning } : {}
-      };
-    });
-  }).addHelpText(
-    "after",
-    '\nDomains (--domain):\n  analysis, project, system, tracking, metadata,\n  experiment, engage-flow, engage-task, engage-setting,\n  engage-scene, engage-activity, engage-workbench, community\n\nExamples:\n  ae-cli capability search "dashboard list" --domain analysis\n  ae-cli capability search "dashboard list" --domain analysis --project-id 1\n  ae-cli capability search "info list" --domain project\n  ae-cli capability search "usage" --domain system\n  ae-cli capability search "plan" --domain tracking\n  ae-cli capability search "data_table" --domain metadata\n  ae-cli capability search "report" --domain experiment\n  ae-cli capability search "flow" --domain engage-flow\n  ae-cli capability search "task" --domain engage-task\n  ae-cli capability search "channel" --domain engage-setting\n  ae-cli capability search "strategy" --domain engage-scene\n  ae-cli capability search "topic" --domain engage-activity\n  ae-cli capability search "workbench" --domain engage-workbench\n  ae-cli capability search "post" --domain community'
-  );
-  capability.command("inspect").description("Inspect one capability schema, risk, auth, and output metadata").argument("<capability-id>", "Capability ID, such as analysis.report.list").option("--domain <domain>", "Override the capability namespace used for gateway routing").option("--project-id <project-id>", "Check availability in a project before returning metadata").action(async (capabilityId, opts) => {
-    await executeAndPrint(program, async (host) => {
-      const gatewayDomain = resolveCapabilityGatewayDomain(capabilityId, opts.domain);
-      return inspectCapability(host, gatewayDomain, capabilityId, parseOptionalProjectId(opts.projectId));
-    });
-  }).addHelpText(
-    "after",
-    "\nExamples:\n  ae-cli capability inspect analysis.dashboard.list\n  ae-cli capability inspect analysis.dashboard.list --project-id 1"
-  );
-  capability.command("validate").description(
-    "Validate and normalize capability input only (schema/params). Does not execute business logic. Use when crafting complex payloads (nested objects, qp, share/member payloads) before dry-run/run. Success data: valid, capability_id, normalized_input. Unlike dry-run, does not return risk/output_mode/supports_cancel preview."
-  ).argument("<capability-id>", "Capability ID, such as metadata.data_table.sql_write").option("--domain <domain>", "Override the capability namespace used for gateway routing").option("--input <json-or-path>", "Input JSON object, file path, @<path>, or - for stdin").action(async (capabilityId, opts) => {
-    await executeAndPrint(program, async (host) => {
-      const gatewayDomain = resolveCapabilityGatewayDomain(capabilityId, opts.domain);
-      return validateCapability(host, gatewayDomain, capabilityId, parseCapabilityInput(opts.input));
-    });
-  }).addHelpText(
-    "after",
-    `
-When to use:
-  Prefer validate while iterating complex input (required fields, types, qp shape), then run.
-  Prefer dry-run alone when you need risk / output mode / cancelability or a delete gate.
-  Motto: validate = fix params; dry-run = confirm ready to run.
-  Do not stack validate + dry-run on the same final input by default (dry-run already validates params).
-  Neither mutates business data. Curated gateway commands: global --validate / --dry-run.
-
-Examples:
-  ae-cli capability validate metadata.data_table.sql_write --input '{"project_id":1,"operation":"create",...}'
-  ae-cli metadata data-table sql-write --project-id 1 ... --validate
-  ae-cli capability validate analysis.project_space.create --input input.json`
-  );
-  capability.command("dry-run").description(
-    "Full pre-execution confirmation without running business logic: validates/normalizes input and returns risk, output_mode, and supports_cancel. Use alone when you need that preview or a delete gate (do not stack after validate on the same final input by default). Global --dry-run on curated/capability run also hits this endpoint."
-  ).argument("<capability-id>", "Capability ID, such as analysis.query.export").option("--domain <domain>", "Override the capability namespace used for gateway routing").option("--input <json-or-path>", "Input JSON object, file path, @<path>, or - for stdin").action(async (capabilityId, opts) => {
-    await executeAndPrint(program, async (host) => {
-      const gatewayDomain = resolveCapabilityGatewayDomain(capabilityId, opts.domain);
-      return dryRunCapability(host, gatewayDomain, capabilityId, parseCapabilityInput(opts.input));
-    });
-  }).addHelpText(
-    "after",
-    `
-Examples:
-  ae-cli capability dry-run analysis.dashboard.list --input '{"project_id":1}'
-  ae-cli capability dry-run analysis.dashboard.list --input input.json`
-  );
-  capability.command("run").description("Execute one capability by ID").argument("<capability-id>", "Capability ID, such as analysis.report.list").option("--domain <domain>", "Override the capability namespace used for gateway routing").option("--input <json-or-path>", "Input JSON object, file path, @<path>, or - for stdin").action(async (capabilityId, opts) => {
-    await executeAndPrint(program, async (host, globalOpts) => {
-      const gatewayDomain = resolveCapabilityGatewayDomain(capabilityId, opts.domain);
-      const input = parseCapabilityInput(opts.input);
-      if (globalOpts.validate && globalOpts.dryRun) {
-        throw new CapabilityCommandValidationError(
-          "Cannot combine --validate and --dry-run.",
-          "Use --validate to fix parameters; use --dry-run as the pre-execution confirmation."
-        );
-      }
-      if (globalOpts.validate) {
-        return validateCapability(host, gatewayDomain, capabilityId, input);
-      }
-      if (globalOpts.dryRun) {
-        return dryRunCapability(host, gatewayDomain, capabilityId, input);
-      }
-      if (!globalOpts.yes) {
-        const metadata = await inspectCapability(host, gatewayDomain, capabilityId);
-        const risk = normalizeRiskLevel(typeof metadata?.risk === "string" ? metadata.risk : void 0);
-        if (requiresConfirmation(risk)) {
-          const confirmed = await confirm(`This capability is marked ${risk} (${capabilityId}). Continue?`);
-          if (!confirmed) {
-            process.stderr.write("Aborted.\n");
-            return void 0;
-          }
-        }
-      }
-      return executeCapability(host, gatewayDomain, capabilityId, input);
-    });
-  }).addHelpText(
-    "after",
-    `
-Examples:
-  ae-cli capability run analysis.dashboard.list --input '{"project_id":1}'
-  ae-cli capability run analysis.dashboard.list --input input.json`
-  );
-}
-async function executeAndPrint(program, action) {
-  const globalOpts = program.opts();
-  const host = resolveHost(globalOpts.host);
-  if (!host) {
-    printError("config", "No AE host configured.", "Run: ae-cli config set-host <url>");
-    process.exitCode = 1;
-    return;
-  }
-  try {
-    const result = await action(host, globalOpts);
-    if (result !== void 0) {
-      await printOutput(result, globalOpts.format ?? "json", globalOpts.jq);
-    }
-  } catch (error) {
-    if (error?.type === "validation" && String(error?.message || "").includes("--jq")) {
-      printError("validation", error.message, error.hint);
-      process.exitCode = 1;
-      return;
-    }
-    printCapabilityError(error);
-    process.exitCode = 1;
-  }
-}
-function printCapabilityError(error) {
-  if (error instanceof CapabilityCommandValidationError) {
-    printError("validation", error.message, error.hint, error.code);
-    return;
-  }
-  if (error instanceof SecureStoreAuthError) {
-    printError("auth", error.message, "Run: ae-cli auth login");
-    return;
-  }
-  if (error instanceof PermissionError) {
-    printError("permission", error.message, void 0, error.code);
-    return;
-  }
-  if (error instanceof CapabilityGatewayError) {
-    printError("api", error.message, error.hint, error.code);
-    return;
-  }
-  const message = error instanceof Error ? error.message : String(error);
-  printError("api", message);
-}
-async function confirm(message) {
-  const rl = readline.createInterface({ input: process.stdin, output: process.stderr });
-  return new Promise((resolve) => {
-    rl.question(`${message} [y/N] `, (answer) => {
-      rl.close();
-      resolve(answer.toLowerCase() === "y" || answer.toLowerCase() === "yes");
-    });
-  });
-}
-export {
-  registerCapability
-};