@ty_krystal/sei-ai 0.1.5 → 0.1.6

package/package.json

@@ -1,69 +1,78 @@
 {
   "name": "@ty_krystal/sei-ai",
-  "version": "0.1.5",
-  "description": "SEI MCP server and developer CLI for query, save, query-sql, and api-docs workflows",
-  "keywords": [
-    "sei",
-    "mcp",
-    "cli",
-    "openapi"
-  ],
-  "homepage": "https://github.com/tanyu/sei-ai",
-  "bugs": {
-    "url": "https://github.com/tanyu/sei-ai/issues"
+  "description": "SEI CLI generated with oclif",
+  "version": "0.1.6",
+  "author": "tanyu",
+  "bin": {
+    "sei-ai": "./bin/run.js"
   },
-  "repository": {
-    "type": "git",
-    "url": "git+https://github.com/tanyu/sei-ai.git"
+  "bugs": "https://github.com/tanyu/sei-ai/issues",
+  "dependencies": {
+    "@oclif/core": "^4",
+    "@oclif/plugin-help": "^6",
+    "@oclif/plugin-plugins": "^5",
+    "@ty_krystal/sei-ai-core": "workspace:*"
+  },
+  "devDependencies": {
+    "@eslint/compat": "^1",
+    "@oclif/prettier-config": "^0.2.1",
+    "@oclif/test": "^4",
+    "@types/chai": "^4",
+    "@types/mocha": "^10",
+    "@types/node": "^18",
+    "chai": "^4",
+    "eslint": "^9",
+    "eslint-config-oclif": "^6",
+    "eslint-config-prettier": "^10",
+    "mocha": "^11",
+    "oclif": "^4",
+    "shx": "^0.3.4",
+    "ts-node": "^10",
+    "typescript": "^5"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "publishConfig": {
+    "access": "public"
   },
-  "license": "MIT",
-  "type": "module",
   "files": [
-    "dist",
-    "README.md",
-    "config.example.json"
+    "./bin",
+    "./dist",
+    "./oclif.manifest.json"
   ],
-  "bin": {
-    "sei-ai": "dist/index.js"
-  },
+  "homepage": "https://github.com/tanyu/sei-ai",
+  "keywords": ["oclif", "sei", "cli"],
+  "license": "MIT",
+  "main": "dist/index.js",
+  "type": "module",
   "oclif": {
     "bin": "sei-ai",
     "dirname": "sei-ai",
-    "commands": {
-      "strategy": "pattern",
-      "target": "./dist/commands",
-      "globPatterns": [
-        "**/*.js"
-      ]
-    }
+    "commands": "./dist/commands",
+    "plugins": [
+      "@oclif/plugin-help",
+      "@oclif/plugin-plugins"
+    ],
+    "topicSeparator": ":"
   },
-  "main": "./dist/index.js",
-  "exports": {
-    ".": {
-      "default": "./dist/index.js"
-    }
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/tanyu/sei-ai.git"
   },
   "scripts": {
-    "dev": "tsx src/index.ts",
-    "start": "node dist/index.js",
-    "start:stdio": "node dist/index.js stdio --config ./config.example.json",
-    "start:http": "node dist/index.js streamable-http --host 0.0.0.0 --port 3000 --path /mcp --config ./config.example.json",
-    "build": "tsc -p tsconfig.build.json && node ./scripts/copy-build-assets.mjs",
-    "test": "node --import tsx --test test/**/*.test.ts",
-    "check": "pnpm run typecheck && pnpm run test",
+    "build": "pnpm --filter @ty_krystal/sei-ai-core build && shx rm -rf dist && tsc -b",
+    "dev": "node ./bin/dev.js",
+    "lint": "eslint",
+    "postpack": "shx rm -f oclif.manifest.json",
+    "posttest": "pnpm run lint",
+    "prepack": "oclif manifest && oclif readme",
+    "prepublishOnly": "pnpm run build",
+    "publish:npm": "npm publish --access public",
+    "start": "node ./bin/run.js",
     "typecheck": "tsc -p tsconfig.json --noEmit",
-    "prepublishOnly": "pnpm run build"
-  },
-  "engines": {
-    "node": "^22.18.0 || ^24.0.0"
+    "test": "pnpm --filter @ty_krystal/sei-ai-core typecheck && mocha --forbid-only \"test/**/*.test.ts\"",
+    "version": "oclif readme && git add README.md"
   },
-  "publishConfig": {
-    "access": "public"
-  },
-  "dependencies": {
-    "@modelcontextprotocol/sdk": "^1.29.0",
-    "@oclif/core": "^4.11.10",
-    "tsx": "^4.22.4",
-    "zod": "^3.25.76"
-  }
+  "types": "dist/index.d.ts"
 }

package/config.example.json

@@ -1,33 +0,0 @@
-{
-  "baseUrl": "http://127.0.0.1:8081",
-  "auth": {
-    "mode": "ai-login",
-    "aiKeyEnv": "SEI_AI_LOGIN_KEY",
-    "roleEnv": "SEI_AI_LOGIN_ROLE"
-  },
-  "tools": {
-    "query": true,
-    "save": true,
-    "schema": true,
-    "querySql": false
-  },
-  "targets": {
-    "modules": {
-      "demo_order": {
-        "mainTable": "demo_order",
-        "query": {
-          "fields": ["_ID", "ORDER_NO", "STATUS", "AMOUNT"],
-          "defaultFields": ["_ID", "ORDER_NO", "STATUS"],
-          "allowAllFields": false
-        },
-        "save": {
-          "actions": ["add", "edit"],
-          "fields": ["STATUS", "MEMO"]
-        }
-      }
-    },
-    "tables": {},
-    "sources": {},
-    "views": {}
-  }
-}

package/dist/README.md

@@ -1,239 +0,0 @@
-# sei-ai
-
-独立的 SEI MCP 服务，使用 `@modelcontextprotocol/sdk` 运行。
-支持 `stdio`、`streamable-http` 和开发者 CLI 启动，默认只开放受控的低代码查询、保存和字段元数据工具，`querySql` 默认关闭。
-CLI 已迁移到 `oclif`，命令面改为顶层子命令。
-
-## 安装
-
-```bash
-npm install -g sei-ai
-```
-
-## 命令
-
-```bash
-pnpm -F sei-ai-mcp dev -- --config ./apps/sei-ai-mcp/config.example.json
-pnpm -F sei-ai-mcp run start:stdio
-pnpm -F sei-ai-mcp run start:http
-pnpm -F sei-ai-mcp run build
-pnpm -F sei-ai-mcp run test
-```
-
-打包后 CLI：
-
-```bash
-sei-ai help
-sei-ai stdio --config ./config.example.json
-sei-ai streamable-http --host 0.0.0.0 --port 3000 --path /mcp --config ./config.example.json
-sei-ai api-docs --format markdown
-sei-ai relogin
-sei-ai query-sql "SELECT _UID,_NAME FROM _SYS_USER"
-sei-ai call POST /api/sei/data/removeAllCache --json '{}'
-sei-ai dict:list --type status
-sei-ai dict:add-category sex 性别
-sei-ai dict:add-item sex male 男
-sei-ai init:base-data --sysid sys --admin-uid admin
-```
-
-## 开发者 CLI
-
-CLI 是新增的开发者命令面，不会改变现有 MCP server 的启动方式、tool 列表或 Host 集成配置。
-
-命令示例：
-
-```bash
-sei-ai query --json '{"head":{"module":"sys_user"},"option":{"fields":"_UID,_NAME"}}'
-sei-ai save --json '{"head":{"module":"sys_user"},"data":[{"action":"edit","rows":[{"keyVal":"admin","row":{"_NAME":"管理员"}}]}]}'
-sei-ai query-sql "SELECT _UID,_NAME FROM _SYS_USER" --page 1 --size 20
-sei-ai api-docs --keyword login --format json
-sei-ai relogin --role admin
-```
-
-常用认证参数：
-
-- `--base-url`
-- `--ai-key`
-- `--role`
-- `--account`
-- `--account-project`
-- `--account-checkcode`
-- `--token`
-- `--timeout`
-
-环境变量加载规则：
-
-- 启动时会自动读取当前工作目录下的 `.env.local` 和 `.env`
-- 加载顺序为 `.env.local` 再 `.env`
-- 已经存在的进程环境变量不会被 `.env` 覆盖
-- 显式 CLI 参数仍然优先于环境变量
-
-载荷输入支持：
-
-- `--json '<payload>'`
-- `--file ./payload.json`
-- `--stdin`
-
-当前命令面：
-
-- `stdio`
-- `streamable-http`
-- `query`
-- `save`
-- `call`
-- `query-sql`
-- `sql`
-- `api-docs`
-- `relogin`
-- `dict:list`
-- `dict:add-category`
-- `dict:add-item`
-- `init:base-data`
-
-HTTP 模式：
-
-```bash
-pnpm -F sei-ai-mcp dev -- --transport streamable-http --host 0.0.0.0 --port 3000 --path /mcp --config ./apps/sei-ai-mcp/config.example.json
-```
-
-Docker Compose：
-
-```bash
-docker compose -f apps/sei-ai-mcp/docker-compose.yml up -d --build
-```
-
-容器默认暴露 `http://127.0.0.1:3719/mcp`，并通过 `host.docker.internal` 访问宿主机上的 SEI 后端。
-如果后端也在 compose 中运行，把 `SEI_BASE_URL` 改成对应服务名即可。
-
-## 配置
-
-支持的配置项：
-
-- `baseUrl`
-- `auth.mode`: `ai-login` 或 `token`
-- `auth.token`
-- `auth.aiKey`
-- `auth.account`
-- `auth.role`
-- `tools.query`
-- `tools.save`
-- `tools.schema`
-- `tools.querySql`
-- `targets.modules`
-- `targets.tables`
-- `targets.sources`
-- `targets.views`
-
-敏感值可通过环境变量注入：
-
-- `SEI_BASE_URL`
-- `SEI_AI_LOGIN_KEY`
-- `SEI_AI_LOGIN_ACCOUNT`
-- `SEI_AI_LOGIN_ROLE`
-- `SEI_TOKEN`
-- `SEI_MCP_TRANSPORT`
-- `SEI_MCP_HOST`
-- `SEI_MCP_PORT`
-- `SEI_MCP_PATH`
-- `SEI_MCP_HTTP_JSON_RESPONSE`
-
-例如可以在项目目录写：
-
-```bash
-SEI_BASE_URL=http://127.0.0.1:8081
-SEI_AI_LOGIN_KEY=dev-ai-secret
-SEI_AI_LOGIN_ROLE=admin
-```
-
-## 权限模型
-
-- 未配置目标时默认拒绝。
-- 查询字段必须命中白名单。
-- 保存字段必须命中白名单。
-- `querySql` 默认关闭，只允许单条 `SELECT/WITH`。
-- stdio 日志只写 `stderr`，不污染 MCP 协议输出。
-
-注意：
-
-- 上面的权限模型只约束 MCP tool 面。
-- 开发者 CLI 直接调用 SEI HTTP 接口，不走 MCP 白名单过滤，因此它是调试/开发入口，不是给模型暴露的 tool 面。
-
-## 工具
-
-- `sei_query`
-- `sei_save`
-- `sei_schema`
-- `sei_query_sql`（默认关闭）
-
-## MCP Host
-
-可直接作为 stdio MCP server 启动，再由上层 Host 注册。
-
-stdio Host 配置示例：
-
-```json
-{
-  "mcpServers": {
-    "sei-ai-mcp": {
-      "command": "sei-ai",
-      "args": [
-        "stdio",
-        "--config",
-        "/abs/path/config.dev.json"
-      ]
-    }
-  }
-}
-```
-
-HTTP 模式可直接挂载到容器端口，Host 地址示例：
-
-```json
-{
-  "mcpServers": {
-    "sei-ai-mcp": {
-      "url": "http://127.0.0.1:3719/mcp"
-    }
-  }
-}
-```
-
-## Spring AI Java 接入
-
-如果 `apps/backend` 通过 Spring AI MCP client 接入，直接使用 `streamable-http`：
-
-```yaml
-spring:
-  ai:
-    mcp:
-      client:
-        enabled: true
-        type: SYNC
-        request-timeout: 30s
-        toolcallback:
-          enabled: true
-        streamable-http:
-          connections:
-            sei-ai-mcp:
-              url: http://127.0.0.1:3719
-              endpoint: /mcp
-```
-
-如果后端默认直接访问宿主机暴露端口，可这样配置：
-
-```bash
-SEI_AI_MCP_HTTP_URL=http://127.0.0.1:3719
-SEI_AI_MCP_HTTP_ENDPOINT=/mcp
-```
-
-如果是宿主机或外部服务直连容器暴露端口，则访问地址为：
-
-```bash
-http://127.0.0.1:3719/mcp
-```
-
-
-
-npm version patch --no-git-tag-version
-pnpm run build
-npm publish --access public --cache /tmp/sei-ai-npm-cache

package/dist/cli-actions.js

@@ -1,157 +0,0 @@
-import { readFile, writeFile } from 'node:fs/promises';
-import { resolve } from 'node:path';
-import { BASE_SEED_DEFAULT_ADMIN_ROLE, BASE_SEED_DEFAULT_ADMIN_UID } from './constants.js';
-import { formatCliError, SeiMcpError } from './errors.js';
-import { buildBaseSeedSqlVars, buildDictCategoryRow, buildDictItemRow, buildDictQueryPayload, buildDictSavePayload, buildDictTree, removeSqlCommentLines, renderBaseSeedSql, splitSqlStatements, } from './cli-helpers.js';
-import { buildOpenApiDocSummary, renderOpenApiMarkdown } from './openapi.js';
-export async function runApiDocs(options) {
-    const raw = await options.client.readApiDocs();
-    const summary = buildOpenApiDocSummary(raw, options.keyword);
-    const output = options.format === 'json' ? `${JSON.stringify(summary, null, 2)}\n` : renderOpenApiMarkdown(summary);
-    await writeOutput(options.outputPath, output);
-}
-export async function runRelogin(options) {
-    const token = await options.client.relogin();
-    printJson({
-        success: true,
-        code: 1,
-        message: '重新登录成功',
-        data: { token },
-    });
-}
-export async function runCall(options) {
-    const response = await options.client.call(options.method, options.path, options.payload, {
-        allowFailure: options.allowFailure,
-        allowEmpty: options.allowEmpty,
-        skipAuth: options.skipAuth,
-    });
-    printJson(response);
-}
-export async function runQuery(options) {
-    const response = await options.client.query(options.payload, {
-        allowFailure: options.allowFailure,
-    });
-    printJson(response);
-}
-export async function runSave(options) {
-    const response = await options.client.save(options.payload, {
-        allowFailure: options.allowFailure,
-    });
-    printJson(response);
-}
-export async function runQuerySql(options) {
-    const response = await options.client.querySql(options.sql, options.page, options.size, {
-        allowFailure: options.allowFailure,
-    });
-    printJson(response);
-}
-export async function runDictList(options) {
-    const payload = buildDictQueryPayload(options.typeCode, options.keyword, options.size ?? 1000);
-    const response = await options.client.query(payload, {
-        allowFailure: options.allowFailure,
-    });
-    if (!options.flat && isObject(response) && isObject(response.data) && Array.isArray(response.data.rows)) {
-        response.data.tree = buildDictTree(response.data.rows);
-    }
-    printJson(response);
-}
-export async function runDictAddCategory(options) {
-    const payload = buildDictSavePayload(buildDictCategoryRow({
-        body: stringOrUndefined(options.rowOptions?.body),
-        code: stringOrUndefined(options.rowOptions?.code),
-        ctype: stringOrUndefined(options.rowOptions?.ctype),
-        dictFlag: numberOrUndefined(options.rowOptions?.dictFlag),
-        ename: stringOrUndefined(options.rowOptions?.ename),
-        memo: stringOrUndefined(options.rowOptions?.memo),
-        name: options.name,
-        sort: numberOrUndefined(options.rowOptions?.sort),
-        sysid: stringOrUndefined(options.rowOptions?.sysid),
-        typeCode: options.typeCode,
-        uuid: stringOrUndefined(options.rowOptions?.uuid),
-    }));
-    const response = await options.client.save(payload, {
-        allowFailure: options.allowFailure,
-    });
-    printJson(response);
-}
-export async function runDictAddItem(options) {
-    const payload = buildDictSavePayload(buildDictItemRow({
-        body: stringOrUndefined(options.rowOptions?.body),
-        code: options.code,
-        ctype: stringOrUndefined(options.rowOptions?.ctype),
-        dictFlag: numberOrUndefined(options.rowOptions?.dictFlag),
-        ename: stringOrUndefined(options.rowOptions?.ename),
-        memo: stringOrUndefined(options.rowOptions?.memo),
-        name: options.name,
-        parent: stringOrUndefined(options.rowOptions?.parent),
-        sort: numberOrUndefined(options.rowOptions?.sort),
-        sysid: stringOrUndefined(options.rowOptions?.sysid),
-        typeCode: options.typeCode,
-        uuid: stringOrUndefined(options.rowOptions?.uuid),
-    }));
-    const response = await options.client.save(payload, {
-        allowFailure: options.allowFailure,
-    });
-    printJson(response);
-}
-export async function runInitBaseData(options) {
-    const sqlFile = resolveBaseSeedSqlPath(options.sqlFile);
-    const template = await readFile(sqlFile, 'utf8');
-    const sql = renderBaseSeedSql(template, buildBaseSeedSqlVars({
-        adminName: options.adminName,
-        adminPassword: options.adminPassword,
-        adminRole: options.adminRole,
-        adminRoleName: options.adminRoleName,
-        adminUid: options.adminUid,
-        resetAdminPassword: options.resetAdminPassword,
-        sysid: options.sysid,
-    }));
-    const statements = splitSqlStatements(removeSqlCommentLines(sql));
-    if (statements.length === 0) {
-        throw new SeiMcpError('初始化 SQL 文件没有可执行语句', 'INVALID_PARAMS');
-    }
-    const executed = await options.client.executeDdlStatements(statements, {
-        allowFailure: options.allowFailure,
-    });
-    await options.client.call('POST', '/api/sei/data/removeAllCache', {}, { allowFailure: false }).catch(() => undefined);
-    printJson({
-        success: true,
-        code: 1,
-        message: '基础源数据初始化完成',
-        data: {
-            executed: Array.isArray(executed) ? executed.length : 0,
-            sqlFile,
-            admin: options.adminUid ?? BASE_SEED_DEFAULT_ADMIN_UID,
-            role: options.adminRole ?? BASE_SEED_DEFAULT_ADMIN_ROLE,
-        },
-    });
-}
-export async function writeOutput(path, text) {
-    if (!path) {
-        process.stdout.write(text);
-        return;
-    }
-    await writeFile(path, text, 'utf8');
-    process.stdout.write(`已写入：${path}\n`);
-}
-export function printJson(value) {
-    process.stdout.write(`${JSON.stringify(value, null, 2)}\n`);
-}
-export function resolveBaseSeedSqlPath(path) {
-    if (path) {
-        return resolve(path);
-    }
-    return resolve(process.cwd(), '.codex/skills/sei-ai/scripts/init-base-data.sql');
-}
-export function formatActionError(error) {
-    return formatCliError(error);
-}
-function stringOrUndefined(value) {
-    return typeof value === 'string' && value.trim() ? value.trim() : undefined;
-}
-function numberOrUndefined(value) {
-    return typeof value === 'number' && Number.isFinite(value) ? value : undefined;
-}
-function isObject(value) {
-    return Boolean(value) && typeof value === 'object' && !Array.isArray(value);
-}