Files
moloapp/src/google/sandbox/cdp_session.h
T
retoorandClaude Sonnet 5.5 1c3fbe1899 feat(clients): sandbox: data plane (JWT proxy, CDP WebSocket), operations, SDK chunk shapes
Data plane per the computer use quickstart and SDK 2.6.0 source: signJwt
minted JWT, /cdp /tabs /cdp_ws_endpoint over HTTP with routing headers, CDP
over the live WsClient with capped reconnect. Operations methods wrapped,
input/output chunk shapes settled from the SDK, ComputerUse moved off execute.
Execution paths remain verified by Discovery, docs and SDK only.

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
2026-10-24 05:30:44 +02:00

94 lines
3.6 KiB
C++

#pragma once
// Chrome DevTools Protocol over the sandbox's CDP WebSocket (computer use).
// Connects like the Google SDK's `generate_browser_ws_headers` plus
// Playwright's connect_over_cdp: GET /cdp_ws_endpoint on the HTTP data plane
// gives a path, the WebSocket URL is the data plane host plus that path, and
// the JWT travels in the Sec-WebSocket-Protocol header
// ("v1.stream, <jwt>, <routing token>, 9222"). Messages are CDP JSON-RPC
// ({"id","method","params"[,"sessionId"]}), see
// https://chromedevtools.github.io/devtools-protocol/ (flat session mode).
//
// Reuses the RFC 6455 client of src/google/live (WsClient, open_stream).
// Hard caps: message size, buffered events, call time, reconnects, and a
// floor between connection attempts. One thread uses a session at a time.
#include <deque>
#include <memory>
#include <string>
#include <vector>
#include "google/live/ws_client.h"
#include "google/sandbox/data_plane.h"
namespace molo::google::sandbox {
struct CdpOptions {
int connect_timeout_ms = 0; // 0: SandboxCaps default
int call_timeout_ms = 0; // 0: SandboxCaps default
std::string browser_port = "9222";
};
class CdpSession {
public:
CdpSession(std::shared_ptr<DataPlane> plane, CdpOptions options = {});
~CdpSession();
CdpSession(const CdpSession&) = delete;
CdpSession& operator=(const CdpSession&) = delete;
// Resolves the endpoint, mints a JWT and runs the upgrade. Idempotent.
void connect();
bool connected() const;
// Sends a polite close and drops the socket.
void close();
// Sends one CDP command and waits for its reply (matched by id). Returns the
// "result" object. A CDP "error" object throws GoogleError 502
// CDP_ERROR with Chrome's message. A lost socket before the send is
// reconnected (fresh JWT, capped); a loss mid-call throws CDP_CONNECTION_LOST
// and the next call reconnects, because commands are never replayed. Session
// ids from before a reconnect are void.
clients::body::Json call(const std::string& method, const clients::body::Json& params,
const std::string& session_id = "", int timeout_ms = 0);
// Browser-level helper: Target.getTargets, Target.attachToTarget
// {flatten:true} for the first "page" target; returns the sessionId.
std::string attach_first_page();
// Events (messages without id) seen while waiting, oldest first; at most
// kMaxCdpEvents are kept, older ones are dropped and counted.
std::vector<clients::body::Json> take_events();
// Waits for an event with this method (already buffered or newly read).
clients::body::Json wait_event(const std::string& method, int timeout_ms = 0);
int connects() const { return connects_; }
int reconnects() const { return reconnects_; }
std::size_t dropped_events() const { return dropped_events_; }
const std::string& endpoint_path() const { return endpoint_path_; }
static void validate_session_id(const std::string& id);
static clients::body::Json request(long id, const std::string& method,
const clients::body::Json& params,
const std::string& session_id);
private:
void open_socket();
void ensure_connected();
bool pump(int budget_ms, long wanted_id, clients::body::Json* reply);
void push_event(clients::body::Json event);
std::shared_ptr<DataPlane> plane_;
CdpOptions options_;
std::unique_ptr<live::WsClient> ws_;
std::string endpoint_path_;
long next_id_ = 1;
int connects_ = 0;
int reconnects_ = 0;
long last_connect_ms_ = 0;
std::deque<clients::body::Json> events_;
std::size_t dropped_events_ = 0;
};
} // namespace molo::google::sandbox