Files
BrowserSkill/crates/bsk-protocol/src/tools/session.rs
T
BB-fat 49378d70de feat: support Agent Window sizing (session start --width/--height, window resize) (#52)
- `bsk session start --width <px> --height <px>` opens the Agent Window
  with the given outer size (chrome.windows.create)
- new `bsk window resize --session <id> --width <px> --height <px>`
  resizes the Agent Window at runtime (chrome.windows.update)
- both validated on CLI, daemon and extension sides (100..=7680 CSS px)
- protocol: new tool.window_resize method (BrowserMutation) and
  optional width/height on tool.session_start params; schemas regenerated
2026-08-05 11:19:10 +08:00

70 lines
2.3 KiB
Rust

//! Session-scoped tools (`tool.session_*`).
use schemars::JsonSchema;
use serde::{Deserialize, Serialize};
use crate::ErrorCode;
#[derive(Debug, Clone, PartialEq, Serialize, Deserialize, JsonSchema)]
pub struct SessionStartParams {
pub session_id: String,
#[serde(default, skip_serializing_if = "Option::is_none")]
pub browser_instance_id: Option<String>,
/// Optional Agent Window outer width in CSS pixels (100..=7680).
#[serde(default, skip_serializing_if = "Option::is_none")]
pub width: Option<u32>,
/// Optional Agent Window outer height in CSS pixels (100..=7680).
#[serde(default, skip_serializing_if = "Option::is_none")]
pub height: Option<u32>,
}
#[derive(Debug, Clone, PartialEq, Serialize, Deserialize, JsonSchema)]
pub struct SessionStartResult {
#[serde(default, skip_serializing_if = "Option::is_none")]
pub agent_window_id: Option<i64>,
}
#[derive(Debug, Clone, PartialEq, Serialize, Deserialize, JsonSchema)]
pub struct SessionStopParams {
pub session_id: String,
}
#[derive(Debug, Clone, PartialEq, Serialize, Deserialize, JsonSchema)]
pub struct ReturnFailure {
pub tab_id: i64,
pub code: ErrorCode,
pub message: String,
}
#[derive(Debug, Clone, Default, PartialEq, Serialize, Deserialize, JsonSchema)]
pub struct SessionStopResult {
#[serde(default, skip_serializing_if = "Vec::is_empty")]
pub returned_tab_ids: Vec<i64>,
#[serde(default, skip_serializing_if = "Vec::is_empty")]
pub return_failures: Vec<ReturnFailure>,
}
#[cfg(test)]
mod tests {
use super::*;
use serde_json::json;
#[test]
fn session_stop_result_round_trips_auto_return_payload() {
let result: SessionStopResult = serde_json::from_value(json!({
"returned_tab_ids": [7, 8],
"return_failures": [
{ "tab_id": 9, "code": "cdp_failed", "message": "move failed" }
]
}))
.unwrap();
assert_eq!(result.returned_tab_ids, vec![7, 8]);
assert_eq!(result.return_failures[0].tab_id, 9);
assert_eq!(result.return_failures[0].code, ErrorCode::CdpFailed);
let encoded = serde_json::to_value(result).unwrap();
assert_eq!(encoded["returned_tab_ids"], json!([7, 8]));
assert_eq!(encoded["return_failures"][0]["code"], "cdp_failed");
}
}