@ty_krystal/sei-ai 0.1.5 → 0.1.8

package/dist/errors.js

@@ -1,55 +0,0 @@
-export class SeiMcpError extends Error {
-    code;
-    details;
-    constructor(message, code = 'INTERNAL_ERROR', details) {
-        super(message);
-        this.name = 'SeiMcpError';
-        this.code = code;
-        this.details = details;
-    }
-}
-export function isSeiMcpError(error) {
-    return error instanceof SeiMcpError;
-}
-export function normalizeErrorMessage(error) {
-    return error instanceof Error ? error.message : 'Unknown error';
-}
-export function formatCliError(error) {
-    if (error instanceof SeiMcpError) {
-        return `[${error.code}] ${error.message}`;
-    }
-    return `[INTERNAL_ERROR] ${normalizeErrorMessage(error)}`;
-}
-export function toErrorLogMeta(error) {
-    if (error instanceof SeiMcpError) {
-        return {
-            code: error.code,
-            message: error.message,
-            details: toJsonValue(error.details),
-        };
-    }
-    if (error instanceof Error) {
-        return {
-            message: error.message,
-            stack: error.stack ?? '',
-        };
-    }
-    return {
-        message: normalizeErrorMessage(error),
-    };
-}
-function toJsonValue(value) {
-    if (value === null) {
-        return null;
-    }
-    if (typeof value === 'string' || typeof value === 'number' || typeof value === 'boolean') {
-        return value;
-    }
-    if (Array.isArray(value)) {
-        return value.map((item) => toJsonValue(item));
-    }
-    if (value && typeof value === 'object') {
-        return Object.fromEntries(Object.entries(value).map(([key, item]) => [key, toJsonValue(item)]));
-    }
-    return String(value);
-}

package/dist/logger.js

@@ -1,71 +0,0 @@
-import { DEFAULT_LOG_LEVEL, MAX_LOG_TEXT } from './constants.js';
-import { truncateText } from './utils.js';
-const LEVEL_PRIORITY = {
-    error: 0,
-    warn: 1,
-    info: 2,
-    debug: 3,
-};
-const SENSITIVE_KEYS = new Set([
-    'authorization',
-    'cookie',
-    'password',
-    'token',
-    'aiKey',
-    'ai_key',
-    'secret',
-    'body',
-]);
-export function createLogger(level = DEFAULT_LOG_LEVEL) {
-    const threshold = LEVEL_PRIORITY[normalizeLevel(level)] ?? LEVEL_PRIORITY.info;
-    function write(targetLevel, message, meta) {
-        if (LEVEL_PRIORITY[targetLevel] > threshold) {
-            return;
-        }
-        const entry = {
-            level: targetLevel,
-            message: truncateText(message, MAX_LOG_TEXT),
-            meta: sanitizeMeta(meta),
-            time: new Date().toISOString(),
-        };
-        process.stderr.write(`${JSON.stringify(entry)}\n`);
-    }
-    return {
-        debug(message, meta) {
-            write('debug', message, meta);
-        },
-        info(message, meta) {
-            write('info', message, meta);
-        },
-        warn(message, meta) {
-            write('warn', message, meta);
-        },
-        error(message, meta) {
-            write('error', message, meta);
-        },
-    };
-}
-function normalizeLevel(level) {
-    const normalized = level.trim().toLowerCase();
-    if (normalized === 'debug' || normalized === 'info' || normalized === 'warn' || normalized === 'error') {
-        return normalized;
-    }
-    return 'info';
-}
-function sanitizeMeta(value) {
-    if (Array.isArray(value)) {
-        return value.map((item) => sanitizeMeta(item));
-    }
-    if (!value || typeof value !== 'object') {
-        return value;
-    }
-    const result = {};
-    for (const [key, item] of Object.entries(value)) {
-        if (SENSITIVE_KEYS.has(key)) {
-            result[key] = '[REDACTED]';
-            continue;
-        }
-        result[key] = sanitizeMeta(item);
-    }
-    return result;
-}

package/dist/openapi.js

@@ -1,261 +0,0 @@
-import { SeiMcpError } from './errors.js';
-const OPENAPI_HTTP_METHODS = ['GET', 'POST', 'PUT', 'DELETE', 'PATCH', 'HEAD', 'OPTIONS', 'TRACE'];
-export function buildOpenApiDocSummary(openapiDoc, keyword) {
-    if (!isObject(openapiDoc)) {
-        throw new SeiMcpError('OpenAPI 文档不是 JSON 对象', 'INVALID_REQUEST');
-    }
-    throwIfOpenApiErrorPayload(openapiDoc);
-    const info = isObject(openapiDoc.info) ? openapiDoc.info : {};
-    const rawPaths = openapiDoc.paths;
-    if (!isObject(rawPaths)) {
-        throw new SeiMcpError('OpenAPI 文档缺少 paths 对象', 'INVALID_REQUEST');
-    }
-    const normalizedKeyword = normalizeText(keyword).toLowerCase();
-    const items = [];
-    for (const [path, rawPathItem] of Object.entries(rawPaths)) {
-        if (!isObject(rawPathItem)) {
-            continue;
-        }
-        for (const [method, rawOperation] of Object.entries(rawPathItem)) {
-            const methodUpper = method.toUpperCase();
-            if (!OPENAPI_HTTP_METHODS.includes(methodUpper) || !isObject(rawOperation)) {
-                continue;
-            }
-            const tags = Array.isArray(rawOperation.tags)
-                ? rawOperation.tags.map((item) => normalizeText(item)).filter(Boolean)
-                : [];
-            const item = {
-                method: methodUpper,
-                path: normalizeText(path),
-                tags,
-                summary: normalizeText(rawOperation.summary),
-                description: normalizeText(rawOperation.description),
-                operationId: normalizeText(rawOperation.operationId),
-                parameters: extractOpenApiParameters(rawOperation),
-                requestBody: extractOpenApiRequestBody(rawOperation),
-                responses: extractOpenApiResponses(rawOperation),
-            };
-            if (normalizedKeyword) {
-                const searchable = JSON.stringify(item).toLowerCase();
-                if (!searchable.includes(normalizedKeyword)) {
-                    continue;
-                }
-            }
-            items.push(item);
-        }
-    }
-    items.sort((a, b) => {
-        const tagA = normalizeText((Array.isArray(a.tags) ? a.tags[0] : '') || '未分组');
-        const tagB = normalizeText((Array.isArray(b.tags) ? b.tags[0] : '') || '未分组');
-        if (tagA !== tagB) {
-            return tagA.localeCompare(tagB, 'zh-CN');
-        }
-        const pathCompare = normalizeText(a.path).localeCompare(normalizeText(b.path), 'en');
-        if (pathCompare !== 0) {
-            return pathCompare;
-        }
-        return OPENAPI_HTTP_METHODS.indexOf(normalizeText(a.method)) -
-            OPENAPI_HTTP_METHODS.indexOf(normalizeText(b.method));
-    });
-    return {
-        title: normalizeText(info.title) || 'SEI API',
-        version: normalizeText(info.version),
-        openapi: normalizeText(openapiDoc.openapi ?? openapiDoc.swagger),
-        count: items.length,
-        items,
-    };
-}
-export function renderOpenApiMarkdown(summary) {
-    const lines = [`# ${normalizeText(summary.title) || 'SEI API'}`, ''];
-    const version = normalizeText(summary.version);
-    const openapiVersion = normalizeText(summary.openapi);
-    if (version) {
-        lines.push(`- 版本：${version}`);
-    }
-    if (openapiVersion) {
-        lines.push(`- OpenAPI：${openapiVersion}`);
-    }
-    lines.push(`- 接口数：${Number(summary.count ?? 0)}`);
-    let currentTag = '';
-    const items = Array.isArray(summary.items) ? summary.items : [];
-    for (const rawItem of items) {
-        if (!isObject(rawItem)) {
-            continue;
-        }
-        const tags = Array.isArray(rawItem.tags) ? rawItem.tags : [];
-        const tag = normalizeText(tags[0] ?? '未分组') || '未分组';
-        if (tag !== currentTag) {
-            lines.push('', `## ${tag}`);
-            currentTag = tag;
-        }
-        const method = normalizeText(rawItem.method);
-        const path = normalizeText(rawItem.path);
-        lines.push('', `### ${method} ${path}`);
-        const summaryText = normalizeText(rawItem.summary);
-        const description = normalizeText(rawItem.description);
-        const operationId = normalizeText(rawItem.operationId);
-        if (summaryText) {
-            lines.push(`- 摘要：${summaryText}`);
-        }
-        if (description && description !== summaryText) {
-            lines.push(`- 说明：${description}`);
-        }
-        if (operationId) {
-            lines.push(`- operationId：\`${operationId}\``);
-        }
-        const parameters = Array.isArray(rawItem.parameters) ? rawItem.parameters : [];
-        if (parameters.length > 0) {
-            lines.push('- 参数：');
-            for (const rawParameter of parameters) {
-                if (!isObject(rawParameter)) {
-                    continue;
-                }
-                const name = normalizeText(rawParameter.name);
-                const location = normalizeText(rawParameter.in);
-                const schema = normalizeText(rawParameter.schema);
-                const required = rawParameter.required ? '必填' : '可选';
-                const descriptionText = normalizeText(rawParameter.description);
-                const detail = [schema, required, descriptionText].filter(Boolean).join('，');
-                lines.push(`  - \`${location} ${name}\`${detail ? `：${detail}` : ''}`);
-            }
-        }
-        const requestBody = Array.isArray(rawItem.requestBody) ? rawItem.requestBody : [];
-        if (requestBody.length > 0) {
-            const parts = requestBody
-                .filter(isObject)
-                .map((body) => {
-                const contentType = normalizeText(body.contentType);
-                const schema = normalizeText(body.schema);
-                return schema ? `${contentType}(${schema})` : contentType;
-            })
-                .filter(Boolean);
-            if (parts.length > 0) {
-                lines.push(`- 请求体：${parts.join(', ')}`);
-            }
-        }
-        const responses = Array.isArray(rawItem.responses) ? rawItem.responses : [];
-        if (responses.length > 0) {
-            const parts = responses
-                .filter(isObject)
-                .map((response) => `${normalizeText(response.status)} ${normalizeText(response.description)}`.trim())
-                .filter(Boolean);
-            if (parts.length > 0) {
-                lines.push(`- 响应：${parts.join(', ')}`);
-            }
-        }
-    }
-    return `${lines.join('\n').trimEnd()}\n`;
-}
-function extractOpenApiParameters(operation) {
-    const rawParameters = operation.parameters;
-    if (!Array.isArray(rawParameters)) {
-        return [];
-    }
-    return rawParameters
-        .filter(isObject)
-        .map((parameter) => ({
-        name: normalizeText(parameter.name),
-        in: normalizeText(parameter.in),
-        required: Boolean(parameter.required),
-        schema: summarizeSchema(parameter.schema),
-        description: normalizeText(parameter.description),
-    }))
-        .filter((item) => item.name || item.in);
-}
-function extractOpenApiRequestBody(operation) {
-    const requestBody = operation.requestBody;
-    if (!isObject(requestBody) || !isObject(requestBody.content)) {
-        return [];
-    }
-    return Object.entries(requestBody.content)
-        .map(([contentType, contentInfo]) => ({
-        contentType: normalizeText(contentType),
-        schema: summarizeSchema(isObject(contentInfo) ? contentInfo.schema : undefined),
-    }))
-        .filter((item) => item.contentType);
-}
-function extractOpenApiResponses(operation) {
-    const rawResponses = operation.responses;
-    if (!isObject(rawResponses)) {
-        return [];
-    }
-    return Object.entries(rawResponses)
-        .map(([status, response]) => ({
-        status: normalizeText(status),
-        description: normalizeText(isObject(response) ? response.description : ''),
-    }))
-        .filter((item) => item.status);
-}
-function summarizeSchema(schema) {
-    if (!isObject(schema)) {
-        return '';
-    }
-    const ref = normalizeText(schema.$ref);
-    if (ref) {
-        return ref.split('/').pop() ?? ref;
-    }
-    const schemaType = normalizeText(schema.type);
-    const schemaFormat = normalizeText(schema.format);
-    if (schemaType === 'array') {
-        const itemText = summarizeSchema(schema.items);
-        return `array<${itemText || 'item'}>`;
-    }
-    if (schemaType && schemaFormat) {
-        return `${schemaType}/${schemaFormat}`;
-    }
-    if (schemaType) {
-        return schemaType;
-    }
-    return Array.isArray(schema.enum) && schema.enum.length > 0 ? 'enum' : '';
-}
-function throwIfOpenApiErrorPayload(openapiDoc) {
-    const rootCause = isObject(openapiDoc.rootCause) ? openapiDoc.rootCause : null;
-    const stackTrace = Array.isArray(rootCause?.stackTrace) ? rootCause.stackTrace : [];
-    const topFrame = stackTrace.find(isObject);
-    const rootMessage = normalizeText(rootCause?.message);
-    const rootException = normalizeText(rootCause?.exception);
-    const message = normalizeText(openapiDoc.message);
-    const error = normalizeText(openapiDoc.error);
-    const path = normalizeText(openapiDoc.path);
-    if (!rootCause && !message && !error) {
-        return;
-    }
-    const parts = [
-        message || error,
-        rootException,
-        rootMessage,
-        formatStackFrame(topFrame),
-        path ? `path=${path}` : '',
-    ].filter(Boolean);
-    throw new SeiMcpError(parts.length > 0
-        ? `OpenAPI 文档生成失败：${parts.join(' | ')}`
-        : 'OpenAPI 文档生成失败，服务端返回异常对象', 'INVALID_REQUEST', {
-        error,
-        message,
-        path,
-        rootCause: rootCause ?? undefined,
-    });
-}
-function formatStackFrame(frame) {
-    if (!isObject(frame)) {
-        return '';
-    }
-    const className = normalizeText(frame.className);
-    const methodName = normalizeText(frame.methodName);
-    const fileName = normalizeText(frame.fileName);
-    const lineNumber = Number(frame.lineNumber);
-    const locationParts = [className, methodName].filter(Boolean);
-    const sourceParts = [fileName, Number.isFinite(lineNumber) && lineNumber > 0 ? String(lineNumber) : ''].filter(Boolean);
-    const location = locationParts.join('#');
-    const source = sourceParts.join(':');
-    if (location && source) {
-        return `${location} (${source})`;
-    }
-    return location || source;
-}
-function normalizeText(value) {
-    return typeof value === 'string' ? value.replace(/\s+/g, ' ').trim() : '';
-}
-function isObject(value) {
-    return Boolean(value) && typeof value === 'object' && !Array.isArray(value);
-}

package/dist/permissions.js

@@ -1,209 +0,0 @@
-import { DEFAULT_QUERY_LIMIT, DEFAULT_QUERY_SQL_PAGE, DEFAULT_QUERY_SQL_SIZE } from './constants.js';
-import { SeiMcpError } from './errors.js';
-import { isObject, toTrimmedString, uniqueStrings } from './utils.js';
-const RESERVED_SAVE_ROW_KEYS = new Set(['keyVal', 'filter', 'log', 'attFile', 'serverEvn', 'row']);
-export function resolveTarget(config, head) {
-    const entries = Object.entries(head).filter(([, value]) => toTrimmedString(value));
-    if (entries.length !== 1) {
-        throw new SeiMcpError('head 必须且只能包含一个目标: module/source/table/view', 'INVALID_PARAMS');
-    }
-    const [kind, rawName] = entries[0];
-    if (kind !== 'module' && kind !== 'source' && kind !== 'table' && kind !== 'view') {
-        throw new SeiMcpError('head 必须且只能包含一个目标: module/source/table/view', 'INVALID_PARAMS');
-    }
-    const name = toTrimmedString(rawName);
-    const pool = config.targets[`${kind}s`];
-    const target = pool[name];
-    if (!target) {
-        throw new SeiMcpError(`目标未配置或未授权: ${kind}.${name}`, 'INVALID_PARAMS');
-    }
-    return { kind, name, target };
-}
-export function authorizeQuery(config, input) {
-    const head = requireHead(input.head);
-    const { target, kind, name } = resolveTarget(config, head);
-    const queryConfig = target.query ?? {};
-    const requestedFields = normalizeList(input.option?.fields);
-    const allowedFields = normalizeList(queryConfig.fields);
-    const defaultFields = normalizeList(queryConfig.defaultFields);
-    let effectiveFields = requestedFields;
-    if (effectiveFields.length === 0) {
-        if (defaultFields.length > 0) {
-            effectiveFields = defaultFields;
-        }
-        else if (queryConfig.allowAllFields === true) {
-            effectiveFields = ['*'];
-        }
-        else {
-            throw new SeiMcpError('query 需要显式字段或默认字段配置', 'INVALID_PARAMS');
-        }
-    }
-    if (effectiveFields.includes('*') && queryConfig.allowAllFields !== true) {
-        throw new SeiMcpError('query 的字段通配符未被白名单允许', 'INVALID_PARAMS');
-    }
-    if (!effectiveFields.includes('*')) {
-        ensureFieldsAllowed(effectiveFields, allowedFields, 'query');
-    }
-    return {
-        head,
-        option: {
-            ...(isObject(input.option) ? input.option : {}),
-            fields: effectiveFields.join(','),
-            limit: toPositiveInteger(input.option?.limit, DEFAULT_QUERY_LIMIT),
-        },
-        _target: {
-            kind,
-            name,
-        },
-    };
-}
-export function authorizeSave(config, input) {
-    const head = requireHead(input.head);
-    const { kind, name, target } = resolveTarget(config, head);
-    const saveConfig = target.save ?? {};
-    const allowedActions = normalizeActions(saveConfig.actions);
-    const allowedFields = normalizeList(saveConfig.fields);
-    const data = Array.isArray(input.data) ? input.data : [];
-    if (data.length === 0) {
-        throw new SeiMcpError('save 需要 data 数组', 'INVALID_PARAMS');
-    }
-    for (const item of data) {
-        const action = normalizeAction(item?.action);
-        if (!allowedActions.includes(action)) {
-            throw new SeiMcpError(`save 动作不在白名单内: ${action}`, 'INVALID_PARAMS');
-        }
-        for (const row of Array.isArray(item?.rows) ? item.rows : []) {
-            const current = isObject(row?.row) ? row.row : {};
-            const fieldKeys = Object.keys(current).filter((key) => !RESERVED_SAVE_ROW_KEYS.has(key));
-            ensureFieldsAllowed(fieldKeys, allowedFields, 'save');
-        }
-    }
-    return {
-        head,
-        data,
-        query: input.query,
-        _target: {
-            kind,
-            name,
-        },
-    };
-}
-export function authorizeSchema(config, input) {
-    const head = requireHead(input.head);
-    const target = resolveTarget(config, head);
-    return {
-        head,
-        _target: target,
-    };
-}
-export function authorizeQuerySql(config, input) {
-    if (config.tools.querySql !== true) {
-        throw new SeiMcpError('querySql 工具未启用', 'INVALID_PARAMS');
-    }
-    const sql = toTrimmedString(input.sql);
-    if (!sql) {
-        throw new SeiMcpError('sql is required', 'INVALID_PARAMS');
-    }
-    if (!isSafeSelectSql(sql)) {
-        throw new SeiMcpError('querySql 只允许单条 SELECT/WITH 查询', 'INVALID_PARAMS');
-    }
-    const tables = extractTableNames(sql);
-    if (tables.some((table) => !isTargetAllowed(config, table))) {
-        throw new SeiMcpError('querySql 引用了未授权的表', 'INVALID_PARAMS');
-    }
-    if (/\bselect\s+\*/i.test(sql)) {
-        throw new SeiMcpError('querySql 不允许使用 *', 'INVALID_PARAMS');
-    }
-    return {
-        sql,
-        page: toPositiveInteger(input.page, DEFAULT_QUERY_SQL_PAGE),
-        size: toPositiveInteger(input.size, DEFAULT_QUERY_SQL_SIZE),
-    };
-}
-function requireHead(head) {
-    if (!isObject(head) || Array.isArray(head)) {
-        throw new SeiMcpError('head is required', 'INVALID_PARAMS');
-    }
-    const result = {};
-    for (const [key, value] of Object.entries(head)) {
-        const trimmed = toTrimmedString(value);
-        if (trimmed) {
-            result[key] = trimmed;
-        }
-    }
-    return result;
-}
-function normalizeList(value) {
-    if (Array.isArray(value)) {
-        return uniqueStrings(value.map((item) => toTrimmedString(item)));
-    }
-    if (typeof value === 'string') {
-        return uniqueStrings(value.split(',').map((item) => item.trim()));
-    }
-    return [];
-}
-function normalizeActions(value) {
-    return normalizeList(value).map(normalizeAction);
-}
-function normalizeAction(value) {
-    return toTrimmedString(value).toLowerCase();
-}
-function ensureFieldsAllowed(requested, allowed, label) {
-    if (allowed.length === 0) {
-        throw new SeiMcpError(`${label} 未配置字段白名单`, 'INVALID_PARAMS');
-    }
-    const allowedSet = new Set(allowed);
-    const blocked = requested.filter((field) => !allowedSet.has(field));
-    if (blocked.length > 0) {
-        throw new SeiMcpError(`${label} 字段未授权: ${blocked.join(', ')}`, 'INVALID_PARAMS');
-    }
-}
-function toPositiveInteger(value, fallback) {
-    const number = Number(value);
-    return Number.isInteger(number) && number > 0 ? number : fallback;
-}
-function isTargetAllowed(config, tableName) {
-    const normalized = toTrimmedString(tableName);
-    if (!normalized) {
-        return false;
-    }
-    const pools = [config.targets.tables, config.targets.sources, config.targets.views, config.targets.modules];
-    for (const pool of pools) {
-        if (pool[normalized]) {
-            return true;
-        }
-        for (const target of Object.values(pool)) {
-            if (isObject(target)) {
-                const mainTable = toTrimmedString(target.mainTable);
-                if (mainTable && mainTable === normalized) {
-                    return true;
-                }
-            }
-        }
-    }
-    return false;
-}
-function isSafeSelectSql(sql) {
-    const normalized = stripSqlComments(sql).trim();
-    if (normalized.includes(';')) {
-        return false;
-    }
-    return /^(with\s+[\s\S]+?\s+select\b|select\b)/i.test(normalized);
-}
-function extractTableNames(sql) {
-    const normalized = stripSqlComments(sql);
-    const tables = [];
-    const regex = /\b(from|join)\s+([`"\[]?)([A-Za-z0-9_.$]+)\2/gi;
-    for (const match of normalized.matchAll(regex)) {
-        const table = match[3];
-        if (table && table.toLowerCase() !== 'select') {
-            tables.push(table);
-        }
-    }
-    return tables;
-}
-function stripSqlComments(sql) {
-    return sql
-        .replace(/\/\*[\s\S]*?\*\//g, ' ')
-        .replace(/--.*$/gm, ' ');
-}