@poncho-ai/browser 0.1.0

package/.turbo/turbo-build.log

@@ -0,0 +1,14 @@
+
+> @poncho-ai/browser@0.1.0 build /home/runner/work/poncho-ai/poncho-ai/packages/browser
+> tsup src/index.ts --format esm --dts
+
+CLI Building entry: src/index.ts
+CLI Using tsconfig: tsconfig.json
+CLI tsup v8.5.1
+CLI Target: es2022
+ESM Build start
+ESM dist/index.js 21.56 KB
+ESM ⚡️ Build success in 52ms
+DTS Build start
+DTS ⚡️ Build success in 4536ms
+DTS dist/index.d.ts 3.75 KB

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Latitude
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/dist/index.d.ts

@@ -0,0 +1,110 @@
+import { ToolDefinition } from '@poncho-ai/sdk';
+
+interface BrowserFrame {
+    data: string;
+    width: number;
+    height: number;
+    timestamp: number;
+}
+interface BrowserStatus {
+    active: boolean;
+    url?: string;
+    interactionAllowed: boolean;
+}
+interface ViewportOptions {
+    width?: number;
+    height?: number;
+}
+interface ScreencastOptions {
+    format?: "jpeg" | "png";
+    quality?: number;
+    maxWidth?: number;
+    maxHeight?: number;
+    everyNthFrame?: number;
+}
+interface MouseInputEvent {
+    type: "mousePressed" | "mouseReleased" | "mouseMoved" | "mouseWheel";
+    x: number;
+    y: number;
+    button?: "left" | "right" | "middle" | "none";
+    clickCount?: number;
+    deltaX?: number;
+    deltaY?: number;
+}
+interface KeyboardInputEvent {
+    type: "keyDown" | "keyUp" | "char";
+    key: string;
+    code?: string;
+    text?: string;
+    keyCode?: number;
+}
+interface ScrollInputEvent {
+    deltaX: number;
+    deltaY: number;
+    x?: number;
+    y?: number;
+}
+interface BrowserConfig {
+    viewport?: ViewportOptions;
+    quality?: number;
+    everyNthFrame?: number;
+    profileDir?: string;
+    sessionName?: string;
+    executablePath?: string;
+    headless?: boolean;
+}
+
+type FrameListener = (frame: BrowserFrame) => void;
+type StatusListener = (status: BrowserStatus) => void;
+declare class BrowserSession {
+    private readonly config;
+    private readonly sessionId;
+    private manager;
+    private readonly tabs;
+    private _lockQueue;
+    private _locked;
+    private _screencastConversation;
+    constructor(sessionId: string, config?: BrowserConfig);
+    get profileDir(): string;
+    private lock;
+    private unlock;
+    private launchFreshManager;
+    private ensureManager;
+    private evictOldestTab;
+    /** Reconcile tab indices with the manager's actual page list. */
+    private reconcileTabs;
+    private realTabCount;
+    private switchToConversation;
+    /** Check if a conversation has an active browser tab. */
+    isActiveFor(conversationId: string): boolean;
+    /** Get the current URL for a conversation's tab. */
+    getUrl(conversationId: string): string | undefined;
+    /** Whether the browser has been launched. */
+    get isLaunched(): boolean;
+    open(conversationId: string, url: string): Promise<{
+        title?: string;
+    }>;
+    private _doOpen;
+    snapshot(conversationId: string): Promise<string>;
+    click(conversationId: string, ref: string): Promise<void>;
+    type(conversationId: string, ref: string, text: string): Promise<void>;
+    screenshot(conversationId: string): Promise<string>;
+    scroll(conversationId: string, direction: "up" | "down", amount?: number): Promise<void>;
+    closeTab(conversationId: string): Promise<void>;
+    navigate(conversationId: string, action: string): Promise<void>;
+    startScreencast(conversationId: string, options?: ScreencastOptions): Promise<void>;
+    stopScreencast(): Promise<void>;
+    onFrame(conversationId: string, listener: FrameListener): () => void;
+    onStatus(conversationId: string, listener: StatusListener): () => void;
+    injectMouse(conversationId: string, event: MouseInputEvent): Promise<void>;
+    injectKeyboard(conversationId: string, event: KeyboardInputEvent): Promise<void>;
+    injectPaste(conversationId: string, text: string): Promise<void>;
+    injectScroll(conversationId: string, event: ScrollInputEvent): Promise<void>;
+    saveState(storagePath: string): Promise<void>;
+    close(): Promise<void>;
+    private emitStatus;
+}
+
+declare function createBrowserTools(getSession: () => BrowserSession, getConversationId: () => string): ToolDefinition[];
+
+export { type BrowserConfig, type BrowserFrame, BrowserSession, type BrowserStatus, type KeyboardInputEvent, type MouseInputEvent, type ScreencastOptions, type ScrollInputEvent, type ViewportOptions, createBrowserTools };