sym_browser
An individual browser operation on an authorised Browser Pass, subject to its scope, native schema, session and permission validation. Eval feedback v1 supports awaited JSON results, settled JavaScript errors, retained work sessions and bounded batches with explicit stop-on-error behavior.
API 2.3.3 · Published service contract ↗
Permissions
Discovery scopes: no additional tool-discovery scope. Subject to discoveryScopes; execution still checks actual grant, account, Pass and resource authority.
Arguments
| Field | Type | Required | Description |
|---|---|---|---|
| passId | string | ✓ | |
| requestId | string | ✓ | |
| operation | object | ✓ |
{
"type": "object",
"properties": {
"passId": {
"type": "string",
"pattern": "^[A-Za-z0-9_.-]{1,128}$"
},
"requestId": {
"type": "string",
"pattern": "^[A-Za-z0-9_.-]{1,128}$"
},
"operation": {
"type": "object",
"properties": {
"verb": {
"type": "string",
"maxLength": 80
},
"profile": {
"type": "string",
"minLength": 1,
"maxLength": 200
},
"tabId": {
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
},
"args": {
"default": {},
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"capabilityRevision": {
"type": "string",
"pattern": "^[a-f0-9]{64}$"
}
},
"required": [
"verb",
"profile",
"capabilityRevision"
],
"additionalProperties": false
}
},
"required": [
"passId",
"requestId",
"operation"
],
"additionalProperties": false
}Returns
open-object; see responseContract.payloads and live/version-specific contract
{
"type": "object",
"properties": {
"result": {
"description": "Native operation value; eval returns its JSON value under result.value."
},
"documentation": {
"description": "Browser verb docs returns documentation instead of result.",
"type": "object",
"properties": {},
"additionalProperties": {}
},
"encoding": {
"type": "string",
"const": "base64"
},
"format": {
"type": "string",
"enum": [
"png",
"jpeg"
]
},
"width": {
"type": "number"
},
"height": {
"type": "number"
},
"asset": {
"description": "Private screenshot metadata; image bytes travel in MCP image content.",
"type": "object",
"properties": {},
"additionalProperties": {}
},
"imageDelivery": {
"type": "object",
"properties": {},
"additionalProperties": {}
},
"error": {
"type": "string"
},
"status": {}
},
"additionalProperties": {},
"anyOf": [
{
"type": "object",
"properties": {
"result": {
"description": "Native operation value; eval returns its JSON value under result.value."
},
"documentation": {
"description": "Browser verb docs returns documentation instead of result.",
"type": "object",
"properties": {},
"additionalProperties": {}
},
"encoding": {
"type": "string",
"const": "base64"
},
"format": {
"type": "string",
"enum": [
"png",
"jpeg"
]
},
"width": {
"type": "number"
},
"height": {
"type": "number"
},
"asset": {
"description": "Private screenshot metadata; image bytes travel in MCP image content.",
"type": "object",
"properties": {},
"additionalProperties": {}
},
"imageDelivery": {
"type": "object",
"properties": {},
"additionalProperties": {}
}
},
"additionalProperties": {},
"not": {
"required": [
"error"
]
}
},
{
"type": "object",
"properties": {
"error": {
"type": "string"
},
"status": {
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
},
"result": false,
"documentation": false,
"encoding": false,
"format": false,
"width": false,
"height": false,
"asset": false,
"imageDelivery": false
},
"required": [
"error",
"status"
],
"additionalProperties": {}
}
]
}REST equivalents
[
{
"method": "POST",
"path": "/v1/passes/{id}/invoke"
}
]