@modelprofile.com/flexharness 10.12.0 → 10.13.0

package/dist_ts/utils.schemadeclarations.js

@@ -0,0 +1,315 @@
+/**
+ * Renders JSON Schema as TypeScript declarations for the tool catalog. The output depends only on
+ * the schema, so the same schema always renders to the same bytes.
+ */
+const identifierPattern = /^[A-Za-z_$][A-Za-z0-9_$]*$/;
+const maxRenderDepth = 32;
+const maxInlineObjectCharacters = 100;
+const maxSafeInteger = Number.MAX_SAFE_INTEGER;
+export const isSchemaRecord = (value) => typeof value === 'object' && value !== null && !Array.isArray(value);
+export const isIdentifier = (value) => identifierPattern.test(value);
+const literal = (value) => {
+    if (typeof value === 'string')
+        return JSON.stringify(value);
+    if (typeof value === 'number' && Number.isFinite(value))
+        return String(value);
+    if (typeof value === 'boolean' || value === null)
+        return String(value);
+    return 'unknown';
+};
+/**
+ * Reports whether `character` occurs outside brackets, braces, parentheses, string literals and
+ * comments.
+ */
+const hasTopLevel = (text, character) => {
+    let depth = 0;
+    let quote;
+    for (let index = 0; index < text.length; index++) {
+        const current = text[index];
+        if (quote) {
+            if (current === '\\')
+                index++;
+            else if (current === quote)
+                quote = undefined;
+            continue;
+        }
+        if (current === '/' && text[index + 1] === '*') {
+            const end = text.indexOf('*/', index + 2);
+            if (end === -1)
+                return false;
+            index = end + 1;
+            continue;
+        }
+        if (current === '"' || current === "'")
+            quote = current;
+        else if (current === '{' || current === '[' || current === '(' || current === '<')
+            depth++;
+        else if (current === '}' || current === ']' || current === ')' || current === '>')
+            depth--;
+        else if (depth === 0 && current === character)
+            return true;
+    }
+    return false;
+};
+const union = (parts) => {
+    const unique = [...new Set(parts)];
+    if (unique.includes('unknown'))
+        return 'unknown';
+    const withoutNever = unique.length > 1 ? unique.filter((part) => part !== 'never') : unique;
+    return withoutNever.join(' | ');
+};
+const intersection = (parts) => {
+    const unique = [...new Set(parts)].filter((part) => part !== 'unknown');
+    if (unique.length === 0)
+        return 'unknown';
+    return unique.map((part) => hasTopLevel(part, '|') ? `(${part})` : part).join(' & ');
+};
+const arrayOf = (element) => hasTopLevel(element, '|') || hasTopLevel(element, '&') ? `(${element})[]` : `${element}[]`;
+const propertyKey = (name) => isIdentifier(name) ? name : JSON.stringify(name);
+/** A JSDoc block at `indent`; a short single line stays on one line. */
+export const docBlock = (text, indent) => {
+    const lines = text.replace(/\*\//g, '*\\/').split('\n').map((line) => line.trimEnd());
+    if (lines.length === 1 && indent.length + lines[0].length <= 100)
+        return `${indent}/** ${lines[0]} */\n`;
+    return `${indent}/**\n${lines.map((line) => line ? `${indent} * ${line}` : `${indent} *`).join('\n')}\n${indent} */\n`;
+};
+export const countOf = (count, unit) => `${count} ${unit}${count === 1 ? '' : 's'}`;
+/** Constraints a TypeScript type cannot state, in a short readable form. */
+const constraintsOf = (schema) => {
+    const constraints = [];
+    const types = Array.isArray(schema.type) ? schema.type : [schema.type];
+    if (types.includes('integer'))
+        constraints.push('integer');
+    if (typeof schema.format === 'string')
+        constraints.push(`format ${schema.format}`);
+    const bound = (value) => typeof value === 'number' && Number.isFinite(value) && Math.abs(value) !== maxSafeInteger;
+    if (bound(schema.exclusiveMinimum))
+        constraints.push(`> ${schema.exclusiveMinimum}`);
+    else if (bound(schema.minimum))
+        constraints.push(`${schema.exclusiveMinimum === true ? '>' : '>='} ${schema.minimum}`);
+    if (bound(schema.exclusiveMaximum))
+        constraints.push(`< ${schema.exclusiveMaximum}`);
+    else if (bound(schema.maximum))
+        constraints.push(`${schema.exclusiveMaximum === true ? '<' : '<='} ${schema.maximum}`);
+    if (bound(schema.multipleOf))
+        constraints.push(`multiple of ${schema.multipleOf}`);
+    const range = (min, max, unit) => {
+        const hasMin = bound(min) && min > 0;
+        const hasMax = bound(max);
+        if (hasMin && hasMax)
+            constraints.push(min === max ? countOf(min, unit) : `${min}-${countOf(max, unit)}`);
+        else if (hasMin)
+            constraints.push(`at least ${countOf(min, unit)}`);
+        else if (hasMax)
+            constraints.push(`at most ${countOf(max, unit)}`);
+    };
+    range(schema.minLength, schema.maxLength, 'character');
+    range(schema.minItems, schema.maxItems, 'item');
+    if (schema.uniqueItems === true)
+        constraints.push('unique items');
+    if (typeof schema.pattern === 'string')
+        constraints.push(`pattern /${schema.pattern}/`);
+    if (schema.default !== undefined) {
+        const value = JSON.stringify(schema.default);
+        if (value !== undefined && value.length <= 60)
+            constraints.push(`default ${value}`);
+    }
+    if (schema.deprecated === true)
+        constraints.push('deprecated');
+    return constraints;
+};
+/** The documentation of a property: its description and the constraints its type cannot state. */
+export const schemaDoc = (schema, description) => {
+    if (!isSchemaRecord(schema))
+        return description?.trim() || undefined;
+    const text = (description ?? (typeof schema.description === 'string' ? schema.description : '')).trim();
+    const constraints = constraintsOf(schema);
+    if (constraints.length === 0)
+        return text || undefined;
+    return text ? `${text} (${constraints.join(', ')})` : constraints.join(', ');
+};
+export class SchemaDeclarationWriter {
+    context;
+    used = new Set();
+    inlining = new Set();
+    constructor(context) {
+        this.context = context;
+    }
+    get usedTypes() {
+        return [...this.used].sort();
+    }
+    /** The TypeScript type of `schema`, with continuation lines indented relative to `indent`. */
+    type(schema, indent = '', depth = 0, omitMemberDocs = false) {
+        if (depth > maxRenderDepth)
+            return 'unknown';
+        if (schema === true)
+            return 'unknown';
+        if (schema === false)
+            return 'never';
+        if (!isSchemaRecord(schema))
+            return 'unknown';
+        const base = this.baseType(schema, indent, depth, omitMemberDocs);
+        return schema.nullable === true ? union([base, 'null']) : base;
+    }
+    /** The members of an object schema; undefined when the schema is not a plain object type. */
+    objectMembers(schema) {
+        if (!isSchemaRecord(schema) || !this.isPlainObject(schema))
+            return undefined;
+        const properties = isSchemaRecord(schema.properties) ? schema.properties : {};
+        return Object.entries(properties).map(([name, property]) => {
+            const doc = schemaDoc(property);
+            return { name, ...(doc === undefined ? {} : { doc }) };
+        });
+    }
+    /** Whether an object schema requires none of its properties. */
+    hasNoRequiredProperties(schema) {
+        return isSchemaRecord(schema)
+            && this.isPlainObject(schema)
+            && !(Array.isArray(schema.required) && schema.required.length > 0);
+    }
+    /** `interface Name { … }` for a plain object schema, otherwise `type Name = …;`. */
+    namedDeclaration(name, schema, description) {
+        const doc = isSchemaRecord(schema)
+            ? (description ?? (typeof schema.description === 'string' ? schema.description : undefined))?.trim()
+            : description?.trim();
+        const prefix = doc ? docBlock(doc, '') : '';
+        if (isSchemaRecord(schema) && this.isPlainObject(schema) && schema.nullable !== true) {
+            return `${prefix}interface ${name} ${this.objectType(schema, '', 0, false)}`;
+        }
+        return `${prefix}type ${name} = ${this.type(schema, '', 0)};`;
+    }
+    isPlainObject(schema) {
+        if (schema.$ref !== undefined || 'const' in schema || schema.enum !== undefined)
+            return false;
+        if (schema.anyOf !== undefined || schema.oneOf !== undefined || schema.allOf !== undefined)
+            return false;
+        if (schema.type === 'object')
+            return true;
+        return schema.type === undefined && isSchemaRecord(schema.properties);
+    }
+    baseType(schema, indent, depth, omitMemberDocs) {
+        if (typeof schema.$ref === 'string')
+            return this.reference(schema.$ref, indent, depth);
+        if ('const' in schema)
+            return literal(schema.const);
+        if (Array.isArray(schema.enum))
+            return schema.enum.length ? union(schema.enum.map(literal)) : 'never';
+        const alternatives = Array.isArray(schema.anyOf) ? schema.anyOf : Array.isArray(schema.oneOf) ? schema.oneOf : undefined;
+        if (alternatives?.length) {
+            return union(alternatives.map((alternative) => this.type(alternative, indent, depth + 1)));
+        }
+        if (Array.isArray(schema.allOf) && schema.allOf.length) {
+            const own = { ...schema };
+            delete own.allOf;
+            const hasOwnShape = own.type !== undefined || own.properties !== undefined;
+            return intersection([
+                ...schema.allOf.map((part) => this.type(part, indent, depth + 1)),
+                ...(hasOwnShape ? [this.type(own, indent, depth + 1)] : []),
+            ]);
+        }
+        const types = Array.isArray(schema.type)
+            ? schema.type.filter((type) => typeof type === 'string')
+            : typeof schema.type === 'string'
+                ? [schema.type]
+                : this.inferredTypes(schema);
+        if (types.length === 0)
+            return 'unknown';
+        return union(types.map((type) => {
+            switch (type) {
+                case 'string': return 'string';
+                case 'number':
+                case 'integer': return 'number';
+                case 'boolean': return 'boolean';
+                case 'null': return 'null';
+                case 'array': return this.arrayType(schema, indent, depth);
+                case 'object': return this.objectType(schema, indent, depth, omitMemberDocs);
+                default: return 'unknown';
+            }
+        }));
+    }
+    inferredTypes(schema) {
+        if (schema.properties !== undefined
+            || schema.additionalProperties !== undefined
+            || schema.patternProperties !== undefined
+            || schema.required !== undefined)
+            return ['object'];
+        if (schema.items !== undefined || schema.prefixItems !== undefined)
+            return ['array'];
+        return [];
+    }
+    reference(ref, indent, depth) {
+        const name = this.context.namedType(ref);
+        if (name) {
+            this.used.add(name);
+            return name;
+        }
+        const target = this.context.resolve(ref);
+        if (target === undefined || this.inlining.has(ref))
+            return 'unknown';
+        this.inlining.add(ref);
+        try {
+            return this.type(target, indent, depth + 1);
+        }
+        finally {
+            this.inlining.delete(ref);
+        }
+    }
+    arrayType(schema, indent, depth) {
+        const tuple = Array.isArray(schema.prefixItems)
+            ? schema.prefixItems
+            : Array.isArray(schema.items) ? schema.items : undefined;
+        if (tuple) {
+            const rest = Array.isArray(schema.prefixItems) ? schema.items : schema.additionalItems;
+            const members = tuple.map((item) => this.type(item, indent, depth + 1));
+            if (rest !== undefined && rest !== false) {
+                members.push(`...${arrayOf(this.type(rest, indent, depth + 1))}`);
+            }
+            return `[${members.join(', ')}]`;
+        }
+        if (schema.items === undefined)
+            return 'unknown[]';
+        return arrayOf(this.type(schema.items, indent, depth + 1));
+    }
+    objectType(schema, indent, depth, omitMemberDocs) {
+        const memberIndent = `${indent}  `;
+        const properties = isSchemaRecord(schema.properties) ? schema.properties : {};
+        const required = new Set(Array.isArray(schema.required)
+            ? schema.required.filter((name) => typeof name === 'string')
+            : []);
+        const members = [];
+        for (const [name, property] of Object.entries(properties)) {
+            const type = this.type(property, memberIndent, depth + 1);
+            const doc = omitMemberDocs ? undefined : schemaDoc(property);
+            members.push({
+                ...(doc === undefined ? {} : { doc }),
+                text: `${propertyKey(name)}${required.has(name) ? '' : '?'}: ${type}`,
+            });
+        }
+        const indexTypes = [];
+        if (isSchemaRecord(schema.patternProperties)) {
+            for (const property of Object.values(schema.patternProperties)) {
+                indexTypes.push(this.type(property, memberIndent, depth + 1));
+            }
+        }
+        if (isSchemaRecord(schema.additionalProperties)) {
+            indexTypes.push(this.type(schema.additionalProperties, memberIndent, depth + 1));
+        }
+        else if (schema.additionalProperties === true && members.length > 0) {
+            indexTypes.push('unknown');
+        }
+        if (indexTypes.length)
+            members.push({ text: `[key: string]: ${union(indexTypes)}` });
+        if (members.length === 0)
+            return schema.additionalProperties === false ? '{}' : 'Record<string, unknown>';
+        if (members.every((member) => member.doc === undefined && !member.text.includes('\n'))) {
+            const inline = `{ ${members.map((member) => member.text).join('; ')} }`;
+            if (inline.length <= maxInlineObjectCharacters)
+                return inline;
+        }
+        const lines = members.map((member) => `${member.doc === undefined ? '' : docBlock(member.doc, memberIndent)}${memberIndent}${member.text};`);
+        return `{\n${lines.join('\n')}\n${indent}}`;
+    }
+}
+/** Indents every non-empty line of `text`. */
+export const indentLines = (text, indent) => text.split('\n').map((line) => line ? `${indent}${line}` : line).join('\n');
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoidXRpbHMuc2NoZW1hZGVjbGFyYXRpb25zLmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vdHMvdXRpbHMuc2NoZW1hZGVjbGFyYXRpb25zLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQUFBOzs7R0FHRztBQWlCSCxNQUFNLGlCQUFpQixHQUFHLDRCQUE0QixDQUFDO0FBQ3ZELE1BQU0sY0FBYyxHQUFHLEVBQUUsQ0FBQztBQUMxQixNQUFNLHlCQUF5QixHQUFHLEdBQUcsQ0FBQztBQUN0QyxNQUFNLGNBQWMsR0FBRyxNQUFNLENBQUMsZ0JBQWdCLENBQUM7QUFFL0MsTUFBTSxDQUFDLE1BQU0sY0FBYyxHQUFHLENBQUMsS0FBYyxFQUF1QyxFQUFFLENBQ3BGLE9BQU8sS0FBSyxLQUFLLFFBQVEsSUFBSSxLQUFLLEtBQUssSUFBSSxJQUFJLENBQUMsS0FBSyxDQUFDLE9BQU8sQ0FBQyxLQUFLLENBQUMsQ0FBQztBQUV2RSxNQUFNLENBQUMsTUFBTSxZQUFZLEdBQUcsQ0FBQyxLQUFhLEVBQVcsRUFBRSxDQUFDLGlCQUFpQixDQUFDLElBQUksQ0FBQyxLQUFLLENBQUMsQ0FBQztBQUV0RixNQUFNLE9BQU8sR0FBRyxDQUFDLEtBQWMsRUFBVSxFQUFFO0lBQ3pDLElBQUksT0FBTyxLQUFLLEtBQUssUUFBUTtRQUFFLE9BQU8sSUFBSSxDQUFDLFNBQVMsQ0FBQyxLQUFLLENBQUMsQ0FBQztJQUM1RCxJQUFJLE9BQU8sS0FBSyxLQUFLLFFBQVEsSUFBSSxNQUFNLENBQUMsUUFBUSxDQUFDLEtBQUssQ0FBQztRQUFFLE9BQU8sTUFBTSxDQUFDLEtBQUssQ0FBQyxDQUFDO0lBQzlFLElBQUksT0FBTyxLQUFLLEtBQUssU0FBUyxJQUFJLEtBQUssS0FBSyxJQUFJO1FBQUUsT0FBTyxNQUFNLENBQUMsS0FBSyxDQUFDLENBQUM7SUFDdkUsT0FBTyxTQUFTLENBQUM7QUFDbkIsQ0FBQyxDQUFDO0FBRUY7OztHQUdHO0FBQ0gsTUFBTSxXQUFXLEdBQUcs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

package/package.json

@@ -2,7 +2,7 @@
   "author": "Task Venture Capital GmbH",
   "license": "MIT",
   "name": "@modelprofile.com/flexharness",
-  "version": "10.12.0",
+  "version": "10.13.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",
@@ -74,8 +74,9 @@
     }
   },
   "dependencies": {
-    "@modelprofile.com/flexharness-agent": "10.12.0",
-    "@modelprofile.com/flexharness-models": "10.12.0",
+    "@cfworker/json-schema": "^4.1.1",
+    "@modelprofile.com/flexharness-agent": "10.13.0",
+    "@modelprofile.com/flexharness-models": "10.13.0",
     "@push.rocks/smartrequest": "^5.5.1",
     "ai": "^7.0.111",
     "zod": "^4.6.5"

package/ts/00_commitinfo_data.ts

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

package/ts/classes.flexharness.ts

@@ -29,7 +29,13 @@ import {
   FLEX_REVERSION_WORKSPACE_ID_MAX_BYTES,
   FLEX_REVERSION_WORKSPACE_LABEL_MAX_BYTES,
   FLEX_SESSION_IMPORT_MAX_DEPTH,
+  FLEX_TOOL_CATALOG_TOOL_NAMES,
 } from './interfaces.js';
+import {
+  FlexToolCatalog,
+  assertNoCatalogCollisions,
+  catalogToolInputSchema,
+} from './classes.toolcatalog.js';
 import type {
   IFlexAgentContextCompactionOptions,
   IFlexAgentContextInvocation,
@@ -112,6 +118,9 @@ import type {
   IFlexSubagentDefinition,
   IFlexSubagentProvenance,
   IFlexTerminalProjection,
+  IFlexCatalogDescribeInput,
+  IFlexCatalogSearchInput,
+  IFlexToolCatalogOptions,
   IFlexToolHandle,
   IFlexToolMessagePart,
   IFlexToolProviderContext,
@@ -168,6 +177,7 @@ import {
   normalizeAgentSessionPolicy,
   normalizeBuiltInTools,
   normalizeSlashCommands,
+  normalizeToolCatalogOptions,
   normalizeSubagents,
   requireHarnessStores,
   resolveBoundedPositiveInteger,
@@ -431,6 +441,10 @@ interface IActiveRun {
   reservedUserMessage?: IFlexMessage;
   reservedAssistantMessage?: IFlexMessage;
   modelResolution?: IFlexResolvedModel;
+  /** The tool-provider context of the run, passed to catalog methods. */
+  toolProviderContext?: Readonly<IFlexToolProviderContext<unknown>>;
+  /** The catalog methods the run offers through search_tools, describe_tools and execute. */
+  toolCatalog?: FlexToolCatalog<unknown>;
   subagents: ReadonlyMap<string, Readonly<IFlexSubagentDefinition>>;
   allowedTools?: readonly string[];
   agentAllowedTools?: readonly string[];
@@ -851,6 +865,7 @@ export class FlexHarness<TScope = unknown> {
   private readonly externalErrorProjector?: TFlexExternalErrorProjector;
   private readonly subagents: ReadonlyMap<string, Readonly<IFlexSubagentDefinition>>;
   private readonly builtInTools: INormalizedBuiltInTools;
+  private readonly toolCatalogOptions: Readonly<Required<IFlexToolCatalogOptions>>;
   private readonly slashCommands: ReadonlyMap<string, TRegisteredSlashCommand<TScope>>;
   private readonly maxSubagentDepth: number;
   private readonly maxSubagentCallsPerRun: number;
@@ -937,6 +952,7 @@ export class FlexHarness<TScope = unknown> {
     this.externalErrorProjector = options.externalErrorProjector;
     this.subagents = normalizeSubagents(options.subagents);
     this.builtInTools = normalizeBuiltInTools(options.builtInTools);
+    this.toolCatalogOptions = normalizeToolCatalogOptions(options.toolCatalog);
     this.slashCommands = normalizeSlashCommands(options.slashCommands);
     this.maxSubagentDepth = resolveBoundedPositiveInteger(
       options.maxSubagentDepth,
@@ -5823,18 +5839,37 @@ export class FlexHarness<TScope = unknown> {
       }
       signal.throwIfAborted();
       run.modelResolution = model!;
+      run.toolProviderContext = toolProviderContext as Readonly<IFlexToolProviderContext<unknown>>;
+      let catalog: FlexToolCatalog<unknown> | undefined;
+      if (toolHandle?.catalog) {
+        try {
+          catalog = await FlexToolCatalog.create(toolHandle.catalog, this.toolCatalogOptions);
+        } catch (error) {
+          throw this.projectExternalError(run, error, 'toolProvider');
+        }
+        signal.throwIfAborted();
+      }
       let tools: TFlexAgentToolSet | undefined;
       try {
         const providedTools = toolHandle?.tools;
         const combinedTools: Record<string, unknown> = { ...(providedTools ?? {}) };
         Object.assign(combinedTools, this.createBuiltInTools(run));
+        if (catalog) assertNoCatalogCollisions(catalog, combinedTools);
         const globalNames = run.allowedTools === undefined ? undefined : new Set(run.allowedTools);
         const agentNames = run.agentAllowedTools === undefined ? undefined : new Set(run.agentAllowedTools);
+        const admitted = (name: string): boolean =>
+          (globalNames === undefined || globalNames.has(name))
+          && (agentNames === undefined || agentNames.has(name));
         const admittedTools = globalNames === undefined && agentNames === undefined
           ? combinedTools
-          : Object.fromEntries(Object.entries(combinedTools).filter(([name]) =>
-              (globalNames === undefined || globalNames.has(name))
-              && (agentNames === undefined || agentNames.has(name))));
+          : Object.fromEntries(Object.entries(combinedTools).filter(([name]) => admitted(name)));
+        const admittedCatalog = catalog && (globalNames === undefined && agentNames === undefined
+          ? catalog
+          : catalog.restrict(catalog.methods.filter(admitted)));
+        if (admittedCatalog && admittedCatalog.methods.length > 0) {
+          run.toolCatalog = admittedCatalog;
+          Object.assign(admittedTools, this.createCatalogTools(run, admittedCatalog));
+        }
         tools = Object.keys(admittedTools).length > 0
           ? wrapToolSet(
               admittedTools as TFlexAgentToolSet,
@@ -5913,6 +5948,59 @@ export class FlexHarness<TScope = unknown> {
     }
   }
 
+  /**
+   * search_tools, describe_tools and execute. `execute` validates the call and runs the method
+   * inside this tool call, so the tool wrapper bounds its output and projects its errors, and the
+   * call's part, events and permission requests carry the method's path.
+   */
+  private createCatalogTools(run: IActiveRun, catalog: FlexToolCatalog<unknown>): Record<string, unknown> {
+    const names = FLEX_TOOL_CATALOG_TOOL_NAMES;
+    const definitions = catalog.toolDefinitions();
+    const describeBytes = Math.max(1024, this.toolOutputLimits.maxBytes - 1024);
+    return {
+      [names.search]: plugins.tool({
+        description: definitions[names.search].description,
+        strict: false,
+        inputSchema: catalogToolInputSchema<IFlexCatalogSearchInput>(definitions[names.search]),
+        execute: async (input: IFlexCatalogSearchInput) => catalog.search(input),
+      }),
+      [names.describe]: plugins.tool({
+        description: definitions[names.describe].description,
+        strict: false,
+        inputSchema: catalogToolInputSchema<IFlexCatalogDescribeInput>(definitions[names.describe]),
+        execute: async (input: IFlexCatalogDescribeInput, options?: { messages?: plugins.ModelMessage[] }) =>
+          catalog.describe(input, {
+            declaredTypes: catalog.declaredTypesIn(options?.messages),
+            maxBytes: describeBytes,
+          }).output,
+      }),
+      [names.execute]: plugins.tool({
+        description: definitions[names.execute].description,
+        strict: false,
+        inputSchema: catalogToolInputSchema<{ method: string; params?: Record<string, unknown> }>(
+          definitions[names.execute],
+        ),
+        execute: async (
+          input: { method: string; params?: Record<string, unknown> },
+          options?: { toolCallId?: string; abortSignal?: AbortSignal },
+        ) => {
+          const call = await catalog.prepareCall(input.method, input.params);
+          if (!call.success) {
+            const error = this.trustInternalError(new FlexHarnessValidationError(JSON.stringify(call.error)));
+            if (options?.toolCallId) run.trustedToolExecutionErrors.set(options.toolCallId, error);
+            throw error;
+          }
+          return call.run({
+            method: call.method,
+            toolCallId: options?.toolCallId ?? '',
+            abortSignal: options?.abortSignal ?? run.controller.signal,
+            provider: run.toolProviderContext!,
+          });
+        },
+      }),
+    };
+  }
+
   private createBuiltInTools(run: IActiveRun): Record<string, unknown> {
     const tools: Record<string, unknown> = {};
     if (run.subagents.size > 0 && (run.stored.session.depth ?? 0) < this.maxSubagentDepth) {
@@ -8422,13 +8510,17 @@ export class FlexHarness<TScope = unknown> {
     const run = this.callbackRun(state, sessionId);
     if (!run || run.toolPartIds.has(event.toolCallId)) return;
     try {
-      const input = normalizeJsonValue(event.input, this.toolOutputLimits);
+      // An execute call is the call of the catalog method it names.
+      const target = event.toolName === FLEX_TOOL_CATALOG_TOOL_NAMES.execute
+        ? run.toolCatalog?.callTarget(event.input)
+        : undefined;
+      const input = normalizeJsonValue(target ? target.params : event.input, this.toolOutputLimits);
       if (!this.reserveCallbackCapacity(run, 1, jsonBytes(input), 1)) return;
       const part: IFlexToolMessagePart = {
         partId: plugins.crypto.randomUUID(),
         type: 'tool',
         toolCallId: this.boundedIdentifier(event.toolCallId, 'toolCallId'),
-        toolName: this.boundedIdentifier(event.toolName, 'toolName'),
+        toolName: this.boundedIdentifier(target ? target.method : event.toolName, 'toolName'),
         status: 'running',
         input,
         startedAt: new Date().toISOString(),
@@ -9129,9 +9221,14 @@ export class FlexHarness<TScope = unknown> {
       }
       const tools = handle.tools;
       this.assertNoBuiltInToolCollisions(run, tools);
+      const catalog = handle.catalog;
+      if (catalog !== undefined && (typeof catalog !== 'object' || catalog === null)) {
+        throw new FlexHarnessValidationError('Tool handle catalog must be an object.');
+      }
       const closeHandle = close;
       return {
         tools,
+        ...(catalog === undefined ? {} : { catalog }),
         ...(closeHandle ? { close: () => closeHandle.call(handle) } : {}),
       };
     } catch (error) {
@@ -9218,6 +9315,9 @@ export class FlexHarness<TScope = unknown> {
         );
         if (!handle) continue;
         owned.push({ handle, closed: false });
+        if (handle.catalog !== undefined) {
+          throw new FlexHarnessValidationError('Resource tool providers cannot supply a tool catalog.');
+        }
         for (const [toolName, tool] of Object.entries(handle.tools)) {
           const exposedName = createFlexResourceToolName(namespace, toolName);
           if (Object.prototype.hasOwnProperty.call(tools, exposedName)) {
@@ -9229,6 +9329,7 @@ export class FlexHarness<TScope = unknown> {
       if (owned.length === 0 && Object.keys(tools).length === 0) return undefined;
       return {
         tools: tools as TFlexAgentToolSet,
+        ...(applicationHandle?.catalog === undefined ? {} : { catalog: applicationHandle.catalog }),
         ...(owned.some((entry) => entry.handle.close) ? { close: closeOwned } : {}),
       };
     } catch (error) {