wuying-agentbay-sdk 0.1.0 → 0.4.0

package/dist/src/application/application.js

@@ -1,172 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.Application = void 0;
-const CallMcpToolRequest_1 = require("../api/models/CallMcpToolRequest");
-const logger_1 = require("../utils/logger");
-const exceptions_1 = require("../exceptions");
-/**
- * Handles application management operations in the AgentBay cloud environment.
- */
-class Application {
-    /**
-     * Creates a new Application instance.
-     * @param session The session object that provides access to the AgentBay API.
-     */
-    constructor(session) {
-        this.session = session;
-    }
-    /**
-     * Helper method to call MCP tools and handle common response processing
-     *
-     * @param toolName - Name of the MCP tool to call
-     * @param args - Arguments to pass to the tool
-     * @param defaultErrorMsg - Default error message if specific error details are not available
-     * @returns A CallMcpToolResult with the response data
-     * @throws APIError if the call fails
-     */
-    async callMcpTool(toolName, args, defaultErrorMsg) {
-        try {
-            const argsJSON = JSON.stringify(args);
-            const request = new CallMcpToolRequest_1.CallMcpToolRequest({
-                authorization: `Bearer ${this.session.getAPIKey()}`,
-                sessionId: this.session.getSessionId(),
-                name: toolName,
-                args: argsJSON
-            });
-            // Log API request
-            (0, logger_1.log)(`API Call: CallMcpTool - ${toolName}`);
-            (0, logger_1.log)(`Request: SessionId=${request.sessionId}, Args=${request.args}`);
-            const client = this.session.getClient();
-            const response = await client.callMcpTool(request);
-            // Log API response
-            if (response && response.body) {
-                (0, logger_1.log)(`Response from CallMcpTool - ${toolName}:`, response.body);
-            }
-            // Extract data from response
-            if (!response.body?.data) {
-                throw new Error('Invalid response data format');
-            }
-            const data = response.body.data;
-            // Create result object
-            const result = {
-                data,
-                statusCode: response.statusCode || 0,
-                isError: false
-            };
-            // Check if there's an error in the response
-            if (data.isError === true) {
-                result.isError = true;
-                // Try to extract the error message from the content field
-                const contentArray = data.content;
-                if (contentArray && contentArray.length > 0) {
-                    result.content = contentArray;
-                    // Extract error message from the first content item
-                    if (contentArray[0]?.text) {
-                        result.errorMsg = contentArray[0].text;
-                        throw new Error(contentArray[0].text);
-                    }
-                }
-                throw new Error(defaultErrorMsg);
-            }
-            // Extract content array if it exists
-            if (Array.isArray(data.content)) {
-                result.content = data.content;
-            }
-            return result;
-        }
-        catch (error) {
-            (0, logger_1.logError)(`Error calling CallMcpTool - ${toolName}:`, error);
-            throw new exceptions_1.APIError(`Failed to call ${toolName}: ${error}`);
-        }
-    }
-    /**
-     * Retrieves a list of installed applications.
-     * @param startMenu Whether to include applications from the start menu. Defaults to true.
-     * @param desktop Whether to include applications from the desktop. Defaults to true.
-     * @param ignoreSystemApps Whether to ignore system applications. Defaults to true.
-     * @returns The content field from the API response
-     * @throws Error if the operation fails.
-     */
-    async getInstalledApps(startMenu = true, desktop = true, ignoreSystemApps = true) {
-        const args = {
-            start_menu: startMenu,
-            desktop,
-            ignore_system_apps: ignoreSystemApps
-        };
-        const result = await this.callMcpTool('get_installed_apps', args, 'Failed to get installed apps');
-        // Return the raw content field for the caller to parse
-        return result.data.content;
-    }
-    /**
-     * Starts an application with the given command and optional working directory.
-     * @param startCmd The command to start the application.
-     * @param workDirectory The working directory for the application. Defaults to an empty string.
-     * @returns The content field from the API response
-     * @throws Error if the operation fails.
-     */
-    async startApp(startCmd, workDirectory = '') {
-        const args = {
-            start_cmd: startCmd
-        };
-        if (workDirectory) {
-            args.work_directory = workDirectory;
-        }
-        const result = await this.callMcpTool('start_app', args, 'Failed to start app');
-        // Return the raw content field for the caller to parse
-        return result.data.content;
-    }
-    /**
-     * Stops an application by process name.
-     * @param pname The name of the process to stop.
-     * @returns The content field from the API response
-     * @throws Error if the operation fails.
-     */
-    async stopAppByPName(pname) {
-        const args = {
-            pname
-        };
-        const result = await this.callMcpTool('stop_app_by_pname', args, 'Failed to stop app by pname');
-        // Return the raw content field for the caller to parse
-        return result.data.content;
-    }
-    /**
-     * Stops an application by process ID.
-     * @param pid The ID of the process to stop.
-     * @returns The content field from the API response
-     * @throws Error if the operation fails.
-     */
-    async stopAppByPID(pid) {
-        const args = {
-            pid
-        };
-        const result = await this.callMcpTool('stop_app_by_pid', args, 'Failed to stop app by pid');
-        // Return the raw content field for the caller to parse
-        return result.data.content;
-    }
-    /**
-     * Stops an application by stop command.
-     * @param stopCmd The command to stop the application.
-     * @returns The content field from the API response
-     * @throws Error if the operation fails.
-     */
-    async stopAppByCmd(stopCmd) {
-        const args = {
-            stop_cmd: stopCmd
-        };
-        const result = await this.callMcpTool('stop_app_by_cmd', args, 'Failed to stop app by command');
-        // Return the raw content field for the caller to parse
-        return result.data.content;
-    }
-    /**
-     * Lists all currently visible applications.
-     * @returns The content field from the API response
-     * @throws Error if the operation fails.
-     */
-    async listVisibleApps() {
-        const args = {};
-        const result = await this.callMcpTool('list_visible_apps', args, 'Failed to list visible apps');
-        // Return the raw content field for the caller to parse
-        return result.data.content;
-    }
-}
-exports.Application = Application;

package/dist/src/application/index.d.ts

@@ -1 +0,0 @@
-export * from './application';

package/dist/src/application/index.js

@@ -1,17 +0,0 @@
-"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 __exportStar = (this && this.__exportStar) || function(m, exports) {
-    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-__exportStar(require("./application"), exports);

package/dist/src/command/command.d.ts

@@ -1,43 +0,0 @@
-import { Session } from '../session';
-/**
- * Handles command execution operations in the AgentBay cloud environment.
- */
-export declare class Command {
-    private session;
-    private client;
-    private baseUrl;
-    /**
-     * Initialize a Command object.
-     *
-     * @param session - The Session instance that this Command belongs to.
-     */
-    constructor(session: Session);
-    /**
-     * Helper method to call MCP tools and handle common response processing
-     *
-     * @param toolName - Name of the MCP tool to call
-     * @param args - Arguments to pass to the tool
-     * @param defaultErrorMsg - Default error message if specific error details are not available
-     * @returns A CallMcpToolResult with the response data
-     * @throws APIError if the call fails
-     */
-    private callMcpTool;
-    /**
-     * Execute a command in the cloud environment with a specified timeout.
-     *
-     * @param command - The command to execute.
-     * @param timeoutMs - The timeout for the command execution in milliseconds. Default is 1000ms.
-     * @returns The content field from the API response
-     */
-    executeCommand(command: string, timeoutMs?: number): Promise<any>;
-    /**
-     * Execute code in the specified language with a timeout.
-     *
-     * @param code - The code to execute.
-     * @param language - The programming language of the code. Must be either 'python' or 'javascript'.
-     * @param timeoutS - The timeout for the code execution in seconds. Default is 300s.
-     * @returns The content field from the API response
-     * @throws APIError if the code execution fails or if an unsupported language is specified.
-     */
-    runCode(code: string, language: string, timeoutS?: number): Promise<any>;
-}

package/dist/src/command/command.js

@@ -1,120 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.Command = void 0;
-const exceptions_1 = require("../exceptions");
-const model_1 = require("../api/models/model");
-const logger_1 = require("../utils/logger");
-/**
- * Handles command execution operations in the AgentBay cloud environment.
- */
-class Command {
-    /**
-     * Initialize a Command object.
-     *
-     * @param session - The Session instance that this Command belongs to.
-     */
-    constructor(session) {
-        this.session = session;
-    }
-    /**
-     * Helper method to call MCP tools and handle common response processing
-     *
-     * @param toolName - Name of the MCP tool to call
-     * @param args - Arguments to pass to the tool
-     * @param defaultErrorMsg - Default error message if specific error details are not available
-     * @returns A CallMcpToolResult with the response data
-     * @throws APIError if the call fails
-     */
-    async callMcpTool(toolName, args, defaultErrorMsg) {
-        try {
-            const argsJSON = JSON.stringify(args);
-            const callToolRequest = new model_1.CallMcpToolRequest({
-                authorization: `Bearer ${this.session.getAPIKey()}`,
-                sessionId: this.session.getSessionId(),
-                name: toolName,
-                args: argsJSON
-            });
-            // Log API request
-            (0, logger_1.log)(`API Call: CallMcpTool - ${toolName}`);
-            (0, logger_1.log)(`Request: SessionId=${this.session.getSessionId()}, Args=${argsJSON}`);
-            const response = await this.session.getClient().callMcpTool(callToolRequest);
-            // Log API response
-            (0, logger_1.log)(`Response from CallMcpTool - ${toolName}:`, response.body);
-            if (!response.body?.data) {
-                throw new Error('Invalid response data format');
-            }
-            // Extract data from response
-            const data = response.body.data;
-            // Create result object
-            const result = {
-                data,
-                statusCode: response.statusCode || 0,
-                isError: false
-            };
-            // Check if there's an error in the response
-            if (data.isError === true) {
-                result.isError = true;
-                // Try to extract the error message from the content field
-                const contentArray = data.content;
-                if (contentArray && contentArray.length > 0) {
-                    result.content = contentArray;
-                    // Extract error message from the first content item
-                    if (contentArray[0]?.text) {
-                        result.errorMsg = contentArray[0].text;
-                        throw new Error(contentArray[0].text);
-                    }
-                }
-                throw new Error(defaultErrorMsg);
-            }
-            // Extract content array if it exists
-            if (Array.isArray(data.content)) {
-                result.content = data.content;
-            }
-            return result;
-        }
-        catch (error) {
-            (0, logger_1.logError)(`Error calling CallMcpTool - ${toolName}:`, error);
-            throw new exceptions_1.APIError(`Failed to call ${toolName}: ${error}`);
-        }
-    }
-    /**
-     * Execute a command in the cloud environment with a specified timeout.
-     *
-     * @param command - The command to execute.
-     * @param timeoutMs - The timeout for the command execution in milliseconds. Default is 1000ms.
-     * @returns The content field from the API response
-     */
-    async executeCommand(command, timeoutMs = 1000) {
-        const args = {
-            command,
-            timeout_ms: timeoutMs
-        };
-        const result = await this.callMcpTool('shell', args, 'Failed to execute command');
-        // Return the raw content field for the caller to parse
-        return result.data.content;
-    }
-    /**
-     * Execute code in the specified language with a timeout.
-     *
-     * @param code - The code to execute.
-     * @param language - The programming language of the code. Must be either 'python' or 'javascript'.
-     * @param timeoutS - The timeout for the code execution in seconds. Default is 300s.
-     * @returns The content field from the API response
-     * @throws APIError if the code execution fails or if an unsupported language is specified.
-     */
-    async runCode(code, language, timeoutS = 300) {
-        // Validate language
-        if (language !== 'python' && language !== 'javascript') {
-            throw new Error(`Unsupported language: ${language}. Supported languages are 'python' and 'javascript'`);
-        }
-        const args = {
-            code,
-            language,
-            timeout_s: timeoutS
-        };
-        const result = await this.callMcpTool('run_code', args, 'Failed to execute code');
-        // Return the raw content field for the caller to parse
-        return result.data.content;
-    }
-}
-exports.Command = Command;

package/dist/src/command/index.d.ts

@@ -1 +0,0 @@
-export * from './command';

package/dist/src/command/index.js

@@ -1,17 +0,0 @@
-"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 __exportStar = (this && this.__exportStar) || function(m, exports) {
-    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-__exportStar(require("./command"), exports);

package/dist/src/config.d.ts

@@ -1,15 +0,0 @@
-import 'dotenv/config';
-interface Config {
-    region_id: string;
-    endpoint: string;
-    timeout_ms: number;
-}
-/**
- * Returns the default configuration
- */
-export declare function defaultConfig(): Config;
-/**
- * Loads configuration from file
- */
-export declare function loadConfig(): Config;
-export {};

package/dist/src/config.js

@@ -1,114 +0,0 @@
-"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.defaultConfig = defaultConfig;
-exports.loadConfig = loadConfig;
-const fs = __importStar(require("fs"));
-const path = __importStar(require("path"));
-require("dotenv/config");
-const logger_1 = require("./utils/logger");
-/**
- * Returns the default configuration
- */
-function defaultConfig() {
-    return {
-        region_id: 'cn-shanghai',
-        endpoint: 'wuyingai.cn-shanghai.aliyuncs.com',
-        timeout_ms: 60000
-    };
-}
-/**
- * Loads configuration from file
- */
-function loadConfig() {
-    // First check if the config file path is specified in environment variables
-    let configPath = process.env.AGENTBAY_CONFIG_PATH;
-    if (!configPath) {
-        try {
-            // Try to find the config file by traversing up from the current directory
-            let dirPath = process.cwd();
-            let found = false;
-            // Start from current directory and traverse up to find .config.json
-            // This will check current dir, parent, grandparent, etc. up to filesystem root
-            for (let i = 0; i < 10; i++) { // Limit search depth to prevent infinite loop
-                const possibleConfigPath = path.join(dirPath, '.config.json');
-                if (fs.existsSync(possibleConfigPath)) {
-                    configPath = possibleConfigPath;
-                    found = true;
-                    (0, logger_1.log)(`Found config file at: ${possibleConfigPath}`);
-                    break;
-                }
-                // Move up one directory
-                const parentDir = path.dirname(dirPath);
-                if (parentDir === dirPath) {
-                    // We've reached the filesystem root
-                    break;
-                }
-                dirPath = parentDir;
-            }
-            if (!found) {
-                // Config file not found, return default config
-                (0, logger_1.log)('Warning: Configuration file not found, using default values');
-                return defaultConfig();
-            }
-        }
-        catch (error) {
-            (0, logger_1.log)(`Warning: Failed to search for configuration file: ${error}, using default values`);
-            return defaultConfig();
-        }
-    }
-    try {
-        // Make sure configPath is defined
-        if (!configPath) {
-            (0, logger_1.log)('Warning: Configuration file path is undefined, using default values');
-            return defaultConfig();
-        }
-        // Read the config file
-        const data = fs.readFileSync(configPath, 'utf8');
-        const config = JSON.parse(data);
-        // Allow environment variables to override config file values
-        if (process.env.AGENTBAY_REGION_ID) {
-            config.region_id = process.env.AGENTBAY_REGION_ID;
-        }
-        if (process.env.AGENTBAY_ENDPOINT) {
-            config.endpoint = process.env.AGENTBAY_ENDPOINT;
-        }
-        return config;
-    }
-    catch (error) {
-        (0, logger_1.log)(`Warning: Failed to read configuration file: ${error}, using default values`);
-        return defaultConfig();
-    }
-}

package/dist/src/context.d.ts

@@ -1,87 +0,0 @@
-import { AgentBay } from './agent-bay';
-/**
- * Represents a persistent storage context in the AgentBay cloud environment.
- */
-export declare class Context {
-    /**
-     * The unique identifier of the context.
-     */
-    id: string;
-    /**
-     * The name of the context.
-     */
-    name: string;
-    /**
-     * The current state of the context (e.g., "available", "in-use").
-     */
-    state: string;
-    /**
-     * Date and time when the Context was created.
-     */
-    createdAt?: string;
-    /**
-     * Date and time when the Context was last used.
-     */
-    lastUsedAt?: string;
-    /**
-     * The operating system type this context is bound to.
-     */
-    osType?: string;
-    /**
-     * Initialize a Context object.
-     *
-     * @param id - The unique identifier of the context.
-     * @param name - The name of the context.
-     * @param state - The current state of the context.
-     * @param createdAt - Date and time when the Context was created.
-     * @param lastUsedAt - Date and time when the Context was last used.
-     * @param osType - The operating system type this context is bound to.
-     */
-    constructor(id: string, name: string, state?: string, createdAt?: string, lastUsedAt?: string, osType?: string);
-}
-/**
- * Provides methods to manage persistent contexts in the AgentBay cloud environment.
- */
-export declare class ContextService {
-    private agentBay;
-    /**
-     * Initialize the ContextService.
-     *
-     * @param agentBay - The AgentBay instance.
-     */
-    constructor(agentBay: AgentBay);
-    /**
-     * Lists all available contexts.
-     *
-     * @returns A list of Context objects.
-     */
-    list(): Promise<Context[]>;
-    /**
-     * Gets a context by name. Optionally creates it if it doesn't exist.
-     *
-     * @param name - The name of the context to get.
-     * @param create - Whether to create the context if it doesn't exist.
-     * @returns The Context object if found or created, null if not found and create is false.
-     */
-    get(name: string, create?: boolean): Promise<Context | null>;
-    /**
-     * Creates a new context with the given name.
-     *
-     * @param name - The name for the new context.
-     * @returns The created Context object.
-     */
-    create(name: string): Promise<Context>;
-    /**
-     * Updates the specified context.
-     *
-     * @param context - The Context object to update.
-     * @returns The updated Context object.
-     */
-    update(context: Context): Promise<Context>;
-    /**
-     * Deletes the specified context.
-     *
-     * @param context - The Context object to delete.
-     */
-    delete(context: Context): Promise<void>;
-}