Sap Session Bind
sap_session_bindClaims exclusive ownership of a SAP session for the calling agent, failing if another agent holds it; use force only for crash recovery to take over the binding.
Instructions
Claim exclusive ownership of a SAP session for the calling agent. Strict by default (#643): if the session is already bound to a different agent, the call fails — pick a different session via sap_session_list, or retry with force=true to take over (use only for crash recovery, otherwise prefer leaving the existing binding intact). Re-binding the same agent is a no-op success.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"session_id": "<session_id>",
"agent_id": "<agent_id>"
},
"name": "sap_session_bind"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| force | No | Take over the binding even if another agent currently holds it. Default False — strict bind. Use True only for crash-recovery scenarios where you know the previous holder is gone. | |
| agent_id | Yes | Agent identifier claiming the session | |
| session_id | Yes | Session ID to bind (e.g., "s2") |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| error | No | Error message if success=False | |
| popup | No | Present when a popup dialog is active on screen | |
| success | No | Whether the operation succeeded | |
| agent_id | No | Agent that now owns the session | |
| session_id | No | ID of the session that was bound | |
| active_window | No | Which window was operated on (e.g., 'wnd[0]', 'wnd[1]'). If 'wnd[1]' or higher, a modal dialog is open. | |
| previous_agent | No | Previous agent binding, if any |