mirror of
https://github.com/Tencent/BrowserSkill.git
synced 2026-09-10 13:01:23 +08:00
BB-fatandalectimison-maker
f443cfae74
`bsk session start --no-focus` opens the Agent Window in the background without stealing focus. The flag threads focused=false through CLI -> daemon IPC -> tool.session_start -> chrome.windows.create; an omitted `focused` keeps the extension default (true) so older clients are unaffected. Reworked onto current main so it composes with #52 window sizing: AgentWindowApi.create / SessionManager.start (extension), start_session (CLI) and the daemon's session start now take options objects/structs ({ size, focused }) instead of colliding positional params. Co-authored-by: alectimison-maker <alec.timison@gmail.com>
65 lines
2.2 KiB
TypeScript
65 lines
2.2 KiB
TypeScript
/**
|
|
* Wrapper around `chrome.windows.*` for creating / closing the
|
|
* dedicated Agent Window each session owns.
|
|
*
|
|
* Kept behind an interface so the SessionManager can be unit-tested
|
|
* with a fake chrome.windows implementation (see
|
|
* `__tests__/manager.test.ts`).
|
|
*/
|
|
|
|
export interface AgentWindowApi {
|
|
create(url: string, opts?: AgentWindowCreateOptions): Promise<number>;
|
|
remove(windowId: number): Promise<void>;
|
|
/**
|
|
* Guarantee the Agent Window has an active, CDP-navigable tab.
|
|
* `chrome://` pages (including the New Tab page) reject `Page.navigate`,
|
|
* so sessions bootstrap with `about:blank` instead.
|
|
*/
|
|
ensureActiveTab(windowId: number, url: string): Promise<void>;
|
|
}
|
|
|
|
/** Creation hints for a new Agent Window. */
|
|
export interface AgentWindowCreateOptions {
|
|
/** Optional outer size in CSS pixels. */
|
|
size?: { width: number; height: number };
|
|
/** Defaults to true so existing sessions keep visible Agent Windows. */
|
|
focused?: boolean;
|
|
}
|
|
|
|
/** Initial tab URL for every new session's Agent Window. */
|
|
export const AGENT_WINDOW_HOME = "about:blank";
|
|
|
|
export const chromeAgentWindowApi: AgentWindowApi = {
|
|
async create(url: string, opts: AgentWindowCreateOptions = {}): Promise<number> {
|
|
const win = await chrome.windows.create({
|
|
type: "normal",
|
|
focused: opts.focused ?? true,
|
|
url,
|
|
...(opts.size ? { width: opts.size.width, height: opts.size.height } : {}),
|
|
});
|
|
if (typeof win?.id !== "number") {
|
|
throw new Error("[bh] chrome.windows.create returned no window id");
|
|
}
|
|
return win.id;
|
|
},
|
|
async remove(windowId: number): Promise<void> {
|
|
try {
|
|
await chrome.windows.remove(windowId);
|
|
} catch (err) {
|
|
// Window may have been closed by the user already; ignore.
|
|
console.debug("[bh] chrome.windows.remove failed", err);
|
|
}
|
|
},
|
|
async ensureActiveTab(windowId: number, url: string): Promise<void> {
|
|
const tabs = await chrome.tabs.query({ windowId });
|
|
const first = tabs.find((t) => typeof t.id === "number");
|
|
if (first?.id) {
|
|
if (!first.active) {
|
|
await chrome.tabs.update(first.id, { active: true });
|
|
}
|
|
return;
|
|
}
|
|
await chrome.tabs.create({ windowId, url, active: true });
|
|
},
|
|
};
|