@modelprofile.com/flexharness 10.12.0 → 10.14.0

package/dist_ts/index.d.ts

@@ -1,5 +1,6 @@
 export * from './classes.flexharness.js';
 export * from './classes.stores.js';
+export { FlexToolCatalog } from './classes.toolcatalog.js';
 export * from './errors.js';
 export * from './interfaces.js';
 export { normalizeJsonValue } from './utils.json.js';

package/dist_ts/index.js

@@ -1,8 +1,9 @@
 export * from './classes.flexharness.js';
 export * from './classes.stores.js';
+export { FlexToolCatalog } from './classes.toolcatalog.js';
 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, isReservedSlashCommandName, isValidSlashCommandName, parseSlashCommand, } from './utils.slashcommands.js';
-//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaW5kZXguanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi90cy9pbmRleC50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFBQSxjQUFjLDBCQUEwQixDQUFDO0FBQ3pDLGNBQWMscUJBQXFCLENBQUM7QUFDcEMsY0FBYyxhQUFhLENBQUM7QUFDNUIsY0FBYyxpQkFBaUIsQ0FBQztBQUNoQyxPQUFPLEVBQUUsa0JBQWtCLEVBQUUsTUFBTSxpQkFBaUIsQ0FBQztBQUNyRCxPQUFPLEVBQ0wsbUNBQW1DLEVBQ25DLGlDQUFpQyxFQUNqQyxvQ0FBb0MsRUFDcEMsd0NBQXdDLEdBQ3pDLE1BQU0sOEJBQThCLENBQUM7QUFDdEMsT0FBTyxFQUNMLGtDQUFrQyxFQUNsQywwQkFBMEIsRUFDMUIsdUJBQXVCLEVBQ3ZCLGlCQUFpQixHQUNsQixNQUFNLDBCQUEwQixDQUFDIn0=
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaW5kZXguanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi90cy9pbmRleC50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFBQSxjQUFjLDBCQUEwQixDQUFDO0FBQ3pDLGNBQWMscUJBQXFCLENBQUM7QUFDcEMsT0FBTyxFQUFFLGVBQWUsRUFBRSxNQUFNLDBCQUEwQixDQUFDO0FBQzNELGNBQWMsYUFBYSxDQUFDO0FBQzVCLGNBQWMsaUJBQWlCLENBQUM7QUFDaEMsT0FBTyxFQUFFLGtCQUFrQixFQUFFLE1BQU0saUJBQWlCLENBQUM7QUFDckQsT0FBTyxFQUNMLG1DQUFtQyxFQUNuQyxpQ0FBaUMsRUFDakMsb0NBQW9DLEVBQ3BDLHdDQUF3QyxHQUN6QyxNQUFNLDhCQUE4QixDQUFDO0FBQ3RDLE9BQU8sRUFDTCxrQ0FBa0MsRUFDbEMsMEJBQTBCLEVBQzFCLHVCQUF1QixFQUN2QixpQkFBaUIsR0FDbEIsTUFBTSwwQkFBMEIsQ0FBQyJ9

package/dist_ts/interfaces.d.ts

@@ -23,6 +23,8 @@ export type TFlexRetryReason = plugins.TAgentRetryReason;
  * Every call carries `provider` and `requestedModelId`; key usage caps on those two.
  */
 export type TFlexModelCallUsage = plugins.TAgentModelCallUsage;
+/** A model call's usage as harness events carry it: a reported call also states its cache hit ratio. */
+export type TFlexObservedModelCallUsage = plugins.TAgentObservedModelCallUsage;
 export interface IFlexTextPromptPart {
     type: 'text';
     text: string;
@@ -109,6 +111,8 @@ export interface IFlexToolMessagePart {
     output?: TJsonValue;
     error?: string;
     childSessionId?: string;
+    /** For a catalog call a `run_code` program made: the `run_code` call's ID. */
+    parentToolCallId?: string;
     model?: IFlexModelIdentity;
     /** ISO time the tool call began. Absent on parts recorded before part times existed. */
     startedAt?: string;
@@ -531,12 +535,241 @@ export interface IFlexToolProviderContext<TScope> extends IFlexSessionGeneration
     signal: AbortSignal;
     requestPermission(request: IFlexPermissionRequestInput): Promise<void>;
 }
-export interface IFlexToolHandle {
+export interface IFlexToolHandle<TScope = unknown> {
     tools: TFlexAgentToolSet;
+    /**
+     * Methods the model finds with `search_tools`, reads with `describe_tools` and calls with
+     * `execute`, instead of seeing each one as a tool on every step. Return the same object on
+     * every run: FlexHarness prepares a catalog once per object and treats it as immutable.
+     */
+    catalog?: IFlexToolCatalog<TScope>;
     close?(): Promise<void> | void;
 }
 export interface IFlexToolProvider<TScope> {
-    provideTools(context: IFlexToolProviderContext<TScope>): Promise<IFlexToolHandle | undefined> | IFlexToolHandle | undefined;
+    provideTools(context: IFlexToolProviderContext<TScope>): Promise<IFlexToolHandle<TScope> | undefined> | IFlexToolHandle<TScope> | undefined;
+}
+/** The names of the built-in catalog tools, reserved while a run has a catalog. */
+export declare const FLEX_TOOL_CATALOG_TOOL_NAMES: Readonly<{
+    readonly search: "search_tools";
+    readonly describe: "describe_tools";
+    readonly execute: "execute";
+}>;
+export declare const FLEX_TOOL_CATALOG_LIMITS: Readonly<{
+    maxMethods: 4096;
+    maxTypes: 4096;
+    maxMethodPathCharacters: 160;
+    maxMethodPathSegments: 8;
+    maxIdentifierCharacters: 128;
+    maxSummaryCharacters: 120;
+    maxDescriptionBytes: number;
+    maxDeclarationBytes: number;
+    maxTags: 16;
+    maxTagCharacters: 48;
+    maxExamples: 4;
+    maxExampleBytes: 1024;
+    maxSchemaBytes: number;
+    defaultSearchResults: 10;
+    maxSearchResults: 50;
+    maxQueryCharacters: 512;
+    maxDescribeMethods: 16;
+    maxDescribeTypes: 32;
+    maxDescribeBytes: number;
+    maxParamIssues: 10;
+}>;
+export interface IFlexCatalogSearchInput {
+    /** Words to rank methods by. */
+    query?: string;
+    /** A dotted namespace to search in or, without `query`, to list. */
+    namespace?: string;
+    limit?: number;
+    offset?: number;
+}
+export interface IFlexCatalogDescribeInput {
+    /** Dotted method paths. */
+    methods?: readonly string[];
+    /** Named types to declare again or for the first time. */
+    types?: readonly string[];
+}
+export interface IFlexCatalogDescribeResult {
+    /** TypeScript text, or a JSON object in `json-schema` mode. */
+    output: TJsonValue;
+    /** The named types the output declares. */
+    declaredTypes: string[];
+}
+/** One way `execute`'s params miss the method's schema. */
+export interface IFlexCatalogParamIssue {
+    /** Where, such as `params.lines[0].amount`. */
+    path: string;
+    expected: string;
+    /** The given value as compact JSON, or `missing`. */
+    got: string;
+}
+/** What `execute` reports to the model, as JSON, when it cannot call a method. */
+export type TFlexCatalogCallError = {
+    error: 'unknown_method';
+    method: string;
+    didYouMean: string[];
+    hint: string;
+} | {
+    error: 'invalid_params';
+    method: string;
+    issues: IFlexCatalogParamIssue[];
+    /** How many more issues were found than listed. */
+    more?: number;
+    /** The lookup that returns the method's declaration. */
+    see: string;
+} | {
+    error: 'denied';
+    method: string;
+    reason: string;
+};
+export interface IFlexCatalogToolDefinition {
+    description: string;
+    /** The tool's input as JSON Schema. */
+    inputSchema: plugins.JSONSchema7;
+}
+/**
+ * A parameter or result schema: a plain JSON Schema object, or a zod, Standard Schema or AI SDK
+ * schema. `$ref`s to `#/$defs/<Name>` or `#/definitions/<Name>` that the schema does not define name
+ * a catalog type.
+ */
+export type TFlexCatalogSchema = {
+    readonly [keyword: string]: unknown;
+} | plugins.FlexibleSchema<unknown>;
+export interface IFlexCatalogRunContext<TScope = unknown> {
+    /** The dotted path the model called. */
+    readonly method: string;
+    /**
+     * The call's ID, which its tool part and permission requests carry: the `execute` call's, or for
+     * a call inside `run_code` the inner call's, `<run_code call ID>.<n>`.
+     */
+    readonly toolCallId: string;
+    readonly abortSignal: AbortSignal;
+    /** The run's tool-provider context: scope, session, run and `requestPermission`. */
+    readonly provider: Readonly<IFlexToolProviderContext<TScope>>;
+}
+export interface IFlexCatalogMethod<TScope = unknown, TParams = any, TResult = unknown> {
+    /**
+     * The dotted path the model calls, such as `banking.listMovements`: up to 8 segments, each a
+     * JavaScript identifier of letters, digits and `_`.
+     */
+    method: string;
+    /** One line of at most 120 characters, shown in search results. */
+    summary: string;
+    /** The full description, shown with the declaration. */
+    description?: string;
+    /** More words `search_tools` matches. */
+    tags?: readonly string[];
+    /** Code shown as `@example` in the declaration. */
+    examples?: readonly string[];
+    /** The parameter object's schema; `execute` validates every call against it. */
+    inputSchema: TFlexCatalogSchema;
+    /** The result's schema, declared as the method's return type. */
+    outputSchema?: TFlexCatalogSchema;
+    /**
+     * Declaration text that replaces the generated one, such as a declaration built from TypeScript
+     * sources with their JSDoc: `function listMovements(params: …): Promise<…>;`, optionally after
+     * its JSDoc, with the last path segment as the function name.
+     */
+    declaration?: string;
+    /** Runs the method with validated parameters. */
+    run(params: TParams, context: IFlexCatalogRunContext<TScope>): TResult | PromiseLike<TResult> | AsyncIterable<TResult>;
+    /**
+     * Decides each validated call before it runs: `run` (the default without this hook), `propose`
+     * to hand it to the catalog's `onProposals` instead of running it, or `{ deny }` to refuse it.
+     */
+    onCall?(params: TParams, context: IFlexCatalogRunContext<TScope>): TFlexCatalogCallDecision | PromiseLike<TFlexCatalogCallDecision>;
+}
+export type TFlexCatalogCallDecision = 'run' | 'propose' | {
+    deny: string;
+};
+/** A call a method's `onCall` decided to propose instead of running. */
+export interface IFlexCatalogProposal {
+    /** The call's ID: the `execute` call's, or the inner call's inside `run_code`. */
+    id: string;
+    method: string;
+    params: unknown;
+}
+export interface IFlexCatalogProposalContext<TScope = unknown> {
+    /** The `execute` or `run_code` call that made the proposals. */
+    readonly toolCallId: string;
+    readonly abortSignal: AbortSignal;
+    readonly provider: Readonly<IFlexToolProviderContext<TScope>>;
+}
+/** A named type that method declarations refer to; it needs a `declaration`, a `schema`, or both. */
+export interface IFlexCatalogType {
+    /** A JavaScript identifier such as `IMoney`. */
+    name: string;
+    description?: string;
+    /** Validates parameters that refer to this type, and generates its declaration. */
+    schema?: TFlexCatalogSchema;
+    /** Declaration text that replaces the generated one, such as `interface IMoney { … }`. */
+    declaration?: string;
+}
+export interface IFlexToolCatalog<TScope = unknown> {
+    methods: readonly IFlexCatalogMethod<TScope>[];
+    types?: readonly IFlexCatalogType[];
+    /**
+     * Receives the calls `onCall` proposed, as one batch: the proposed call of an `execute`, or every
+     * call a `run_code` program proposed, once the program finished. A failed program proposes
+     * nothing. What it returns is what the model sees for them.
+     */
+    onProposals?(proposals: readonly IFlexCatalogProposal[], context: IFlexCatalogProposalContext<TScope>): unknown;
+}
+export interface IFlexToolCatalogOptions {
+    /**
+     * What `describe_tools` returns: `typescript` (default) declarations with named types shared
+     * across the session, or `json-schema` with each method's self-contained JSON Schema.
+     */
+    declarations?: 'typescript' | 'json-schema';
+    /**
+     * Adds `run_code`, which runs a short TypeScript or JavaScript program against the catalog in a
+     * QuickJS sandbox. Needs the optional peers `quickjs-emscripten-core`,
+     * `@jitl/quickjs-ng-wasmfile-release-sync` and `amaro`.
+     */
+    codeMode?: boolean | IFlexCodeModeOptions;
+}
+export interface IFlexCodeModeOptions {
+    limits?: Partial<IFlexCodeModeLimits>;
+}
+/** The bounds of one `run_code` program. */
+export interface IFlexCodeModeLimits {
+    /** UTF-8 bytes of the program. */
+    maxSourceBytes: number;
+    /** Milliseconds the program may compute; time waiting for calls does not count. */
+    cpuMs: number;
+    /** Milliseconds the program may take in all, not counting waits for a permission decision. */
+    wallMs: number;
+    /** Bytes of the sandbox's heap. */
+    memoryBytes: number;
+    /**
+     * Bytes of the sandbox's stack. QuickJS runs on the host's stack as well, so a larger value lets
+     * deep recursion reach the host's limit first; the program then fails at its `stack` limit all
+     * the same.
+     */
+    stackBytes: number;
+    /** Catalog calls per program. */
+    maxCalls: number;
+    /** Catalog calls running at once; further calls wait for a slot. */
+    maxConcurrentCalls: number;
+    /** UTF-8 bytes of console output kept; more is cut off. */
+    maxLogBytes: number;
+}
+export declare const FLEX_CODE_MODE_TOOL_NAME = "run_code";
+export declare const FLEX_CODE_MODE_DEFAULT_LIMITS: Readonly<IFlexCodeModeLimits>;
+export declare const FLEX_CODE_MODE_MAXIMUM_LIMITS: Readonly<IFlexCodeModeLimits>;
+/** What `run_code` reports to the model, as JSON, when a program does not finish. */
+export interface IFlexCodeRunFailure {
+    error: 'syntax_error' | 'program_error' | 'limit_exceeded' | 'aborted';
+    /** The limit that stopped the program, for `limit_exceeded`. */
+    limit?: 'source' | 'cpu' | 'wall' | 'memory' | 'stack' | 'calls';
+    name?: string;
+    message: string;
+    /** The program's line, when known. */
+    line?: number;
+    /** Catalog calls the program made. */
+    calls: number;
+    logs?: string;
 }
 export interface IFlexResourceToolProviderResolverContext<TScope> extends IFlexSessionGeneration {
     scopeId: string;
@@ -1096,6 +1329,7 @@ export interface IFlexHarnessOptions<TScope> {
     externalErrorProjector?: TFlexExternalErrorProjector;
     subagents?: IFlexSubagentDefinition[];
     builtInTools?: IFlexBuiltInToolsOptions;
+    toolCatalog?: IFlexToolCatalogOptions;
     slashCommands?: readonly TFlexSlashCommandRegistration<TScope>[];
     /** Maximum child depth (root is 0). Defaults to 6; configurable from 1 through 8. */
     maxSubagentDepth?: number;
@@ -1251,7 +1485,7 @@ export type TFlexModelUsageEvent = IFlexEventBase & {
     readonly type: 'model.usage';
     readonly runId?: string;
     readonly source: 'generation' | 'compaction';
-} & Readonly<TFlexModelCallUsage>;
+} & Readonly<TFlexObservedModelCallUsage>;
 export interface IFlexPromptQueueEvent extends IFlexEventBase {
     readonly type: 'prompt.queued' | 'prompt.started' | 'prompt.running' | 'prompt.finished';
     readonly queueId: string;

package/dist_ts/interfaces.js

@@ -16,6 +16,55 @@ export const FLEX_SESSION_IMPORT_MAXIMUM_LIMITS = Object.freeze({
     maxPageBytes: 1536 * 1024,
     stagedImportIdleTimeoutMs: 60 * 60 * 1000,
 });
+/** The names of the built-in catalog tools, reserved while a run has a catalog. */
+export const FLEX_TOOL_CATALOG_TOOL_NAMES = Object.freeze({
+    search: 'search_tools',
+    describe: 'describe_tools',
+    execute: 'execute',
+});
+export const FLEX_TOOL_CATALOG_LIMITS = Object.freeze({
+    maxMethods: 4096,
+    maxTypes: 4096,
+    maxMethodPathCharacters: 160,
+    maxMethodPathSegments: 8,
+    maxIdentifierCharacters: 128,
+    maxSummaryCharacters: 120,
+    maxDescriptionBytes: 16 * 1024,
+    maxDeclarationBytes: 16 * 1024,
+    maxTags: 16,
+    maxTagCharacters: 48,
+    maxExamples: 4,
+    maxExampleBytes: 1024,
+    maxSchemaBytes: 64 * 1024,
+    defaultSearchResults: 10,
+    maxSearchResults: 50,
+    maxQueryCharacters: 512,
+    maxDescribeMethods: 16,
+    maxDescribeTypes: 32,
+    maxDescribeBytes: 64 * 1024,
+    maxParamIssues: 10,
+});
+export const FLEX_CODE_MODE_TOOL_NAME = 'run_code';
+export const FLEX_CODE_MODE_DEFAULT_LIMITS = Object.freeze({
+    maxSourceBytes: 32 * 1024,
+    cpuMs: 5_000,
+    wallMs: 60_000,
+    memoryBytes: 64 * 1024 * 1024,
+    stackBytes: 64 * 1024,
+    maxCalls: 200,
+    maxConcurrentCalls: 8,
+    maxLogBytes: 16 * 1024,
+});
+export const FLEX_CODE_MODE_MAXIMUM_LIMITS = Object.freeze({
+    maxSourceBytes: 256 * 1024,
+    cpuMs: 60_000,
+    wallMs: 30 * 60_000,
+    memoryBytes: 512 * 1024 * 1024,
+    stackBytes: 256 * 1024,
+    maxCalls: 10_000,
+    maxConcurrentCalls: 64,
+    maxLogBytes: 256 * 1024,
+});
 export const FLEX_PROJECT_MANAGEMENT_SCHEMA_VERSION = 1;
 export const FLEX_SESSION_GENERATION_ID_MAX_BYTES = 128;
 export const FLEX_SESSION_GENERATION_COHORT_MAX_ENTRIES = 2048;
@@ -46,4 +95,4 @@ export const FLEX_REVERSION_MAX_AFFECTED_WORKSPACES = 64;
 export const FLEX_REVERSION_WORKSPACE_ID_MAX_BYTES = 512;
 export const FLEX_REVERSION_WORKSPACE_LABEL_MAX_BYTES = 2048;
 export const FLEX_REVERSION_REASON_CODE_MAX_BYTES = 128;
-//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaW50ZXJmYWNlcy5qcyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uL3RzL2ludGVyZmFjZXMudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBeVRBLHlGQUF5RjtBQUN6RixNQUFNLENBQUMsTUFBTSxxQ0FBcUMsR0FBRyxHQUFHLEdBQUcsSUFBSSxDQUFDO0FBQ2hFLE1BQU0sQ0FBQyxNQUFNLHFDQUFxQyxHQUFHLEVBQUUsR0FBRyxJQUFJLENBQUM7QUFDL0QsTUFBTSxDQUFDLE1BQU0sNkJBQTZCLEdBQUcsQ0FBQyxDQUFDO0FBRS9DLE1BQU0sQ0FBQyxNQUFNLGtDQUFrQyxHQUFHLE1BQU0sQ0FBQyxNQUFNLENBQUM7SUFDOUQsY0FBYyxFQUFFLENBQUM7SUFDakIscUJBQXFCLEVBQUUsSUFBSTtJQUMzQixlQUFlLEVBQUUsRUFBRSxHQUFHLElBQUksR0FBRyxJQUFJO0lBQ2pDLFlBQVksRUFBRSxJQUFJLEdBQUcsSUFBSTtJQUN6Qix5QkFBeUIsRUFBRSxDQUFDLEdBQUcsRUFBRSxHQUFHLElBQUk7Q0FDekMsQ0FBQyxDQUFDO0FBRUgsTUFBTSxDQUFDLE1BQU0sa0NBQWtDLEdBQUcsTUFBTSxDQUFDLE1BQU0sQ0FBQztJQUM5RCxjQUFjLEVBQUUsRUFBRTtJQUNsQixxQkFBcUIsRUFBRSxNQUFNO0lBQzdCLGVBQWUsRUFBRSxHQUFHLEdBQUcsSUFBSSxHQUFHLElBQUk7SUFDbEMsWUFBWSxFQUFFLElBQUksR0FBRyxJQUFJO0lBQ3pCLHlCQUF5QixFQUFFLEVBQUUsR0FBRyxFQUFFLEdBQUcsSUFBSTtDQUMxQyxDQUFDLENBQUM7QUFrZkgsTUFBTSxDQUFDLE1BQU0sc0NBQXNDLEdBQUcsQ0FBVSxDQUFDO0FBQ2pFLE1BQU0sQ0FBQyxNQUFNLG9DQUFvQyxHQUFHLEdBQUcsQ0FBQztBQUN4RCxNQUFNLENBQUMsTUFBTSwwQ0FBMEMsR0FBRyxJQUFJLENBQUM7QUFPL0QsTUFBTSxDQUFDLE1BQU0sd0NBQXdDLEdBQUcsSUFBSSxDQUFDO0FBeUQ3RCxNQUFNLENBQUMsTUFBTSw4QkFBOEIsR0FBRyxNQUFNLENBQUMsTUFBTSxDQUFDO0lBQzFELFlBQVksRUFBRSxDQUFDLEdBQUcsSUFBSTtJQUN0QixrQkFBa0IsRUFBRSxHQUFHLEdBQUcsSUFBSTtJQUM5QixtQkFBbUIsRUFBRSxDQUFDLEdBQUcsSUFBSTtJQUM3QixjQUFjLEVBQUUsR0FBRztJQUNuQixRQUFRLEVBQUUsR0FBRztJQUNiLGFBQWEsRUFBRSxJQUFJO0lBQ25CLGdCQUFnQixFQUFFLElBQUksR0FBRyxJQUFJO0NBQzlCLENBQUMsQ0FBQztBQStMSCxNQUFNLENBQUMsTUFBTSw2QkFBNkIsR0FBRyxNQUFNLENBQUMsTUFBTSxDQUFDO0lBQ3pELGlCQUFpQixFQUFFLEdBQUc7SUFDdEIsV0FBVyxFQUFFLEdBQUc7SUFDaEIsaUJBQWlCLEVBQUUsSUFBSTtJQUN2QiwyQkFBMkIsRUFBRSxJQUFJO0NBQ2xDLENBQUMsQ0FBQztBQUVILE1BQU0sQ0FBQyxNQUFNLDZCQUE2QixHQUFHLE1BQU0sQ0FBQyxNQUFNLENBQUM7SUFDekQsaUJBQWlCLEVBQUUsSUFBSTtJQUN2QixXQUFXLEVBQUUsSUFBSTtJQUNqQixpQkFBaUIsRUFBRSxNQUFNO0lBQ3pCLDJCQUEyQixFQUFFLE1BQU07Q0FDcEMsQ0FBQyxDQUFDO0FBRUgsTUFBTSxDQUFDLE1BQU0sa0NBQWtDLEdBQUcsR0FBRyxHQUFHLElBQUksQ0FBQztBQUM3RCxNQUFNLENBQUMsTUFBTSxzQ0FBc0MsR0FBRyxFQUFFLENBQUM7QUFDekQsTUFBTSxDQUFDLE1BQU0scUNBQXFDLEdBQUcsR0FBRyxDQUFDO0FBQ3pELE1BQU0sQ0FBQyxNQUFNLHdDQUF3QyxHQUFHLElBQUksQ0FBQztBQUM3RCxNQUFNLENBQUMsTUFBTSxvQ0FBb0MsR0FBRyxHQUFHLENBQUMifQ==
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaW50ZXJmYWNlcy5qcyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uL3RzL2ludGVyZmFjZXMudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBNlRBLHlGQUF5RjtBQUN6RixNQUFNLENBQUMsTUFBTSxxQ0FBcUMsR0FBRyxHQUFHLEdBQUcsSUFBSSxDQUFDO0FBQ2hFLE1BQU0sQ0FBQyxNQUFNLHFDQUFxQyxHQUFHLEVBQUUsR0FBRyxJQUFJLENBQUM7QUFDL0QsTUFBTSxDQUFDLE1BQU0sNkJBQTZCLEdBQUcsQ0FBQyxDQUFDO0FBRS9DLE1BQU0sQ0FBQyxNQUFNLGtDQUFrQyxHQUFHLE1BQU0sQ0FBQyxNQUFNLENBQUM7SUFDOUQsY0FBYyxFQUFFLENBQUM7SUFDakIscUJBQXFCLEVBQUUsSUFBSTtJQUMzQixlQUFlLEVBQUUsRUFBRSxHQUFHLElBQUksR0FBRyxJQUFJO0lBQ2pDLFlBQVksRUFBRSxJQUFJLEdBQUcsSUFBSTtJQUN6Qix5QkFBeUIsRUFBRSxDQUFDLEdBQUcsRUFBRSxHQUFHLElBQUk7Q0FDekMsQ0FBQyxDQUFDO0FBRUgsTUFBTSxDQUFDLE1BQU0sa0NBQWtDLEdBQUcsTUFBTSxDQUFDLE1BQU0sQ0FBQztJQUM5RCxjQUFjLEVBQUUsRUFBRTtJQUNsQixxQkFBcUIsRUFBRSxNQUFNO0lBQzdCLGVBQWUsRUFBRSxHQUFHLEdBQUcsSUFBSSxHQUFHLElBQUk7SUFDbEMsWUFBWSxFQUFFLElBQUksR0FBRyxJQUFJO0lBQ3pCLHlCQUF5QixFQUFFLEVBQUUsR0FBRyxFQUFFLEdBQUcsSUFBSTtDQUMxQyxDQUFDLENBQUM7QUErVUgsbUZBQW1GO0FBQ25GLE1BQU0sQ0FBQyxNQUFNLDRCQUE0QixHQUFHLE1BQU0sQ0FBQyxNQUFNLENBQUM7SUFDeEQsTUFBTSxFQUFFLGNBQWM7SUFDdEIsUUFBUSxFQUFFLGdCQUFnQjtJQUMxQixPQUFPLEVBQUUsU0FBUztDQUNWLENBQUMsQ0FBQztBQUVaLE1BQU0sQ0FBQyxNQUFNLHdCQUF3QixH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

package/dist_ts/plugins.d.ts

@@ -3,9 +3,74 @@ import * as crypto from 'node:crypto';
 import * as fs from 'node:fs/promises';
 import * as path from 'node:path';
 export { AsyncLocalStorage, crypto, fs, path };
+import { asSchema, jsonSchema } from 'ai';
+import { Validator as JsonSchemaValidator } from '@cfworker/json-schema';
+export { asSchema, jsonSchema, JsonSchemaValidator };
+export type { FlexibleSchema, JSONSchema7, ModelMessage, Schema } from 'ai';
+/** A value inside a QuickJS context; the host disposes every handle it owns. */
+export interface IQuickJsHandle {
+    readonly alive: boolean;
+    dispose(): void;
+}
+export type TQuickJsResult = {
+    value: IQuickJsHandle;
+    error?: undefined;
+} | {
+    error: IQuickJsHandle;
+    value?: undefined;
+};
+export interface IQuickJsDeferredPromise {
+    readonly handle: IQuickJsHandle;
+    readonly alive: boolean;
+    resolve(value?: IQuickJsHandle): void;
+    reject(value?: IQuickJsHandle): void;
+    dispose(): void;
+}
+export interface IQuickJsContext {
+    readonly global: IQuickJsHandle;
+    newString(value: string): IQuickJsHandle;
+    getString(handle: IQuickJsHandle): string;
+    newFunction(name: string, implementation: (...args: IQuickJsHandle[]) => IQuickJsHandle | void): IQuickJsHandle;
+    setProp(target: IQuickJsHandle, key: string, value: IQuickJsHandle): void;
+    newPromise(): IQuickJsDeferredPromise;
+    newError(message: string): IQuickJsHandle;
+    evalCode(code: string, filename?: string): TQuickJsResult;
+    resolvePromise(handle: IQuickJsHandle): Promise<TQuickJsResult>;
+    dump(handle: IQuickJsHandle): unknown;
+    dispose(): void;
+}
+export interface IQuickJsRuntime {
+    readonly alive: boolean;
+    setMemoryLimit(bytes: number): void;
+    setMaxStackSize(bytes: number): void;
+    setInterruptHandler(handler: () => boolean): void;
+    newContext(): IQuickJsContext;
+    /** Runs the queued promise jobs; `error` is an exception none of them caught. */
+    executePendingJobs(): {
+        error?: IQuickJsHandle;
+    };
+    dispose(): void;
+}
+export interface IQuickJsModule {
+    newRuntime(): IQuickJsRuntime;
+}
+/** A failed strip, as amaro reports it. */
+export interface IAmaroError {
+    code?: string;
+    message?: string;
+    startLine?: number;
+}
+export interface ICodeSandboxEngine {
+    /** A new WebAssembly instance of QuickJS-ng, with a memory of its own. */
+    newModule(): Promise<IQuickJsModule>;
+    /** Removes TypeScript type syntax, keeping every line where it was. */
+    stripTypes(source: string): string;
+}
+/** Loads QuickJS and amaro, the optional peers code mode needs. */
+export declare const importCodeSandboxEngine: () => Promise<ICodeSandboxEngine>;
 import { AgentEventStoreConflictError, AgentPendingInputQueue, AgentPendingInputRejectedError, AgentSession, buildModelMessages, ToolJobStoreConflictError, createAgentEvent, filterModelVisibleAgentEvents, getAgentGenerationTransactions, isGenerationInModelContext, modelMessagesToAgentEvents, tool, validateAgentEventArchiveV2, validateAgentEventSnapshotV2, z } from '@modelprofile.com/flexharness-agent';
 export { AgentEventStoreConflictError, AgentPendingInputQueue, AgentPendingInputRejectedError, AgentSession, buildModelMessages, ToolJobStoreConflictError, createAgentEvent, filterModelVisibleAgentEvents, getAgentGenerationTransactions, isGenerationInModelContext, modelMessagesToAgentEvents, tool, validateAgentEventArchiveV2, validateAgentEventSnapshotV2, z, };
-export type { IAgentAppliedInput, ISmartAiCacheDispatch, IAgentEventArchiveV2, IAgentContextCompactionOptions, IAgentEventSnapshotV2, IAgentEventStoreV2, IAgentGenerateResult, IAgentGenerationHandle, IAgentGenerationLease, IAgentRetryEvent, IAgentRunResult, IAgentSession, IAgentSessionOptions, IAgentToolCallUpdateEvent, IAgentRuntimeEventPayload, IGenerationBegunEvent, IGenerationExecutionCompletedEvent, IGenerationExecutionStartedEvent, IGenerationOutcomeEvent, IToolExecutionContext, IToolExecutionIntentEvent, IToolJobSnapshot, IToolJobState, IToolJobStore, TAgentContextBuilder, TAgentContextCompactor, TAgentEvent, TAgentGenerationOutcome, TAgentModelCallUsage, TAgentModelCallUsageEvent, TAgentRetryReason, TAgentToolCallFinishEvent, TAgentToolExecutionReconciliationOptions, } from '@modelprofile.com/flexharness-agent';
+export type { IAgentAppliedInput, ISmartAiCacheDispatch, IAgentEventArchiveV2, IAgentContextCompactionOptions, IAgentEventSnapshotV2, IAgentEventStoreV2, IAgentGenerateResult, IAgentGenerationHandle, IAgentGenerationLease, IAgentRetryEvent, IAgentRunResult, IAgentSession, IAgentSessionOptions, IAgentToolCallUpdateEvent, IAgentRuntimeEventPayload, IGenerationBegunEvent, IGenerationExecutionCompletedEvent, IGenerationExecutionStartedEvent, IGenerationOutcomeEvent, IToolExecutionContext, IToolExecutionIntentEvent, IToolJobSnapshot, IToolJobState, IToolJobStore, TAgentContextBuilder, TAgentContextCompactor, TAgentEvent, TAgentGenerationOutcome, TAgentModelCallUsage, TAgentModelCallUsageEvent, TAgentObservedModelCallUsage, TAgentRetryReason, TAgentToolCallFinishEvent, TAgentToolExecutionReconciliationOptions, } from '@modelprofile.com/flexharness-agent';
 import { getSmartAiCacheWaitMs, isModelLimitError, isModelLimitInfo } from '@modelprofile.com/flexharness-models';
 export { getSmartAiCacheWaitMs, isModelLimitError, isModelLimitInfo };
 export type { IModelLimitInfo } from '@modelprofile.com/flexharness-models';

package/dist_ts/plugins.js

@@ -4,9 +4,27 @@ import * as crypto from 'node:crypto';
 import * as fs from 'node:fs/promises';
 import * as path from 'node:path';
 export { AsyncLocalStorage, crypto, fs, path };
+// third party scope
+import { asSchema, jsonSchema } from 'ai';
+import { Validator as JsonSchemaValidator } from '@cfworker/json-schema';
+export { asSchema, jsonSchema, JsonSchemaValidator };
+/** Loads QuickJS and amaro, the optional peers code mode needs. */
+export const importCodeSandboxEngine = async () => {
+    const [core, variant, amaro] = await Promise.all([
+        import('quickjs-emscripten-core'),
+        import('@jitl/quickjs-ng-wasmfile-release-sync'),
+        import('amaro'),
+    ]);
+    // The variant's typings resolve as CommonJS; at run time the default export is the variant.
+    const quickjsVariant = variant.default;
+    return {
+        newModule: async () => await core.newQuickJSWASMModuleFromVariant(quickjsVariant),
+        stripTypes: (source) => amaro.transformSync(source, { mode: 'strip-only' }).code,
+    };
+};
 // @push.rocks scope
 import { AgentEventStoreConflictError, AgentPendingInputQueue, AgentPendingInputRejectedError, AgentSession, buildModelMessages, ToolJobStoreConflictError, createAgentEvent, filterModelVisibleAgentEvents, getAgentGenerationTransactions, isGenerationInModelContext, modelMessagesToAgentEvents, tool, validateAgentEventArchiveV2, validateAgentEventSnapshotV2, z, } from '@modelprofile.com/flexharness-agent';
 export { AgentEventStoreConflictError, AgentPendingInputQueue, AgentPendingInputRejectedError, AgentSession, buildModelMessages, ToolJobStoreConflictError, createAgentEvent, filterModelVisibleAgentEvents, getAgentGenerationTransactions, isGenerationInModelContext, modelMessagesToAgentEvents, tool, validateAgentEventArchiveV2, validateAgentEventSnapshotV2, z, };
 import { getSmartAiCacheWaitMs, isModelLimitError, isModelLimitInfo } from '@modelprofile.com/flexharness-models';
 export { getSmartAiCacheWaitMs, isModelLimitError, isModelLimitInfo };
-//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoicGx1Z2lucy5qcyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uL3RzL3BsdWdpbnMudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBQUEsb0JBQW9CO0FBQ3BCLE9BQU8sRUFBRSxpQkFBaUIsRUFBRSxNQUFNLGtCQUFrQixDQUFDO0FBQ3JELE9BQU8sS0FBSyxNQUFNLE1BQU0sYUFBYSxDQUFDO0FBQ3RDLE9BQU8sS0FBSyxFQUFFLE1BQU0sa0JBQWtCLENBQUM7QUFDdkMsT0FBTyxLQUFLLElBQUksTUFBTSxXQUFXLENBQUM7QUFFbEMsT0FBTyxFQUFFLGlCQUFpQixFQUFFLE1BQU0sRUFBRSxFQUFFLEVBQUUsSUFBSSxFQUFFLENBQUM7QUFFL0Msb0JBQW9CO0FBQ3BCLE9BQU8sRUFDTCw0QkFBNEIsRUFDNUIsc0JBQXNCLEVBQ3RCLDhCQUE4QixFQUM5QixZQUFZLEVBQ1osa0JBQWtCLEVBQ2xCLHlCQUF5QixFQUN6QixnQkFBZ0IsRUFDaEIsNkJBQTZCLEVBQzdCLDhCQUE4QixFQUM5QiwwQkFBMEIsRUFDMUIsMEJBQTBCLEVBQzFCLElBQUksRUFDSiwyQkFBMkIsRUFDM0IsNEJBQTRCLEVBQzVCLENBQUMsR0FDRixNQUFNLHFDQUFxQyxDQUFDO0FBRTdDLE9BQU8sRUFDTCw0QkFBNEIsRUFDNUIsc0JBQXNCLEVBQ3RCLDhCQUE4QixFQUM5QixZQUFZLEVBQ1osa0JBQWtCLEVBQ2xCLHlCQUF5QixFQUN6QixnQkFBZ0IsRUFDaEIsNkJBQTZCLEVBQzdCLDhCQUE4QixFQUM5QiwwQkFBMEIsRUFDMUIsMEJBQTBCLEVBQzFCLElBQUksRUFDSiwyQkFBMkIsRUFDM0IsNEJBQTRCLEVBQzVCLENBQUMsR0FDRixDQUFDO0FBcUNGLE9BQU8sRUFBRSxxQkFBcUIsRUFBRSxpQkFBaUIsRUFBRSxnQkFBZ0IsRUFBRSxNQUFNLHNDQUFzQyxDQUFDO0FBRWxILE9BQU8sRUFBRSxxQkFBcUIsRUFBRSxpQkFBaUIsRUFBRSxnQkFBZ0IsRUFBRSxDQUFDIn0=
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoicGx1Z2lucy5qcyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uL3RzL3BsdWdpbnMudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBQUEsb0JBQW9CO0FBQ3BCLE9BQU8sRUFBRSxpQkFBaUIsRUFBRSxNQUFNLGtCQUFrQixDQUFDO0FBQ3JELE9BQU8sS0FBSyxNQUFNLE1BQU0sYUFBYSxDQUFDO0FBQ3RDLE9BQU8sS0FBSyxFQUFFLE1BQU0sa0JBQWtCLENBQUM7QUFDdkMsT0FBTyxLQUFLLElBQUksTUFBTSxXQUFXLENBQUM7QUFFbEMsT0FBTyxFQUFFLGlCQUFpQixFQUFFLE1BQU0sRUFBRSxFQUFFLEVBQUUsSUFBSSxFQUFFLENBQUM7QUFFL0Msb0JBQW9CO0FBQ3BCLE9BQU8sRUFBRSxRQUFRLEVBQUUsVUFBVSxFQUFFLE1BQU0sSUFBSSxDQUFDO0FBQzFDLE9BQU8sRUFBRSxTQUFTLElBQUksbUJBQW1CLEVBQUUsTUFBTSx1QkFBdUIsQ0FBQztBQUV6RSxPQUFPLEVBQUUsUUFBUSxFQUFFLFVBQVUsRUFBRSxtQkFBbUIsRUFBRSxDQUFDO0FBa0VyRCxtRUFBbUU7QUFDbkUsTUFBTSxDQUFDLE1BQU0sdUJBQXVCLEdBQUcsS0FBSyxJQUFpQyxFQUFFO0lBQzdFLE1BQU0sQ0FBQyxJQUFJLEVBQUUsT0FBTyxFQUFFLEtBQUssQ0FBQyxHQUFHLE1BQU0sT0FBTyxDQUFDLEdBQUcsQ0FBQztRQUMvQyxNQUFNLENBQUMseUJBQXlCLENBQUM7UUFDakMsTUFBTSxDQUFDLHdDQUF3QyxDQUFDO1FBQ2hELE1BQU0sQ0FBQyxPQUFPLENBQUM7S0FDaEIsQ0FBQyxDQUFDO0lBQ0gsNEZBQTRGO0lBQzVGLE1BQU0sY0FBYyxHQUFJLE9BQWdDLENBQUMsT0FBcUUsQ0FBQztJQUMvSCxPQUFPO1FBQ0wsU0FBUyxFQUFFLEtBQUssSUFBSSxFQUFFLENBQUMsTUFBTSxJQUFJLENBQUMsK0JBQStCLENBQUMsY0FBYyxDQUE4QjtRQUM5RyxVQUFVLEVBQUUsQ0FBQyxNQUFNLEVBQUUsRUFBRSxDQUFDLEtBQUssQ0FBQyxhQUFhLENBQUMsTUFBTSxFQUFFLEVBQUUsSUFBSSxFQUFFLFlBQVksRUFBRSxDQUFDLENBQUMsSUFBSTtLQUNqRixDQUFDO0FBQ0osQ0FBQyxDQUFDO0FBRUYsb0JBQW9CO0FBQ3BCLE9BQU8sRUFDTCw0QkFBNEIsRUFDNUIsc0JBQXNCLEVBQ3RCLDhCQUE4QixFQUM5QixZQUFZLEVBQ1osa0JBQWtCLEVBQ2xCLHlCQUF5QixFQUN6QixnQkFBZ0IsRUFDaEIsNkJBQTZCLEVBQzdCLDhCQUE4QixFQUM5QiwwQkFBMEIsRUFDMUIsMEJBQTBCLEVBQzFCLElBQUksRUFDSiwyQkFBMkIsRUFDM0IsNEJBQTRCLEVBQzVCLENBQUMsR0FDRixNQUFNLHFDQUFxQyxDQUFDO0FBRTdDLE9BQU8sRUFDTCw0QkFBNEIsRUFDNUIsc0JBQXNCLEVBQ3RCLDhCQUE4QixFQUM5QixZQUFZLEVBQ1osa0JBQWtCLEVBQ2xCLHlCQUF5QixFQUN6QixnQkFBZ0IsRUFDaEIsNkJBQTZCLEVBQzdCLDhCQUE4QixFQUM5QiwwQkFBMEIsRUFDMUIsMEJBQTBCLEVBQzFCLElBQUksRUFDSiwyQkFBMkIsRUFDM0IsNEJBQTRCLEVBQzVCLENBQUMsR0FDRixDQUFDO0FBc0NGLE9BQU8sRUFBRSxxQkFBcUIsRUFBRSxpQkFBaUIsRUFBRSxnQkFBZ0IsRUFBRSxNQUFNLHNDQUFzQyxDQUFDO0FBRWxILE9BQU8sRUFBRSxxQkFBcUIsRUFBRSxpQkFBaUIsRUFBRSxnQkFBZ0IsRUFBRSxDQUFDIn0=

package/dist_ts/utils.harnessoptions.d.ts

@@ -1,4 +1,4 @@
-import type { IFlexAgentSessionPolicy, IFlexCallbackLimits, IFlexHarnessOptions, IFlexHarnessStores, IFlexPromptQueueLimits, IFlexReversionLimits, IFlexSlashCommandHandlerRegistration, IFlexSlashCommandTemplateRegistration, IFlexSubagentDefinition, TFlexSlashCommandRegistration } from './interfaces.js';
+import type { IFlexAgentSessionPolicy, IFlexCallbackLimits, IFlexHarnessOptions, IFlexHarnessStores, IFlexPromptQueueLimits, IFlexReversionLimits, IFlexSlashCommandHandlerRegistration, IFlexSlashCommandTemplateRegistration, IFlexCodeModeLimits, IFlexSubagentDefinition, IFlexToolCatalogOptions, TFlexSlashCommandRegistration } from './interfaces.js';
 export type TRegisteredSlashCommand<TScope> = Readonly<IFlexSlashCommandTemplateRegistration> | Readonly<IFlexSlashCommandHandlerRegistration<TScope>>;
 export interface INormalizedProjectManagementTools {
     readonly task: boolean;
@@ -12,6 +12,12 @@ export interface INormalizedBuiltInTools {
 export declare const maxSubagentNameBytes = 128;
 export declare function normalizeAllowedTools(names: readonly string[] | undefined, label?: string): readonly string[] | undefined;
 export declare function normalizeSubagents(definitions: readonly IFlexSubagentDefinition[] | undefined): ReadonlyMap<string, Readonly<IFlexSubagentDefinition>>;
+export interface INormalizedToolCatalogOptions {
+    readonly declarations: 'typescript' | 'json-schema';
+    /** The limits of `run_code`; absent while code mode is off. */
+    readonly codeMode?: Readonly<IFlexCodeModeLimits>;
+}
+export declare function normalizeToolCatalogOptions(options: IFlexToolCatalogOptions | undefined): INormalizedToolCatalogOptions;
 export declare function normalizeBuiltInTools(options: IFlexHarnessOptions<unknown>['builtInTools']): INormalizedBuiltInTools;
 export declare function normalizeSlashCommands<TScope>(registrations: readonly TFlexSlashCommandRegistration<TScope>[] | undefined): ReadonlyMap<string, TRegisteredSlashCommand<TScope>>;
 export declare function resolveBoundedPositiveInteger(value: number | undefined, name: string, defaultValue: number, maximum: number): number;