digitalsee-ai-flow-cli 0.9.15 → 0.9.24-beta

package/dist/utils/connectable.js

@@ -0,0 +1,221 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.normalizeConnectablePluginPage = exports.normalizeConnectableCategories = exports.unwrapResponseData = void 0;
+const isRecord = (value) => Boolean(value) && typeof value === 'object' && !Array.isArray(value);
+const hasOwn = (record, key) => Object.prototype.hasOwnProperty.call(record, key);
+const firstValue = (record, keys) => {
+    for (const key of keys) {
+        if (hasOwn(record, key) && record[key] !== undefined && record[key] !== null) {
+            return record[key];
+        }
+    }
+    return undefined;
+};
+const firstString = (record, keys) => {
+    for (const key of keys) {
+        const value = record[key];
+        if (typeof value === 'string' && value.trim()) {
+            return value.trim();
+        }
+    }
+    return undefined;
+};
+const toFiniteNumber = (value) => {
+    if (typeof value === 'number') {
+        return Number.isFinite(value) ? value : undefined;
+    }
+    if (typeof value === 'string' && value.trim()) {
+        const parsed = Number(value);
+        return Number.isFinite(parsed) ? parsed : undefined;
+    }
+    return undefined;
+};
+const toBoolean = (value, fallback = false) => {
+    if (typeof value === 'boolean')
+        return value;
+    if (value === 1 || value === '1' || value === 'true')
+        return true;
+    if (value === 0 || value === '0' || value === 'false')
+        return false;
+    return fallback;
+};
+/**
+ * 循环解包 `data` 信封，深度上限 4。
+ *
+ * 兼容两类输入：
+ * - axios interceptor 已解一层 `{error, result, data}` 后的直接业务数据；
+ * - 后端多级 `data` 嵌套（ReturnResultVO 包裹）。
+ *
+ * 响应含 `items`（分页结构）时停止解包，避免吞掉分页字段。
+ */
+const unwrapResponseData = (response) => {
+    let current = response;
+    let depth = 0;
+    while (depth < 4 && isRecord(current) && hasOwn(current, 'data') && !hasOwn(current, 'items')) {
+        current = current.data;
+        depth += 1;
+    }
+    return current;
+};
+exports.unwrapResponseData = unwrapResponseData;
+/**
+ * 归一化 connectable 分类响应为 `NodeCategory[]`。
+ *
+ * wire 字段兼容：`name/categoryName/category_name`、`label/name`、`desc/description`、
+ * `icon`、`searchAction/search_action`。
+ */
+const normalizeConnectableCategories = (response) => {
+    const rawCategories = (0, exports.unwrapResponseData)(response);
+    if (!Array.isArray(rawCategories)) {
+        return [];
+    }
+    return rawCategories.filter(isRecord).map((category) => ({
+        name: firstString(category, ['name', 'categoryName', 'category_name']) ?? '',
+        label: firstString(category, ['label', 'name']) ?? '',
+        desc: firstString(category, ['desc', 'description']),
+        icon: firstString(category, ['icon']),
+        search_action: toBoolean(firstValue(category, ['searchAction', 'search_action'])),
+    }));
+};
+exports.normalizeConnectableCategories = normalizeConnectableCategories;
+const normalizeStableIdentifier = (value) => {
+    if (typeof value === 'number') {
+        return Number.isSafeInteger(value) && value > 0 ? String(value) : undefined;
+    }
+    if (typeof value !== 'string') {
+        return undefined;
+    }
+    const normalized = value.trim();
+    if (!normalized)
+        return undefined;
+    if (/^-?\d+$/.test(normalized)) {
+        const digits = normalized.startsWith('-') ? normalized.slice(1) : normalized;
+        if (normalized.startsWith('-') || /^0+$/.test(digits))
+            return undefined;
+    }
+    return normalized;
+};
+const normalizeBackendLongIdentifier = (value) => {
+    if (typeof value === 'number') {
+        return Number.isSafeInteger(value) ? String(value) : undefined;
+    }
+    if (typeof value !== 'string')
+        return undefined;
+    const normalized = value.trim();
+    return /^-?\d+$/.test(normalized) ? normalized : undefined;
+};
+const findStableIdentifier = (record, candidates) => {
+    for (const candidate of candidates) {
+        const value = normalizeStableIdentifier(record[candidate]);
+        if (value !== undefined) {
+            return { value, source: candidate };
+        }
+    }
+    return undefined;
+};
+const toStringArray = (value) => Array.isArray(value) ? value.filter((item) => typeof item === 'string') : [];
+const normalizeConnector = (value) => {
+    const connector = isRecord(value) ? value : {};
+    // 正式 NodePackage 包标识是 connector.id；linkId/appPackage 等仅兼容未升级部署。
+    // 展示 name 不参与兜底，避免把可变文案作为身份标识。
+    const identifier = findStableIdentifier(connector, [
+        'id',
+        'linkId',
+        'link_id',
+        'appPackage',
+        'app_package',
+        'connectorId',
+        'connector_id',
+    ]);
+    return {
+        id: identifier?.value ?? '',
+        name: firstString(connector, ['name', 'displayName', 'display_name']) ?? '',
+        description: firstString(connector, ['description', 'desc']),
+        build_type: firstString(connector, ['buildType', 'build_type']),
+        app_domain_category: toStringArray(firstValue(connector, ['appDomainCategory', 'app_domain_category'])),
+        app_action_category: toStringArray(firstValue(connector, ['appActionCategory', 'app_action_category'])),
+        deployment_type: firstString(connector, ['deploymentType', 'deployment_type']),
+        icon: firstString(connector, ['icon']),
+    };
+};
+const normalizeAction = (value) => {
+    const action = isRecord(value) ? value : {};
+    const rawNodeSchema = firstValue(action, ['nodeSchema', 'node_schema']);
+    const nodeSchema = isRecord(rawNodeSchema) ? rawNodeSchema : null;
+    const schemaNodeKey = nodeSchema ? firstString(nodeSchema, ['key']) : undefined;
+    const schemaNodeVersion = nodeSchema
+        ? toFiniteNumber(firstValue(nodeSchema, ['version']))
+        : undefined;
+    // 后端数字 id：19 位雪花 Long ID 保持字符串；<=0 是 legacy 哨兵，仅保留给创建接口。
+    const backendActionId = normalizeBackendLongIdentifier(firstValue(action, ['id', 'actionId', 'action_id'])) ??
+        (schemaNodeKey ? '0' : undefined);
+    // NodePackage 的持久化身份是 action_key + action_ver，数字 id 不能作为 UI 身份。
+    const actionKey = firstString(action, ['actionKey', 'action_key', 'nodeKey', 'node_key']) ?? schemaNodeKey;
+    return {
+        ...action,
+        id: actionKey ?? '',
+        backend_action_id: backendActionId,
+        action_key: actionKey ?? '',
+        action_ver: toFiniteNumber(firstValue(action, ['actionVer', 'action_ver', 'nodeVersion', 'node_version', 'version'])) ?? schemaNodeVersion,
+        is_trigger: toBoolean(firstValue(action, ['isTrigger', 'is_trigger'])),
+        name: firstString(action, ['name', 'actionName', 'action_name']) ?? '',
+        description: firstString(action, ['description', 'desc']) ?? null,
+        // connectable 只返回已加载且当前租户可见的 NodePackage，统一置为可用。
+        status: 1,
+        protocol: firstString(action, ['protocol']) ?? '',
+        config_schema: firstValue(action, ['configSchema', 'config_schema']) ?? {},
+        sample_output: firstValue(action, ['sampleOutput', 'sample_output']),
+        node_struct: firstString(action, ['nodeStruct', 'node_struct']) ?? '',
+        action_type: firstString(action, ['actionType', 'action_type']) ?? null,
+    };
+};
+const normalizeMatchType = (value) => {
+    if (typeof value !== 'string' || !value.trim())
+        return undefined;
+    const normalized = value.trim().toUpperCase();
+    switch (normalized) {
+        case 'CONNECTOR_ONL':
+            return 'CONNECTOR_ONLY';
+        case 'ACTION_MATCHED':
+            return 'ACTION_ONLY';
+        case 'BOTH':
+            return 'BOTH_MATCHED';
+        default:
+            return normalized;
+    }
+};
+const readPageNumber = (page, keys, fallback) => toFiniteNumber(firstValue(page, keys)) ?? fallback;
+/**
+ * 归一化 connectable 插件分页响应为 `SearchLinksResponse`。
+ *
+ * wire 字段兼容：`items/records`、`page/current`、`pages/total/size`、
+ * `matchedActions/matched_actions`、`defaultExpanded/default_expanded`、
+ * `matchType/match_type`（旧枚举转换）。
+ */
+const normalizeConnectablePluginPage = (response) => {
+    const unwrapped = (0, exports.unwrapResponseData)(response);
+    const page = isRecord(unwrapped) ? unwrapped : {};
+    const rawItems = firstValue(page, ['items', 'records']);
+    const items = Array.isArray(rawItems)
+        ? rawItems.filter(isRecord).map((item) => {
+            const connector = normalizeConnector(item.connector);
+            const rawActions = firstValue(item, ['matchedActions', 'matched_actions']);
+            const matchedActions = Array.isArray(rawActions) ? rawActions.map(normalizeAction) : [];
+            return {
+                connector,
+                matched_actions: matchedActions,
+                default_expanded: toBoolean(firstValue(item, ['defaultExpanded', 'default_expanded'])),
+                match_type: normalizeMatchType(firstValue(item, ['matchType', 'match_type'])),
+            };
+        })
+        : [];
+    return {
+        items,
+        total: readPageNumber(page, ['total'], items.length),
+        size: readPageNumber(page, ['size'], items.length),
+        page: readPageNumber(page, ['page', 'current'], 1),
+        pages: readPageNumber(page, ['pages'], 0),
+    };
+};
+exports.normalizeConnectablePluginPage = normalizeConnectablePluginPage;
+//# sourceMappingURL=connectable.js.map

package/dist/utils/nodePackage.js

@@ -33,6 +33,7 @@ var __importStar = (this && this.__importStar) || (function () {
     };
 })();
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.NODE_PACKAGE_DOWNGRADE_HINT = void 0;
 exports.getCachedNodePackageSupport = getCachedNodePackageSupport;
 exports.getNodePackageSupportFor = getNodePackageSupportFor;
 exports.checkAndCacheNodePackageSupport = checkAndCacheNodePackageSupport;
@@ -45,6 +46,11 @@ const STATE_DIR = path.join(os.homedir(), '.ai-flow-cli');
 function getStateFile() {
     return path.join(STATE_DIR, `node-package-${(0, config_1.getActiveProfile)()}.json`);
 }
+/**
+ * 本版本统一使用 connectable API，不再回退旧版接口；
+ * 目标 baseUrl 不支持 NodePackage 时给出的降级建议。
+ */
+exports.NODE_PACKAGE_DOWNGRADE_HINT = '本版本已统一使用 NodePackage connectable API，目标服务不支持；如需连接旧版服务，请降级 CLI：npm install -g digitalsee-ai-flow-cli@0.9.15';
 function ensureStateDir() {
     if (!fs.existsSync(STATE_DIR)) {
         fs.mkdirSync(STATE_DIR, { recursive: true });
@@ -78,8 +84,24 @@ function getNodePackageSupportFor(profileName) {
     }
     return undefined;
 }
+/**
+ * Probe NodePackage support and cache the conclusion per profile.
+ *
+ * Only a definitive probe result (supported or unsupported) is written to the
+ * cache file. Transient errors (network, auth, 5xx) leave the existing cache
+ * untouched — a previous conclusion stays valid and the caller gets the stale
+ * value (or `false` when nothing is cached) instead of locking in a wrong
+ * "unsupported" answer.
+ */
 async function checkAndCacheNodePackageSupport() {
-    const supported = await (0, node_1.isNodePackageSupported)();
+    let supported;
+    try {
+        supported = await (0, node_1.isNodePackageSupported)();
+    }
+    catch {
+        const cached = getCachedNodePackageSupport();
+        return cached ?? false;
+    }
     ensureStateDir();
     fs.writeFileSync(getStateFile(), JSON.stringify({ supported, checkedAt: Date.now() }), 'utf-8');
     return supported;

package/dist/utils/nodeSchemaCache.js

@@ -0,0 +1,87 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.clearNodePackageSchemaCache = clearNodePackageSchemaCache;
+exports.setNodePackageSchema = setNodePackageSchema;
+exports.peekNodePackageSchema = peekNodePackageSchema;
+exports.getNodePackageSchema = getNodePackageSchema;
+const node_1 = require("@/api/node");
+/**
+ * NodePackage node schema cache.
+ *
+ * Cache dimension: (nodeKey, version) → NodeSchema.
+ * - Invalid versions (undefined/null/negative/non-finite) use an `@latest`
+ *   placeholder key: only pre-warmed cache entries are served and no remote
+ *   request is fired, avoiding ambiguous lookups.
+ * - Valid numeric versions (including 0) are cached precisely as
+ *   `${nodeKey}@${version}`.
+ * - Concurrent calls with the same key share one pending Promise.
+ */
+const schemaCacheByKey = new Map();
+const pendingRequestsByKey = new Map();
+function buildSchemaCacheKey(nodeKey, version) {
+    if (!nodeKey) {
+        throw new Error('nodeSchemaCache: nodeKey is required');
+    }
+    if (version === undefined || version === null) {
+        return `${nodeKey}@latest`;
+    }
+    if (typeof version !== 'number' || !Number.isFinite(version) || version < 0) {
+        return `${nodeKey}@latest`;
+    }
+    return `${nodeKey}@${version}`;
+}
+function isResolvableVersion(version) {
+    return (version !== undefined &&
+        version !== null &&
+        typeof version === 'number' &&
+        Number.isFinite(version) &&
+        version >= 0);
+}
+function clearNodePackageSchemaCache() {
+    schemaCacheByKey.clear();
+    pendingRequestsByKey.clear();
+}
+function setNodePackageSchema(nodeKey, version, schema) {
+    if (!nodeKey || !schema) {
+        return;
+    }
+    schemaCacheByKey.set(buildSchemaCacheKey(nodeKey, version), schema);
+}
+/**
+ * Synchronously read a pre-warmed schema without triggering a network request.
+ */
+function peekNodePackageSchema(nodeKey, version) {
+    if (!nodeKey)
+        return null;
+    return schemaCacheByKey.get(buildSchemaCacheKey(nodeKey, version)) ?? null;
+}
+async function getNodePackageSchema(nodeKey, version) {
+    if (!nodeKey) {
+        return null;
+    }
+    const cacheKey = buildSchemaCacheKey(nodeKey, version);
+    if (schemaCacheByKey.has(cacheKey)) {
+        return schemaCacheByKey.get(cacheKey);
+    }
+    if (pendingRequestsByKey.has(cacheKey)) {
+        return pendingRequestsByKey.get(cacheKey);
+    }
+    // Invalid/missing version: @latest placeholder, serve pre-warmed cache only
+    if (!isResolvableVersion(version)) {
+        return schemaCacheByKey.get(cacheKey) ?? null;
+    }
+    const request = (0, node_1.getActionNodeSchema)(nodeKey, version)
+        .then((schema) => {
+        schemaCacheByKey.set(cacheKey, schema);
+        return schema;
+    })
+        .catch(() => {
+        return null;
+    })
+        .finally(() => {
+        pendingRequestsByKey.delete(cacheKey);
+    });
+    pendingRequestsByKey.set(cacheKey, request);
+    return request;
+}
+//# sourceMappingURL=nodeSchemaCache.js.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "digitalsee-ai-flow-cli",
-  "version": "0.9.15",
+  "version": "0.9.24-beta",
   "description": "AI Flow CLI - manage connection flows and node configurations",
   "main": "dist/index.js",
   "bin": {