@modelprofile.com/flexharness 10.2.1 → 10.4.0

package/dist_ts/00_commitinfo_data.js

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

package/dist_ts/index.d.ts

@@ -4,4 +4,4 @@ export * from './errors.js';
 export * from './interfaces.js';
 export { normalizeJsonValue } from './utils.json.js';
 export { assertFlexProjectManagementSnapshot, assertFlexProjectManagementRecord, assertFlexProjectManagementTombstone, createEmptyFlexProjectManagementSnapshot, } from './utils.projectmanagement.js';
-export { FLEX_SLASH_COMMAND_MAX_INPUT_BYTES, parseSlashCommand, } from './utils.slashcommands.js';
+export { FLEX_SLASH_COMMAND_MAX_INPUT_BYTES, isReservedSlashCommandName, isValidSlashCommandName, parseSlashCommand, } from './utils.slashcommands.js';

package/dist_ts/index.js

@@ -4,5 +4,5 @@ export * from './errors.js';
 export * from './interfaces.js';
 export { normalizeJsonValue } from './utils.json.js';
 export { assertFlexProjectManagementSnapshot, assertFlexProjectManagementRecord, assertFlexProjectManagementTombstone, createEmptyFlexProjectManagementSnapshot, } from './utils.projectmanagement.js';
-export { FLEX_SLASH_COMMAND_MAX_INPUT_BYTES, parseSlashCommand, } from './utils.slashcommands.js';
-//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaW5kZXguanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi90cy9pbmRleC50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFBQSxjQUFjLDBCQUEwQixDQUFDO0FBQ3pDLGNBQWMscUJBQXFCLENBQUM7QUFDcEMsY0FBYyxhQUFhLENBQUM7QUFDNUIsY0FBYyxpQkFBaUIsQ0FBQztBQUNoQyxPQUFPLEVBQUUsa0JBQWtCLEVBQUUsTUFBTSxpQkFBaUIsQ0FBQztBQUNyRCxPQUFPLEVBQ0wsbUNBQW1DLEVBQ25DLGlDQUFpQyxFQUNqQyxvQ0FBb0MsRUFDcEMsd0NBQXdDLEdBQ3pDLE1BQU0sOEJBQThCLENBQUM7QUFDdEMsT0FBTyxFQUNMLGtDQUFrQyxFQUNsQyxpQkFBaUIsR0FDbEIsTUFBTSwwQkFBMEIsQ0FBQyJ9
+export { FLEX_SLASH_COMMAND_MAX_INPUT_BYTES, isReservedSlashCommandName, isValidSlashCommandName, parseSlashCommand, } from './utils.slashcommands.js';
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaW5kZXguanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi90cy9pbmRleC50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFBQSxjQUFjLDBCQUEwQixDQUFDO0FBQ3pDLGNBQWMscUJBQXFCLENBQUM7QUFDcEMsY0FBYyxhQUFhLENBQUM7QUFDNUIsY0FBYyxpQkFBaUIsQ0FBQztBQUNoQyxPQUFPLEVBQUUsa0JBQWtCLEVBQUUsTUFBTSxpQkFBaUIsQ0FBQztBQUNyRCxPQUFPLEVBQ0wsbUNBQW1DLEVBQ25DLGlDQUFpQyxFQUNqQyxvQ0FBb0MsRUFDcEMsd0NBQXdDLEdBQ3pDLE1BQU0sOEJBQThCLENBQUM7QUFDdEMsT0FBTyxFQUNMLGtDQUFrQyxFQUNsQywwQkFBMEIsRUFDMUIsdUJBQXVCLEVBQ3ZCLGlCQUFpQixHQUNsQixNQUFNLDBCQUEwQixDQUFDIn0=

package/dist_ts/utils.slashcommands.js

@@ -1,7 +1,7 @@
 import { FlexHarnessValidationError } from './errors.js';
 export const FLEX_SLASH_COMMAND_MAX_INPUT_BYTES = 768 * 1024;
-const slashCommandNamePattern = /^[a-z][a-z0-9-]{0,63}$/u;
-const slashCommandPattern = /^\/([a-z][a-z0-9-]{0,63})(?:$|(\s+)([\s\S]*))$/u;
+const slashCommandNamePattern = /^[a-z][a-z0-9_-]{0,63}$/u;
+const slashCommandPattern = /^\/([a-z][a-z0-9_-]{0,63})(?:$|(\s+)([\s\S]*))$/u;
 const slashCommandArgumentsPattern = /(?:\[Image\s+\d+\]|"[^"]*"|'[^']*'|[^\s"']+)/gi;
 const slashCommandQuoteTrimPattern = /^["']|["']$/g;
 const slashCommandPlaceholderPattern = /\$(\d+)/g;
@@ -165,4 +165,4 @@ export function expandSlashCommandTemplate(template, rawArguments, arguments_) {
     }
     return expanded;
 }
-//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoidXRpbHMuc2xhc2hjb21tYW5kcy5qcyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uL3RzL3V0aWxzLnNsYXNoY29tbWFuZHMudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBQUEsT0FBTyxFQUFFLDBCQUEwQixFQUFFLE1BQU0sYUFBYSxDQUFDO0FBTXpELE1BQU0sQ0FBQyxNQUFNLGtDQUFrQyxHQUFHLEdBQUcsR0FBRyxJQUFJLENBQUM7QUFFN0QsTUFBTSx1QkFBdUIsR0FBRyx5QkFBeUIsQ0FBQztBQUMxRCxNQUFNLG1CQUFtQixHQUFHLGlEQUFpRCxDQUFDO0FBQzlFLE1BQU0sNEJBQTRCLEdBQUcsZ0RBQWdELENBQUM7QUFDdEYsTUFBTSw0QkFBNEIsR0FBRyxjQUFjLENBQUM7QUFDcEQsTUFBTSw4QkFBOEIsR0FBRyxVQUFVLENBQUM7QUFDbEQsTUFBTSxpQ0FBaUMsR0FBRyxzQkFBc0IsQ0FBQztBQUNqRSxNQUFNLHlCQUF5QixHQUFHLElBQUksR0FBRyxDQUFDLENBQUMsU0FBUyxFQUFFLE1BQU0sRUFBRSxNQUFNLEVBQUUsTUFBTSxDQUFDLENBQUMsQ0FBQztBQUUvRSxNQUFNLENBQUMsTUFBTSxzQ0FBc0MsR0FBRzs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7O0NBa0VyRCxDQUFDO0FBRUYsTUFBTSxVQUFVLHVCQUF1QixDQUFDLElBQVk7SUFDbEQsT0FBTyx1QkFBdUIsQ0FBQyxJQUFJLENBQUMsSUFBSSxDQUFDLENBQUM7QUFDNUMsQ0FBQztBQUVELE1BQU0sVUFBVSwwQkFBMEIsQ0FBQyxJQUFZO0lBQ3JELE9BQU8seUJBQXlCLENBQUMsR0FBRyxDQUFDLElBQUksQ0FBQyxDQUFDO0FBQzdDLENBQUM7QUFFRCxTQUFTLDZCQUE2QixDQUFDLFlBQW9CO0lBQ3pELE1BQU0sTUFBTSxHQUFHLFlBQVksQ0FBQyxLQUFLLENBQUMsNEJBQTRCLENBQUMsSUFBSSxF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
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoidXRpbHMuc2xhc2hjb21tYW5kcy5qcyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uL3RzL3V0aWxzLnNsYXNoY29tbWFuZHMudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBQUEsT0FBTyxFQUFFLDBCQUEwQixFQUFFLE1BQU0sYUFBYSxDQUFDO0FBTXpELE1BQU0sQ0FBQyxNQUFNLGtDQUFrQyxHQUFHLEdBQUcsR0FBRyxJQUFJLENBQUM7QUFFN0QsTUFBTSx1QkFBdUIsR0FBRywwQkFBMEIsQ0FBQztBQUMzRCxNQUFNLG1CQUFtQixHQUFHLGtEQUFrRCxDQUFDO0FBQy9FLE1BQU0sNEJBQTRCLEdBQUcsZ0RBQWdELENBQUM7QUFDdEYsTUFBTSw0QkFBNEIsR0FBRyxjQUFjLENBQUM7QUFDcEQsTUFBTSw4QkFBOEIsR0FBRyxVQUFVLENBQUM7QUFDbEQsTUFBTSxpQ0FBaUMsR0FBRyxzQkFBc0IsQ0FBQztBQUNqRSxNQUFNLHlCQUF5QixHQUFHLElBQUksR0FBRyxDQUFDLENBQUMsU0FBUyxFQUFFLE1BQU0sRUFBRSxNQUFNLEVBQUUsTUFBTSxDQUFDLENBQUMsQ0FBQztBQUUvRSxNQUFNLENBQUMsTUFBTSxzQ0FBc0MsR0FBRzs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7O0NBa0VyRCxDQUFDO0FBRUYsTUFBTSxVQUFVLHVCQUF1QixDQUFDLElBQVk7SUFDbEQsT0FBTyx1QkFBdUIsQ0FBQyxJQUFJLENBQUMsSUFBSSxDQUFDLENBQUM7QUFDNUMsQ0FBQztBQUVELE1BQU0sVUFBVSwwQkFBMEIsQ0FBQyxJQUFZO0lBQ3JELE9BQU8seUJBQXlCLENBQUMsR0FBRyxDQUFDLElBQUksQ0FBQyxDQUFDO0FBQzdDLENBQUM7QUFFRCxTQUFTLDZCQUE2QixDQUFDLFlBQW9CO0lBQ3pELE1BQU0sTUFBTSxHQUFHLFlBQVksQ0FBQyxLQUFLLENBQUMsNEJBQTRCLENBQUMsSUFBSSxF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

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.2.1",
+  "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.2.1",
-    "@modelprofile.com/flexharness-models": "10.2.1",
+    "@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';
@@ -642,7 +649,7 @@ The run takes a steer in at its next step boundary: after the tool results of it
 
 ## Slash Commands
 
-`parseSlashCommand()` is the public strict pure parser. It accepts at most 768 KiB, returns `not-command` for input not starting with `/`, `malformed` for invalid slash syntax, and `parsed` with the exact input, lowercase command name, separator-stripped raw argument text, and OpenCode-compatible quoted tokenization. Command names match `[a-z][a-z0-9-]{0,63}`. Single and double quotes group tokens and are stripped; escapes are not interpreted.
+`parseSlashCommand()` is the public strict pure parser. It accepts at most 768 KiB, returns `not-command` for input not starting with `/`, `malformed` for invalid slash syntax, and `parsed` with the exact input, lowercase command name, separator-stripped raw argument text, and OpenCode-compatible quoted tokenization. Command names match `[a-z][a-z0-9_-]{0,63}`. The public `isValidSlashCommandName(name)` and `isReservedSlashCommandName(name)` helpers let applications validate registration names against the same rules. Single and double quotes group tokens and are stripped; escapes are not interpreted.
 
 Applications register immutable custom commands at construction:
 
@@ -688,7 +695,7 @@ const harness = new FlexHarness({
 
 `compact`, `init`, `undo`, and `redo` are reserved. `listSlashCommands()` verifies the scope and session and returns immutable data-only descriptors with `kind`, placeholder `hints`, current immediate availability, and `workspaceReversion`. `compact`, `undo`, `redo`, and custom handlers require an otherwise idle command session. Prompt templates and `init` use the normal bounded FIFO and may wait behind an active prompt. Their descriptors report availability from the same queue-admission conditions used by execution: lifecycle, slash ownership, pending reversion, root-session eligibility, outstanding count, and estimated prompt bytes. A dynamic capacity race may still produce `FlexHarnessQueueFullError` during admission. Only one slash-command execution may own a session at a time.
 
-At most 128 custom commands may be registered. Every registration must be a plain object with exactly one of `template` or `handler`; names must match `[a-z][a-z0-9-]{0,63}`, be unique, and not use a reserved name. Optional descriptions must be non-empty and at most 2048 UTF-8 bytes. Templates must be non-empty and at most 768 KiB, and the expanded prompt must also fit 768 KiB. Registrations are copied and frozen during construction.
+At most 128 custom commands may be registered. Every registration must be a plain object with exactly one of `template` or `handler`; names must match `[a-z][a-z0-9_-]{0,63}`, be unique, and not use a reserved name. Optional descriptions must be non-empty and at most 2048 UTF-8 bytes. Templates must be non-empty and at most 768 KiB, and the expanded prompt must also fit 768 KiB. Registrations are copied and frozen during construction.
 
 `/undo` and `/redo`, plus `undoSession()` and `redoSession()`, move a durable history cursor. The direct methods return `{ revertedRunId }` and `{ restoredRunId }`; the slash forms return `{ type: 'operation', name: 'undo' | 'redo' }`. Each committed cursor move emits one `session.history.changed` event with `direction`, `runId`, and the selected session identity. A committed branch emits the same event with `direction: 'branch'` and no `runId`, so controllers should refresh the complete selected session. Capture finalization, cleanup, and metadata-only changes do not emit this event.
 

package/ts/00_commitinfo_data.ts

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

package/ts/index.ts

@@ -11,5 +11,7 @@ export {
 } from './utils.projectmanagement.js';
 export {
   FLEX_SLASH_COMMAND_MAX_INPUT_BYTES,
+  isReservedSlashCommandName,
+  isValidSlashCommandName,
   parseSlashCommand,
 } from './utils.slashcommands.js';

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';
@@ -642,7 +649,7 @@ The run takes a steer in at its next step boundary: after the tool results of it
 
 ## Slash Commands
 
-`parseSlashCommand()` is the public strict pure parser. It accepts at most 768 KiB, returns `not-command` for input not starting with `/`, `malformed` for invalid slash syntax, and `parsed` with the exact input, lowercase command name, separator-stripped raw argument text, and OpenCode-compatible quoted tokenization. Command names match `[a-z][a-z0-9-]{0,63}`. Single and double quotes group tokens and are stripped; escapes are not interpreted.
+`parseSlashCommand()` is the public strict pure parser. It accepts at most 768 KiB, returns `not-command` for input not starting with `/`, `malformed` for invalid slash syntax, and `parsed` with the exact input, lowercase command name, separator-stripped raw argument text, and OpenCode-compatible quoted tokenization. Command names match `[a-z][a-z0-9_-]{0,63}`. The public `isValidSlashCommandName(name)` and `isReservedSlashCommandName(name)` helpers let applications validate registration names against the same rules. Single and double quotes group tokens and are stripped; escapes are not interpreted.
 
 Applications register immutable custom commands at construction:
 
@@ -688,7 +695,7 @@ const harness = new FlexHarness({
 
 `compact`, `init`, `undo`, and `redo` are reserved. `listSlashCommands()` verifies the scope and session and returns immutable data-only descriptors with `kind`, placeholder `hints`, current immediate availability, and `workspaceReversion`. `compact`, `undo`, `redo`, and custom handlers require an otherwise idle command session. Prompt templates and `init` use the normal bounded FIFO and may wait behind an active prompt. Their descriptors report availability from the same queue-admission conditions used by execution: lifecycle, slash ownership, pending reversion, root-session eligibility, outstanding count, and estimated prompt bytes. A dynamic capacity race may still produce `FlexHarnessQueueFullError` during admission. Only one slash-command execution may own a session at a time.
 
-At most 128 custom commands may be registered. Every registration must be a plain object with exactly one of `template` or `handler`; names must match `[a-z][a-z0-9-]{0,63}`, be unique, and not use a reserved name. Optional descriptions must be non-empty and at most 2048 UTF-8 bytes. Templates must be non-empty and at most 768 KiB, and the expanded prompt must also fit 768 KiB. Registrations are copied and frozen during construction.
+At most 128 custom commands may be registered. Every registration must be a plain object with exactly one of `template` or `handler`; names must match `[a-z][a-z0-9_-]{0,63}`, be unique, and not use a reserved name. Optional descriptions must be non-empty and at most 2048 UTF-8 bytes. Templates must be non-empty and at most 768 KiB, and the expanded prompt must also fit 768 KiB. Registrations are copied and frozen during construction.
 
 `/undo` and `/redo`, plus `undoSession()` and `redoSession()`, move a durable history cursor. The direct methods return `{ revertedRunId }` and `{ restoredRunId }`; the slash forms return `{ type: 'operation', name: 'undo' | 'redo' }`. Each committed cursor move emits one `session.history.changed` event with `direction`, `runId`, and the selected session identity. A committed branch emits the same event with `direction: 'branch'` and no `runId`, so controllers should refresh the complete selected session. Capture finalization, cleanup, and metadata-only changes do not emit this event.
 

package/ts/utils.slashcommands.ts

@@ -6,8 +6,8 @@ import type {
 
 export const FLEX_SLASH_COMMAND_MAX_INPUT_BYTES = 768 * 1024;
 
-const slashCommandNamePattern = /^[a-z][a-z0-9-]{0,63}$/u;
-const slashCommandPattern = /^\/([a-z][a-z0-9-]{0,63})(?:$|(\s+)([\s\S]*))$/u;
+const slashCommandNamePattern = /^[a-z][a-z0-9_-]{0,63}$/u;
+const slashCommandPattern = /^\/([a-z][a-z0-9_-]{0,63})(?:$|(\s+)([\s\S]*))$/u;
 const slashCommandArgumentsPattern = /(?:\[Image\s+\d+\]|"[^"]*"|'[^']*'|[^\s"']+)/gi;
 const slashCommandQuoteTrimPattern = /^["']|["']$/g;
 const slashCommandPlaceholderPattern = /\$(\d+)/g;

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 });
+    },
+  };
+}