get_workspace_context

Retrieve a summary of the current Selenix workspace, including project name, active test, test count, and selected command count for browser automation management.

Instructions

Get a summary of the current Selenix workspace: project name, active test, test count, selected command count.

Input Schema

TableJSON Schema

Name	Required	Description	Default
No arguments

Implementation Reference

src/bridge-client.ts:24-71 (handler)

The tool execution is dynamic; the BridgeClient makes an HTTP POST request to an API endpoint named after the tool (in this case, /api/get_workspace_context).

export class BridgeClient {
  async call(endpoint: string, body: Record<string, unknown> = {}): Promise<unknown> {
    // Re-read config on every call so we pick up new tokens after Selenix restarts
    const config = readConfig()

    return new Promise((resolve, reject) => {
      const data = JSON.stringify(body)
      const req = http.request(
        {
          hostname: '127.0.0.1',
          port: config.port,
          path: `/api/${endpoint}`,
          method: 'POST',
          headers: {
            'Content-Type': 'application/json',
            Authorization: `Bearer ${config.token}`,
            'Content-Length': Buffer.byteLength(data),
          },
          timeout: 180000, // 3 minutes for long-running operations like run_test
        },
        (res) => {
          let responseData = ''
          res.on('data', (chunk: string) => (responseData += chunk))
          res.on('end', () => {
            try {
              resolve(JSON.parse(responseData))
            } catch {
              resolve({ raw: responseData })
            }
          })
        }
      )
      req.on('error', (err) =>
        reject(
          new Error(
            `Cannot connect to Selenix bridge at 127.0.0.1:${config.port}. ` +
              `Is Selenix running with MCP Server enabled? (${err.message})`
          )
        )
      )
      req.on('timeout', () => {
        req.destroy()
        reject(new Error('Request timed out after 180 seconds'))
      })
      req.write(data)
      req.end()
    })
  }

src/tools.ts:162-166 (registration)

Registration of the 'get_workspace_context' tool definition.

  name: 'get_workspace_context',
  description:
    'Get a summary of the current Selenix workspace: project name, active test, test count, selected command count.',
  inputSchema: { type: 'object' as const, properties: {} },
},

Selenix-MCP