@modelprofile.com/browser-runtime 1.0.0

package/dist_ts/classes.flexprovider.d.ts

@@ -0,0 +1,9 @@
+import * as plugins from './plugins.js';
+import type { IBrowserRuntimeFlexToolProviderOptions } from './interfaces.js';
+export declare class BrowserRuntimeFlexToolProvider<TScope> implements plugins.flexharness.IFlexToolProvider<TScope> {
+    private readonly client;
+    private readonly resolveCapability;
+    private state;
+    constructor(options: IBrowserRuntimeFlexToolProviderOptions<TScope>);
+    provideTools(context: plugins.flexharness.IFlexToolProviderContext<TScope>): Promise<plugins.flexharness.IFlexToolHandle>;
+}

package/dist_ts/classes.flexprovider.js

@@ -0,0 +1,117 @@
+import * as plugins from './plugins.js';
+import { BrowserRuntimeError } from './errors.js';
+import { validateBoundedString, validateExactKeys } from './utils.js';
+const allowedActions = [
+    'navigate',
+    'snapshot',
+    'screenshot',
+    'click',
+    'fill',
+    'press',
+];
+export class BrowserRuntimeFlexToolProvider {
+    client;
+    resolveCapability;
+    state = 'unused';
+    constructor(options) {
+        if (!options || typeof options !== 'object')
+            throw new BrowserRuntimeError('INVALID_INPUT');
+        if (!options.client || typeof options.resolveCapability !== 'function') {
+            throw new BrowserRuntimeError('INVALID_INPUT');
+        }
+        this.client = options.client;
+        this.resolveCapability = options.resolveCapability;
+    }
+    async provideTools(context) {
+        if (this.state !== 'unused')
+            throw new BrowserRuntimeError('BUSY');
+        this.state = 'provisioning';
+        const scopeId = validateBoundedString(context.scopeId, 'scopeId', 1, 128);
+        const sessionId = validateBoundedString(context.sessionId, 'sessionId', 1, 128);
+        if (this.client.scopeId !== scopeId || this.client.sessionId !== sessionId) {
+            this.state = 'closed';
+            throw new BrowserRuntimeError('CAPABILITY_INVALID');
+        }
+        try {
+            context.signal.throwIfAborted();
+            const resolved = validateExactKeys(await this.resolveCapability(context), ['capabilityToken'], 'resolved capability');
+            const capabilityToken = validateBoundedString(resolved.capabilityToken, 'capabilityToken', 16, 512);
+            context.signal.throwIfAborted();
+            await this.client.acquire(capabilityToken, context.signal);
+            context.signal.throwIfAborted();
+        }
+        catch (error) {
+            await this.client.release().catch(() => undefined);
+            await this.client.close().catch(() => undefined);
+            this.state = 'closed';
+            throw error;
+        }
+        this.state = 'active';
+        const tools = plugins.smartagent.createBrowserTools({
+            abortSignal: context.signal,
+            browser: this.client.asToolBrowserContext(),
+            requestPermission: async (request) => {
+                const metadata = request.metadata ?? {};
+                const actionValue = metadata.action;
+                if (typeof actionValue !== 'string' || !allowedActions.includes(actionValue)) {
+                    throw new BrowserRuntimeError('INVALID_INPUT');
+                }
+                const action = actionValue;
+                const toolCallId = request.toolCallId === undefined
+                    ? undefined
+                    : validateBoundedString(request.toolCallId, 'toolCallId', 1, 128);
+                const permission = context.requestPermission({
+                    kind: `browser.${action}`,
+                    description: `Allow the browser to perform the ${action} action.`,
+                    ...(toolCallId ? { toolCallId } : {}),
+                    metadata: { action },
+                });
+                const signal = AbortSignal.any([
+                    context.signal,
+                    request.abortSignal ?? new AbortController().signal,
+                ]);
+                signal.throwIfAborted();
+                let onAbort;
+                const aborted = new Promise((_resolve, reject) => {
+                    onAbort = () => reject(new BrowserRuntimeError('ABORTED'));
+                    signal.addEventListener('abort', onAbort, { once: true });
+                });
+                try {
+                    await Promise.race([permission, aborted]);
+                    signal.throwIfAborted();
+                }
+                finally {
+                    signal.removeEventListener('abort', onAbort);
+                }
+            },
+        }, {
+            allowedActions,
+            maxLines: 2000,
+            maxBytes: 128 * 1024,
+        });
+        let closePromise;
+        const close = () => {
+            if (closePromise)
+                return closePromise;
+            closePromise = (async () => {
+                context.signal.removeEventListener('abort', onRunAbort);
+                let releaseError;
+                await this.client.release().catch((error) => { releaseError = error; });
+                await this.client.close();
+                this.state = 'closed';
+                if (releaseError)
+                    throw releaseError;
+            })();
+            return closePromise;
+        };
+        const onRunAbort = () => {
+            void close().catch(() => undefined);
+        };
+        context.signal.addEventListener('abort', onRunAbort, { once: true });
+        return {
+            tools,
+            close,
+        };
+    }
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiY2xhc3Nlcy5mbGV4cHJvdmlkZXIuanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi90cy9jbGFzc2VzLmZsZXhwcm92aWRlci50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFBQSxPQUFPLEtBQUssT0FBTyxNQUFNLGNBQWMsQ0FBQztBQUl4QyxPQUFPLEVBQUUsbUJBQW1CLEVBQUUsTUFBTSxhQUFhLENBQUM7QUFDbEQsT0FBTyxFQUFFLHFCQUFxQixFQUFFLGlCQUFpQixFQUFFLE1BQU0sWUFBWSxDQUFDO0FBRXRFLE1BQU0sY0FBYyxHQUFHO0lBQ3JCLFVBQVU7SUFDVixVQUFVO0lBQ1YsWUFBWTtJQUNaLE9BQU87SUFDUCxNQUFNO0lBQ04sT0FBTztDQUM0RCxDQUFDO0FBRXRFLE1BQU0sT0FBTyw4QkFBOEI7SUFFeEIsTUFBTSxDQUEyRDtJQUNqRSxpQkFBaUIsQ0FBc0U7SUFDaEcsS0FBSyxHQUFvRCxRQUFRLENBQUM7SUFFMUUsWUFBWSxPQUF1RDtRQUNqRSxJQUFJLENBQUMsT0FBTyxJQUFJLE9BQU8sT0FBTyxLQUFLLFFBQVE7WUFBRSxNQUFNLElBQUksbUJBQW1CLENBQUMsZUFBZSxDQUFDLENBQUM7UUFDNUYsSUFBSSxDQUFDLE9BQU8sQ0FBQyxNQUFNLElBQUksT0FBTyxPQUFPLENBQUMsaUJBQWlCLEtBQUssVUFBVSxFQUFFLENBQUM7WUFDdkUsTUFBTSxJQUFJLG1CQUFtQixDQUFDLGVBQWUsQ0FBQyxDQUFDO1FBQ2pELENBQUM7UUFDRCxJQUFJLENBQUMsTUFBTSxHQUFHLE9BQU8sQ0FBQyxNQUFNLENBQUM7UUFDN0IsSUFBSSxDQUFDLGlCQUFpQixHQUFHLE9BQU8sQ0FBQyxpQkFBaUIsQ0FBQztJQUNyRCxDQUFDO0lBRU0sS0FBSyxDQUFDLFlBQVksQ0FDdkIsT0FBNkQ7UUFFN0QsSUFBSSxJQUFJLENBQUMsS0FBSyxLQUFLLFFBQVE7WUFBRSxNQUFNLElBQUksbUJBQW1CLENBQUMsTUFBTSxDQUFDLENBQUM7UUFDbkUs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

package/dist_ts/classes.framed.d.ts

@@ -0,0 +1,52 @@
+import * as plugins from './plugins.js';
+import type { BrowserRuntime } from './classes.runtime.js';
+import type { IAttachTrustedFramedPeerOptions, IBrowserRuntimeFramedClientOptions, IBrowserRuntimeOperationOptions, TBrowserAgentAction, TBrowserAgentActionResult } from './interfaces.js';
+export declare class BrowserRuntimeFramedServerPeer {
+    private readonly runtime;
+    private readonly onClosed;
+    private readonly trustedPeerId;
+    private readonly trustedScopeId;
+    private readonly trustedSessionId;
+    private readonly channel;
+    private readonly activeRequests;
+    private lease?;
+    private started;
+    private closePromise?;
+    private closing;
+    private readonly dispatches;
+    constructor(runtime: BrowserRuntime, options: IAttachTrustedFramedPeerOptions, onClosed?: () => void);
+    get peerId(): string;
+    start(): void;
+    close(): Promise<void>;
+    private handleMessage;
+    private dispatchRequest;
+    private requireLease;
+    private sendError;
+    private closeInternal;
+    private closeFromStream;
+}
+export declare class BrowserRuntimeFramedClient {
+    private readonly channel;
+    private readonly maxPendingRequests;
+    private readonly requestTimeoutMs;
+    private readonly pending;
+    private acquired;
+    private started;
+    private closePromise?;
+    private readonly scopeIdValue;
+    private readonly sessionIdValue;
+    constructor(options: IBrowserRuntimeFramedClientOptions);
+    start(): void;
+    get scopeId(): string;
+    get sessionId(): string;
+    acquire(capabilityTokenArg: string, signal?: AbortSignal): Promise<void>;
+    executeAgentAction(actionArg: TBrowserAgentAction, options?: IBrowserRuntimeOperationOptions): Promise<TBrowserAgentActionResult>;
+    asToolBrowserContext(): plugins.smartagent.IToolBrowserContext;
+    release(): Promise<void>;
+    close(): Promise<void>;
+    private request;
+    private requestWithId;
+    private handleResponse;
+    private handleClose;
+    private closeInternal;
+}