ai-world-sdk 1.3.5 → 1.5.0

package/dist/admin.d.ts

@@ -0,0 +1,129 @@
+/**
+ * Admin Client
+ * 管理员客户端：用户管理、角色管理、数据库表管理
+ * 所有接口需管理员权限
+ */
+export interface AdminClientConfig {
+    baseUrl?: string;
+    token?: string;
+    headers?: Record<string, string>;
+}
+export interface AdminUserInfo {
+    id: number;
+    email?: string;
+    full_name?: string;
+    avatar_url?: string;
+    feishu_user_id?: string;
+    is_active: boolean;
+    is_superuser: boolean;
+    role_id?: number;
+    role_name?: string;
+    created_at: string;
+}
+export interface AdminUserListResponse {
+    items: AdminUserInfo[];
+    total: number;
+    page: number;
+    page_size: number;
+}
+export interface ListUsersOptions {
+    page?: number;
+    pageSize?: number;
+    search?: string;
+    roleId?: number;
+    noRole?: boolean;
+}
+export interface RoleInfo {
+    id: number;
+    name: string;
+    description?: string;
+    permissions: Record<string, boolean>;
+    created_at?: string;
+    updated_at?: string;
+}
+export interface CreateRoleData {
+    name: string;
+    description?: string;
+    permissions?: Record<string, boolean>;
+}
+export interface UpdateRoleData {
+    name?: string;
+    description?: string;
+    permissions?: Record<string, boolean>;
+}
+export interface RoleUserCount {
+    role_id: number;
+    role_name: string;
+    user_count: number;
+}
+export interface TableColumn {
+    name: string;
+    type: string;
+    nullable?: boolean;
+    default?: string;
+    primary_key?: boolean;
+}
+export interface TableDataResponse {
+    data: Record<string, any>[];
+    total: number;
+    page: number;
+    page_size: number;
+}
+export interface ListTableDataOptions {
+    page?: number;
+    pageSize?: number;
+    search?: string;
+    sortBy?: string;
+    sortOrder?: "asc" | "desc";
+}
+export declare class AdminClient {
+    private baseUrl;
+    private headers;
+    constructor(config?: AdminClientConfig);
+    private handleErrorResponse;
+    private buildUrl;
+    listUsers(options?: ListUsersOptions): Promise<AdminUserListResponse>;
+    getUser(userId: number): Promise<AdminUserInfo>;
+    activateUser(userId: number): Promise<{
+        message: string;
+    }>;
+    deactivateUser(userId: number): Promise<{
+        message: string;
+    }>;
+    makeAdmin(userId: number): Promise<{
+        message: string;
+    }>;
+    removeAdmin(userId: number): Promise<{
+        message: string;
+    }>;
+    setUserRole(userId: number, roleId?: number): Promise<{
+        message: string;
+    }>;
+    batchSetRole(userIds: number[], roleId?: number | null): Promise<{
+        message: string;
+    }>;
+    listRoles(): Promise<RoleInfo[]>;
+    getRole(roleId: number): Promise<RoleInfo>;
+    getRoleUserCounts(): Promise<RoleUserCount[]>;
+    createRole(data: CreateRoleData): Promise<RoleInfo>;
+    updateRole(roleId: number, data: UpdateRoleData): Promise<RoleInfo>;
+    deleteRole(roleId: number): Promise<{
+        message: string;
+    }>;
+    listTables(): Promise<string[]>;
+    getTableSchema(tableName: string): Promise<TableColumn[]>;
+    getTableData(tableName: string, options?: ListTableDataOptions): Promise<TableDataResponse>;
+    insertRow(tableName: string, data: Record<string, any>): Promise<Record<string, any>>;
+    updateRow(tableName: string, primaryKey: Record<string, any>, data: Record<string, any>): Promise<Record<string, any>>;
+    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

@@ -0,0 +1,322 @@
+"use strict";
+/**
+ * Admin Client
+ * 管理员客户端：用户管理、角色管理、数据库表管理
+ * 所有接口需管理员权限
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AdminClient = void 0;
+const config_1 = require("./config");
+const log_1 = require("./log");
+class AdminClient {
+    constructor(config = {}) {
+        this.baseUrl =
+            config.baseUrl ||
+                config_1.sdkConfig.getServerUrl() ||
+                (typeof window !== "undefined" ? window.location.origin : "");
+        const globalHeaders = config_1.sdkConfig.getHeaders();
+        const globalToken = config.token || config_1.sdkConfig.getToken();
+        this.headers = {
+            "Content-Type": "application/json",
+            ...globalHeaders,
+            ...config.headers,
+        };
+        if (globalToken) {
+            this.headers["Authorization"] = `Bearer ${globalToken}`;
+        }
+    }
+    async handleErrorResponse(response) {
+        let errorMessage = `Request failed: ${response.status} ${response.statusText}`;
+        try {
+            const errorText = await response.text();
+            const errorJson = JSON.parse(errorText);
+            errorMessage = errorJson.detail || errorMessage;
+        }
+        catch { }
+        throw new Error(errorMessage);
+    }
+    buildUrl(path, params) {
+        const url = `${this.baseUrl}${path}`;
+        if (!params)
+            return url;
+        const sp = new URLSearchParams();
+        for (const [k, v] of Object.entries(params)) {
+            if (v !== undefined && v !== null)
+                sp.append(k, String(v));
+        }
+        const qs = sp.toString();
+        return qs ? `${url}?${qs}` : url;
+    }
+    // ==================== 用户管理 ====================
+    async listUsers(options = {}) {
+        config_1.sdkConfig.ensureVersionCompatible();
+        const url = this.buildUrl("/api/admin/users", {
+            page: options.page,
+            page_size: options.pageSize,
+            search: options.search,
+            role_id: options.roleId,
+            no_role: options.noRole,
+        });
+        (0, log_1.debugLog)("Admin list users:", options);
+        (0, log_1.logRequest)("GET", url, this.headers);
+        const response = await fetch(url, { 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;
+    }
+    async getUser(userId) {
+        config_1.sdkConfig.ensureVersionCompatible();
+        const url = `${this.baseUrl}/api/admin/users/${userId}`;
+        (0, log_1.logRequest)("GET", url, this.headers);
+        const response = await fetch(url, { 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;
+    }
+    async activateUser(userId) {
+        config_1.sdkConfig.ensureVersionCompatible();
+        const url = `${this.baseUrl}/api/admin/users/${userId}/activate`;
+        (0, log_1.logRequest)("PATCH", url, this.headers);
+        const response = await fetch(url, {
+            method: "PATCH",
+            headers: this.headers,
+        });
+        if (!response.ok)
+            await this.handleErrorResponse(response);
+        return (await response.json());
+    }
+    async deactivateUser(userId) {
+        config_1.sdkConfig.ensureVersionCompatible();
+        const url = `${this.baseUrl}/api/admin/users/${userId}/deactivate`;
+        (0, log_1.logRequest)("PATCH", url, this.headers);
+        const response = await fetch(url, {
+            method: "PATCH",
+            headers: this.headers,
+        });
+        if (!response.ok)
+            await this.handleErrorResponse(response);
+        return (await response.json());
+    }
+    async makeAdmin(userId) {
+        config_1.sdkConfig.ensureVersionCompatible();
+        const url = `${this.baseUrl}/api/admin/users/${userId}/make-admin`;
+        (0, log_1.logRequest)("PATCH", url, this.headers);
+        const response = await fetch(url, {
+            method: "PATCH",
+            headers: this.headers,
+        });
+        if (!response.ok)
+            await this.handleErrorResponse(response);
+        return (await response.json());
+    }
+    async removeAdmin(userId) {
+        config_1.sdkConfig.ensureVersionCompatible();
+        const url = `${this.baseUrl}/api/admin/users/${userId}/remove-admin`;
+        (0, log_1.logRequest)("PATCH", url, this.headers);
+        const response = await fetch(url, {
+            method: "PATCH",
+            headers: this.headers,
+        });
+        if (!response.ok)
+            await this.handleErrorResponse(response);
+        return (await response.json());
+    }
+    async setUserRole(userId, roleId) {
+        config_1.sdkConfig.ensureVersionCompatible();
+        const url = this.buildUrl(`/api/admin/users/${userId}/role`, roleId !== undefined ? { role_id: roleId } : undefined);
+        (0, log_1.logRequest)("PATCH", url, this.headers);
+        const response = await fetch(url, {
+            method: "PATCH",
+            headers: this.headers,
+        });
+        if (!response.ok)
+            await this.handleErrorResponse(response);
+        return (await response.json());
+    }
+    async batchSetRole(userIds, roleId) {
+        config_1.sdkConfig.ensureVersionCompatible();
+        const url = `${this.baseUrl}/api/admin/users/batch-role`;
+        (0, log_1.logRequest)("PATCH", url, this.headers);
+        const response = await fetch(url, {
+            method: "PATCH",
+            headers: this.headers,
+            body: JSON.stringify({ user_ids: userIds, role_id: roleId ?? null }),
+        });
+        if (!response.ok)
+            await this.handleErrorResponse(response);
+        return (await response.json());
+    }
+    // ==================== 角色管理 ====================
+    async listRoles() {
+        config_1.sdkConfig.ensureVersionCompatible();
+        const url = `${this.baseUrl}/api/admin/roles`;
+        (0, log_1.logRequest)("GET", url, this.headers);
+        const response = await fetch(url, { 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;
+    }
+    async getRole(roleId) {
+        config_1.sdkConfig.ensureVersionCompatible();
+        const url = `${this.baseUrl}/api/admin/roles/${roleId}`;
+        (0, log_1.logRequest)("GET", url, this.headers);
+        const response = await fetch(url, { 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;
+    }
+    async getRoleUserCounts() {
+        config_1.sdkConfig.ensureVersionCompatible();
+        const url = `${this.baseUrl}/api/admin/roles/user-counts`;
+        (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());
+    }
+    async createRole(data) {
+        config_1.sdkConfig.ensureVersionCompatible();
+        const url = `${this.baseUrl}/api/admin/roles`;
+        (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 updateRole(roleId, data) {
+        config_1.sdkConfig.ensureVersionCompatible();
+        const url = `${this.baseUrl}/api/admin/roles/${roleId}`;
+        (0, log_1.logRequest)("PATCH", url, this.headers);
+        const response = await fetch(url, {
+            method: "PATCH",
+            headers: this.headers,
+            body: JSON.stringify(data),
+        });
+        if (!response.ok)
+            await this.handleErrorResponse(response);
+        return (await response.json());
+    }
+    async deleteRole(roleId) {
+        config_1.sdkConfig.ensureVersionCompatible();
+        const url = `${this.baseUrl}/api/admin/roles/${roleId}`;
+        (0, log_1.logRequest)("DELETE", url, this.headers);
+        const response = await fetch(url, {
+            method: "DELETE",
+            headers: this.headers,
+        });
+        if (!response.ok)
+            await this.handleErrorResponse(response);
+        return (await response.json());
+    }
+    // ==================== 数据库表管理 ====================
+    async listTables() {
+        config_1.sdkConfig.ensureVersionCompatible();
+        const url = `${this.baseUrl}/api/admin/database/tables`;
+        (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());
+    }
+    async getTableSchema(tableName) {
+        config_1.sdkConfig.ensureVersionCompatible();
+        const url = `${this.baseUrl}/api/admin/database/tables/${tableName}/schema`;
+        (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());
+    }
+    async getTableData(tableName, options = {}) {
+        config_1.sdkConfig.ensureVersionCompatible();
+        const url = this.buildUrl(`/api/admin/database/tables/${tableName}/data`, {
+            page: options.page,
+            page_size: options.pageSize,
+            search: options.search,
+            sort_by: options.sortBy,
+            sort_order: options.sortOrder,
+        });
+        (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());
+    }
+    async insertRow(tableName, data) {
+        config_1.sdkConfig.ensureVersionCompatible();
+        const url = `${this.baseUrl}/api/admin/database/tables/${tableName}/data`;
+        (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 updateRow(tableName, primaryKey, data) {
+        config_1.sdkConfig.ensureVersionCompatible();
+        const url = `${this.baseUrl}/api/admin/database/tables/${tableName}/data`;
+        (0, log_1.logRequest)("PUT", url, this.headers);
+        const response = await fetch(url, {
+            method: "PUT",
+            headers: this.headers,
+            body: JSON.stringify({ primary_key: primaryKey, data }),
+        });
+        if (!response.ok)
+            await this.handleErrorResponse(response);
+        return (await response.json());
+    }
+    async deleteRow(tableName, primaryKey) {
+        config_1.sdkConfig.ensureVersionCompatible();
+        const url = `${this.baseUrl}/api/admin/database/tables/${tableName}/data`;
+        (0, log_1.logRequest)("DELETE", url, this.headers);
+        const response = await fetch(url, {
+            method: "DELETE",
+            headers: this.headers,
+            body: JSON.stringify({ primary_key: primaryKey }),
+        });
+        if (!response.ok)
+            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/chrome-extension.d.ts

@@ -0,0 +1,54 @@
+/**
+ * Chrome Extension Client
+ * Chrome 插件管理客户端
+ */
+export interface ChromeExtensionClientConfig {
+    baseUrl?: string;
+    token?: string;
+    headers?: Record<string, string>;
+}
+export interface ChromeExtensionInfo {
+    extension_id: string;
+    name: string;
+    description: string;
+    author?: string;
+    version: string;
+    user_id?: number;
+    created_at?: string;
+    updated_at?: string;
+}
+export interface ChromeExtensionListResponse {
+    items: ChromeExtensionInfo[];
+    total: number;
+    page: number;
+    page_size: number;
+}
+export interface ListChromeExtensionsOptions {
+    page?: number;
+    pageSize?: number;
+    name?: string;
+    extensionId?: string;
+    author?: string;
+}
+export interface CreateChromeExtensionData {
+    extensionId: string;
+    name: string;
+    description: string;
+    author?: string;
+    version?: string;
+    extensionZip?: File | Blob;
+}
+export declare class ChromeExtensionClient {
+    private baseUrl;
+    private headers;
+    constructor(config?: ChromeExtensionClientConfig);
+    private handleErrorResponse;
+    private buildUrl;
+    list(options?: ListChromeExtensionsOptions): Promise<ChromeExtensionListResponse>;
+    get(extensionId: string): Promise<ChromeExtensionInfo>;
+    create(data: CreateChromeExtensionData): Promise<ChromeExtensionInfo>;
+    delete(extensionId: string): Promise<{
+        message: string;
+    }>;
+    download(extensionId: string): Promise<Blob>;
+}

package/dist/chrome-extension.js

@@ -0,0 +1,124 @@
+"use strict";
+/**
+ * Chrome Extension Client
+ * Chrome 插件管理客户端
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ChromeExtensionClient = void 0;
+const config_1 = require("./config");
+const log_1 = require("./log");
+class ChromeExtensionClient {
+    constructor(config = {}) {
+        this.baseUrl =
+            config.baseUrl ||
+                config_1.sdkConfig.getServerUrl() ||
+                (typeof window !== "undefined" ? window.location.origin : "");
+        const globalHeaders = config_1.sdkConfig.getHeaders();
+        const globalToken = config.token || config_1.sdkConfig.getToken();
+        this.headers = {
+            "Content-Type": "application/json",
+            ...globalHeaders,
+            ...config.headers,
+        };
+        if (globalToken) {
+            this.headers["Authorization"] = `Bearer ${globalToken}`;
+        }
+    }
+    async handleErrorResponse(response) {
+        let errorMessage = `Request failed: ${response.status} ${response.statusText}`;
+        try {
+            const errorText = await response.text();
+            const errorJson = JSON.parse(errorText);
+            errorMessage = errorJson.detail || errorMessage;
+        }
+        catch { }
+        throw new Error(errorMessage);
+    }
+    buildUrl(path, params) {
+        const url = `${this.baseUrl}${path}`;
+        if (!params)
+            return url;
+        const sp = new URLSearchParams();
+        for (const [k, v] of Object.entries(params)) {
+            if (v !== undefined && v !== null)
+                sp.append(k, String(v));
+        }
+        const qs = sp.toString();
+        return qs ? `${url}?${qs}` : url;
+    }
+    async list(options = {}) {
+        config_1.sdkConfig.ensureVersionCompatible();
+        const url = this.buildUrl("/api/chrome-extensions/", {
+            page: options.page,
+            page_size: options.pageSize,
+            name: options.name,
+            extension_id: options.extensionId,
+            author: options.author,
+        });
+        (0, log_1.logRequest)("GET", url, this.headers);
+        const response = await fetch(url, { 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;
+    }
+    async get(extensionId) {
+        config_1.sdkConfig.ensureVersionCompatible();
+        const url = `${this.baseUrl}/api/chrome-extensions/${extensionId}`;
+        (0, log_1.logRequest)("GET", url, this.headers);
+        const response = await fetch(url, { 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;
+    }
+    async create(data) {
+        config_1.sdkConfig.ensureVersionCompatible();
+        const url = `${this.baseUrl}/api/chrome-extensions/create`;
+        const formData = new FormData();
+        formData.append("extension_id", data.extensionId);
+        formData.append("name", data.name);
+        formData.append("description", data.description);
+        if (data.author)
+            formData.append("author", data.author);
+        if (data.version)
+            formData.append("version", data.version);
+        if (data.extensionZip)
+            formData.append("extension_zip", data.extensionZip);
+        const uploadHeaders = { ...this.headers };
+        delete uploadHeaders["Content-Type"];
+        (0, log_1.logRequest)("POST", url, uploadHeaders);
+        const response = await fetch(url, {
+            method: "POST",
+            headers: uploadHeaders,
+            body: formData,
+        });
+        if (!response.ok)
+            await this.handleErrorResponse(response);
+        return (await response.json());
+    }
+    async delete(extensionId) {
+        config_1.sdkConfig.ensureVersionCompatible();
+        const url = `${this.baseUrl}/api/chrome-extensions/${extensionId}`;
+        (0, log_1.logRequest)("DELETE", url, this.headers);
+        const response = await fetch(url, {
+            method: "DELETE",
+            headers: this.headers,
+        });
+        if (!response.ok)
+            await this.handleErrorResponse(response);
+        return (await response.json());
+    }
+    async download(extensionId) {
+        config_1.sdkConfig.ensureVersionCompatible();
+        const url = `${this.baseUrl}/api/chrome-extensions/${extensionId}/download`;
+        (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.blob();
+    }
+}
+exports.ChromeExtensionClient = ChromeExtensionClient;

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

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