@modelprofile.com/flexharness 10.3.0 → 10.4.0

package/dist_ts/00_commitinfo_data.js

@@ -3,7 +3,7 @@
  */
 export const commitinfo = {
     name: '@modelprofile.com/flexharness',
-    version: '10.3.0',
+    version: '10.4.0',
     description: 'The FlexHarness toolbox source repository and shared dependency catalog.'
 };
 //# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiMDBfY29tbWl0aW5mb19kYXRhLmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vdHMvMDBfY29tbWl0aW5mb19kYXRhLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQUFBOztHQUVHO0FBQ0gsTUFBTSxDQUFDLE1BQU0sVUFBVSxHQUFHO0lBQ3hCLElBQUksRUFBRSwrQkFBK0I7SUFDckMsT0FBTyxFQUFFLFFBQVE7SUFDakIsV0FBVyxFQUFFLDBFQUEwRTtDQUN4RixDQUFBIn0=

package/dist_ts_browser/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.IFlexToolProvider<TScope> {
+    private readonly client;
+    private readonly resolveCapability;
+    private state;
+    constructor(options: IBrowserRuntimeFlexToolProviderOptions<TScope>);
+    provideTools(context: plugins.IFlexToolProviderContext<TScope>): Promise<plugins.IFlexToolHandle>;
+}

package/dist_ts_browser/classes.flexprovider.js

@@ -0,0 +1,135 @@
+import * as plugins from './plugins.js';
+import { createFramedToolBrowserContext } from './tool.context.js';
+const browserActions = [
+    'navigate',
+    'snapshot',
+    'screenshot',
+    'click',
+    'fill',
+    'press',
+];
+const boundedIdentifier = (minimum, maximum) => plugins.z.string().trim().min(minimum).max(maximum);
+const runBindingSchema = plugins.z.object({
+    scopeId: boundedIdentifier(1, 128),
+    sessionId: boundedIdentifier(1, 128),
+    runId: boundedIdentifier(1, 256),
+});
+const capabilitySchema = plugins.z.strictObject({
+    capabilityToken: boundedIdentifier(16, 512),
+});
+export class BrowserRuntimeFlexToolProvider {
+    client;
+    resolveCapability;
+    state = 'unused';
+    constructor(options) {
+        if (!options || !options.client || typeof options.resolveCapability !== 'function') {
+            throw new plugins.BrowserRuntimeError('INVALID_INPUT');
+        }
+        this.client = options.client;
+        this.resolveCapability = options.resolveCapability;
+    }
+    async provideTools(context) {
+        if (this.state !== 'unused')
+            throw new plugins.BrowserRuntimeError('BUSY');
+        this.state = 'provisioning';
+        try {
+            const binding = runBindingSchema.safeParse(context);
+            if (!binding.success)
+                throw new plugins.BrowserRuntimeError('INVALID_INPUT');
+            if (this.client.scopeId !== binding.data.scopeId
+                || this.client.sessionId.harnessId !== 'flex'
+                || this.client.sessionId.nativeId !== binding.data.sessionId
+                || this.client.runId !== binding.data.runId)
+                throw new plugins.BrowserRuntimeError('CAPABILITY_INVALID');
+            context.signal.throwIfAborted();
+            const capability = capabilitySchema.safeParse(await this.resolveCapability(context));
+            if (!capability.success)
+                throw new plugins.BrowserRuntimeError('INVALID_INPUT');
+            context.signal.throwIfAborted();
+            await this.client.acquire(capability.data.capabilityToken, context.signal);
+            context.signal.throwIfAborted();
+        }
+        catch (error) {
+            this.state = 'closed';
+            const cleanupErrors = [];
+            await this.client.release().catch((cleanupError) => cleanupErrors.push(cleanupError));
+            await this.client.close().catch((cleanupError) => cleanupErrors.push(cleanupError));
+            if (cleanupErrors.length > 0) {
+                throw new AggregateError([error, ...cleanupErrors], 'Browser tool provisioning cleanup failed.');
+            }
+            throw error;
+        }
+        this.state = 'active';
+        const tools = plugins.createBrowserTools({
+            abortSignal: context.signal,
+            browser: createFramedToolBrowserContext(this.client, context.signal),
+            requestPermission: async (request) => {
+                const action = plugins.z.enum(browserActions).safeParse(request.metadata?.action);
+                if (!action.success)
+                    throw new plugins.BrowserRuntimeError('INVALID_INPUT');
+                const toolCallId = request.toolCallId === undefined
+                    ? undefined
+                    : boundedIdentifier(1, 128).safeParse(request.toolCallId);
+                if (toolCallId !== undefined && !toolCallId.success) {
+                    throw new plugins.BrowserRuntimeError('INVALID_INPUT');
+                }
+                const signal = request.abortSignal
+                    ? AbortSignal.any([context.signal, request.abortSignal])
+                    : context.signal;
+                signal.throwIfAborted();
+                const permission = context.requestPermission({
+                    kind: `browser.${action.data}`,
+                    description: `Allow the browser to perform the ${action.data} action.`,
+                    ...(toolCallId === undefined ? {} : { toolCallId: toolCallId.data }),
+                    metadata: { action: action.data },
+                });
+                let onAbort;
+                const aborted = new Promise((_resolve, reject) => {
+                    onAbort = () => reject(new plugins.BrowserRuntimeError('ABORTED'));
+                    signal.addEventListener('abort', onAbort, { once: true });
+                    if (signal.aborted)
+                        onAbort();
+                });
+                try {
+                    await Promise.race([permission, aborted]);
+                    signal.throwIfAborted();
+                }
+                finally {
+                    signal.removeEventListener('abort', onAbort);
+                }
+            },
+        }, {
+            allowedActions: browserActions,
+            maxLines: 2000,
+            maxBytes: 128 * 1024,
+        });
+        let closePromise;
+        const close = () => {
+            if (closePromise)
+                return closePromise;
+            closePromise = (async () => {
+                context.signal.removeEventListener('abort', onRunAbort);
+                const cleanupErrors = [];
+                await this.client.release().catch((error) => cleanupErrors.push(error));
+                await this.client.close().catch((error) => cleanupErrors.push(error));
+                this.state = 'closed';
+                if (cleanupErrors.length === 1)
+                    throw cleanupErrors[0];
+                if (cleanupErrors.length > 1) {
+                    throw new AggregateError(cleanupErrors, 'Browser tool cleanup failed.');
+                }
+            })();
+            return closePromise;
+        };
+        const onRunAbort = () => {
+            void close().catch(() => undefined);
+        };
+        context.signal.addEventListener('abort', onRunAbort, { once: true });
+        if (context.signal.aborted) {
+            await close();
+            throw new plugins.BrowserRuntimeError('ABORTED');
+        }
+        return { tools, close };
+    }
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiY2xhc3Nlcy5mbGV4cHJvdmlkZXIuanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi90c19icm93c2VyL2NsYXNzZXMuZmxleHByb3ZpZGVyLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQUFBLE9BQU8sS0FBSyxPQUFPLE1BQU0sY0FBYyxDQUFDO0FBRXhDLE9BQU8sRUFBRSw4QkFBOEIsRUFBRSxNQUFNLG1CQUFtQixDQUFDO0FBRW5FLE1BQU0sY0FBYyxHQUFHO0lBQ3JCLFVBQVU7SUFDVixVQUFVO0lBQ1YsWUFBWTtJQUNaLE9BQU87SUFDUCxNQUFNO0lBQ04sT0FBTztDQUNpRCxDQUFDO0FBRTNELE1BQU0saUJBQWlCLEdBQUcsQ0FBQyxPQUFlLEVBQUUsT0FBZSxFQUFFLEVBQUUsQ0FDN0QsT0FBTyxDQUFDLENBQUMsQ0FBQyxNQUFNLEVBQUUsQ0FBQyxJQUFJLEVBQUUsQ0FBQyxHQUFHLENBQUMsT0FBTyxDQUFDLENBQUMsR0FBRyxDQUFDLE9BQU8sQ0FBQyxDQUFDO0FBRXRELE1BQU0sZ0JBQWdCLEdBQUcsT0FBTyxDQUFDLENBQUMsQ0FBQyxNQUFNLENBQUM7SUFDeEMsT0FBTyxFQUFFLGlCQUFpQixDQUFDLENBQUMsRUFBRSxHQUFHLENBQUM7SUFDbEMsU0FBUyxFQUFFLGlCQUFpQixDQUFDLENBQUMsRUFBRSxHQUFHLENBQUM7SUFDcEMsS0FBSyxFQUFFLGlCQUFpQixDQUFDLENBQUMsRUFBRSxHQUFHLENBQUM7Q0FDakMsQ0FBQyxDQUFDO0FBRUgsTUFBTSxnQkFBZ0IsR0FBRyxPQUFPLENBQUMsQ0FBQyxDQUFDLFlBQVksQ0FBQztJQUM5QyxlQUFlLEVBQUUsaUJBQWlCLENBQUMsRUFBRSxFQUFFLEdBQUcsQ0FBQztDQUM1QyxDQUFDLENBQUM7QUFFSCxNQUFNLE9BQU8sOEJBQThCO0lBRXhCLE1BQU0sQ0FBcUM7SUFDM0MsaUJBQWlCLENBQXNFO0lBQ2hHLEtBQUssR0FBb0QsUUFBUSxDQUFDO0lBRTFFLFlBQVksT0FBdUQ7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

package/dist_ts_browser/index.d.ts

@@ -0,0 +1,3 @@
+export { BrowserRuntimeFlexToolProvider } from './classes.flexprovider.js';
+export { createFramedToolBrowserContext } from './tool.context.js';
+export type { IBrowserRuntimeFlexToolProviderOptions, IResolvedBrowserFlexCapability, } from './interfaces.js';

package/dist_ts_browser/index.js

@@ -0,0 +1,3 @@
+export { BrowserRuntimeFlexToolProvider } from './classes.flexprovider.js';
+export { createFramedToolBrowserContext } from './tool.context.js';
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaW5kZXguanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi90c19icm93c2VyL2luZGV4LnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQUFBLE9BQU8sRUFBRSw4QkFBOEIsRUFBRSxNQUFNLDJCQUEyQixDQUFDO0FBQzNFLE9BQU8sRUFBRSw4QkFBOEIsRUFBRSxNQUFNLG1CQUFtQixDQUFDIn0=

package/dist_ts_browser/interfaces.d.ts

@@ -0,0 +1,8 @@
+import type * as plugins from './plugins.js';
+export interface IResolvedBrowserFlexCapability {
+    capabilityToken: string;
+}
+export interface IBrowserRuntimeFlexToolProviderOptions<TScope> {
+    client: plugins.BrowserRuntimeFramedClient;
+    resolveCapability(context: plugins.IFlexToolProviderContext<TScope>): Promise<IResolvedBrowserFlexCapability> | IResolvedBrowserFlexCapability;
+}

package/dist_ts_browser/interfaces.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaW50ZXJmYWNlcy5qcyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uL3RzX2Jyb3dzZXIvaW50ZXJmYWNlcy50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiIn0=

package/dist_ts_browser/plugins.d.ts

@@ -0,0 +1,7 @@
+import { z } from 'zod';
+import { BrowserRuntimeError, validateAgentAction } from '@push.rocks/smartbrowser/runtime';
+import { createBrowserTools } from '@modelprofile.com/flexharness/tools';
+export { z, BrowserRuntimeError, validateAgentAction, createBrowserTools };
+export type { BrowserRuntimeFramedClient, TBrowserAgentAction, } from '@push.rocks/smartbrowser/runtime';
+export type { IFlexToolHandle, IFlexToolProvider, IFlexToolProviderContext, } from '@modelprofile.com/flexharness';
+export type { IBrowserToolInput, IToolBrowserContext, IToolBrowserRunOptions, TBrowserToolAction, } from '@modelprofile.com/flexharness/tools';

package/dist_ts_browser/plugins.js

@@ -0,0 +1,5 @@
+import { z } from 'zod';
+import { BrowserRuntimeError, validateAgentAction, } from '@push.rocks/smartbrowser/runtime';
+import { createBrowserTools } from '@modelprofile.com/flexharness/tools';
+export { z, BrowserRuntimeError, validateAgentAction, createBrowserTools };
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoicGx1Z2lucy5qcyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uL3RzX2Jyb3dzZXIvcGx1Z2lucy50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFBQSxPQUFPLEVBQUUsQ0FBQyxFQUFFLE1BQU0sS0FBSyxDQUFDO0FBQ3hCLE9BQU8sRUFDTCxtQkFBbUIsRUFDbkIsbUJBQW1CLEdBQ3BCLE1BQU0sa0NBQWtDLENBQUM7QUFDMUMsT0FBTyxFQUFFLGtCQUFrQixFQUFFLE1BQU0scUNBQXFDLENBQUM7QUFFekUsT0FBTyxFQUFFLENBQUMsRUFBRSxtQkFBbUIsRUFBRSxtQkFBbUIsRUFBRSxrQkFBa0IsRUFBRSxDQUFDIn0=

package/dist_ts_browser/tool.context.d.ts

@@ -0,0 +1,2 @@
+import * as plugins from './plugins.js';
+export declare function createFramedToolBrowserContext(client: plugins.BrowserRuntimeFramedClient, runSignal: AbortSignal): plugins.IToolBrowserContext;

package/dist_ts_browser/tool.context.js

@@ -0,0 +1,61 @@
+import * as plugins from './plugins.js';
+const browserToolInputSchema = plugins.z.strictObject({
+    action: plugins.z.preprocess((value) => typeof value === 'string' ? value.trim() : value ?? 'snapshot', plugins.z.enum(['navigate', 'snapshot', 'screenshot', 'click', 'fill', 'press'])),
+    url: plugins.z.string().optional(),
+    selector: plugins.z.string().optional(),
+    text: plugins.z.string().optional(),
+    timeoutMs: plugins.z.number().int().min(100).max(120_000).optional(),
+});
+export function createFramedToolBrowserContext(client, runSignal) {
+    return {
+        execute: async (input, options) => {
+            const parsed = browserToolInputSchema.safeParse(input);
+            if (!parsed.success)
+                throw new plugins.BrowserRuntimeError('INVALID_INPUT');
+            const { action, url, selector, text, timeoutMs } = parsed.data;
+            let runtimeAction;
+            switch (action) {
+                case 'navigate':
+                    runtimeAction = plugins.validateAgentAction({
+                        action,
+                        url: url ?? '',
+                        ...(timeoutMs === undefined ? {} : { timeoutMs }),
+                    });
+                    break;
+                case 'snapshot':
+                case 'screenshot':
+                    runtimeAction = { action };
+                    break;
+                case 'click':
+                    runtimeAction = plugins.validateAgentAction({
+                        action,
+                        selector: selector ?? '',
+                        ...(timeoutMs === undefined ? {} : { timeoutMs }),
+                    });
+                    break;
+                case 'fill':
+                    runtimeAction = plugins.validateAgentAction({
+                        action,
+                        selector: selector ?? '',
+                        text: text ?? '',
+                        ...(timeoutMs === undefined ? {} : { timeoutMs }),
+                    });
+                    break;
+                case 'press':
+                    runtimeAction = plugins.validateAgentAction({
+                        action,
+                        selector: selector ?? '',
+                        key: text ?? '',
+                        ...(timeoutMs === undefined ? {} : { timeoutMs }),
+                    });
+                    break;
+            }
+            const signal = options?.abortSignal
+                ? AbortSignal.any([runSignal, options.abortSignal])
+                : runSignal;
+            signal.throwIfAborted();
+            return client.executeAgentAction(runtimeAction, { signal });
+        },
+    };
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoidG9vbC5jb250ZXh0LmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vdHNfYnJvd3Nlci90b29sLmNvbnRleHQudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBQUEsT0FBTyxLQUFLLE9BQU8sTUFBTSxjQUFjLENBQUM7QUFFeEMsTUFBTSxzQkFBc0IsR0FBRyxPQUFPLENBQUMsQ0FBQyxDQUFDLFlBQVksQ0FBQztJQUNwRCxNQUFNLEVBQUUsT0FBTyxDQUFDLENBQUMsQ0FBQyxVQUFVLENBQzFCLENBQUMsS0FBSyxFQUFFLEVBQUUsQ0FBQyxPQUFPLEtBQUssS0FBSyxRQUFRLENBQUMsQ0FBQyxDQUFDLEtBQUssQ0FBQyxJQUFJLEVBQUUsQ0FBQyxDQUFDLENBQUMsS0FBSyxJQUFJLFVBQVUsRUFDekUsT0FBTyxDQUFDLENBQUMsQ0FBQyxJQUFJLENBQUMsQ0FBQyxVQUFVLEVBQUUsVUFBVSxFQUFFLFlBQVksRUFBRSxPQUFPLEVBQUUsTUFBTSxFQUFFLE9BQU8sQ0FBQyxDQUFDLENBQ2pGO0lBQ0QsR0FBRyxFQUFFLE9BQU8sQ0FBQyxDQUFDLENBQUMsTUFBTSxFQUFFLENBQUMsUUFBUSxFQUFFO0lBQ2xDLFFBQVEsRUFBRSxPQUFPLENBQUMsQ0FBQyxDQUFDLE1BQU0sRUFBRSxDQUFDLFFBQVEsRUFBRTtJQUN2QyxJQUFJLEVBQUUsT0FBTyxDQUFDLENBQUMsQ0FBQyxNQUFNLEVBQUUsQ0FBQyxRQUFRLEVBQUU7SUFDbkMsU0FBUyxFQUFFLE9BQU8sQ0FBQyxDQUFDLENBQUMsTUFBTSxFQUFFLENBQUMsR0FBRyxFQUFFLENBQUMsR0FBRyxDQUFDLEdBQUcsQ0FBQyxDQUFDLEdBQUcsQ0FBQyxPQUFPLENBQUMsQ0FBQyxRQUFRLEVBQUU7Q0FDckUsQ0FBQyxDQUFDO0FBRUgsTUFBTSxVQUFVLDhCQUE4QixDQUM1QyxNQUEwQyxFQUMxQyxTQUFzQjtJQUV0QixPQUFPO1FBQ0wsT0FBTyxFQUFFLEtBQUssRUFBRSxLQUFnQyxFQUFFLE9BQXdD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

package/package.json

@@ -2,7 +2,7 @@
   "author": "Task Venture Capital GmbH",
   "license": "MIT",
   "name": "@modelprofile.com/flexharness",
-  "version": "10.3.0",
+  "version": "10.4.0",
   "type": "module",
   "description": "Managed agent sessions with tools, MCP, chat, OCR, documents and browser control through focused subpath imports.",
   "main": "./dist_ts/index.js",
@@ -24,6 +24,10 @@
       "types": "./dist_ts_tools_node/index.d.ts",
       "import": "./dist_ts_tools_node/index.js"
     },
+    "./browser": {
+      "types": "./dist_ts_browser/index.d.ts",
+      "import": "./dist_ts_browser/index.js"
+    },
     "./compaction": {
       "types": "./dist_ts_compaction/index.d.ts",
       "import": "./dist_ts_compaction/index.js"
@@ -70,14 +74,15 @@
     }
   },
   "dependencies": {
-    "@modelprofile.com/flexharness-agent": "10.3.0",
-    "@modelprofile.com/flexharness-models": "10.3.0",
+    "@modelprofile.com/flexharness-agent": "10.4.0",
+    "@modelprofile.com/flexharness-models": "10.4.0",
     "@push.rocks/smartrequest": "^5.5.1",
     "ai": "^7.0.111",
     "zod": "^4.6.5"
   },
   "peerDependencies": {
     "@modelcontextprotocol/sdk": "^1.29.0",
+    "@push.rocks/smartbrowser": "^5.0.0",
     "@push.rocks/smartpdf": "^6.0.0",
     "sharp": "^0.35.3",
     "puppeteer": "^24.42.0",
@@ -93,6 +98,9 @@
     "@modelcontextprotocol/sdk": {
       "optional": true
     },
+    "@push.rocks/smartbrowser": {
+      "optional": true
+    },
     "@push.rocks/smartpdf": {
       "optional": true
     },
@@ -139,6 +147,8 @@
     "dist_ts_tools",
     "ts_tools_node",
     "dist_ts_tools_node",
+    "ts_browser",
+    "dist_ts_browser",
     "ts_compaction",
     "dist_ts_compaction",
     "ts_mcp",

package/readme.md

@@ -55,6 +55,7 @@ or provider SDKs.
 | --- | --- | --- |
 | `/tools` | Host-supplied execution contexts, HTTP and JSON tools | None |
 | `/tools/node` | Local filesystem and process tools, file-backed job adapters | None |
+| `/browser` | Run-scoped SmartBrowser framed-client adapter for Flex tool providers | `@push.rocks/smartbrowser` |
 | `/compaction` | Model-driven conversation compaction | None |
 | `/media` | Vision recipes using an injected model | None |
 | `/ocr` | `ImageOcr`, OCR contracts and Mistral transport | None |
@@ -75,6 +76,12 @@ only for the entrypoints your project imports, for example:
 pnpm add @modelprofile.com/flexharness lit
 ```
 
+For a managed SmartBrowser resource, install its optional browser peer:
+
+```sh
+pnpm add @modelprofile.com/flexharness @push.rocks/smartbrowser
+```
+
 ```typescript
 import { ChatSession } from '@modelprofile.com/flexharness/chat';
 import '@modelprofile.com/flexharness/chat/web';

package/ts/00_commitinfo_data.ts

@@ -3,6 +3,6 @@
  */
 export const commitinfo = {
   name: '@modelprofile.com/flexharness',
-  version: '10.3.0',
+  version: '10.4.0',
   description: 'The FlexHarness toolbox source repository and shared dependency catalog.'
 }

package/ts/readme.md

@@ -55,6 +55,7 @@ or provider SDKs.
 | --- | --- | --- |
 | `/tools` | Host-supplied execution contexts, HTTP and JSON tools | None |
 | `/tools/node` | Local filesystem and process tools, file-backed job adapters | None |
+| `/browser` | Run-scoped SmartBrowser framed-client adapter for Flex tool providers | `@push.rocks/smartbrowser` |
 | `/compaction` | Model-driven conversation compaction | None |
 | `/media` | Vision recipes using an injected model | None |
 | `/ocr` | `ImageOcr`, OCR contracts and Mistral transport | None |
@@ -75,6 +76,12 @@ only for the entrypoints your project imports, for example:
 pnpm add @modelprofile.com/flexharness lit
 ```
 
+For a managed SmartBrowser resource, install its optional browser peer:
+
+```sh
+pnpm add @modelprofile.com/flexharness @push.rocks/smartbrowser
+```
+
 ```typescript
 import { ChatSession } from '@modelprofile.com/flexharness/chat';
 import '@modelprofile.com/flexharness/chat/web';

package/ts_browser/classes.flexprovider.ts

@@ -0,0 +1,140 @@
+import * as plugins from './plugins.js';
+import type { IBrowserRuntimeFlexToolProviderOptions } from './interfaces.js';
+import { createFramedToolBrowserContext } from './tool.context.js';
+
+const browserActions = [
+  'navigate',
+  'snapshot',
+  'screenshot',
+  'click',
+  'fill',
+  'press',
+] as const satisfies readonly plugins.TBrowserToolAction[];
+
+const boundedIdentifier = (minimum: number, maximum: number) =>
+  plugins.z.string().trim().min(minimum).max(maximum);
+
+const runBindingSchema = plugins.z.object({
+  scopeId: boundedIdentifier(1, 128),
+  sessionId: boundedIdentifier(1, 128),
+  runId: boundedIdentifier(1, 256),
+});
+
+const capabilitySchema = plugins.z.strictObject({
+  capabilityToken: boundedIdentifier(16, 512),
+});
+
+export class BrowserRuntimeFlexToolProvider<TScope>
+implements plugins.IFlexToolProvider<TScope> {
+  private readonly client: plugins.BrowserRuntimeFramedClient;
+  private readonly resolveCapability: IBrowserRuntimeFlexToolProviderOptions<TScope>['resolveCapability'];
+  private state: 'unused' | 'provisioning' | 'active' | 'closed' = 'unused';
+
+  constructor(options: IBrowserRuntimeFlexToolProviderOptions<TScope>) {
+    if (!options || !options.client || typeof options.resolveCapability !== 'function') {
+      throw new plugins.BrowserRuntimeError('INVALID_INPUT');
+    }
+    this.client = options.client;
+    this.resolveCapability = options.resolveCapability;
+  }
+
+  public async provideTools(
+    context: plugins.IFlexToolProviderContext<TScope>,
+  ): Promise<plugins.IFlexToolHandle> {
+    if (this.state !== 'unused') throw new plugins.BrowserRuntimeError('BUSY');
+    this.state = 'provisioning';
+    try {
+      const binding = runBindingSchema.safeParse(context);
+      if (!binding.success) throw new plugins.BrowserRuntimeError('INVALID_INPUT');
+      if (
+        this.client.scopeId !== binding.data.scopeId
+        || this.client.sessionId.harnessId !== 'flex'
+        || this.client.sessionId.nativeId !== binding.data.sessionId
+        || this.client.runId !== binding.data.runId
+      ) throw new plugins.BrowserRuntimeError('CAPABILITY_INVALID');
+      context.signal.throwIfAborted();
+      const capability = capabilitySchema.safeParse(await this.resolveCapability(context));
+      if (!capability.success) throw new plugins.BrowserRuntimeError('INVALID_INPUT');
+      context.signal.throwIfAborted();
+      await this.client.acquire(capability.data.capabilityToken, context.signal);
+      context.signal.throwIfAborted();
+    } catch (error) {
+      this.state = 'closed';
+      const cleanupErrors: unknown[] = [];
+      await this.client.release().catch((cleanupError: unknown) => cleanupErrors.push(cleanupError));
+      await this.client.close().catch((cleanupError: unknown) => cleanupErrors.push(cleanupError));
+      if (cleanupErrors.length > 0) {
+        throw new AggregateError([error, ...cleanupErrors], 'Browser tool provisioning cleanup failed.');
+      }
+      throw error;
+    }
+    this.state = 'active';
+
+    const tools = plugins.createBrowserTools({
+      abortSignal: context.signal,
+      browser: createFramedToolBrowserContext(this.client, context.signal),
+      requestPermission: async (request) => {
+        const action = plugins.z.enum(browserActions).safeParse(request.metadata?.action);
+        if (!action.success) throw new plugins.BrowserRuntimeError('INVALID_INPUT');
+        const toolCallId = request.toolCallId === undefined
+          ? undefined
+          : boundedIdentifier(1, 128).safeParse(request.toolCallId);
+        if (toolCallId !== undefined && !toolCallId.success) {
+          throw new plugins.BrowserRuntimeError('INVALID_INPUT');
+        }
+        const signal = request.abortSignal
+          ? AbortSignal.any([context.signal, request.abortSignal])
+          : context.signal;
+        signal.throwIfAborted();
+        const permission = context.requestPermission({
+          kind: `browser.${action.data}`,
+          description: `Allow the browser to perform the ${action.data} action.`,
+          ...(toolCallId === undefined ? {} : { toolCallId: toolCallId.data }),
+          metadata: { action: action.data },
+        });
+        let onAbort!: () => void;
+        const aborted = new Promise<never>((_resolve, reject) => {
+          onAbort = () => reject(new plugins.BrowserRuntimeError('ABORTED'));
+          signal.addEventListener('abort', onAbort, { once: true });
+          if (signal.aborted) onAbort();
+        });
+        try {
+          await Promise.race([permission, aborted]);
+          signal.throwIfAborted();
+        } finally {
+          signal.removeEventListener('abort', onAbort);
+        }
+      },
+    }, {
+      allowedActions: browserActions,
+      maxLines: 2000,
+      maxBytes: 128 * 1024,
+    });
+
+    let closePromise: Promise<void> | undefined;
+    const close = (): Promise<void> => {
+      if (closePromise) return closePromise;
+      closePromise = (async () => {
+        context.signal.removeEventListener('abort', onRunAbort);
+        const cleanupErrors: unknown[] = [];
+        await this.client.release().catch((error: unknown) => cleanupErrors.push(error));
+        await this.client.close().catch((error: unknown) => cleanupErrors.push(error));
+        this.state = 'closed';
+        if (cleanupErrors.length === 1) throw cleanupErrors[0];
+        if (cleanupErrors.length > 1) {
+          throw new AggregateError(cleanupErrors, 'Browser tool cleanup failed.');
+        }
+      })();
+      return closePromise;
+    };
+    const onRunAbort = (): void => {
+      void close().catch(() => undefined);
+    };
+    context.signal.addEventListener('abort', onRunAbort, { once: true });
+    if (context.signal.aborted) {
+      await close();
+      throw new plugins.BrowserRuntimeError('ABORTED');
+    }
+    return { tools, close };
+  }
+}

package/ts_browser/index.ts

@@ -0,0 +1,6 @@
+export { BrowserRuntimeFlexToolProvider } from './classes.flexprovider.js';
+export { createFramedToolBrowserContext } from './tool.context.js';
+export type {
+  IBrowserRuntimeFlexToolProviderOptions,
+  IResolvedBrowserFlexCapability,
+} from './interfaces.js';

package/ts_browser/interfaces.ts

@@ -0,0 +1,12 @@
+import type * as plugins from './plugins.js';
+
+export interface IResolvedBrowserFlexCapability {
+  capabilityToken: string;
+}
+
+export interface IBrowserRuntimeFlexToolProviderOptions<TScope> {
+  client: plugins.BrowserRuntimeFramedClient;
+  resolveCapability(
+    context: plugins.IFlexToolProviderContext<TScope>,
+  ): Promise<IResolvedBrowserFlexCapability> | IResolvedBrowserFlexCapability;
+}

package/ts_browser/plugins.ts

@@ -0,0 +1,23 @@
+import { z } from 'zod';
+import {
+  BrowserRuntimeError,
+  validateAgentAction,
+} from '@push.rocks/smartbrowser/runtime';
+import { createBrowserTools } from '@modelprofile.com/flexharness/tools';
+
+export { z, BrowserRuntimeError, validateAgentAction, createBrowserTools };
+export type {
+  BrowserRuntimeFramedClient,
+  TBrowserAgentAction,
+} from '@push.rocks/smartbrowser/runtime';
+export type {
+  IFlexToolHandle,
+  IFlexToolProvider,
+  IFlexToolProviderContext,
+} from '@modelprofile.com/flexharness';
+export type {
+  IBrowserToolInput,
+  IToolBrowserContext,
+  IToolBrowserRunOptions,
+  TBrowserToolAction,
+} from '@modelprofile.com/flexharness/tools';

package/ts_browser/readme.md

@@ -0,0 +1,32 @@
+# FlexHarness browser adapter
+
+Install both packages before importing this optional entrypoint:
+
+```sh
+pnpm add @modelprofile.com/flexharness @push.rocks/smartbrowser
+```
+
+Import `BrowserRuntimeFlexToolProvider` from `@modelprofile.com/flexharness/browser` and `BrowserRuntimeFramedClient` from `@push.rocks/smartbrowser/runtime`. Create a fresh client and provider for each Flex run. The host supplies the trusted framed streams and the complete SmartBrowser binding when constructing the client; the provider resolves only the capability token.
+
+```typescript
+import { BrowserRuntimeFlexToolProvider } from '@modelprofile.com/flexharness/browser';
+import { BrowserRuntimeFramedClient } from '@push.rocks/smartbrowser/runtime';
+
+const client = new BrowserRuntimeFramedClient({
+  ...trustedBinding,
+  readable,
+  writable,
+});
+const provider = new BrowserRuntimeFlexToolProvider({
+  client,
+  resolveCapability: () => ({ capabilityToken }),
+});
+```
+
+`trustedBinding`, `readable`, `writable`, and `capabilityToken` are host-provided values. The binding contains the exact project, browser resource, attachment authority and revision, actor, peer, Flex scope, session, run, and channel identities. The provider checks the Flex run's scope, session, and run against the client before resolving or acquiring a capability. SmartBrowser's framed server validates the token against the complete trusted binding.
+
+The provider exposes `navigate`, `snapshot`, `screenshot`, `click`, `fill`, and `press` through the existing `/tools` browser tool. Navigation and input actions request Flex permission as `browser.<action>` with the tool call ID. Snapshot and screenshot are observations and do not request permission. Tool and run cancellation reach the framed client. The returned Flex tool handle releases the capability and closes the client; FlexHarness closes this handle after the run. A screenshot returns bounded artifact metadata, which the host can use for a separate authorized artifact read.
+
+This entrypoint replaces `BrowserRuntimeFlexToolProvider` from `@modelprofile.com/browser-runtime`. Browser resource ownership, capabilities, framed transport, and artifact storage now come from `@push.rocks/smartbrowser/runtime`.
+
+For hosts that used the old client's `client.asToolBrowserContext()`, import `createFramedToolBrowserContext` from this entrypoint and call `createFramedToolBrowserContext(client, runSignal)`. It returns the same `IToolBrowserContext` shape, maps the six supported actions to `executeAgentAction()`, and combines the run signal with each tool invocation's abort signal.

package/ts_browser/tool.context.ts

@@ -0,0 +1,67 @@
+import * as plugins from './plugins.js';
+
+const browserToolInputSchema = plugins.z.strictObject({
+  action: plugins.z.preprocess(
+    (value) => typeof value === 'string' ? value.trim() : value ?? 'snapshot',
+    plugins.z.enum(['navigate', 'snapshot', 'screenshot', 'click', 'fill', 'press']),
+  ),
+  url: plugins.z.string().optional(),
+  selector: plugins.z.string().optional(),
+  text: plugins.z.string().optional(),
+  timeoutMs: plugins.z.number().int().min(100).max(120_000).optional(),
+});
+
+export function createFramedToolBrowserContext(
+  client: plugins.BrowserRuntimeFramedClient,
+  runSignal: AbortSignal,
+): plugins.IToolBrowserContext {
+  return {
+    execute: async (input: plugins.IBrowserToolInput, options?: plugins.IToolBrowserRunOptions) => {
+      const parsed = browserToolInputSchema.safeParse(input);
+      if (!parsed.success) throw new plugins.BrowserRuntimeError('INVALID_INPUT');
+      const { action, url, selector, text, timeoutMs } = parsed.data;
+      let runtimeAction: plugins.TBrowserAgentAction;
+      switch (action) {
+        case 'navigate':
+          runtimeAction = plugins.validateAgentAction({
+            action,
+            url: url ?? '',
+            ...(timeoutMs === undefined ? {} : { timeoutMs }),
+          });
+          break;
+        case 'snapshot':
+        case 'screenshot':
+          runtimeAction = { action };
+          break;
+        case 'click':
+          runtimeAction = plugins.validateAgentAction({
+            action,
+            selector: selector ?? '',
+            ...(timeoutMs === undefined ? {} : { timeoutMs }),
+          });
+          break;
+        case 'fill':
+          runtimeAction = plugins.validateAgentAction({
+            action,
+            selector: selector ?? '',
+            text: text ?? '',
+            ...(timeoutMs === undefined ? {} : { timeoutMs }),
+          });
+          break;
+        case 'press':
+          runtimeAction = plugins.validateAgentAction({
+            action,
+            selector: selector ?? '',
+            key: text ?? '',
+            ...(timeoutMs === undefined ? {} : { timeoutMs }),
+          });
+          break;
+      }
+      const signal = options?.abortSignal
+        ? AbortSignal.any([runSignal, options.abortSignal])
+        : runSignal;
+      signal.throwIfAborted();
+      return client.executeAgentAction(runtimeAction, { signal });
+    },
+  };
+}