ai-world-sdk 1.3.6 → 1.5.1

package/dist/admin.d.ts

@@ -118,4 +118,12 @@ export declare class AdminClient {
     deleteRow(tableName: string, primaryKey: Record<string, any>): Promise<{
         message: string;
     }>;
+    executeSql(data: {
+        sql: string;
+        description?: string;
+    }): Promise<any>;
+    getSqlHistory(options?: {
+        page?: number;
+        pageSize?: number;
+    }): Promise<any>;
 }

package/dist/admin.js

@@ -293,5 +293,30 @@ class AdminClient {
             await this.handleErrorResponse(response);
         return (await response.json());
     }
+    async executeSql(data) {
+        config_1.sdkConfig.ensureVersionCompatible();
+        const url = `${this.baseUrl}/api/admin/database/execute-sql`;
+        (0, log_1.logRequest)("POST", url, this.headers);
+        const response = await fetch(url, {
+            method: "POST",
+            headers: this.headers,
+            body: JSON.stringify(data),
+        });
+        if (!response.ok)
+            await this.handleErrorResponse(response);
+        return await response.json();
+    }
+    async getSqlHistory(options = {}) {
+        config_1.sdkConfig.ensureVersionCompatible();
+        const url = this.buildUrl("/api/admin/database/sql-history", {
+            page: options.page,
+            page_size: options.pageSize,
+        });
+        (0, log_1.logRequest)("GET", url, this.headers);
+        const response = await fetch(url, { headers: this.headers });
+        if (!response.ok)
+            await this.handleErrorResponse(response);
+        return await response.json();
+    }
 }
 exports.AdminClient = AdminClient;

package/dist/agent-skills.d.ts

@@ -69,6 +69,9 @@ export declare class AgentSkillClient {
      * 获取 Skill 详情
      */
     get(skillName: string): Promise<AgentSkillInfo>;
+    getSkillMd(skillName: string): Promise<{
+        content: string;
+    }>;
     /**
      * Upload a skill (zip file)
      * 上传 Skill

package/dist/agent-skills.js

@@ -112,6 +112,22 @@ class AgentSkillClient {
         (0, log_1.logResponse)(response.status, response.statusText, response.headers, result);
         return result;
     }
+    async getSkillMd(skillName) {
+        config_1.sdkConfig.ensureVersionCompatible();
+        const apiUrl = `${this.baseUrl}/api/agent-skills/${skillName}/skill-md`;
+        (0, log_1.debugLog)("Get agent skill SKILL.md:", { skillName });
+        (0, log_1.logRequest)("GET", apiUrl, this.headers);
+        const response = await fetch(apiUrl, {
+            method: "GET",
+            headers: this.headers,
+        });
+        if (!response.ok) {
+            await this.handleErrorResponse(response);
+        }
+        const result = (await response.json());
+        (0, log_1.logResponse)(response.status, response.statusText, response.headers, result);
+        return result;
+    }
     /**
      * Upload a skill (zip file)
      * 上传 Skill

package/dist/cli/commands/admin.d.ts

@@ -0,0 +1,2 @@
+import { Command } from 'commander';
+export declare function registerAdminCommands(program: Command): void;

package/dist/cli/commands/admin.js

@@ -0,0 +1,455 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerAdminCommands = registerAdminCommands;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const admin_1 = require("../../admin");
+const config_1 = require("../config");
+const output_1 = require("../output");
+const utils_1 = require("../utils");
+function collectOpts(cmd) {
+    const chain = [];
+    for (let c = cmd; c; c = c.parent) {
+        chain.unshift(c);
+    }
+    const o = {};
+    for (const c of chain) {
+        Object.assign(o, c.opts());
+    }
+    return o;
+}
+function prepareAdmin(program, cmd) {
+    const o = collectOpts(cmd);
+    const auth = (0, config_1.resolveAuth)({
+        baseUrl: o.baseUrl,
+        token: o.token,
+        pluginId: o.pluginId,
+    });
+    (0, utils_1.requireOption)(auth.token, 'token');
+    (0, utils_1.initSDK)(auth);
+    return (0, utils_1.getFormat)(program);
+}
+function parseJson(raw, label) {
+    try {
+        return JSON.parse(raw);
+    }
+    catch {
+        const err = new Error(`无效 JSON (${label})`);
+        err.code = 'VALIDATION_ERROR';
+        throw err;
+    }
+}
+function parseUserIdsList(raw) {
+    return raw
+        .split(',')
+        .map((s) => s.trim())
+        .filter(Boolean)
+        .map((s) => {
+        const n = Number(s);
+        if (!Number.isFinite(n)) {
+            const err = new Error(`无效的用户 ID: ${s}`);
+            err.code = 'VALIDATION_ERROR';
+            throw err;
+        }
+        return n;
+    });
+}
+function registerAdminCommands(program) {
+    const admin = program.command('admin');
+    const user = admin.command('user');
+    user
+        .command('list')
+        .option('--page <n>', '页码', (v) => parseInt(v, 10))
+        .option('--page-size <n>', '每页条数', (v) => parseInt(v, 10))
+        .action(async (_opts, cmd) => {
+        const commandName = 'admin user list';
+        try {
+            const format = prepareAdmin(program, cmd);
+            const o = cmd.opts();
+            const client = new admin_1.AdminClient();
+            const result = await client.listUsers({
+                page: o.page,
+                pageSize: o.pageSize,
+            });
+            (0, output_1.output)(result, format);
+        }
+        catch (err) {
+            (0, utils_1.handleError)(err, commandName);
+        }
+    });
+    user
+        .command('get')
+        .argument('<userId>', '用户 ID', (v) => parseInt(v, 10))
+        .action(async (userId, _opts, cmd) => {
+        const commandName = 'admin user get';
+        try {
+            const format = prepareAdmin(program, cmd);
+            const client = new admin_1.AdminClient();
+            const result = await client.getUser(userId);
+            (0, output_1.output)(result, format);
+        }
+        catch (err) {
+            (0, utils_1.handleError)(err, commandName);
+        }
+    });
+    user
+        .command('activate')
+        .argument('<userId>', '用户 ID', (v) => parseInt(v, 10))
+        .action(async (userId, _opts, cmd) => {
+        const commandName = 'admin user activate';
+        try {
+            const format = prepareAdmin(program, cmd);
+            const client = new admin_1.AdminClient();
+            const result = await client.activateUser(userId);
+            (0, output_1.output)(result, format);
+        }
+        catch (err) {
+            (0, utils_1.handleError)(err, commandName);
+        }
+    });
+    user
+        .command('deactivate')
+        .argument('<userId>', '用户 ID', (v) => parseInt(v, 10))
+        .action(async (userId, _opts, cmd) => {
+        const commandName = 'admin user deactivate';
+        try {
+            const format = prepareAdmin(program, cmd);
+            const client = new admin_1.AdminClient();
+            const result = await client.deactivateUser(userId);
+            (0, output_1.output)(result, format);
+        }
+        catch (err) {
+            (0, utils_1.handleError)(err, commandName);
+        }
+    });
+    user
+        .command('set-role')
+        .argument('<userId>', '用户 ID', (v) => parseInt(v, 10))
+        .requiredOption('--role-id <n>', '角色 ID', (v) => parseInt(v, 10))
+        .action(async (userId, opts, cmd) => {
+        const commandName = 'admin user set-role';
+        try {
+            const format = prepareAdmin(program, cmd);
+            const client = new admin_1.AdminClient();
+            const result = await client.setUserRole(userId, opts.roleId);
+            (0, output_1.output)(result, format);
+        }
+        catch (err) {
+            (0, utils_1.handleError)(err, commandName);
+        }
+    });
+    user
+        .command('batch-role')
+        .requiredOption('--user-ids <csv>', '用户 ID，逗号分隔')
+        .requiredOption('--role-id <n>', '角色 ID', (v) => parseInt(v, 10))
+        .action(async (opts, cmd) => {
+        const commandName = 'admin user batch-role';
+        try {
+            const format = prepareAdmin(program, cmd);
+            const ids = parseUserIdsList(opts.userIds);
+            const client = new admin_1.AdminClient();
+            const result = await client.batchSetRole(ids, opts.roleId);
+            (0, output_1.output)(result, format);
+        }
+        catch (err) {
+            (0, utils_1.handleError)(err, commandName);
+        }
+    });
+    const role = admin.command('role');
+    role.command('list').action(async (_opts, cmd) => {
+        const commandName = 'admin role list';
+        try {
+            const format = prepareAdmin(program, cmd);
+            const client = new admin_1.AdminClient();
+            const result = await client.listRoles();
+            (0, output_1.output)(result, format);
+        }
+        catch (err) {
+            (0, utils_1.handleError)(err, commandName);
+        }
+    });
+    role
+        .command('get')
+        .argument('<roleId>', '角色 ID', (v) => parseInt(v, 10))
+        .action(async (roleId, _opts, cmd) => {
+        const commandName = 'admin role get';
+        try {
+            const format = prepareAdmin(program, cmd);
+            const client = new admin_1.AdminClient();
+            const result = await client.getRole(roleId);
+            (0, output_1.output)(result, format);
+        }
+        catch (err) {
+            (0, utils_1.handleError)(err, commandName);
+        }
+    });
+    role
+        .command('create')
+        .requiredOption('--name <name>', '角色名称')
+        .option('--permissions <json>', '权限 JSON 对象')
+        .action(async (opts, cmd) => {
+        const commandName = 'admin role create';
+        try {
+            const format = prepareAdmin(program, cmd);
+            const permissions = opts.permissions
+                ? parseJson(opts.permissions, 'permissions')
+                : undefined;
+            const client = new admin_1.AdminClient();
+            const result = await client.createRole({
+                name: opts.name,
+                permissions,
+            });
+            (0, output_1.output)(result, format);
+        }
+        catch (err) {
+            (0, utils_1.handleError)(err, commandName);
+        }
+    });
+    role
+        .command('update')
+        .argument('<roleId>', '角色 ID', (v) => parseInt(v, 10))
+        .option('--name <name>', '角色名称')
+        .option('--permissions <json>', '权限 JSON 对象')
+        .action(async (roleId, opts, cmd) => {
+        const commandName = 'admin role update';
+        try {
+            const format = prepareAdmin(program, cmd);
+            const data = {};
+            if (opts.name !== undefined)
+                data.name = opts.name;
+            if (opts.permissions !== undefined) {
+                data.permissions = parseJson(opts.permissions, 'permissions');
+            }
+            const client = new admin_1.AdminClient();
+            const result = await client.updateRole(roleId, data);
+            (0, output_1.output)(result, format);
+        }
+        catch (err) {
+            (0, utils_1.handleError)(err, commandName);
+        }
+    });
+    role
+        .command('delete')
+        .argument('<roleId>', '角色 ID', (v) => parseInt(v, 10))
+        .action(async (roleId, _opts, cmd) => {
+        const commandName = 'admin role delete';
+        try {
+            const format = prepareAdmin(program, cmd);
+            const client = new admin_1.AdminClient();
+            const result = await client.deleteRole(roleId);
+            (0, output_1.output)(result, format);
+        }
+        catch (err) {
+            (0, utils_1.handleError)(err, commandName);
+        }
+    });
+    role.command('user-counts').action(async (_opts, cmd) => {
+        const commandName = 'admin role user-counts';
+        try {
+            const format = prepareAdmin(program, cmd);
+            const client = new admin_1.AdminClient();
+            const result = await client.getRoleUserCounts();
+            (0, output_1.output)(result, format);
+        }
+        catch (err) {
+            (0, utils_1.handleError)(err, commandName);
+        }
+    });
+    const db = admin.command('db');
+    db.command('tables').action(async (_opts, cmd) => {
+        const commandName = 'admin db tables';
+        try {
+            const format = prepareAdmin(program, cmd);
+            const client = new admin_1.AdminClient();
+            const result = await client.listTables();
+            (0, output_1.output)(result, format);
+        }
+        catch (err) {
+            (0, utils_1.handleError)(err, commandName);
+        }
+    });
+    db
+        .command('schema')
+        .argument('<tableName>', '表名')
+        .action(async (tableName, _opts, cmd) => {
+        const commandName = 'admin db schema';
+        try {
+            const format = prepareAdmin(program, cmd);
+            const client = new admin_1.AdminClient();
+            const result = await client.getTableSchema(tableName);
+            (0, output_1.output)(result, format);
+        }
+        catch (err) {
+            (0, utils_1.handleError)(err, commandName);
+        }
+    });
+    db
+        .command('data')
+        .argument('<tableName>', '表名')
+        .option('--page <n>', '页码', (v) => parseInt(v, 10))
+        .option('--page-size <n>', '每页条数', (v) => parseInt(v, 10))
+        .option('--search <q>', '搜索')
+        .option('--sort-by <column>', '排序列')
+        .option('--sort-order <order>', 'asc | desc')
+        .action(async (tableName, opts, cmd) => {
+        const commandName = 'admin db data';
+        try {
+            const format = prepareAdmin(program, cmd);
+            const sortOrder = opts.sortOrder;
+            if (sortOrder !== undefined &&
+                sortOrder !== 'asc' &&
+                sortOrder !== 'desc') {
+                const err = new Error('sort-order 必须是 asc 或 desc');
+                err.code = 'VALIDATION_ERROR';
+                throw err;
+            }
+            const client = new admin_1.AdminClient();
+            const result = await client.getTableData(tableName, {
+                page: opts.page,
+                pageSize: opts.pageSize,
+                search: opts.search,
+                sortBy: opts.sortBy,
+                sortOrder: sortOrder,
+            });
+            (0, output_1.output)(result, format);
+        }
+        catch (err) {
+            (0, utils_1.handleError)(err, commandName);
+        }
+    });
+    db
+        .command('insert')
+        .argument('<tableName>', '表名')
+        .requiredOption('--data <json>', '行数据 JSON')
+        .action(async (tableName, opts, cmd) => {
+        const commandName = 'admin db insert';
+        try {
+            const format = prepareAdmin(program, cmd);
+            const data = parseJson(opts.data, 'data');
+            const client = new admin_1.AdminClient();
+            const result = await client.insertRow(tableName, data);
+            (0, output_1.output)(result, format);
+        }
+        catch (err) {
+            (0, utils_1.handleError)(err, commandName);
+        }
+    });
+    db
+        .command('update')
+        .argument('<tableName>', '表名')
+        .requiredOption('--primary-key <json>', '主键 JSON')
+        .requiredOption('--data <json>', '更新字段 JSON')
+        .action(async (tableName, opts, cmd) => {
+        const commandName = 'admin db update';
+        try {
+            const format = prepareAdmin(program, cmd);
+            const primaryKey = parseJson(opts.primaryKey, 'primary-key');
+            const data = parseJson(opts.data, 'data');
+            const client = new admin_1.AdminClient();
+            const result = await client.updateRow(tableName, primaryKey, data);
+            (0, output_1.output)(result, format);
+        }
+        catch (err) {
+            (0, utils_1.handleError)(err, commandName);
+        }
+    });
+    db
+        .command('delete')
+        .argument('<tableName>', '表名')
+        .requiredOption('--primary-key <json>', '主键 JSON')
+        .action(async (tableName, opts, cmd) => {
+        const commandName = 'admin db delete';
+        try {
+            const format = prepareAdmin(program, cmd);
+            const primaryKey = parseJson(opts.primaryKey, 'primary-key');
+            const client = new admin_1.AdminClient();
+            const result = await client.deleteRow(tableName, primaryKey);
+            (0, output_1.output)(result, format);
+        }
+        catch (err) {
+            (0, utils_1.handleError)(err, commandName);
+        }
+    });
+    db
+        .command('exec-sql')
+        .option('--sql <sql>', 'SQL 语句')
+        .option('--file <path>', '从文件读取 SQL')
+        .option('--description <text>', '描述')
+        .action(async (opts, cmd) => {
+        const commandName = 'admin db exec-sql';
+        try {
+            const format = prepareAdmin(program, cmd);
+            let sql = opts.sql?.trim() ?? '';
+            if (opts.file) {
+                const abs = path.resolve(opts.file);
+                if (!fs.existsSync(abs)) {
+                    throw new Error(`文件不存在: ${abs}`);
+                }
+                sql = fs.readFileSync(abs, 'utf-8').trim();
+            }
+            (0, utils_1.requireOption)(sql, 'sql');
+            const client = new admin_1.AdminClient();
+            const result = await client.executeSql({
+                sql,
+                description: opts.description,
+            });
+            (0, output_1.output)(result, format);
+        }
+        catch (err) {
+            (0, utils_1.handleError)(err, commandName);
+        }
+    });
+    db
+        .command('sql-history')
+        .option('--page <n>', '页码', (v) => parseInt(v, 10))
+        .option('--page-size <n>', '每页条数', (v) => parseInt(v, 10))
+        .action(async (_opts, cmd) => {
+        const commandName = 'admin db sql-history';
+        try {
+            const format = prepareAdmin(program, cmd);
+            const o = cmd.opts();
+            const client = new admin_1.AdminClient();
+            const result = await client.getSqlHistory({
+                page: o.page,
+                pageSize: o.pageSize,
+            });
+            (0, output_1.output)(result, format);
+        }
+        catch (err) {
+            (0, utils_1.handleError)(err, commandName);
+        }
+    });
+}

package/dist/cli/commands/auth.d.ts

@@ -0,0 +1,2 @@
+import { Command } from 'commander';
+export declare function registerAuthCommands(program: Command): void;

package/dist/cli/commands/auth.js

@@ -0,0 +1,120 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerAuthCommands = registerAuthCommands;
+const auth_1 = require("../../auth");
+const config_1 = require("../../config");
+const login_1 = require("../../login");
+const config_2 = require("../config");
+const output_1 = require("../output");
+const utils_1 = require("../utils");
+function resetSdkAuthState() {
+    const s = config_1.sdkConfig;
+    s._authenticated = null;
+    s._authCheckPromise = null;
+    s._currentUser = null;
+}
+function applyRootDebug(program) {
+    const root = program.opts();
+    if (root.debug) {
+        config_1.sdkConfig.setDebug(true);
+    }
+}
+function registerAuthCommands(program) {
+    program
+        .command('login')
+        .description('登录 AI World（浏览器 OAuth 或直接设置 token）')
+        .option('--token <jwt>', '直接设置 JWT token')
+        .option('--timeout <ms>', 'OAuth 超时毫秒数', (v) => parseInt(v, 10))
+        .action(async (opts) => {
+        try {
+            applyRootDebug(program);
+            const root = program.opts();
+            const resolvedBase = (0, config_2.resolveAuth)({
+                baseUrl: root.baseUrl,
+                token: root.token,
+                pluginId: root.pluginId,
+            }).baseUrl;
+            if (opts.token) {
+                (0, config_2.setConfigValues)({ token: opts.token, 'base-url': resolvedBase });
+            }
+            else {
+                const result = await (0, login_1.performLogin)({
+                    baseUrl: resolvedBase,
+                    timeout: opts.timeout,
+                });
+                (0, config_2.setConfigValues)({ token: result.token, 'base-url': result.baseUrl });
+            }
+            const merged = (0, config_2.resolveAuth)({
+                baseUrl: root.baseUrl,
+                pluginId: root.pluginId,
+            });
+            (0, utils_1.initSDK)(merged);
+            const pluginId = await (0, utils_1.resolvePluginIdDefault)(merged);
+            const format = (0, utils_1.getFormat)(program);
+            (0, output_1.output)({ ok: true, baseUrl: merged.baseUrl, pluginId: pluginId ?? merged.pluginId }, format);
+        }
+        catch (e) {
+            (0, utils_1.handleError)(e, 'login');
+        }
+    });
+    program
+        .command('logout')
+        .description('退出登录（清除缓存 token）')
+        .action(() => {
+        try {
+            const cfg = (0, config_2.readConfig)();
+            delete cfg.token;
+            (0, config_2.writeConfig)(cfg);
+            const format = (0, utils_1.getFormat)(program);
+            (0, output_1.output)({ ok: true, loggedOut: true }, format);
+        }
+        catch (e) {
+            (0, utils_1.handleError)(e, 'logout');
+        }
+    });
+    program
+        .command('me')
+        .description('查看当前用户信息')
+        .action(async () => {
+        try {
+            applyRootDebug(program);
+            const merged = (0, config_2.resolveAuth)(program.opts());
+            resetSdkAuthState();
+            (0, utils_1.initSDK)(merged);
+            const client = new auth_1.AuthClient();
+            const user = await client.getCurrentUserInfo();
+            const format = (0, utils_1.getFormat)(program);
+            (0, output_1.output)(user, format);
+        }
+        catch (e) {
+            (0, utils_1.handleError)(e, 'me');
+        }
+    });
+    program
+        .command('status')
+        .description('检查认证状态')
+        .action(async () => {
+        try {
+            applyRootDebug(program);
+            const merged = (0, config_2.resolveAuth)(program.opts());
+            resetSdkAuthState();
+            (0, utils_1.initSDK)(merged);
+            const ok = await config_1.sdkConfig.checkAuthentication();
+            const format = (0, utils_1.getFormat)(program);
+            const payload = {
+                authenticated: ok,
+                baseUrl: merged.baseUrl,
+                user: ok ? config_1.sdkConfig.getCurrentUser() : null,
+            };
+            if (format === 'table') {
+                (0, output_1.output)(payload, 'table');
+            }
+            else {
+                (0, output_1.outputJSON)(payload);
+            }
+        }
+        catch (e) {
+            (0, utils_1.handleError)(e, 'status');
+        }
+    });
+}

package/dist/cli/commands/chrome.d.ts

@@ -0,0 +1,2 @@
+import { Command } from 'commander';
+export declare function registerChromeCommands(program: Command): void;