AGBCLOUD

Appearance

Class: Command ​

Overview ​

The Command module provides methods for executing shell commands within a session in the AGB cloud environment. It supports command execution with configurable timeouts.

Command module for executing shell commands in the session.

Hierarchy ​

  • BaseService

    ↳ Command

Table of contents ​

Properties ​

Methods ​

Properties ​

typescript
exec: (`command`: `string`, `timeoutMs`: `number`, `cwd?`: `string`, `envs?`: `Record`<`string`, `string`>) => `Promise`<``CommandResult``>
run: (`command`: `string`, `timeoutMs`: `number`, `cwd?`: `string`, `envs?`: `Record`<`string`, `string`>) => `Promise`<``CommandResult``>

Type declaration ​

▸ (command, timeoutMs?, cwd?, envs?): Promise&lt;CommandResult&gt;

Execute a shell command in the session.

Parameters ​
NameTypeDefault valueDescription
commandstringundefinedThe command string to execute
timeoutMsnumber1000Timeout in milliseconds (default 1000)
cwd?stringundefinedOptional working directory
envs?Record&lt;string, string&gt;undefinedOptional environment variables (key-value pairs)
Returns ​

Promise&lt;CommandResult&gt;

Promise resolving to CommandResult with stdout, stderr, exitCode

Type declaration ​

▸ (command, timeoutMs?, cwd?, envs?): Promise&lt;CommandResult&gt;

Parameters ​
NameTypeDefault value
commandstringundefined
timeoutMsnumber1000
cwd?stringundefined
envs?Record&lt;string, string&gt;undefined
Returns ​

Promise&lt;CommandResult&gt;

session ​

• Protected session: SessionLike

Inherited from ​

BaseService.session

Methods ​

callMcpTool ​

▸ callMcpTool(name, args, readTimeout?, connectTimeout?): Promise&lt;OperationResult&gt;

Parameters ​

NameType
namestring
argsRecord&lt;string, unknown&gt;
readTimeout?number
connectTimeout?number

Returns ​

Promise&lt;OperationResult&gt;

Inherited from ​

BaseService.callMcpTool

execute ​

▸ execute(command, timeoutMs?, cwd?, envs?): Promise&lt;CommandResult&gt;

Execute a shell command in the session.

Parameters ​

NameTypeDefault valueDescription
commandstringundefinedThe command string to execute
timeoutMsnumber1000Timeout in milliseconds (default 1000)
cwd?stringundefinedOptional working directory
envs?Record&lt;string, string&gt;undefinedOptional environment variables (key-value pairs)

Returns ​

Promise&lt;CommandResult&gt;

Promise resolving to CommandResult with stdout, stderr, exitCode

handleError ​

▸ handleError(e): unknown

Parameters ​

NameType
eunknown

Returns ​

unknown

Inherited from ​

BaseService.handleError

toJSON ​

▸ toJSON(): Record&lt;string, unknown&gt;

Returns ​

Record&lt;string, unknown&gt;

Inherited from ​

BaseService.toJSON

Best Practices ​

  1. Always specify appropriate timeout values based on expected command duration
  2. Handle command execution errors gracefully
  3. Use absolute paths when referencing files in commands, or use the cwd parameter
  4. Use the cwd parameter to set working directory instead of cd commands
  5. Use the envs parameter to set environment variables instead of export commands
  6. Check exit_code for more precise error handling (0 means success)
  7. Use stdout and stderr separately for better output parsing
  8. Be aware that commands run with session user permissions
  9. Clean up temporary files created by commands