abb-rws-client 0.2.0 → 0.7.1

package/dist/RwsClient.js

@@ -17,15 +17,15 @@
 import { HttpSession } from './HttpSession.js';
 import { WsSubscriber } from './WsSubscriber.js';
 import { RwsError } from './types.js';
-import { controllerState as pathControllerState, operationMode as pathOperationMode, rapidTasks as pathRapidTasks, rapidExecutionState as pathRapidExecutionState, startRapid as mapStartRapid, stopRapid as mapStopRapid, resetRapid as mapResetRapid, jointTarget as pathJointTarget, robTarget as pathRobTarget, loadModule as mapLoadModule, listModules as pathListModules, uploadFile as pathUploadFile, signal as pathSignal, setSignal as mapSetSignal, } from './ResourceMapper.js';
-import { parseControllerState, parseOperationMode, parseExecutionState, parseJointTarget, parseRobTarget, parseSignal, parseRapidTasks, } from './ResponseParser.js';
+import { controllerState as pathControllerState, setControllerState as mapSetControllerState, operationMode as pathOperationMode, speedRatio as pathSpeedRatio, setSpeedRatio as mapSetSpeedRatio, collisionDetectionState as pathCollisionDetectionState, restartController as mapRestartController, lockOperationMode as mapLockOperationMode, unlockOperationMode as mapUnlockOperationMode, rapidTasks as pathRapidTasks, rapidExecutionState as pathRapidExecutionState, startRapid as mapStartRapid, stopRapid as mapStopRapid, resetRapid as mapResetRapid, setExecutionCycle as mapSetExecutionCycle, rapidSymbol as pathRapidSymbol, rapidSymbolProperties as pathRapidSymbolProperties, setRapidSymbol as mapSetRapidSymbol, activeUiInstruction as pathActiveUiInstruction, setUiInstructionParam as mapSetUiInstructionParam, activateRapidTask as mapActivateRapidTask, deactivateRapidTask as mapDeactivateRapidTask, activateAllRapidTasks as mapActivateAllRapidTasks, deactivateAllRapidTasks as mapDeactivateAllRapidTasks, searchRapidSymbols as mapSearchRapidSymbols, validateRapidValue as mapValidateRapidValue, jointTarget as pathJointTarget, robTarget as pathRobTarget, cartesianFull as pathCartesianFull, loadModule as mapLoadModule, listModules as pathListModules, uploadFile as pathUploadFile, allSignals as pathAllSignals, networks as pathNetworks, devices as pathDevices, signal as pathSignal, setSignal as mapSetSignal, systemInfo as pathSystemInfo, controllerIdentity as pathControllerIdentity, clockInfo as pathClockInfo, setControllerClock as mapSetControllerClock, elogMessages as pathElogMessages, clearElogDomain as mapClearElogDomain, clearAllElogs as mapClearAllElogs, fileServicePath, deleteFile as pathDeleteFile, copyFile as mapCopyFile, requestMastership as mapRequestMastership, releaseMastership as mapReleaseMastership, } from './ResourceMapper.js';
+import { parseControllerState, parseOperationMode, parseSpeedRatio, parseExecutionState, parseExecutionInfo, parseJointTarget, parseRobTarget, parseCartesianFull, parseRapidSymbolValue, parseRapidSymbolProperties, parseSignal, parseSignalList, parseNetworks, parseDevices, parseRapidTasks, parseSystemInfo, parseControllerIdentity, parseControllerClock, parseActiveUiInstruction, parseRapidSymbolSearch, parseElogMessages, parseDirectory, parseCollisionDetectionState, } from './ResponseParser.js';
 export class RwsClient {
     session;
     subscriber;
     constructor(options) {
         const sessionOptions = {
             baseUrl: `http://${options.host}:${options.port ?? 80}`,
-            username: options.username ?? 'Default User',
+            username: options.username ?? 'Admin',
             password: options.password ?? 'robotics',
             requestIntervalMs: options.requestIntervalMs ?? 55,
             timeoutMs: options.timeout ?? 5000,
@@ -38,6 +38,36 @@ export class RwsClient {
     getSessionCookie() {
         return this.session.getSessionCookie();
     }
+    /**
+     * Generic HTTP request helper exposing the underlying authenticated session.
+     *
+     * Lets adapters call any RWS endpoint without requiring this library to wrap
+     * each one in a typed method. Useful for endpoints that aren't (yet) exposed
+     * as named methods — the caller handles parsing the response body.
+     *
+     * Reuses the session's digest auth, cookie, queue, retry, and timeout logic.
+     *
+     * @param method   'GET' | 'POST' | 'PUT' | 'DELETE'
+     * @param path     URL path, e.g. `/rw/cfg/MOC/ROBOT/instances?json=1`
+     * @param body     Optional request body (form-encoded string for POST/PUT)
+     * @returns        `{ status: number, body: string }` — raw response
+     */
+    async request(method, path, body) {
+        let res;
+        if (method === 'GET') {
+            res = await this.session.get(path);
+        }
+        else if (method === 'POST') {
+            res = await this.session.post(path, body ?? '');
+        }
+        else if (method === 'PUT') {
+            res = await this.session.put(path, body ?? '');
+        }
+        else {
+            res = await this.session.delete(path);
+        }
+        return { status: res.status, body: res.body };
+    }
     // ─── Connection ─────────────────────────────────────────────────────────────
     /**
      * Establish a session with the controller.
@@ -66,9 +96,16 @@ export class RwsClient {
         try {
             await this.subscriber.closeAll();
         }
-        finally {
-            this.session.clearSession();
+        catch { /* ignore */ }
+        // Server-side cleanup: GET /logout releases mastership, subscriptions, and frees
+        // the session slot in the controller's pool. Without this, orphan mastership can
+        // block subsequent clients for several minutes (until the controller times out
+        // the session by inactivity). Best-effort — ignore errors.
+        try {
+            await this.session.get('/logout');
         }
+        catch { /* ignore */ }
+        this.session.clearSession();
     }
     // ─── Controller state ───────────────────────────────────────────────────────
     /**
@@ -89,6 +126,24 @@ export class RwsClient {
             throw new RwsError(`getControllerState failed: ${String(e)}`, 'UNKNOWN');
         }
     }
+    /**
+     * Set the controller motor state.
+     * Requires AUTO mode and mastership (request with requestMastership('motion') first).
+     *
+     * @param state - 'motoron' | 'motoroff'
+     * @throws {RwsError} code='AUTH_FAILED' if mastership is not held
+     */
+    async setControllerState(state) {
+        try {
+            const { path, body } = mapSetControllerState(state);
+            await this.session.post(path, body);
+        }
+        catch (e) {
+            if (e instanceof RwsError)
+                throw e;
+            throw new RwsError(`setControllerState failed: ${String(e)}`, 'UNKNOWN');
+        }
+    }
     /**
      * Read the current operation mode.
      *
@@ -106,6 +161,123 @@ export class RwsClient {
             throw new RwsError(`getOperationMode failed: ${String(e)}`, 'UNKNOWN');
         }
     }
+    /**
+     * Read the collision detection state.
+     * Returns INIT (no collision), TRIGGERED, CONFIRMED, or TRIGGERED_ACK.
+     * Requires the Collision Detection option on the controller.
+     */
+    async getCollisionDetectionState() {
+        try {
+            const { body } = await this.session.get(pathCollisionDetectionState());
+            return parseCollisionDetectionState(body);
+        }
+        catch (e) {
+            if (e instanceof RwsError)
+                throw e;
+            throw new RwsError(`getCollisionDetectionState failed: ${String(e)}`, 'UNKNOWN');
+        }
+    }
+    /**
+     * Restart (or warm-start) the controller.
+     *
+     * **Modes:**
+     * - `restart`  — Normal restart; saves state and activates changed system parameters
+     * - `istart`   — Restart with original installation settings; discards all programs
+     * - `pstart`   — Restart preserving system parameters; removes programs
+     * - `bstart`   — Boot with last auto-saved state (crash recovery)
+     *
+     * @param mode - Restart mode; default 'restart'
+     */
+    async restartController(mode = 'restart') {
+        try {
+            const { path, body } = mapRestartController(mode);
+            await this.session.post(path, body);
+        }
+        catch (e) {
+            if (e instanceof RwsError)
+                throw e;
+            throw new RwsError(`restartController failed: ${String(e)}`, 'UNKNOWN');
+        }
+    }
+    /**
+     * Lock the operation mode selector on the FlexPendant.
+     * @param pin       - 4-digit PIN code
+     * @param permanent - true = permanent lock; false = temporary
+     */
+    async lockOperationMode(pin, permanent = false) {
+        try {
+            const { path, body } = mapLockOperationMode(pin, permanent);
+            await this.session.post(path, body);
+        }
+        catch (e) {
+            if (e instanceof RwsError)
+                throw e;
+            throw new RwsError(`lockOperationMode failed: ${String(e)}`, 'UNKNOWN');
+        }
+    }
+    /** Unlock the operation mode selector. */
+    async unlockOperationMode() {
+        try {
+            const { path, body } = mapUnlockOperationMode();
+            await this.session.post(path, body);
+        }
+        catch (e) {
+            if (e instanceof RwsError)
+                throw e;
+            throw new RwsError(`unlockOperationMode failed: ${String(e)}`, 'UNKNOWN');
+        }
+    }
+    /**
+     * Switch the controller's operation mode. **Virtual controllers only** — on
+     * real IRC5 hardware the physical key switch on the FlexPendant is the
+     * source of truth and the controller will reject this with 403.
+     *
+     * RWS 1.0 endpoint: POST /rw/panel/opmode with body `opmode=auto|man|manfs`
+     * (note the lowercase pre-OmniCore values).
+     */
+    async setOperationMode(mode) {
+        const wire = mode === 'AUTO' ? 'auto' : mode === 'MANR' ? 'man' : 'manfs';
+        try {
+            await this.session.post('/rw/panel/opmode', `opmode=${wire}`);
+        }
+        catch (e) {
+            if (e instanceof RwsError) {
+                throw e;
+            }
+            throw new RwsError(`setOperationMode failed: ${String(e)}`, 'UNKNOWN');
+        }
+    }
+    // ─── Speed ratio ────────────────────────────────────────────────────────────
+    /**
+     * Read the current speed ratio (0–100).
+     * Represents override percentage applied to all robot speeds.
+     */
+    async getSpeedRatio() {
+        try {
+            const { body } = await this.session.get(pathSpeedRatio());
+            return parseSpeedRatio(body);
+        }
+        catch (e) {
+            if (e instanceof RwsError)
+                throw e;
+            throw new RwsError(`getSpeedRatio failed: ${String(e)}`, 'UNKNOWN');
+        }
+    }
+    /**
+     * Set the speed ratio override (0–100). Only valid in AUTO mode.
+     * @param ratio - Integer 0–100 (clamped automatically)
+     */
+    async setSpeedRatio(ratio) {
+        try {
+            const { path, body } = mapSetSpeedRatio(ratio);
+            await this.session.post(path, body);
+        }
+        catch (e) {
+            if (e instanceof RwsError)
+                throw e;
+            throw new RwsError(`setSpeedRatio failed: ${String(e)}`, 'UNKNOWN');
+        }
+    }
     // ─── RAPID execution ────────────────────────────────────────────────────────
     /**
      * Read the current RAPID execution state.
@@ -123,6 +295,22 @@ export class RwsClient {
             throw new RwsError(`getRapidExecutionState failed: ${String(e)}`, 'UNKNOWN');
         }
     }
+    /**
+     * Read the full RAPID execution info including state and current cycle mode.
+     *
+     * @returns ExecutionInfo with state ('running'|'stopped') and cycle ('once'|'forever'|'asis'|'oncedone')
+     */
+    async getRapidExecutionInfo() {
+        try {
+            const { body } = await this.session.get(pathRapidExecutionState());
+            return parseExecutionInfo(body);
+        }
+        catch (e) {
+            if (e instanceof RwsError)
+                throw e;
+            throw new RwsError(`getRapidExecutionInfo failed: ${String(e)}`, 'UNKNOWN');
+        }
+    }
     /**
      * Retrieve all RAPID tasks and their current states.
      *
@@ -191,6 +379,222 @@ export class RwsClient {
             throw new RwsError(`resetRapid failed: ${String(e)}`, 'UNKNOWN');
         }
     }
+    /**
+     * Set the RAPID execution cycle mode.
+     * @param cycle - 'once' (run once then stop) | 'forever' (loop) | 'asis' (keep current)
+     */
+    async setExecutionCycle(cycle) {
+        try {
+            const { path, body } = mapSetExecutionCycle(cycle);
+            await this.session.post(path, body);
+        }
+        catch (e) {
+            if (e instanceof RwsError)
+                throw e;
+            throw new RwsError(`setExecutionCycle failed: ${String(e)}`, 'UNKNOWN');
+        }
+    }
+    // ─── RAPID variables ────────────────────────────────────────────────────────
+    /**
+     * Read the value of a RAPID symbol (variable, persistent, or constant).
+     * Returns the raw string as the controller formats it (e.g. '42', '"hello"', '[1,2,3]').
+     *
+     * @param taskName   - RAPID task name, e.g. 'T_ROB1'
+     * @param moduleName - Module name, e.g. 'user'
+     * @param symbolName - Symbol name, e.g. 'reg1'
+     */
+    async getRapidVariable(taskName, moduleName, symbolName) {
+        try {
+            const { body } = await this.session.get(pathRapidSymbol(taskName, moduleName, symbolName));
+            return parseRapidSymbolValue(body);
+        }
+        catch (e) {
+            if (e instanceof RwsError)
+                throw e;
+            throw new RwsError(`getRapidVariable failed: ${String(e)}`, 'UNKNOWN');
+        }
+    }
+    /**
+     * Write a value to a RAPID variable or persistent.
+     * Value must be a RAPID-formatted string: e.g. '42', '3.14', '"hello"', '[1,0,0,0]'.
+     *
+     * @param taskName   - RAPID task name
+     * @param moduleName - Module name
+     * @param symbolName - Symbol name
+     * @param value      - New value in RAPID syntax
+     */
+    async setRapidVariable(taskName, moduleName, symbolName, value) {
+        try {
+            const { path, body } = mapSetRapidSymbol(taskName, moduleName, symbolName, value);
+            await this.session.post(path, body);
+        }
+        catch (e) {
+            if (e instanceof RwsError)
+                throw e;
+            throw new RwsError(`setRapidVariable failed: ${String(e)}`, 'UNKNOWN');
+        }
+    }
+    /**
+     * Activate a RAPID task (for multitasking systems).
+     * Mastership is taken internally by the controller.
+     * @param task - Task name, e.g. 'T_ROB2'
+     */
+    async activateRapidTask(task) {
+        try {
+            const { path, body } = mapActivateRapidTask(task);
+            await this.session.post(path, body);
+        }
+        catch (e) {
+            if (e instanceof RwsError)
+                throw e;
+            throw new RwsError(`activateRapidTask failed: ${String(e)}`, 'UNKNOWN');
+        }
+    }
+    /**
+     * Deactivate a RAPID task (for multitasking systems).
+     * @param task - Task name
+     */
+    async deactivateRapidTask(task) {
+        try {
+            const { path, body } = mapDeactivateRapidTask(task);
+            await this.session.post(path, body);
+        }
+        catch (e) {
+            if (e instanceof RwsError)
+                throw e;
+            throw new RwsError(`deactivateRapidTask failed: ${String(e)}`, 'UNKNOWN');
+        }
+    }
+    /** Activate ALL RAPID tasks. */
+    async activateAllRapidTasks() {
+        try {
+            const { path, body } = mapActivateAllRapidTasks();
+            await this.session.post(path, body);
+        }
+        catch (e) {
+            if (e instanceof RwsError)
+                throw e;
+            throw new RwsError(`activateAllRapidTasks failed: ${String(e)}`, 'UNKNOWN');
+        }
+    }
+    /** Deactivate ALL RAPID tasks. */
+    async deactivateAllRapidTasks() {
+        try {
+            const { path, body } = mapDeactivateAllRapidTasks();
+            await this.session.post(path, body);
+        }
+        catch (e) {
+            if (e instanceof RwsError)
+                throw e;
+            throw new RwsError(`deactivateAllRapidTasks failed: ${String(e)}`, 'UNKNOWN');
+        }
+    }
+    /**
+     * Get the currently active RAPID UI instruction.
+     * Returns null if no UI instruction is waiting for input.
+     * Used to detect when RAPID is waiting for operator input (TPReadNum, TPReadFK, etc.).
+     */
+    async getActiveUiInstruction() {
+        try {
+            const { body } = await this.session.get(pathActiveUiInstruction());
+            return parseActiveUiInstruction(body);
+        }
+        catch (e) {
+            if (e instanceof RwsError)
+                throw e;
+            throw new RwsError(`getActiveUiInstruction failed: ${String(e)}`, 'UNKNOWN');
+        }
+    }
+    /**
+     * Respond to an active RAPID UI instruction (e.g. send the answer to a TPReadNum).
+     * Get the stackurl from getActiveUiInstruction().stack.
+     *
+     * Common parameter names:
+     * - 'Result' — the answer value for TPReadNum, TPReadFK
+     * - 'TPFK1' … 'TPFK5' — individual function key states (0/1)
+     * - 'TPCompleted' — set to 'TRUE' when done
+     *
+     * @param stackurl - Stack URL from UiInstruction.stack (e.g. 'RAPID/T_ROB1/%$104')
+     * @param uiparam  - Parameter name, e.g. 'Result'
+     * @param value    - Value to set, e.g. '42' or 'TRUE'
+     */
+    async setUiInstructionParam(stackurl, uiparam, value) {
+        try {
+            const { path, body } = mapSetUiInstructionParam(stackurl, uiparam, value);
+            await this.session.post(path, body);
+        }
+        catch (e) {
+            if (e instanceof RwsError)
+                throw e;
+            throw new RwsError(`setUiInstructionParam failed: ${String(e)}`, 'UNKNOWN');
+        }
+    }
+    /**
+     * Search for RAPID symbols matching filter criteria.
+     *
+     * @param params - Search parameters (task is required; all others are optional filters)
+     * @returns Array of matching symbols with abbreviated properties
+     *
+     * @example
+     * ```ts
+     * // Find all persistent variables in T_ROB1
+     * const persistents = await client.searchRapidSymbols({ task: 'T_ROB1', symtyp: 'per' });
+     * ```
+     */
+    async searchRapidSymbols(params) {
+        try {
+            const { path, body } = mapSearchRapidSymbols(params);
+            const { body: responseBody } = await this.session.post(path, body);
+            return parseRapidSymbolSearch(responseBody);
+        }
+        catch (e) {
+            if (e instanceof RwsError)
+                throw e;
+            throw new RwsError(`searchRapidSymbols failed: ${String(e)}`, 'UNKNOWN');
+        }
+    }
+    /**
+     * Validate a value against a RAPID data type without writing it.
+     * Useful for validating user input before calling setRapidVariable.
+     *
+     * @param task     - RAPID task name, e.g. 'T_ROB1'
+     * @param value    - Value in RAPID syntax, e.g. '[1,0,0,0]'
+     * @param datatype - RAPID data type name, e.g. 'tooldata', 'robtarget', 'num'
+     * @returns true if valid, false if invalid (no exception thrown for invalid values)
+     */
+    async validateRapidValue(task, value, datatype) {
+        try {
+            const { path, body } = mapValidateRapidValue(task, value, datatype);
+            const { status } = await this.session.post(path, body);
+            return status === 204;
+        }
+        catch (e) {
+            if (e instanceof RwsError && e.httpStatus === 400)
+                return false;
+            if (e instanceof RwsError)
+                throw e;
+            throw new RwsError(`validateRapidValue failed: ${String(e)}`, 'UNKNOWN');
+        }
+    }
+    /**
+     * Read RAPID symbol properties (type, dimensions, storage class, etc.).
+     * Useful for introspecting variables, persistents, constants, and records.
+     *
+     * @param taskName   - RAPID task name, e.g. 'T_ROB1'
+     * @param moduleName - Module name, e.g. 'user'
+     * @param symbolName - Symbol name, e.g. 'reg1'
+     */
+    async getRapidSymbolProperties(taskName, moduleName, symbolName) {
+        try {
+            const { body } = await this.session.get(pathRapidSymbolProperties(taskName, moduleName, symbolName));
+            return parseRapidSymbolProperties(body);
+        }
+        catch (e) {
+            if (e instanceof RwsError)
+                throw e;
+            throw new RwsError(`getRapidSymbolProperties failed: ${String(e)}`, 'UNKNOWN');
+        }
+    }
     // ─── Motion ─────────────────────────────────────────────────────────────────
     /**
      * Read the current joint-space positions for a mechanical unit.
@@ -228,6 +632,24 @@ export class RwsClient {
             throw new RwsError(`getCartesianPosition failed: ${String(e)}`, 'UNKNOWN');
         }
     }
+    /**
+     * Read the current Cartesian position including robot configuration flags.
+     * Uses /cartesian endpoint (no tool/wobj override — uses active tool/wobj).
+     * Returns j1/j4/j6/jx configuration integers in addition to pose.
+     *
+     * @param mechunit - Default 'ROB_1'
+     */
+    async getCartesianFull(mechunit) {
+        try {
+            const { body } = await this.session.get(pathCartesianFull(mechunit));
+            return parseCartesianFull(body);
+        }
+        catch (e) {
+            if (e instanceof RwsError)
+                throw e;
+            throw new RwsError(`getCartesianFull failed: ${String(e)}`, 'UNKNOWN');
+        }
+    }
     // ─── Modules ────────────────────────────────────────────────────────────────
     /**
      * Download a file from the controller filesystem as a UTF-8 string.
@@ -249,13 +671,14 @@ export class RwsClient {
         }
     }
     /**
-     * Upload a RAPID module file to the controller filesystem.
-     * The file content is uploaded as UTF-8 bytes via PUT /fileservice/{remotePath}.
+     * Upload a file to the controller filesystem.
+     * The content is uploaded as UTF-8 bytes via PUT /fileservice/{remotePath}.
+     * Works for any file type — RAPID modules, .cfg files, plain text, etc.
      *
      * @param remotePath - Controller path, e.g. '$HOME/MyMod.mod'
-     * @param content    - RAPID module source as a string
+     * @param content    - File content as a string
      */
-    async uploadModule(remotePath, content) {
+    async uploadFile(remotePath, content) {
         try {
             const path = pathUploadFile(remotePath);
             const bytes = new TextEncoder().encode(content);
@@ -264,9 +687,13 @@ export class RwsClient {
         catch (e) {
             if (e instanceof RwsError)
                 throw e;
-            throw new RwsError(`uploadModule failed: ${String(e)}`, 'UNKNOWN');
+            throw new RwsError(`uploadFile failed: ${String(e)}`, 'UNKNOWN');
         }
     }
+    /** @deprecated use uploadFile() — same behavior, neutral name. Kept for backward compat. */
+    uploadModule(remotePath, content) {
+        return this.uploadFile(remotePath, content);
+    }
     /**
      * Unload a RAPID module from a task (remove it from memory).
      * RAPID must be stopped before calling this.
@@ -324,6 +751,71 @@ export class RwsClient {
             throw new RwsError(`listModules failed: ${String(e)}`, 'UNKNOWN');
         }
     }
+    /**
+     * Download a directory listing from the controller filesystem.
+     * Returns entries sorted: directories first, then files.
+     *
+     * @param remotePath - Controller path, e.g. '$HOME' or '$HOME/Dispense'
+     */
+    async listDirectory(remotePath) {
+        try {
+            const { body } = await this.session.get(fileServicePath(remotePath));
+            return parseDirectory(body);
+        }
+        catch (e) {
+            if (e instanceof RwsError)
+                throw e;
+            throw new RwsError(`listDirectory failed: ${String(e)}`, 'UNKNOWN');
+        }
+    }
+    /**
+     * Delete a file from the controller filesystem.
+     * @param remotePath - Controller path, e.g. '$HOME/OldMod.mod'
+     */
+    async deleteFile(remotePath) {
+        try {
+            await this.session.delete(pathDeleteFile(remotePath));
+        }
+        catch (e) {
+            if (e instanceof RwsError)
+                throw e;
+            throw new RwsError(`deleteFile failed: ${String(e)}`, 'UNKNOWN');
+        }
+    }
+    /**
+     * Create a directory on the controller filesystem.
+     * @param parentPath - Parent directory path, e.g. '$HOME'
+     * @param dirName    - New directory name, e.g. 'Backup'
+     */
+    async createDirectory(parentPath, dirName) {
+        try {
+            const path = fileServicePath(parentPath);
+            // RWS 1.0 fileservice expects params in the body, not the query string.
+            // Putting fs-action in the URL returns 400 "Invalid/No Query Parameter".
+            await this.session.post(path, `fs-action=create&fs-newname=${encodeURIComponent(dirName)}`);
+        }
+        catch (e) {
+            if (e instanceof RwsError)
+                throw e;
+            throw new RwsError(`createDirectory failed: ${String(e)}`, 'UNKNOWN');
+        }
+    }
+    /**
+     * Copy a file on the controller filesystem.
+     * @param sourcePath - Source file path, e.g. '$HOME/MyMod.mod'
+     * @param destPath   - Destination path (full path including filename), e.g. '$HOME/Backup/MyMod.mod'
+     */
+    async copyFile(sourcePath, destPath) {
+        try {
+            const { path, body } = mapCopyFile(sourcePath, destPath);
+            await this.session.post(path, body);
+        }
+        catch (e) {
+            if (e instanceof RwsError)
+                throw e;
+            throw new RwsError(`copyFile failed: ${String(e)}`, 'UNKNOWN');
+        }
+    }
     // ─── I/O signals ────────────────────────────────────────────────────────────
     /**
      * Read an I/O signal value.
@@ -363,6 +855,202 @@ export class RwsClient {
             throw new RwsError(`writeSignal failed: ${String(e)}`, 'UNKNOWN');
         }
     }
+    /**
+     * List all configured I/O signals (paginated).
+     * The controller returns up to `limit` signals per call; use `start` to page through.
+     *
+     * @param start - Starting index (default 0)
+     * @param limit - Results per page (default 100)
+     */
+    async listAllSignals(start = 0, limit = 100) {
+        try {
+            const { body } = await this.session.get(pathAllSignals(start, limit));
+            return parseSignalList(body);
+        }
+        catch (e) {
+            if (e instanceof RwsError)
+                throw e;
+            throw new RwsError(`listAllSignals failed: ${String(e)}`, 'UNKNOWN');
+        }
+    }
+    /**
+     * List all configured I/O networks.
+     */
+    async listNetworks() {
+        try {
+            const { body } = await this.session.get(pathNetworks());
+            return parseNetworks(body);
+        }
+        catch (e) {
+            if (e instanceof RwsError)
+                throw e;
+            throw new RwsError(`listNetworks failed: ${String(e)}`, 'UNKNOWN');
+        }
+    }
+    /**
+     * List all I/O devices on a network.
+     * @param network - Network name, e.g. 'Local'
+     */
+    async listDevices(network) {
+        try {
+            const { body } = await this.session.get(pathDevices(network));
+            return parseDevices(body);
+        }
+        catch (e) {
+            if (e instanceof RwsError)
+                throw e;
+            throw new RwsError(`listDevices failed: ${String(e)}`, 'UNKNOWN');
+        }
+    }
+    // ─── Controller info ────────────────────────────────────────────────────────
+    /**
+     * Read RobotWare system information (version, options, system ID).
+     */
+    async getSystemInfo() {
+        try {
+            const { body } = await this.session.get(pathSystemInfo());
+            return parseSystemInfo(body);
+        }
+        catch (e) {
+            if (e instanceof RwsError)
+                throw e;
+            throw new RwsError(`getSystemInfo failed: ${String(e)}`, 'UNKNOWN');
+        }
+    }
+    /**
+     * Read controller hardware identity (name, ID, type, MAC address).
+     */
+    async getControllerIdentity() {
+        try {
+            const { body } = await this.session.get(pathControllerIdentity());
+            return parseControllerIdentity(body);
+        }
+        catch (e) {
+            if (e instanceof RwsError)
+                throw e;
+            throw new RwsError(`getControllerIdentity failed: ${String(e)}`, 'UNKNOWN');
+        }
+    }
+    /**
+     * Read the controller date and time.
+     * Returns a ControllerClock with the datetime string in 'YYYY-MM-DD T HH:MM:SS' format (UTC).
+     */
+    async getControllerClock() {
+        try {
+            const { body } = await this.session.get(pathClockInfo());
+            return parseControllerClock(body);
+        }
+        catch (e) {
+            if (e instanceof RwsError)
+                throw e;
+            throw new RwsError(`getControllerClock failed: ${String(e)}`, 'UNKNOWN');
+        }
+    }
+    /**
+     * Set the controller date and time (UTC).
+     * @param year  - Full year, e.g. 2024
+     * @param month - Month 1–12
+     * @param day   - Day 1–31
+     * @param hour  - Hour 0–23
+     * @param min   - Minute 0–59
+     * @param sec   - Second 0–59
+     */
+    async setControllerClock(year, month, day, hour, min, sec) {
+        try {
+            const { path, body } = mapSetControllerClock(year, month, day, hour, min, sec);
+            await this.session.put(path, new TextEncoder().encode(body));
+        }
+        catch (e) {
+            if (e instanceof RwsError)
+                throw e;
+            throw new RwsError(`setControllerClock failed: ${String(e)}`, 'UNKNOWN');
+        }
+    }
+    // ─── Event log ──────────────────────────────────────────────────────────────
+    /**
+     * Retrieve event log messages from the controller.
+     * Domain 0 is the main system log (up to 1000 entries).
+     * Messages are returned newest-first (LIFO order).
+     *
+     * @param domain - Log domain number; default 0 (main system log)
+     * @param lang   - Language for message text; default 'en'
+     */
+    async getEventLog(domain = 0, lang = 'en') {
+        try {
+            const { body } = await this.session.get(pathElogMessages(domain, lang));
+            return parseElogMessages(body);
+        }
+        catch (e) {
+            if (e instanceof RwsError)
+                throw e;
+            throw new RwsError(`getEventLog failed: ${String(e)}`, 'UNKNOWN');
+        }
+    }
+    /**
+     * Clear event log messages in a specific domain.
+     * @param domain - Log domain number; default 0 (main system log)
+     */
+    async clearEventLog(domain = 0) {
+        try {
+            const { path, body } = mapClearElogDomain(domain);
+            await this.session.post(path, body);
+        }
+        catch (e) {
+            if (e instanceof RwsError)
+                throw e;
+            throw new RwsError(`clearEventLog failed: ${String(e)}`, 'UNKNOWN');
+        }
+    }
+    /**
+     * Clear ALL event log messages across all domains.
+     */
+    async clearAllEventLogs() {
+        try {
+            const { path, body } = mapClearAllElogs();
+            await this.session.post(path, body);
+        }
+        catch (e) {
+            if (e instanceof RwsError)
+                throw e;
+            throw new RwsError(`clearAllEventLogs failed: ${String(e)}`, 'UNKNOWN');
+        }
+    }
+    // ─── Mastership ──────────────────────────────────────────────────────────────
+    /**
+     * Request mastership on a domain.
+     * Must call releaseMastership when done. Operations that modify controller state
+     * (motor on/off, speed ratio, etc.) require mastership on the appropriate domain.
+     *
+     * @param domain - 'cfg' | 'motion' | 'rapid'
+     */
+    async requestMastership(domain) {
+        try {
+            const { path, body } = mapRequestMastership(domain);
+            await this.session.post(path, body);
+        }
+        catch (e) {
+            if (e instanceof RwsError)
+                throw e;
+            throw new RwsError(`requestMastership failed: ${String(e)}`, 'UNKNOWN');
+        }
+    }
+    /**
+     * Release mastership on a domain.
+     * Always call this after requestMastership, even if the operation failed.
+     *
+     * @param domain - 'cfg' | 'motion' | 'rapid'
+     */
+    async releaseMastership(domain) {
+        try {
+            const { path, body } = mapReleaseMastership(domain);
+            await this.session.post(path, body);
+        }
+        catch (e) {
+            if (e instanceof RwsError)
+                throw e;
+            throw new RwsError(`releaseMastership failed: ${String(e)}`, 'UNKNOWN');
+        }
+    }
     // ─── Subscriptions ──────────────────────────────────────────────────────────
     /**
      * Subscribe to one or more RWS resource events via WebSocket.