yuanflow-cli 0.1.0 → 0.1.1

package/src/ycloud/commands/shared.js

@@ -1,30 +0,0 @@
-export function getGlobalFlagsHelp() {
-  return `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`;
-}
-
-export function parseInteger(value) {
-  if (value === undefined) {
-    return undefined;
-  }
-  const parsed = Number.parseInt(String(value), 10);
-  return Number.isNaN(parsed) ? undefined : parsed;
-}
-
-export function parseFloatNumber(value) {
-  if (value === undefined) {
-    return undefined;
-  }
-  const parsed = Number.parseFloat(String(value));
-  return Number.isNaN(parsed) ? undefined : parsed;
-}
-
-export function parseJsonString(value) {
-  if (!value) {
-    return undefined;
-  }
-  return JSON.parse(value);
-}

package/src/ycloud/commands/tool-registry.js

@@ -1,209 +0,0 @@
-const STATIC_TOOL_REGISTRY = {
-  content: {
-    title: "content creation tools",
-    commands: {
-      "knowledge-base-search": {
-        toolId: "knowledge_base_search",
-        commandName: "content knowledge-base-search",
-        description: "Search knowledge base content via wrapped tool",
-        requiredFlags: ["query"],
-      },
-      "copywriting-generate": {
-        toolId: "copywriting_generate",
-        commandName: "content copywriting-generate",
-        description: "Generate short video copywriting",
-        requiredFlags: ["task"],
-      },
-      "douyin-topic-generate": {
-        toolId: "douyin_topic_generate",
-        commandName: "content douyin-topic-generate",
-        description: "Generate Douyin topic ideas",
-        requiredFlags: ["prompt"],
-      },
-      "doubao-image-generate": {
-        toolId: "doubao_image_generate",
-        commandName: "content doubao-image-generate",
-        description: "Generate image assets with Doubao image model",
-        requiredFlags: ["prompt"],
-      },
-      "script-generate": {
-        toolId: "script_generate",
-        commandName: "content script-generate",
-        description: "Generate video script content",
-        requiredFlags: ["task", "duration-seconds"],
-      },
-      "xiaohongshu-content-generate": {
-        toolId: "xiaohongshu_content_generate",
-        commandName: "content xiaohongshu-content-generate",
-        description: "Generate Xiaohongshu content and images",
-        requiredFlags: ["prompt"],
-      },
-    },
-  },
-  oss: {
-    title: "oss tools",
-    commands: {
-      "temp-policy": {
-        toolId: "oss_temp_policy_get",
-        commandName: "oss temp-policy",
-        description: "Get OSS temporary object policy",
-        requiredFlags: [],
-      },
-      "upload-base64": {
-        toolId: "oss_upload_base64",
-        commandName: "oss upload-base64",
-        description: "Upload Base64 payload to OSS",
-        requiredFlags: ["filename", "content-base64"],
-      },
-    },
-  },
-  speech: {
-    title: "speech tools",
-    commands: {
-      recognition: {
-        toolId: "speech_recognition",
-        commandName: "speech recognition",
-        description: "Recognize speech from audio file",
-        requiredFlags: ["audio-url"],
-      },
-      synthesis: {
-        toolId: "speech_synthesis",
-        commandName: "speech synthesis",
-        description: "Synthesize speech audio from text",
-        requiredFlags: ["text"],
-      },
-      "disfluency-trim-plan": {
-        toolId: "speech_disfluency_trim_plan",
-        commandName: "speech disfluency-trim-plan",
-        description: "Generate disfluency trim plan for speech",
-        requiredFlags: ["audio-url", "script-text"],
-      },
-    },
-  },
-  social: {
-    title: "social media atomic tools",
-    commands: {
-      "xiaohongshu-search-notes": {
-        toolId: "social_search_notes_v3",
-        commandName: "social xiaohongshu-search-notes",
-        description: "Search Xiaohongshu notes",
-        requiredFlags: ["keyword"],
-        aliases: { keywords: "keyword" },
-      },
-      "xiaohongshu-search-users": {
-        toolId: "social_search_users_v1",
-        commandName: "social xiaohongshu-search-users",
-        description: "Search Xiaohongshu users",
-        requiredFlags: ["keyword"],
-        aliases: { keywords: "keyword" },
-      },
-      "xiaohongshu-note-info": {
-        toolId: "social_get_note_info_v2",
-        commandName: "social xiaohongshu-note-info",
-        description: "Get Xiaohongshu note detail",
-        requiredFlags: [],
-      },
-      "douyin-video-search": {
-        toolId: "social_get_video_search_results",
-        commandName: "social douyin-video-search",
-        description: "Search Douyin videos",
-        requiredFlags: ["keyword"],
-      },
-      "douyin-general-search": {
-        toolId: "social_get_general_search_results",
-        commandName: "social douyin-general-search",
-        description: "Run Douyin general search",
-        requiredFlags: ["keyword"],
-      },
-      "douyin-hot-search": {
-        toolId: "social_get_hot_search_list",
-        commandName: "social douyin-hot-search",
-        description: "Get Douyin hot search list",
-        requiredFlags: [],
-      },
-      "douyin-user-info": {
-        toolId: "social_get_user_info_by_sec_user_id",
-        commandName: "social douyin-user-info",
-        description: "Get Douyin user info by sec_user_id",
-        requiredFlags: ["sec-user-id"],
-      },
-      "douyin-homepage-videos": {
-        toolId: "social_get_user_homepage_video_data",
-        commandName: "social douyin-homepage-videos",
-        description: "Get Douyin user homepage videos",
-        requiredFlags: ["sec-user-id"],
-      },
-      "douyin-video-detail": {
-        toolId: "social_get_single_video_data_v2",
-        commandName: "social douyin-video-detail",
-        description: "Get Douyin single video detail",
-        requiredFlags: ["aweme-id"],
-      },
-    },
-  },
-};
-
-function toKebabCase(value) {
-  return value
-    .replace(/^social_/, "")
-    .replace(/_/g, "-");
-}
-
-function toFlagName(value) {
-  return value.replace(/_/g, "-");
-}
-
-function inferAliases(toolId, schemaProperties) {
-  const aliases = {};
-  if (toolId === "social_search_notes_v3" || toolId === "social_search_users_v1") {
-    aliases.keywords = "keyword";
-  }
-
-  if (schemaProperties.sec_uid && !schemaProperties.sec_user_id) {
-    aliases["sec-user-id"] = "sec-uid";
-  }
-
-  if (schemaProperties.url && schemaProperties.share_link) {
-    aliases.url = "share-link";
-  }
-
-  return Object.keys(aliases).length > 0 ? aliases : undefined;
-}
-
-function buildSocialCommandConfig(item) {
-  const properties = item.schema?.properties || {};
-  const required = (item.schema?.required || []).map(toFlagName);
-  return {
-    toolId: item.tool_id,
-    commandName: `social ${toKebabCase(item.tool_id)}`,
-    description: item.description || `Execute ${item.tool_id}`,
-    requiredFlags: required,
-    aliases: inferAliases(item.tool_id, properties),
-  };
-}
-
-export function buildToolRegistry(catalogMap) {
-  const registry = structuredClone(STATIC_TOOL_REGISTRY);
-  const socialCommands = { ...registry.social.commands };
-
-  for (const item of catalogMap.values()) {
-    if (!item.tool_id?.startsWith("social_")) {
-      continue;
-    }
-    const subcommand = toKebabCase(item.tool_id);
-    if (socialCommands[subcommand]) {
-      continue;
-    }
-    socialCommands[subcommand] = buildSocialCommandConfig(item);
-  }
-
-  registry.social.commands = Object.fromEntries(
-    Object.entries(socialCommands).sort(([left], [right]) =>
-      left.localeCompare(right),
-    ),
-  );
-
-  return registry;
-}
-
-export const TOOL_REGISTRY = STATIC_TOOL_REGISTRY;

package/src/ycloud/commands/tool-runner.js

@@ -1,226 +0,0 @@
-import { apiPost } from "../core/http.js";
-import { getToken } from "../core/token.js";
-import { getGlobalFlagsHelp, parseFloatNumber, parseInteger, parseJsonString } from "./shared.js";
-
-function toFlagName(property) {
-  return property.replace(/_/g, "-");
-}
-
-function parsePrimitiveBySchema(name, schema, value) {
-  if (value === undefined) {
-    return undefined;
-  }
-
-  const type = schema?.type;
-  if (type === "integer") {
-    return parseInteger(value);
-  }
-  if (type === "number") {
-    return parseFloatNumber(value);
-  }
-  if (type === "boolean") {
-    return value === true || value === "true";
-  }
-  if (type === "object") {
-    if (typeof value === "string") {
-      return parseJsonString(value);
-    }
-    return value;
-  }
-  if (type === "array") {
-    if (Array.isArray(value)) {
-      return value;
-    }
-    if (typeof value === "string") {
-      const trimmed = value.trim();
-      if (trimmed.startsWith("[")) {
-        return parseJsonString(trimmed);
-      }
-      return trimmed
-        .split(",")
-        .map((item) => item.trim())
-        .filter(Boolean);
-    }
-  }
-  return value;
-}
-
-function normalizeFlagValue(name, schema, value) {
-  if (value === undefined) {
-    return undefined;
-  }
-  if (schema?.type) {
-    return parsePrimitiveBySchema(name, schema, value);
-  }
-  if (name.endsWith("_count") || name.endsWith("_limit") || name.endsWith("_seconds") || name === "page" || name === "page_size" || name === "top_k" || name === "sample_rate" || name === "count" || name === "image_count" || name === "copy_length" || name === "duration_seconds" || name === "ai_mode") {
-    return parseInteger(value);
-  }
-  if (name === "min_score") {
-    return parseFloatNumber(value);
-  }
-  if (name === "enable_timestamp" || name === "return_raw") {
-    return value === true || value === "true";
-  }
-  if (name === "constraints" || name === "context" || name === "body") {
-    return typeof value === "string" ? parseJsonString(value) : value;
-  }
-  return value;
-}
-
-function mapFlagsToBody(rawOptions, commandConfig, schemaProperties = {}) {
-  const options = { ...rawOptions };
-  for (const [from, to] of Object.entries(commandConfig.aliases || {})) {
-    if (options[from] !== undefined && options[to] === undefined) {
-      options[to] = options[from];
-    }
-  }
-
-  const body = {};
-  for (const property of Object.keys(schemaProperties)) {
-    const flag = toFlagName(property);
-    const rawValue = options[flag];
-    if (rawValue !== undefined) {
-      body[property] = normalizeFlagValue(property, schemaProperties[property], rawValue);
-    }
-  }
-  return body;
-}
-
-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 function createDomainHelp(domain, registry, catalogMap) {
-  const items = Object.entries(registry.commands).map(([subcommand, config]) => {
-    const item = catalogMap.get(config.toolId);
-    const description = item?.description || config.description;
-    return `  ${subcommand.padEnd(28)} ${description}`;
-  });
-
-  return `${registry.title}
-
-Usage:
-  ycloud ${domain} <subcommand> [flags]
-
-Available Subcommands:
-${items.join("\n")}
-
-${getGlobalFlagsHelp()}`;
-}
-
-export function createToolCommandHelp(domain, subcommand, config, catalogItem) {
-  const properties = catalogItem?.schema?.properties || {};
-  const required = new Set(config.requiredFlags || []);
-  const propertyLines = [];
-  const optionalLines = [];
-
-  for (const property of Object.keys(properties)) {
-    const flag = `--${toFlagName(property)}`;
-    const type = properties[property].type || "string";
-    const desc = properties[property].description || "";
-    const line = `  ${flag} ${type}`.padEnd(28) + desc;
-    if (required.has(toFlagName(property))) {
-      propertyLines.push(line);
-    } else {
-      optionalLines.push(line);
-    }
-  }
-
-  return `${config.description}
-
-Usage:
-  ycloud ${domain} ${subcommand} [flags]
-
-Required Flags:
-${propertyLines.length ? propertyLines.join("\n") : "  none"}
-
-Optional Flags:
-${optionalLines.length ? optionalLines.join("\n") : "  none"}
-
-${getGlobalFlagsHelp()}
-
-Examples:
-  ycloud ${domain} ${subcommand} --output json
-
-Read on success:
-  data
-
-Read on error:
-  error.code
-  error.message
-  error.retryable`;
-}
-
-export async function executeRegisteredTool(
-  context,
-  tokens,
-  domain,
-  registry,
-  catalogMap,
-) {
-  const subcommand = tokens[0];
-  const config = registry.commands[subcommand];
-  if (!config) {
-    return context.fail(
-      context.commandName,
-      "UNKNOWN_COMMAND",
-      "未知命令",
-      1,
-      false,
-    );
-  }
-
-  const options = context.parseCommandFlags(tokens.slice(1));
-  for (const requiredFlag of config.requiredFlags || []) {
-    const aliasSource = Object.entries(config.aliases || {}).find(
-      ([from, to]) => to === requiredFlag && options[from] !== undefined,
-    );
-    if (options[requiredFlag] === undefined && !aliasSource) {
-      return context.fail(
-        config.commandName,
-        "BAD_ARGUMENT",
-        `缺少必填参数 --${requiredFlag}`,
-        2,
-        false,
-      );
-    }
-  }
-
-  const token = await requireToken(context);
-  if (typeof token !== "string") {
-    return token;
-  }
-
-  const catalogItem = catalogMap.get(config.toolId);
-  const body = mapFlagsToBody(
-    options,
-    config,
-    catalogItem?.schema?.properties || {},
-  );
-
-  const data = await apiPost("/v1/tools/execute", {
-    token,
-    traceId: context.globalOptions.traceId,
-    timeout: context.globalOptions.timeout,
-    baseUrl: context.globalOptions.baseUrl,
-    body: {
-      tool_id: config.toolId,
-      params: body,
-      trace_id: context.globalOptions.traceId,
-    },
-  });
-
-  return context.ok(config.commandName, data, {
-    tool_id: config.toolId,
-  });
-}

package/src/ycloud/commands/tool.js

@@ -1,178 +0,0 @@
-import { apiGet, apiPost } from "../core/http.js";
-import { getToken } from "../core/token.js";
-import { getGlobalFlagsHelp, parseJsonString } from "./shared.js";
-
-export function getToolHelp(subcommand) {
-  if (subcommand === "catalog") {
-    return `List available tool catalog
-
-Usage:
-  ycloud tool catalog [flags]
-
-Optional Flags:
-  none
-
-${getGlobalFlagsHelp()}
-
-Examples:
-  ycloud tool catalog --output json
-
-Read on success:
-  data.tools
-
-Read on error:
-  error.code
-  error.message
-  error.retryable`;
-  }
-
-  if (subcommand === "execute") {
-    return `Execute a server-side tool
-
-Usage:
-  ycloud tool execute [flags]
-
-Required Flags:
-  --tool-id string       tool id to execute
-
-Optional Flags:
-  --params string        JSON object string
-  --params-file string   local JSON file path
-  --session-id string    optional session id
-  --idempotency-key string request idempotency key
-
-${getGlobalFlagsHelp()}
-
-Examples:
-  ycloud tool execute --tool-id copywriting_generate --params "{\"topic\":\"短视频文案\"}" --output json
-
-Read on success:
-  data
-  meta.tool_id
-
-Read on error:
-  error.code
-  error.message
-  error.retryable`;
-  }
-
-  return `Tool commands
-
-Usage:
-  ycloud tool <catalog|execute> [flags]`;
-}
-
-function requireToken(context) {
-  return getToken().then((token) => {
-    if (!token) {
-      return context.fail(
-        context.commandName,
-        "TOKEN_MISSING",
-        "缺少 YUANCHUANG_API_TOKEN",
-        3,
-        false,
-      );
-    }
-    return token;
-  });
-}
-
-export async function executeToolCatalog(context) {
-  const token = await requireToken(context);
-  if (typeof token !== "string") {
-    return token;
-  }
-  const data = await apiGet("/v1/tools/catalog", {
-    token,
-    traceId: context.globalOptions.traceId,
-    timeout: context.globalOptions.timeout,
-    baseUrl: context.globalOptions.baseUrl,
-  });
-  return context.ok("tool catalog", data);
-}
-
-export async function executeToolExecute(context, tokens, allowedToolIds = new Set()) {
-  const options = context.parseCommandFlags(tokens);
-  if (!options["tool-id"]) {
-    return context.fail(
-      "tool execute",
-      "BAD_ARGUMENT",
-      "缺少必填参数 --tool-id",
-      2,
-      false,
-    );
-  }
-  if (options.params && options["params-file"]) {
-    return context.fail(
-      "tool execute",
-      "BAD_ARGUMENT",
-      "--params 和 --params-file 只能二选一",
-      2,
-      false,
-    );
-  }
-  if (allowedToolIds.size > 0 && !allowedToolIds.has(options["tool-id"])) {
-    return context.fail(
-      "tool execute",
-      "BAD_ARGUMENT",
-      `tool_id 未注册到当前 CLI 暴露面: ${options["tool-id"]}`,
-      2,
-      false,
-    );
-  }
-
-  const token = await requireToken(context);
-  if (typeof token !== "string") {
-    return token;
-  }
-
-  let params = undefined;
-  if (options.params) {
-    try {
-      params = parseJsonString(options.params);
-    } catch {
-      return context.fail(
-        "tool execute",
-        "BAD_ARGUMENT",
-        "--params 必须是合法 JSON",
-        2,
-        false,
-      );
-    }
-  }
-
-  if (options["params-file"]) {
-    const { readFile } = await import("node:fs/promises");
-    try {
-      params = JSON.parse(
-        await readFile(options["params-file"], { encoding: "utf-8" }),
-      );
-    } catch {
-      return context.fail(
-        "tool execute",
-        "BAD_ARGUMENT",
-        "--params-file 必须是合法 JSON 文件",
-        2,
-        false,
-      );
-    }
-  }
-
-  const data = await apiPost("/v1/tools/execute", {
-    token,
-    traceId: context.globalOptions.traceId,
-    timeout: context.globalOptions.timeout,
-    baseUrl: context.globalOptions.baseUrl,
-    body: {
-      tool_id: options["tool-id"],
-      params,
-      session_id: options["session-id"],
-      trace_id: context.globalOptions.traceId,
-      idempotency_key: options["idempotency-key"],
-    },
-  });
-
-  return context.ok("tool execute", data, {
-    tool_id: options["tool-id"],
-  });
-}