yuanflow-cli 0.1.0 → 0.1.1

package/src/ycloud/commands/index.js

@@ -1,381 +0,0 @@
-import {
-  executeAuthCharges,
-  executeAuthInfo,
-  executeAuthStatus,
-  executeAuthValidate,
-  getAuthHelp,
-} from "./auth.js";
-import {
-  executeAnalysisCreatorProfile,
-  getAnalysisHelp,
-} from "./analysis.js";
-import {
-  executeComplianceCheck,
-  getComplianceHelp,
-} from "./compliance.js";
-import {
-  buildExposedCommands,
-  executeCommandsDescribe,
-  executeCommandsList,
-  getCommandsHelp,
-} from "./commands.js";
-import {
-  executeConfigClearToken,
-  executeConfigGet,
-  executeConfigSetToken,
-  getConfigHelp,
-} from "./config.js";
-import { executeHealthCheck, getHealthHelp } from "./health.js";
-import { executeKbSearch, getKbHelp } from "./kb.js";
-import { executeSchema, getSchemaHelp } from "./schema.js";
-import { buildToolRegistry } from "./tool-registry.js";
-import {
-  createDomainHelp,
-  createToolCommandHelp,
-  executeRegisteredTool,
-} from "./tool-runner.js";
-import { executeToolCatalog, executeToolExecute, getToolHelp } from "./tool.js";
-import { executeVersionCheck, getVersionHelp } from "./version.js";
-
-const TOP_LEVEL_HELP = `YuanFlow CLI local command tool for Agent-friendly cloud API access.
-
-USAGE:
-    ycloud <command> [subcommand] [flags]
-
-EXAMPLES:
-    ycloud auth validate --output json
-    ycloud tool catalog --output json
-    ycloud kb search --query "短视频脚本结构" --top-k 5 --output json
-
-GLOBAL FLAGS:
-    --output <string>      output format: json (default) | text
-    --trace-id <string>    optional request trace id
-    --timeout <int>        request timeout in milliseconds
-    --base-url <string>    override API base URL
-    -h, --help             show help
-
-COMMANDS:
-    auth                   token validation and account info
-    health                 service health check
-    version                local CLI version info
-    tool                   tool catalog and tool execution
-    kb                     knowledge base search
-    analysis               creator analysis commands
-    compliance             compliance checking commands
-    config                 local CLI config management
-    commands               list and describe exposed commands
-    schema                 inspect command parameter schema from OpenAPI
-    content                wrapped content generation tools
-    social                 social media atomic tools
-    oss                    oss helper tools
-    speech                 speech helper tools
-`;
-
-function parseArgs(rawArgs) {
-  const tokens = [...rawArgs];
-  const options = {
-    output: "json",
-    traceId: undefined,
-    timeout: undefined,
-    baseUrl: undefined,
-    help: false,
-  };
-  const positional = [];
-
-  for (let index = 0; index < tokens.length; index += 1) {
-    const token = tokens[index];
-    if (token === "-h" || token === "--help") {
-      options.help = true;
-      continue;
-    }
-    if (token === "--output") {
-      options.output = tokens[index + 1] || "json";
-      index += 1;
-      continue;
-    }
-    if (token === "--trace-id") {
-      options.traceId = tokens[index + 1];
-      index += 1;
-      continue;
-    }
-    if (token === "--timeout") {
-      options.timeout = tokens[index + 1];
-      index += 1;
-      continue;
-    }
-    if (token === "--base-url") {
-      options.baseUrl = tokens[index + 1];
-      index += 1;
-      continue;
-    }
-    positional.push(token);
-  }
-
-  return { positional, options };
-}
-
-function getCommandName(positional) {
-  return `${positional[0] || ""} ${positional[1] || ""}`.trim() || "unknown";
-}
-
-function asJson(command, success, data, error = null, meta = {}, warnings = []) {
-  return {
-    success,
-    command,
-    data,
-    warnings,
-    error,
-    meta,
-  };
-}
-
-function renderJson(payload) {
-  return `${JSON.stringify(payload)}\n`;
-}
-
-function renderTextPayload(payload) {
-  const lines = [
-    `command: ${payload.command}`,
-    `success: ${payload.success}`,
-  ];
-
-  if (payload.error) {
-    lines.push(`error.code: ${payload.error.code}`);
-    lines.push(`error.message: ${payload.error.message}`);
-    lines.push(`error.retryable: ${payload.error.retryable}`);
-  }
-
-  if (payload.data !== null && payload.data !== undefined) {
-    lines.push("data:");
-    lines.push(JSON.stringify(payload.data, null, 2));
-  }
-
-  if (payload.meta && Object.keys(payload.meta).length > 0) {
-    lines.push("meta:");
-    lines.push(JSON.stringify(payload.meta, null, 2));
-  }
-
-  return `${lines.join("\n")}\n`;
-}
-
-function renderOutput(payload, globalOptions) {
-  if (globalOptions.output === "text") {
-    return renderTextPayload(payload);
-  }
-  return renderJson(payload);
-}
-
-function fail(command, code, message, exitCode = 1, retryable = false) {
-  const payload = asJson(command, false, null, { code, message, retryable }, {});
-  return {
-    code: exitCode,
-    output: renderOutput(payload, this?.globalOptions || { output: "json" }),
-  };
-}
-
-function ok(command, data, meta = {}) {
-  const payload = asJson(command, true, data, null, meta);
-  return {
-    code: 0,
-    output: renderOutput(payload, this?.globalOptions || { output: "json" }),
-  };
-}
-
-function text(commandHelp) {
-  return {
-    code: 0,
-    output: `${commandHelp}\n`,
-  };
-}
-
-function parseCommandFlags(tokens) {
-  const options = {};
-  for (let index = 0; index < tokens.length; index += 1) {
-    const token = tokens[index];
-    if (!token.startsWith("--")) {
-      continue;
-    }
-    const name = token.slice(2);
-    const next = tokens[index + 1];
-    if (!next || next.startsWith("--")) {
-      options[name] = true;
-      continue;
-    }
-    options[name] = next;
-    index += 1;
-  }
-  return options;
-}
-
-let cachedToolCatalogMap = null;
-let cachedToolRegistry = null;
-
-async function getToolCatalogMap() {
-  if (cachedToolCatalogMap) {
-    return cachedToolCatalogMap;
-  }
-  const { readFile } = await import("node:fs/promises");
-  const { join } = await import("node:path");
-  const { fileURLToPath } = await import("node:url");
-  const currentDir = fileURLToPath(new URL(".", import.meta.url));
-  const jsonText = await readFile(
-    join(currentDir, "..", "resources", "tool_catalog_full.json"),
-    "utf8",
-  );
-  const raw = JSON.parse(jsonText);
-  const items = raw.data?.data?.items || [];
-  cachedToolCatalogMap = new Map(items.map((item) => [item.tool_id, item]));
-  return cachedToolCatalogMap;
-}
-
-async function getToolRegistry() {
-  if (cachedToolRegistry) {
-    return cachedToolRegistry;
-  }
-  const catalogMap = await getToolCatalogMap();
-  cachedToolRegistry = buildToolRegistry(catalogMap);
-  return cachedToolRegistry;
-}
-
-function buildContext(globalOptions, commandName) {
-  return {
-    globalOptions,
-    commandName,
-    ok: ok.bind({ globalOptions }),
-    fail: fail.bind({ globalOptions }),
-    parseCommandFlags,
-  };
-}
-
-export async function executeCommand(rawArgs) {
-  const { positional, options } = parseArgs(rawArgs);
-  const commandName = getCommandName(positional);
-  const context = buildContext(options, commandName);
-  const toolRegistry = await getToolRegistry();
-  const catalogMap = await getToolCatalogMap();
-  const exposedCommands = buildExposedCommands(toolRegistry, catalogMap);
-  const allowedToolIds = new Set(
-    exposedCommands
-      .filter((item) => item.kind === "tool")
-      .map((item) => item.tool_id),
-  );
-
-  if (positional.length === 0 || options.help) {
-    if (positional.length === 0) {
-      return text(TOP_LEVEL_HELP);
-    }
-    if (positional[0] === "auth") {
-      return text(getAuthHelp(positional[1]));
-    }
-    if (positional[0] === "health") {
-      return text(getHealthHelp(positional[1]));
-    }
-    if (positional[0] === "version") {
-      return text(getVersionHelp(positional[1]));
-    }
-    if (positional[0] === "tool") {
-      return text(getToolHelp(positional[1]));
-    }
-    if (positional[0] === "kb") {
-      return text(getKbHelp(positional[1]));
-    }
-    if (positional[0] === "analysis") {
-      return text(getAnalysisHelp(positional[1]));
-    }
-    if (positional[0] === "compliance") {
-      return text(getComplianceHelp(positional[1]));
-    }
-    if (positional[0] === "config") {
-      return text(getConfigHelp(positional[1]));
-    }
-    if (positional[0] === "commands") {
-      return text(getCommandsHelp(positional[1]));
-    }
-    if (positional[0] === "schema") {
-      return text(getSchemaHelp());
-    }
-    if (toolRegistry[positional[0]]) {
-      if (positional[1]) {
-        const config = toolRegistry[positional[0]].commands[positional[1]];
-        if (config) {
-          return text(
-            createToolCommandHelp(
-              positional[0],
-              positional[1],
-              config,
-              catalogMap.get(config.toolId),
-            ),
-          );
-        }
-      }
-      return text(createDomainHelp(positional[0], toolRegistry[positional[0]], catalogMap));
-    }
-    return text(TOP_LEVEL_HELP);
-  }
-
-  if (positional[0] === "auth" && positional[1] === "info") {
-    return executeAuthInfo(context, positional.slice(2));
-  }
-  if (positional[0] === "auth" && positional[1] === "validate") {
-    return executeAuthValidate(context, positional.slice(2));
-  }
-  if (positional[0] === "auth" && positional[1] === "charges") {
-    return executeAuthCharges(context, positional.slice(2));
-  }
-  if (positional[0] === "auth" && positional[1] === "status") {
-    return executeAuthStatus(context, positional.slice(2));
-  }
-  if (positional[0] === "health" && positional[1] === "check") {
-    return executeHealthCheck(context, positional.slice(2));
-  }
-  if (positional[0] === "version" && positional[1] === "check") {
-    return executeVersionCheck(context, positional.slice(2));
-  }
-  if (positional[0] === "tool" && positional[1] === "catalog") {
-    return executeToolCatalog(context, positional.slice(2));
-  }
-  if (positional[0] === "tool" && positional[1] === "execute") {
-    return executeToolExecute(context, positional.slice(2), allowedToolIds);
-  }
-  if (positional[0] === "kb" && positional[1] === "search") {
-    return executeKbSearch(context, positional.slice(2));
-  }
-  if (
-    positional[0] === "analysis" &&
-    positional[1] === "creator-profile"
-  ) {
-    return executeAnalysisCreatorProfile(context, positional.slice(2));
-  }
-  if (positional[0] === "compliance" && positional[1] === "check") {
-    return executeComplianceCheck(context, positional.slice(2));
-  }
-  if (positional[0] === "config" && positional[1] === "set-token") {
-    return executeConfigSetToken(context, positional.slice(2));
-  }
-  if (positional[0] === "config" && positional[1] === "get") {
-    return executeConfigGet(context, positional.slice(2));
-  }
-  if (positional[0] === "config" && positional[1] === "clear-token") {
-    return executeConfigClearToken(context, positional.slice(2));
-  }
-  if (positional[0] === "commands" && positional[1] === "list") {
-    return executeCommandsList(context, exposedCommands);
-  }
-  if (positional[0] === "commands" && positional[1] === "describe") {
-    return executeCommandsDescribe(context, positional.slice(2), exposedCommands);
-  }
-  if (positional[0] === "schema") {
-    return executeSchema(context, positional.slice(1));
-  }
-  if (toolRegistry[positional[0]]) {
-    return executeRegisteredTool(
-      context,
-      positional.slice(1),
-      positional[0],
-      toolRegistry[positional[0]],
-      catalogMap,
-    );
-  }
-
-  return fail(commandName, "UNKNOWN_COMMAND", "未知命令", 1, false);
-}

package/src/ycloud/commands/kb.js

@@ -1,82 +0,0 @@
-import { apiPost } from "../core/http.js";
-import { getToken } from "../core/token.js";
-import {
-  getGlobalFlagsHelp,
-  parseFloatNumber,
-  parseInteger,
-} from "./shared.js";
-
-export function getKbHelp() {
-  return `Search knowledge base content
-
-Usage:
-  ycloud kb search [flags]
-
-Required Flags:
-  --query string         search keyword
-
-Optional Flags:
-  --top-k int            number of results to return (default 5)
-  --min-score float      minimum similarity score
-  --course-name string   course name filter
-
-${getGlobalFlagsHelp()}
-
-Examples:
-  ycloud kb search --query "短视频脚本结构" --top-k 5 --output json
-
-Read on success:
-  data.hits
-
-Read on error:
-  error.code
-  error.message
-  error.retryable`;
-}
-
-async function requireToken(context) {
-  const token = await getToken();
-  if (!token) {
-    return context.fail(
-      context.commandName,
-      "TOKEN_MISSING",
-      "缺少 YUANCHUANG_API_TOKEN",
-      3,
-      false,
-    );
-  }
-  return token;
-}
-
-export async function executeKbSearch(context, tokens) {
-  const options = context.parseCommandFlags(tokens);
-  if (!options.query) {
-    return context.fail(
-      "kb search",
-      "BAD_ARGUMENT",
-      "缺少必填参数 --query",
-      2,
-      false,
-    );
-  }
-
-  const token = await requireToken(context);
-  if (typeof token !== "string") {
-    return token;
-  }
-
-  const data = await apiPost("/v1/knowledge-base/search", {
-    token,
-    traceId: context.globalOptions.traceId,
-    timeout: context.globalOptions.timeout,
-    baseUrl: context.globalOptions.baseUrl,
-    body: {
-      query: options.query,
-      top_k: parseInteger(options["top-k"]) ?? 5,
-      min_score: parseFloatNumber(options["min-score"]),
-      course_name: options["course-name"],
-    },
-  });
-
-  return context.ok("kb search", data);
-}

package/src/ycloud/commands/schema.js

@@ -1,229 +0,0 @@
-import { fetchOpenApiSpec } from "../core/http.js";
-import { getGlobalFlagsHelp } from "./shared.js";
-
-const COMMAND_SCHEMA_MAP = {
-  "auth.validate": {
-    command: "auth validate",
-    method: "GET",
-    path: "/v1/auth/validate",
-    cliFlags: [],
-  },
-  "auth.info": {
-    command: "auth info",
-    method: "GET",
-    path: "/v1/auth/info",
-    cliFlags: [],
-  },
-  "auth.charges": {
-    command: "auth charges",
-    method: "GET",
-    path: "/v1/auth/charges",
-    cliFlags: [
-      { flag: "--model-id", apiField: "model_id", required: false },
-      { flag: "--charge-type", apiField: "charge_type", required: false },
-      { flag: "--user-level", apiField: "user_level", required: false },
-      { flag: "--start-at", apiField: "start_at", required: false },
-      { flag: "--end-at", apiField: "end_at", required: false },
-      { flag: "--limit", apiField: "limit", required: false },
-      { flag: "--offset", apiField: "offset", required: false },
-    ],
-  },
-  "health.check": {
-    command: "health check",
-    method: "GET",
-    path: "/v1/health",
-    cliFlags: [],
-  },
-  "tool.catalog": {
-    command: "tool catalog",
-    method: "GET",
-    path: "/v1/tools/catalog",
-    cliFlags: [],
-  },
-  "version.check": {
-    command: "version check",
-    method: "GET",
-    path: "/v1/version/check",
-    cliFlags: [
-      { flag: "--app-id", apiField: "app_id", required: false },
-      { flag: "--platform", apiField: "platform", required: false },
-      { flag: "--channel", apiField: "channel", required: false },
-      {
-        flag: "--current-version",
-        apiField: "current_version",
-        required: false,
-      },
-      { flag: "--current-build", apiField: "current_build", required: false },
-    ],
-  },
-  "tool.execute": {
-    command: "tool execute",
-    method: "POST",
-    path: "/v1/tools/execute",
-    cliFlags: [
-      { flag: "--tool-id", apiField: "tool_id", required: true },
-      { flag: "--params", apiField: "params", required: false },
-      { flag: "--params-file", apiField: "params", required: false },
-      { flag: "--session-id", apiField: "session_id", required: false },
-      { flag: "--trace-id", apiField: "trace_id", required: false },
-      {
-        flag: "--idempotency-key",
-        apiField: "idempotency_key",
-        required: false,
-      },
-    ],
-  },
-  "kb.search": {
-    command: "kb search",
-    method: "POST",
-    path: "/v1/knowledge-base/search",
-    cliFlags: [
-      { flag: "--query", apiField: "query", required: true },
-      { flag: "--top-k", apiField: "top_k", required: false },
-      { flag: "--min-score", apiField: "min_score", required: false },
-      { flag: "--course-name", apiField: "course_name", required: false },
-    ],
-  },
-  "analysis.creator-profile": {
-    command: "analysis creator-profile",
-    method: "POST",
-    path: "/v1/analysis/douyin/creator-profile",
-    cliFlags: [
-      { flag: "--profile-url", apiField: "profile_url", required: true },
-      { flag: "--video-limit", apiField: "video_limit", required: false },
-    ],
-  },
-  "compliance.check": {
-    command: "compliance check",
-    method: "POST",
-    path: "/v1/compliance/check",
-    cliFlags: [
-      { flag: "--content", apiField: "content", required: false },
-      { flag: "--content-file", apiField: "content", required: false },
-      { flag: "--project-id", apiField: "project_id", required: false },
-      { flag: "--metadata", apiField: "metadata", required: false },
-      { flag: "--metadata-file", apiField: "metadata", required: false },
-    ],
-  },
-};
-
-export function getSchemaHelp() {
-  return `Inspect command parameter schema from OpenAPI
-
-Usage:
-  ycloud schema <command> [flags]
-
-Required Flags:
-  none
-
-Optional Flags:
-  none
-
-${getGlobalFlagsHelp()}
-
-Examples:
-  ycloud schema list --output json
-  ycloud schema kb.search --output json
-  ycloud schema tool.execute --output text
-
-Read on success:
-  data.command
-  data.api.path
-  data.api.request_body
-
-Read on error:
-  error.code
-  error.message
-  error.retryable`;
-}
-
-function dereferenceSchema(spec, schema) {
-  if (!schema) {
-    return {};
-  }
-  if (schema.$ref) {
-    const refName = schema.$ref.split("/").pop();
-    return spec.components?.schemas?.[refName] || {};
-  }
-  return schema;
-}
-
-function normalizeProperties(properties = {}) {
-  return Object.entries(properties).map(([name, value]) => ({
-    name,
-    type: value.type || value.$ref || "unknown",
-  }));
-}
-
-export async function executeSchema(context, tokens) {
-  const key = tokens[0];
-  if (!key) {
-    return context.fail(
-      "schema",
-      "BAD_ARGUMENT",
-      "缺少命令标识，例如 kb.search",
-      2,
-      false,
-    );
-  }
-
-  if (key === "list") {
-    return context.ok("schema list", {
-      commands: Object.entries(COMMAND_SCHEMA_MAP).map(([itemKey, value]) => ({
-        key: itemKey,
-        command: value.command,
-        method: value.method,
-        path: value.path,
-      })),
-    });
-  }
-
-  const target = COMMAND_SCHEMA_MAP[key];
-  if (!target) {
-    return context.fail(
-      "schema",
-      "BAD_ARGUMENT",
-      `不支持的 schema 命令: ${key}`,
-      2,
-      false,
-    );
-  }
-
-  const spec = await fetchOpenApiSpec({
-    timeout: context.globalOptions.timeout,
-    baseUrl: context.globalOptions.baseUrl,
-  });
-  const operation =
-    spec.paths?.[target.path]?.[target.method.toLowerCase()] || {};
-
-  let requestBody = {
-    required: [],
-    properties: [],
-  };
-
-  const bodySchema = dereferenceSchema(
-    spec,
-    operation.requestBody?.content?.["application/json"]?.schema,
-  );
-  if (bodySchema && Object.keys(bodySchema).length > 0) {
-    requestBody = {
-      required: bodySchema.required || [],
-      properties: normalizeProperties(bodySchema.properties),
-    };
-  }
-
-  const data = {
-    command: target.command,
-    cli: {
-      flags: target.cliFlags,
-    },
-    api: {
-      method: target.method,
-      path: target.path,
-      summary: operation.summary || null,
-      request_body: requestBody,
-    },
-  };
-
-  return context.ok(`schema ${key}`, data);
-}