kaba.browser

kaba.browser is the application-level part of the SDK. It is available only on kaba:// pages.

// Read one setting
const size = await kaba.browser.getSetting('terminal_font_size');

// Open one of Kaba's dialogs and wait for its result
const result = await kaba.browser.showModal('kaba-remote-train', { /* options */ });

// Engine events arrive on an event target
const events = kaba.browser.kabaStream();

[todo: confirm argument lists, return shapes and event names for the methods below against the source before publishing as a stable reference.]

Application

Method	Purpose
`getInfo()`	Version and platform information.
`profile()`, `spaces()`	The account and its workspaces.
`checkForUpdates()`	Look for an update.
`restartBrowser()`	Restart. Synchronous.
`exit()`	Quit.
`setRunOnStartup()`	Launch at login.
`kabaLogout()`	Sign out.
`reloadShell()`	Reload the header and pane chrome.
`flushDNS()`	Clear the DNS cache.
`createEventsStream()`	Application events. Returns an event target.
`kabaStream()`	Engine events (models, downloads, peers). Returns an event target.

Settings and hotkeys

Method	Purpose
`getSettings()`, `getSetting()`, `setSetting()`	Read and write settings.
`listHotkeys()`, `setHotkey()`, `resetHotkey()`, `resetAllHotkeys()`, `propagateHotkeys()`	Keyboard shortcuts.
`getAnimationDefaults()`	Default motion settings.
`pickDownloadFolder()`	Ask the user for a downloads folder.
`setStartPageBackgroundImage()`, `setAvatar()`	Wallpaper and avatar.
`getDefaultProtocolSettings()`, `setAsDefaultProtocolClient()`, `removeAsDefaultProtocolClient()`	Default browser.
`getDefaultHtmlHandlerSettings()`, `setAsDefaultHtmlHandler()`, `removeAsDefaultHtmlHandler()`	HTML file association.

Ad blocker

adblockerEnabled(), enableAdblocker(), disableAdblocker(), updateAdblocker(), customAdblocker().

Windows

Method	Purpose
`newWindow()`, `closeWindow()`	Open and close.
`minimizeWindow()`, `maximizeWindow()`, `toggleWindowMaximized()`	Window state.
`setWindowDimensions()`, `moveWindow()`	Size and position.
`toggleUI()`, `isShellInterfaceHidden()`	Minimal mode.
`executeShellWindowCommand()`	Run a named shell command.

Pages and panes

Method	Purpose
`openUrl()`, `gotoUrl()`, `newPane()`, `closePane()`	Navigate and open.
`getPageUrl()`, `refreshPage()`, `focusPage()`	The current page.
`getPaneInfo()`, `refreshTabState()`	State.
`currentPaneLayout()`, `loadPaneLayout()`	Read and restore a frame’s layout.
`captureActivePane()`, `getDisplaySources()`	Screenshots and screen sources.
`executeJavaScriptInPage()`, `injectCssInPage()`, `uninjectCssInPage()`, `spawnAndExecuteJs()`	Act on a page.
`doWebcontentsCmd()`	Send an editing command such as copy or paste.
`toggleSiteInfo()`, `resizeSiteInfo()`	The Kaba bar’s site panel.
`toggleLiveReloading()`	Reload a page when its files change.

Dialogs and menus

Method	Purpose
`showModal()`, `closeModal()`	One of Kaba’s dialogs. `closeModal` is synchronous.
`showOpenDialog()`	The system file chooser.
`showContextMenu()`	A native context menu.
`toast()`	Show a notice.
`openFolder()`	Open a folder in the system file manager.

Sites

Method	Purpose
`sitesOverview()`, `siteClear()`	What Settings → Sites shows and clears.
`resetPermissions()`	Forget permission decisions.
`getCertificate()`	A site’s certificate.
`headers()`	Request headers as a site would see them.

Models

ask() sends a prompt and returns the answer. say() speaks text. resetAI() restarts the model worker. setPolicy(), updatePolicy() and deletePolicy() manage policies. kabaToolTrace() records a tool-loop step for display.

System

Method	Purpose
`currentLoad()`, `stats()`, `processMetrics()`	CPU, memory and per-process figures.
`captureMainHeapSnapshot()`	A heap snapshot of the main process.
`toggleProxy()`	Turn proxy routing on or off.

Utilities

Method	Purpose
`fetchBody()`, `downloadURL()`	Fetch or download a URL.
`getResourceContentType()`	MIME type for a path. Synchronous.
`listBuiltinFavicons()`, `getBuiltinFavicon()`, `uploadFavicon()`, `imageToIco()`	Icons.
`updateSetupState()`	Mark first-run steps complete.

kaba.downloads: getDownloads(), pause(), resume(), cancel(), remove(), clearCompleted(), open(), showInFolder(), getLocalPath(), openPath(), downloadsFolder(), openDownloadsFolder(), and createEventsStream().

kaba.logger: query() and stream().

kaba.omnibar: show(), hide(), toggle(), loadURL(), reload(), close(), resize(), and createEventStream().