hangwin--mcp-chrome
hangerye
60 行
1.8 KiB
TypeScript
60 行
1.8 KiB
TypeScript
/**
|
|
* Sidepanel Utilities
|
|
*
|
|
* Shared helpers for opening and managing the Chrome sidepanel from background modules.
|
|
* Used by web-editor, quick-panel, and other modules that need to trigger sidepanel navigation.
|
|
*/
|
|
|
|
/**
|
|
* Best-effort open the sidepanel with AgentChat tab selected.
|
|
*
|
|
* @param tabId - Tab ID to associate with sidepanel
|
|
* @param windowId - Optional window ID for fallback when tab-level open fails
|
|
* @param sessionId - Optional session ID to navigate directly to chat view (deep-link)
|
|
*
|
|
* @remarks
|
|
* This function is intentionally resilient - it will not throw on failures.
|
|
* Sidepanel availability varies across Chrome versions and contexts.
|
|
*/
|
|
export async function openAgentChatSidepanel(
|
|
tabId: number,
|
|
windowId?: number,
|
|
sessionId?: string,
|
|
): Promise<void> {
|
|
try {
|
|
// Build deep-link path with optional session navigation
|
|
let path = 'sidepanel.html?tab=agent-chat';
|
|
if (sessionId) {
|
|
path += `&view=chat&sessionId=${encodeURIComponent(sessionId)}`;
|
|
}
|
|
|
|
// Configure sidepanel options for this tab
|
|
|
|
const sidePanel = chrome.sidePanel as any;
|
|
|
|
if (sidePanel?.setOptions) {
|
|
await sidePanel.setOptions({
|
|
tabId,
|
|
path,
|
|
enabled: true,
|
|
});
|
|
}
|
|
|
|
// Attempt to open the sidepanel
|
|
if (sidePanel?.open) {
|
|
try {
|
|
await sidePanel.open({ tabId });
|
|
} catch {
|
|
// Fallback to window-level open if tab-level fails
|
|
// This handles cases where the tab is in a special state
|
|
if (typeof windowId === 'number') {
|
|
await sidePanel.open({ windowId });
|
|
}
|
|
}
|
|
}
|
|
} catch {
|
|
// Best-effort: side panel may be unavailable in some Chrome versions/environments
|
|
// Intentionally suppress errors to avoid breaking calling code
|
|
}
|
|
}
|