wuying-agentbay-sdk 0.1.0 → 0.4.0

package/dist/src/context.js

@@ -1,208 +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.ContextService = exports.Context = void 0;
-const exceptions_1 = require("./exceptions");
-const $_client = __importStar(require("./api"));
-const logger_1 = require("./utils/logger");
-/**
- * Represents a persistent storage context in the AgentBay cloud environment.
- */
-class Context {
-    /**
-     * 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, name, state = 'available', createdAt, lastUsedAt, osType) {
-        this.id = id;
-        this.name = name;
-        this.state = state;
-        this.createdAt = createdAt;
-        this.lastUsedAt = lastUsedAt;
-        this.osType = osType;
-    }
-}
-exports.Context = Context;
-/**
- * Provides methods to manage persistent contexts in the AgentBay cloud environment.
- */
-class ContextService {
-    /**
-     * Initialize the ContextService.
-     *
-     * @param agentBay - The AgentBay instance.
-     */
-    constructor(agentBay) {
-        this.agentBay = agentBay;
-    }
-    /**
-     * Lists all available contexts.
-     *
-     * @returns A list of Context objects.
-     */
-    async list() {
-        try {
-            const request = new $_client.ListContextsRequest({
-                authorization: `Bearer ${this.agentBay.getAPIKey()}`
-            });
-            // Log API request
-            (0, logger_1.log)("API Call: ListContexts");
-            (0, logger_1.log)("Request: No parameters");
-            const response = await this.agentBay.getClient().listContexts(request);
-            // Log API response
-            (0, logger_1.log)(`Response from ListContexts:`, response.body);
-            const contexts = [];
-            if (response.body?.data) {
-                for (const contextData of response.body.data) {
-                    contexts.push(new Context(contextData.id || '', contextData.name || '', contextData.state || 'available', contextData.createTime, contextData.lastUsedTime, contextData.osType));
-                }
-            }
-            return contexts;
-        }
-        catch (error) {
-            (0, logger_1.logError)("Error calling ListContexts:", error);
-            throw new exceptions_1.APIError(`Failed to list contexts: ${error}`);
-        }
-    }
-    /**
-     * 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.
-     */
-    async get(name, create = false) {
-        try {
-            const request = new $_client.GetContextRequest({
-                name: name,
-                allowCreate: create ? 'true' : 'false',
-                authorization: `Bearer ${this.agentBay.getAPIKey()}`
-            });
-            // Log API request
-            (0, logger_1.log)("API Call: GetContext");
-            (0, logger_1.log)(`Request: Name=${name}, AllowCreate=${create}`);
-            const response = await this.agentBay.getClient().getContext(request);
-            // Log API response
-            (0, logger_1.log)(`Response from GetContext:`, response.body);
-            const contextId = response.body?.data?.id;
-            if (!contextId) {
-                return null;
-            }
-            // Get the full context details
-            const contexts = await this.list();
-            for (const context of contexts) {
-                if (context.id === contextId) {
-                    return context;
-                }
-            }
-            // If we couldn't find the context in the list, create a basic one
-            return new Context(contextId, name);
-        }
-        catch (error) {
-            (0, logger_1.logError)("Error calling GetContext:", error);
-            throw new exceptions_1.APIError(`Failed to get context ${name}: ${error}`);
-        }
-    }
-    /**
-     * Creates a new context with the given name.
-     *
-     * @param name - The name for the new context.
-     * @returns The created Context object.
-     */
-    async create(name) {
-        const context = await this.get(name, true);
-        if (!context) {
-            throw new exceptions_1.APIError(`Failed to create context ${name}`);
-        }
-        return context;
-    }
-    /**
-     * Updates the specified context.
-     *
-     * @param context - The Context object to update.
-     * @returns The updated Context object.
-     */
-    async update(context) {
-        try {
-            const request = new $_client.ModifyContextRequest({
-                id: context.id,
-                name: context.name,
-                authorization: `Bearer ${this.agentBay.getAPIKey()}`
-            });
-            // Log API request
-            (0, logger_1.log)("API Call: ModifyContext");
-            (0, logger_1.log)(`Request: Id=${context.id}, Name=${context.name}`);
-            const response = await this.agentBay.getClient().modifyContext(request);
-            // Log API response
-            (0, logger_1.log)(`Response from ModifyContext:`, response.body);
-            // Return the updated context
-            return context;
-        }
-        catch (error) {
-            (0, logger_1.logError)("Error calling ModifyContext:", error);
-            throw new exceptions_1.APIError(`Failed to update context ${context.id}: ${error}`);
-        }
-    }
-    /**
-     * Deletes the specified context.
-     *
-     * @param context - The Context object to delete.
-     */
-    async delete(context) {
-        try {
-            const request = new $_client.DeleteContextRequest({
-                id: context.id,
-                authorization: `Bearer ${this.agentBay.getAPIKey()}`
-            });
-            // Log API request
-            (0, logger_1.log)("API Call: DeleteContext");
-            (0, logger_1.log)(`Request: Id=${context.id}`);
-            const response = await this.agentBay.getClient().deleteContext(request);
-            // Log API response
-            (0, logger_1.log)(`Response from DeleteContext:`, response.body);
-        }
-        catch (error) {
-            (0, logger_1.logError)("Error calling DeleteContext:", error);
-            throw new exceptions_1.APIError(`Failed to delete context ${context.id}: ${error}`);
-        }
-    }
-}
-exports.ContextService = ContextService;

package/dist/src/exceptions.d.ts

@@ -1,30 +0,0 @@
-/**
- * Base exception for all AgentBay errors.
- */
-export declare class AgentBayError extends Error {
-    constructor(message: string);
-}
-/**
- * Raised when there is an authentication error.
- */
-export declare class AuthenticationError extends AgentBayError {
-    constructor(message: string);
-}
-/**
- * Raised when there is an error with the API.
- */
-export declare class APIError extends AgentBayError {
-    constructor(message: string);
-}
-/**
- * Raised when there is an error with file operations.
- */
-export declare class FileError extends AgentBayError {
-    constructor(message: string);
-}
-/**
- * Raised when there is an error with command execution.
- */
-export declare class CommandError extends AgentBayError {
-    constructor(message: string);
-}

package/dist/src/exceptions.js

@@ -1,58 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.CommandError = exports.FileError = exports.APIError = exports.AuthenticationError = exports.AgentBayError = void 0;
-/**
- * Base exception for all AgentBay errors.
- */
-class AgentBayError extends Error {
-    constructor(message) {
-        super(message);
-        this.name = 'AgentBayError';
-        Object.setPrototypeOf(this, AgentBayError.prototype);
-    }
-}
-exports.AgentBayError = AgentBayError;
-/**
- * Raised when there is an authentication error.
- */
-class AuthenticationError extends AgentBayError {
-    constructor(message) {
-        super(message);
-        this.name = 'AuthenticationError';
-        Object.setPrototypeOf(this, AuthenticationError.prototype);
-    }
-}
-exports.AuthenticationError = AuthenticationError;
-/**
- * Raised when there is an error with the API.
- */
-class APIError extends AgentBayError {
-    constructor(message) {
-        super(message);
-        this.name = 'APIError';
-        Object.setPrototypeOf(this, APIError.prototype);
-    }
-}
-exports.APIError = APIError;
-/**
- * Raised when there is an error with file operations.
- */
-class FileError extends AgentBayError {
-    constructor(message) {
-        super(message);
-        this.name = 'FileError';
-        Object.setPrototypeOf(this, FileError.prototype);
-    }
-}
-exports.FileError = FileError;
-/**
- * Raised when there is an error with command execution.
- */
-class CommandError extends AgentBayError {
-    constructor(message) {
-        super(message);
-        this.name = 'CommandError';
-        Object.setPrototypeOf(this, CommandError.prototype);
-    }
-}
-exports.CommandError = CommandError;

package/dist/src/filesystem/filesystem.d.ts

@@ -1,109 +0,0 @@
-import { Session } from '../session';
-/**
- * Handles file operations in the AgentBay cloud environment.
- */
-export declare class FileSystem {
-    private session;
-    private client;
-    private baseUrl;
-    /**
-     * Initialize a FileSystem object.
-     *
-     * @param session - The Session instance that this FileSystem 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;
-    /**
-     * Creates a new directory at the specified path.
-     *
-     * @param path - Path to the directory to create.
-     * @returns The content field from the API response
-     * @throws APIError if the operation fails.
-     */
-    createDirectory(path: string): Promise<any>;
-    /**
-     * Edits a file by replacing occurrences of oldText with newText.
-     *
-     * @param path - Path to the file to edit.
-     * @param edits - Array of edit operations, each containing oldText and newText.
-     * @param dryRun - Optional: If true, preview changes without applying them.
-     * @returns The content field from the API response
-     * @throws APIError if the operation fails.
-     */
-    editFile(path: string, edits: Array<{
-        oldText: string;
-        newText: string;
-    }>, dryRun?: boolean): Promise<any>;
-    /**
-     * Gets information about a file or directory.
-     *
-     * @param path - Path to the file or directory to inspect.
-     * @returns The content field from the API response
-     * @throws APIError if the operation fails.
-     */
-    getFileInfo(path: string): Promise<any>;
-    /**
-     * Lists the contents of a directory.
-     *
-     * @param path - Path to the directory to list.
-     * @returns The content field from the API response
-     * @throws APIError if the operation fails.
-     */
-    listDirectory(path: string): Promise<any>;
-    /**
-     * Moves a file or directory from source to destination.
-     *
-     * @param source - Path to the source file or directory.
-     * @param destination - Path to the destination file or directory.
-     * @returns The content field from the API response
-     * @throws APIError if the operation fails.
-     */
-    moveFile(source: string, destination: string): Promise<any>;
-    /**
-     * Reads the content of a file.
-     *
-     * @param path - Path to the file to read.
-     * @param offset - Optional: Line offset to start reading from.
-     * @param length - Optional: Number of lines to read. If 0, reads the entire file.
-     * @returns The content field from the API response
-     * @throws APIError if the operation fails.
-     */
-    readFile(path: string, offset?: number, length?: number): Promise<any>;
-    /**
-     * Reads the content of multiple files.
-     *
-     * @param paths - Array of file paths to read.
-     * @returns The content field from the API response
-     * @throws APIError if the operation fails.
-     */
-    readMultipleFiles(paths: string[]): Promise<any>;
-    /**
-     * Searches for files in a directory that match a pattern.
-     *
-     * @param path - Path to the directory to search in.
-     * @param pattern - Pattern to search for. Supports glob patterns.
-     * @param excludePatterns - Optional: Array of patterns to exclude.
-     * @returns The content field from the API response
-     * @throws APIError if the operation fails.
-     */
-    searchFiles(path: string, pattern: string, excludePatterns?: string[]): Promise<any>;
-    /**
-     * Writes content to a file.
-     *
-     * @param path - Path to the file to write.
-     * @param content - Content to write to the file.
-     * @param mode - Optional: Write mode. One of "overwrite", "append", or "create_new". Default is "overwrite".
-     * @returns The content field from the API response
-     * @throws APIError if the operation fails.
-     */
-    writeFile(path: string, content: string, mode?: string): Promise<any>;
-}

package/dist/src/filesystem/filesystem.js

@@ -1,245 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.FileSystem = void 0;
-const exceptions_1 = require("../exceptions");
-const model_1 = require("../api/models/model");
-const logger_1 = require("../utils/logger");
-/**
- * Handles file operations in the AgentBay cloud environment.
- */
-class FileSystem {
-    /**
-     * Initialize a FileSystem object.
-     *
-     * @param session - The Session instance that this FileSystem 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}`);
-        }
-    }
-    /**
-     * Creates a new directory at the specified path.
-     *
-     * @param path - Path to the directory to create.
-     * @returns The content field from the API response
-     * @throws APIError if the operation fails.
-     */
-    async createDirectory(path) {
-        const args = {
-            path
-        };
-        const result = await this.callMcpTool('create_directory', args, 'Failed to create directory');
-        // Return the raw content field for the caller to parse
-        return result.data.content;
-    }
-    /**
-     * Edits a file by replacing occurrences of oldText with newText.
-     *
-     * @param path - Path to the file to edit.
-     * @param edits - Array of edit operations, each containing oldText and newText.
-     * @param dryRun - Optional: If true, preview changes without applying them.
-     * @returns The content field from the API response
-     * @throws APIError if the operation fails.
-     */
-    async editFile(path, edits, dryRun = false) {
-        const args = {
-            path,
-            edits,
-            dryRun
-        };
-        const result = await this.callMcpTool('edit_file', args, 'Failed to edit file');
-        // Return the raw content field for the caller to parse
-        return result.data.content;
-    }
-    /**
-     * Gets information about a file or directory.
-     *
-     * @param path - Path to the file or directory to inspect.
-     * @returns The content field from the API response
-     * @throws APIError if the operation fails.
-     */
-    async getFileInfo(path) {
-        const args = {
-            path
-        };
-        const result = await this.callMcpTool('get_file_info', args, 'Failed to get file info');
-        // Return the raw content field for the caller to parse
-        return result.data.content;
-    }
-    /**
-     * Lists the contents of a directory.
-     *
-     * @param path - Path to the directory to list.
-     * @returns The content field from the API response
-     * @throws APIError if the operation fails.
-     */
-    async listDirectory(path) {
-        const args = {
-            path
-        };
-        const result = await this.callMcpTool('list_directory', args, 'Failed to list directory');
-        // Return the raw content field for the caller to parse
-        return result.data.content;
-    }
-    /**
-     * Moves a file or directory from source to destination.
-     *
-     * @param source - Path to the source file or directory.
-     * @param destination - Path to the destination file or directory.
-     * @returns The content field from the API response
-     * @throws APIError if the operation fails.
-     */
-    async moveFile(source, destination) {
-        const args = {
-            source,
-            destination
-        };
-        const result = await this.callMcpTool('move_file', args, 'Failed to move file');
-        // Return the raw content field for the caller to parse
-        return result.data.content;
-    }
-    /**
-     * Reads the content of a file.
-     *
-     * @param path - Path to the file to read.
-     * @param offset - Optional: Line offset to start reading from.
-     * @param length - Optional: Number of lines to read. If 0, reads the entire file.
-     * @returns The content field from the API response
-     * @throws APIError if the operation fails.
-     */
-    async readFile(path, offset = 0, length = 0) {
-        const args = {
-            path
-        };
-        if (offset > 0) {
-            args.offset = offset;
-        }
-        if (length > 0) {
-            args.length = length;
-        }
-        const result = await this.callMcpTool('read_file', args, 'Failed to read file');
-        // Return the raw content field for the caller to parse
-        return result.data.content;
-    }
-    /**
-     * Reads the content of multiple files.
-     *
-     * @param paths - Array of file paths to read.
-     * @returns The content field from the API response
-     * @throws APIError if the operation fails.
-     */
-    async readMultipleFiles(paths) {
-        const args = {
-            paths
-        };
-        const result = await this.callMcpTool('read_multiple_files', args, 'Failed to read multiple files');
-        // Return the raw content field for the caller to parse
-        return result.data.content;
-    }
-    /**
-     * Searches for files in a directory that match a pattern.
-     *
-     * @param path - Path to the directory to search in.
-     * @param pattern - Pattern to search for. Supports glob patterns.
-     * @param excludePatterns - Optional: Array of patterns to exclude.
-     * @returns The content field from the API response
-     * @throws APIError if the operation fails.
-     */
-    async searchFiles(path, pattern, excludePatterns = []) {
-        const args = {
-            path,
-            pattern
-        };
-        if (excludePatterns.length > 0) {
-            args.exclude_patterns = excludePatterns;
-        }
-        const result = await this.callMcpTool('search_files', args, 'Failed to search files');
-        // Return the raw content field for the caller to parse
-        return result.data.content;
-    }
-    /**
-     * Writes content to a file.
-     *
-     * @param path - Path to the file to write.
-     * @param content - Content to write to the file.
-     * @param mode - Optional: Write mode. One of "overwrite", "append", or "create_new". Default is "overwrite".
-     * @returns The content field from the API response
-     * @throws APIError if the operation fails.
-     */
-    async writeFile(path, content, mode = 'overwrite') {
-        // Validate mode
-        const validModes = ['overwrite', 'append', 'create_new'];
-        if (!validModes.includes(mode)) {
-            throw new exceptions_1.APIError(`Invalid mode: ${mode}. Must be one of ${validModes.join(', ')}`);
-        }
-        const args = {
-            path,
-            content,
-            mode
-        };
-        const result = await this.callMcpTool('write_file', args, 'Failed to write file');
-        // Return the raw content field for the caller to parse
-        return result.data.content;
-    }
-}
-exports.FileSystem = FileSystem;

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

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

package/dist/src/filesystem/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("./filesystem"), exports);

package/dist/src/index.d.ts

@@ -1,10 +0,0 @@
-export { AgentBay } from './agent-bay';
-export { Session } from './session';
-export { Context, ContextService } from './context';
-export * from './exceptions';
-export * from './filesystem';
-export * from './command';
-export * from './oss';
-export * from './api';
-export * from './application';
-export * from './ui';