@vurb/core 3.3.4 → 3.6.0

package/dist/core/builder/BuildPipeline.js

@@ -0,0 +1,139 @@
+/**
+ * BuildPipeline — Compiles FluentToolBuilder state into a GroupedToolBuilder.
+ *
+ * Extracts the `_build()` pipeline from FluentToolBuilder into a
+ * standalone function for SRP compliance. Handles:
+ * - Name parsing (`domain.action`)
+ * - Description compilation (instructions + sandbox prompting)
+ * - Semantic defaults resolution
+ * - Handler wrapping (implicit `success()`)
+ * - GroupedToolBuilder assembly + middleware propagation
+ *
+ * @module
+ */
+import {} from 'zod';
+import { z } from 'zod';
+import { GroupedToolBuilder } from './GroupedToolBuilder.js';
+import {} from '../types.js';
+import { success, TOOL_RESPONSE_BRAND } from '../response.js';
+import {} from '../../presenter/Presenter.js';
+import {} from '../execution/ConcurrencyGuard.js';
+import {} from '../../sandbox/SandboxEngine.js';
+import { SANDBOX_SYSTEM_INSTRUCTION } from '../../sandbox/index.js';
+import {} from './SemanticDefaults.js';
+/**
+ * Compile FluentToolBuilder state into a GroupedToolBuilder.
+ *
+ * @param config - Assembled configuration from builder state
+ * @returns A `GroupedToolBuilder` ready for registration
+ */
+export function buildToolFromFluent(config) {
+    // Build accumulated with* params into ZodObject
+    let inputSchema;
+    if (Object.keys(config.withParams).length > 0) {
+        inputSchema = z.object(config.withParams);
+    }
+    // Parse name: 'domain.action' → tool='domain', action='action'
+    const dotIndex = config.name.indexOf('.');
+    // Bug #109 fix: reject multi-dot names early with a clear error.
+    if (dotIndex > 0 && config.name.indexOf('.', dotIndex + 1) !== -1) {
+        throw new Error(`Tool name '${config.name}' has too many dot-separated segments. ` +
+            `Only one dot is allowed (e.g. 'group.action'). Use f.router() for nested prefixes.`);
+    }
+    const toolName = dotIndex > 0 ? config.name.slice(0, dotIndex) : config.name;
+    const actionName = dotIndex > 0 ? config.name.slice(dotIndex + 1) : 'default';
+    // Compile description: instructions + description
+    const descParts = [];
+    if (config.instructions) {
+        descParts.push(`[INSTRUCTIONS] ${config.instructions}`);
+    }
+    if (config.description) {
+        descParts.push(config.description);
+    }
+    // HATEOAS Auto-Prompting: teach the LLM about sandbox capability
+    if (config.sandboxConfig) {
+        descParts.push(SANDBOX_SYSTEM_INSTRUCTION.trim());
+    }
+    const compiledDescription = descParts.length > 0 ? descParts.join('\n\n') : undefined;
+    // Resolve semantic defaults + overrides
+    const readOnly = config.readOnly ?? config.semanticDefaults.readOnly;
+    const destructive = config.destructive ?? config.semanticDefaults.destructive;
+    const idempotent = config.idempotent ?? config.semanticDefaults.idempotent;
+    // Wrap handler: (input, ctx) → (ctx, args)
+    const resolvedHandler = config.handler;
+    const wrappedHandler = async (ctx, args) => {
+        const result = await resolvedHandler(args, ctx);
+        // Guard: void/null handlers → safe fallback (Bug #41)
+        if (result === undefined || result === null) {
+            return success('OK');
+        }
+        // Auto-wrap non-ToolResponse results (implicit success)
+        // Primary: check brand symbol stamped by success()/error()/toolError() helpers.
+        // Fallback: shape-based heuristic for manually constructed ToolResponse objects.
+        if (typeof result === 'object' && result !== null) {
+            // Brand check — reliable, no false positives (Bug #127)
+            if (TOOL_RESPONSE_BRAND in result) {
+                return result;
+            }
+            // Shape heuristic — backward compat for manually constructed ToolResponse
+            if ('content' in result &&
+                Array.isArray(result.content) &&
+                result.content.length > 0 &&
+                result.content[0]?.type === 'text' &&
+                typeof result.content[0]?.text === 'string' &&
+                Object.keys(result).every(k => k === 'content' || k === 'isError')) {
+                return result;
+            }
+        }
+        // Implicit success() — the dev just returns raw data!
+        return success(result);
+    };
+    // Build via GroupedToolBuilder for consistency with existing pipeline
+    const builder = new GroupedToolBuilder(toolName);
+    if (compiledDescription)
+        builder.description(compiledDescription);
+    if (config.tags.length > 0)
+        builder.tags(...config.tags);
+    if (config.toonMode)
+        builder.toonDescription();
+    if (config.annotations)
+        builder.annotations(config.annotations);
+    // Propagate state sync hints
+    if (config.invalidatesPatterns.length > 0) {
+        builder.invalidates(...config.invalidatesPatterns);
+    }
+    if (config.cacheControl) {
+        config.cacheControl === 'immutable' ? builder.cached() : builder.stale();
+    }
+    // Propagate runtime guards
+    if (config.concurrency) {
+        builder.concurrency(config.concurrency);
+    }
+    if (config.egressMaxBytes !== undefined) {
+        builder.maxPayloadBytes(config.egressMaxBytes);
+    }
+    // Propagate sandbox config
+    if (config.sandboxConfig) {
+        builder.sandbox(config.sandboxConfig);
+    }
+    // Propagate FSM state gate
+    if (config.fsmStates) {
+        builder.bindState(config.fsmStates, config.fsmTransition);
+    }
+    // Apply middleware
+    for (const mw of config.middlewares) {
+        builder.use(mw);
+    }
+    // Register the single action
+    builder.action({
+        name: actionName,
+        handler: wrappedHandler,
+        ...(inputSchema ? { schema: inputSchema } : {}),
+        ...(readOnly !== undefined ? { readOnly } : {}),
+        ...(destructive !== undefined ? { destructive } : {}),
+        ...(idempotent !== undefined ? { idempotent } : {}),
+        ...(config.returns ? { returns: config.returns } : {}),
+    });
+    return builder;
+}
+//# sourceMappingURL=BuildPipeline.js.map

package/dist/core/builder/BuildPipeline.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"BuildPipeline.js","sourceRoot":"","sources":["../../../src/core/builder/BuildPipeline.ts"],"names":[],"mappings":"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"}

package/dist/core/builder/FluentToolBuilder.d.ts

@@ -26,27 +26,15 @@
  * @module
  */
 import { type ZodType, type ZodObject, type ZodRawShape } from 'zod';
+import { type Model } from '../../model/defineModel.js';
 import { GroupedToolBuilder } from './GroupedToolBuilder.js';
 import { type ToolResponse, type MiddlewareFn } from '../types.js';
 import { type Presenter } from '../../presenter/Presenter.js';
 import { type ConcurrencyConfig } from '../execution/ConcurrencyGuard.js';
 import { type SandboxConfig } from '../../sandbox/SandboxEngine.js';
 import { type MiddlewareDefinition } from '../middleware/ContextDerivation.js';
-/**
- * Semantic defaults applied by each verb.
- * @internal
- */
-export interface SemanticDefaults {
-    readonly readOnly?: boolean;
-    readonly destructive?: boolean;
-    readonly idempotent?: boolean;
-}
-/** Defaults for `f.query()` — read-only, no side effects */
-export declare const QUERY_DEFAULTS: SemanticDefaults;
-/** Defaults for `f.mutation()` — destructive, irreversible */
-export declare const MUTATION_DEFAULTS: SemanticDefaults;
-/** Defaults for `f.action()` — neutral, no assumptions */
-export declare const ACTION_DEFAULTS: SemanticDefaults;
+import { type SemanticDefaults } from './SemanticDefaults.js';
+export { type SemanticDefaults, QUERY_DEFAULTS, MUTATION_DEFAULTS, ACTION_DEFAULTS } from './SemanticDefaults.js';
 /**
  * Fluent builder that accumulates types at each step.
  *
@@ -54,13 +42,14 @@ export declare const ACTION_DEFAULTS: SemanticDefaults;
  * @typeParam TInput - Accumulated input type (built by `with*()` methods)
  * @typeParam TCtx - Accumulated context type (enriched by `.use()`)
  */
-export declare class FluentToolBuilder<TContext, TInput = void, TCtx = TContext> {
+export declare class FluentToolBuilder<TContext, TInput = Record<string, never>, TCtx = TContext> {
     /** @internal */ readonly _name: string;
     /** @internal */ _description?: string;
     /** @internal */ _instructions?: string;
     /** @internal */ _inputSchema?: ZodObject<ZodRawShape>;
     /** @internal */ _withParams: Record<string, ZodType>;
     /** @internal */ _tags: string[];
+    /** @internal */ _modelRef?: Model;
     /**
      * @internal Bug #118 fix: reject duplicate parameter names.
      * All `withXxx()` methods delegate to this instead of assigning directly.
@@ -169,6 +158,108 @@ export declare class FluentToolBuilder<TContext, TInput = void, TCtx = TContext>
      * @returns Builder with narrowed `TInput` type
      */
     withOptionalBoolean<K extends string>(name: K, description?: string): FluentToolBuilder<TContext, TInput & Partial<Record<K, boolean>>, TCtx>;
+    /**
+     * Add multiple required string parameters in bulk.
+     *
+     * @param fields - Record of `{ paramName: 'description' }`
+     * @returns Builder with narrowed `TInput` type
+     *
+     * @example
+     * ```typescript
+     * f.query('tasks.get')
+     *     .withStrings({
+     *         company_slug: 'Workspace identifier',
+     *         project_slug: 'Project identifier',
+     *     })
+     *     .handle(async (input) => { ... });
+     * // input.company_slug: string ✅
+     * // input.project_slug: string ✅
+     * ```
+     */
+    withStrings<R extends Record<string, string>>(fields: R): FluentToolBuilder<TContext, TInput & {
+        [K in keyof R & string]: string;
+    }, TCtx>;
+    /**
+     * Add multiple optional string parameters in bulk.
+     *
+     * @param fields - Record of `{ paramName: 'description' }`
+     * @returns Builder with narrowed `TInput` type
+     *
+     * @example
+     * ```typescript
+     * f.query('tasks.filter')
+     *     .withOptionalStrings({
+     *         title:    'Filter by title (partial match)',
+     *         workflow: 'Column name (e.g. "In Progress")',
+     *         labels:   'Comma-separated label names',
+     *     })
+     *     .handle(async (input) => { ... });
+     * // input.title?: string | undefined ✅
+     * ```
+     */
+    withOptionalStrings<R extends Record<string, string>>(fields: R): FluentToolBuilder<TContext, TInput & {
+        [K in keyof R & string]?: string | undefined;
+    }, TCtx>;
+    /**
+     * Add multiple required number parameters in bulk.
+     *
+     * @param fields - Record of `{ paramName: 'description' }`
+     * @returns Builder with narrowed `TInput` type
+     */
+    withNumbers<R extends Record<string, string>>(fields: R): FluentToolBuilder<TContext, TInput & {
+        [K in keyof R & string]: number;
+    }, TCtx>;
+    /**
+     * Add multiple optional number parameters in bulk.
+     *
+     * @param fields - Record of `{ paramName: 'description' }`
+     * @returns Builder with narrowed `TInput` type
+     *
+     * @example
+     * ```typescript
+     * f.query('tasks.filter')
+     *     .withOptionalNumbers({
+     *         per_page:  'Results per page (default: 50)',
+     *         offset:    'Pagination offset',
+     *     })
+     *     .handle(async (input) => { ... });
+     * // input.per_page?: number | undefined ✅
+     * ```
+     */
+    withOptionalNumbers<R extends Record<string, string>>(fields: R): FluentToolBuilder<TContext, TInput & {
+        [K in keyof R & string]?: number | undefined;
+    }, TCtx>;
+    /**
+     * Add multiple required boolean parameters in bulk.
+     *
+     * @param fields - Record of `{ paramName: 'description' }`
+     * @returns Builder with narrowed `TInput` type
+     */
+    withBooleans<R extends Record<string, string>>(fields: R): FluentToolBuilder<TContext, TInput & {
+        [K in keyof R & string]: boolean;
+    }, TCtx>;
+    /**
+     * Add multiple optional boolean parameters in bulk.
+     *
+     * @param fields - Record of `{ paramName: 'description' }`
+     * @returns Builder with narrowed `TInput` type
+     *
+     * @example
+     * ```typescript
+     * f.query('tasks.filter')
+     *     .withOptionalBooleans({
+     *         is_blocker:  'Only blockers',
+     *         is_bug:      'Only bugs',
+     *         unassigned:  'Only unassigned tasks',
+     *         is_archived: 'Include archived tasks',
+     *     })
+     *     .handle(async (input) => { ... });
+     * // input.is_blocker?: boolean | undefined ✅
+     * ```
+     */
+    withOptionalBooleans<R extends Record<string, string>>(fields: R): FluentToolBuilder<TContext, TInput & {
+        [K in keyof R & string]?: boolean | undefined;
+    }, TCtx>;
     /**
      * Add a required enum parameter.
      *
@@ -222,6 +313,114 @@ export declare class FluentToolBuilder<TContext, TInput = void, TCtx = TContext>
      * @returns Builder with narrowed `TInput` type
      */
     withOptionalArray<K extends string, I extends 'string' | 'number' | 'boolean'>(name: K, itemType: I, description?: string): FluentToolBuilder<TContext, TInput & Partial<Record<K, (I extends 'string' ? string : I extends 'number' ? number : boolean)[]>>, TCtx>;
+    /**
+     * Add multiple required enum parameters in bulk.
+     *
+     * Each entry is `paramName: [allowedValues, description?]`.
+     *
+     * @param fields - Record of `{ paramName: [values, description?] }`
+     * @returns Builder with narrowed `TInput` type
+     *
+     * @example
+     * ```typescript
+     * f.query('tasks.filter')
+     *     .withEnums({
+     *         status:   [['open', 'closed', 'archived'], 'Task status'],
+     *         priority: [['low', 'medium', 'high'], 'Priority level'],
+     *     })
+     *     .handle(async (input) => { ... });
+     * // input.status: 'open' | 'closed' | 'archived' ✅
+     * ```
+     */
+    withEnums<R extends Record<string, readonly [readonly [string, ...string[]], string?]>>(fields: R): FluentToolBuilder<TContext, TInput & {
+        [K in keyof R & string]: R[K][0][number];
+    }, TCtx>;
+    /**
+     * Add multiple optional enum parameters in bulk.
+     *
+     * Each entry is `paramName: [allowedValues, description?]`.
+     *
+     * @param fields - Record of `{ paramName: [values, description?] }`
+     * @returns Builder with narrowed `TInput` type
+     *
+     * @example
+     * ```typescript
+     * f.query('tasks.filter')
+     *     .withOptionalEnums({
+     *         status:   [['open', 'closed'], 'Filter by status'],
+     *         priority: [['low', 'medium', 'high'], 'Filter by priority'],
+     *     })
+     *     .handle(async (input) => { ... });
+     * // input.status?: 'open' | 'closed' | undefined ✅
+     * ```
+     */
+    withOptionalEnums<R extends Record<string, readonly [readonly [string, ...string[]], string?]>>(fields: R): FluentToolBuilder<TContext, TInput & {
+        [K in keyof R & string]?: R[K][0][number] | undefined;
+    }, TCtx>;
+    /**
+     * Add multiple required array parameters in bulk, sharing the same item type.
+     *
+     * @param itemType - Type of array items (`'string'`, `'number'`, `'boolean'`)
+     * @param fields - Record of `{ paramName: 'description' }`
+     * @returns Builder with narrowed `TInput` type
+     *
+     * @example
+     * ```typescript
+     * f.mutation('tasks.update')
+     *     .withArrays('string', {
+     *         tags:   'Tags to apply',
+     *         labels: 'Category labels',
+     *     })
+     *     .handle(async (input) => { ... });
+     * // input.tags: string[] ✅
+     * // input.labels: string[] ✅
+     * ```
+     */
+    withArrays<I extends 'string' | 'number' | 'boolean', R extends Record<string, string>>(itemType: I, fields: R): FluentToolBuilder<TContext, TInput & {
+        [K in keyof R & string]: (I extends 'string' ? string : I extends 'number' ? number : boolean)[];
+    }, TCtx>;
+    /**
+     * Add multiple optional array parameters in bulk, sharing the same item type.
+     *
+     * @param itemType - Type of array items (`'string'`, `'number'`, `'boolean'`)
+     * @param fields - Record of `{ paramName: 'description' }`
+     * @returns Builder with narrowed `TInput` type
+     *
+     * @example
+     * ```typescript
+     * f.query('tasks.filter')
+     *     .withOptionalArrays('string', {
+     *         tags:   'Filter by tags',
+     *         labels: 'Filter by labels',
+     *     })
+     *     .handle(async (input) => { ... });
+     * // input.tags?: string[] | undefined ✅
+     * ```
+     */
+    withOptionalArrays<I extends 'string' | 'number' | 'boolean', R extends Record<string, string>>(itemType: I, fields: R): FluentToolBuilder<TContext, TInput & {
+        [K in keyof R & string]?: (I extends 'string' ? string : I extends 'number' ? number : boolean)[] | undefined;
+    }, TCtx>;
+    /**
+     * Derive tool input parameters from a Model's fillable profile.
+     *
+     * Reads the specified operation from `model.input` (fillable profiles),
+     * then adds each field as a parameter using the type and description from
+     * the Model's casts. For `create`, fields respect their schema optionality.
+     * For `update` and `filter`, all fields become optional.
+     *
+     * @param model - A `Model` from `defineModel()`
+     * @param operation - The fillable profile name (e.g. `'create'`, `'update'`, `'filter'`)
+     * @returns Builder with additional parameters from the Model
+     *
+     * @example
+     * ```typescript
+     * f.mutation('task.create')
+     *   .fromModel(TaskModel, 'create')
+     *   .withStrings({ company_slug: '...', project_slug: '...' })
+     *   .handle(async (input, ctx) => { ... });
+     * ```
+     */
+    fromModel<M extends Model>(model: M, operation: string): FluentToolBuilder<TContext, TInput & Record<string, any>, TCtx>;
     /**
      * Add context-derivation middleware (tRPC-style).
      *
@@ -267,7 +466,7 @@ export declare class FluentToolBuilder<TContext, TInput = void, TCtx = TContext>
      * @param presenter - A Presenter instance
      * @returns `this` for chaining
      */
-    returns(presenter: Presenter<unknown>): FluentToolBuilder<TContext, TInput, TCtx>;
+    returns(presenter: Presenter<any>): FluentToolBuilder<TContext, TInput, TCtx>;
     /**
      * Add capability tags for selective tool exposure.
      *
@@ -404,13 +603,48 @@ export declare class FluentToolBuilder<TContext, TInput = void, TCtx = TContext>
      *     });
      * ```
      */
-    handle(handler: (input: TInput extends void ? Record<string, unknown> : TInput, ctx: TCtx) => Promise<ToolResponse | unknown>): GroupedToolBuilder<TContext>;
+    handle(handler: (input: [TInput] extends [Record<string, never>] ? Record<string, any> : TInput, ctx: TCtx) => Promise<ToolResponse | unknown>): GroupedToolBuilder<TContext>;
+    /**
+     * Auto-generate a handler that proxies to `ctx.client` HTTP methods.
+     *
+     * Eliminates boilerplate by deriving the HTTP method from the semantic
+     * verb (`query` → GET, `mutation` → POST) and passing model input
+     * directly as query params or request body.
+     *
+     * For tools with non-trivial logic (data transformation, multi-step
+     * calls, conditional behavior), use `.handle()` instead.
+     *
+     * @param endpoint - API path (e.g. `'companies/standup/summary'`)
+     * @param options - Optional overrides
+     * @param options.method - Force HTTP method (`'GET'`, `'POST'`, `'PUT'`, `'DELETE'`)
+     * @param options.unwrap - Auto-unwrap `response.data` (default: `true`)
+     * @returns A `GroupedToolBuilder` ready for registration
+     *
+     * @example
+     * ```typescript
+     * const pulse = analytics.query('pulse')
+     *     .fromModel(AnalyticsModel, 'query')
+     *     .proxy('companies/manager-dashboard/pulse');
+     *
+     * const create = note.mutation('create')
+     *     .fromModel(NoteModel, 'create')
+     *     .proxy('notes');
+     *
+     * const update = note.mutation('update')
+     *     .fromModel(NoteModel, 'update')
+     *     .proxy('notes/:uuid', { method: 'PUT' });
+     * ```
+     */
+    proxy(endpoint: string, options?: {
+        method?: 'GET' | 'POST' | 'PUT' | 'DELETE';
+        unwrap?: boolean;
+    }): GroupedToolBuilder<TContext>;
     /**
      * Alias for `.handle()` — for backward compatibility.
      * @internal
      */
     resolve(handler: (args: {
-        input: TInput extends void ? Record<string, unknown> : TInput;
+        input: [TInput] extends [Record<string, never>] ? Record<string, any> : TInput;
         ctx: TCtx;
     }) => Promise<ToolResponse | unknown>): GroupedToolBuilder<TContext>;
     /** @internal */

package/dist/core/builder/FluentToolBuilder.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"FluentToolBuilder.d.ts","sourceRoot":"","sources":["../../../src/core/builder/FluentToolBuilder.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,OAAO,EAAK,KAAK,OAAO,EAAE,KAAK,SAAS,EAAE,KAAK,WAAW,EAAE,MAAM,KAAK,CAAC;AACxE,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAC7D,OAAO,EAAE,KAAK,YAAY,EAAE,KAAK,YAAY,EAAE,MAAM,aAAa,CAAC;AAEnE,OAAO,EAAE,KAAK,SAAS,EAAE,MAAM,8BAA8B,CAAC;AAC9D,OAAO,EAAE,KAAK,iBAAiB,EAAE,MAAM,kCAAkC,CAAC;AAC1E,OAAO,EAAE,KAAK,aAAa,EAAE,MAAM,gCAAgC,CAAC;AAEpE,OAAO,EAAE,KAAK,oBAAoB,EAAE,MAAM,oCAAoC,CAAC;AAI/E;;;GAGG;AACH,MAAM,WAAW,gBAAgB;IAC7B,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAC;IAC5B,QAAQ,CAAC,WAAW,CAAC,EAAE,OAAO,CAAC;IAC/B,QAAQ,CAAC,UAAU,CAAC,EAAE,OAAO,CAAC;CACjC;AAED,4DAA4D;AAC5D,eAAO,MAAM,cAAc,EAAE,gBAAqC,CAAC;AAEnE,8DAA8D;AAC9D,eAAO,MAAM,iBAAiB,EAAE,gBAAwC,CAAC;AAEzE,0DAA0D;AAC1D,eAAO,MAAM,eAAe,EAAE,gBAAqB,CAAC;AAepD;;;;;;GAMG;AACH,qBAAa,iBAAiB,CAC1B,QAAQ,EACR,MAAM,GAAG,IAAI,EACb,IAAI,GAAG,QAAQ;IAEf,gBAAgB,CAAC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACxC,gBAAgB,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;IACvC,gBAAgB,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC;IACxC,gBAAgB,CAAC,YAAY,CAAC,EAAE,SAAS,CAAC,WAAW,CAAC,CAAC;IACvD,gBAAgB,CAAC,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAM;IAC3D,gBAAgB,CAAC,KAAK,EAAE,MAAM,EAAE,CAAM;IAEtC;;;OAGG;IACH,OAAO,CAAC,SAAS;IAejB,gBAAgB,CAAC,YAAY,EAAE,YAAY,CAAC,QAAQ,CAAC,EAAE,CAAM;IAC7D,gBAAgB,CAAC,QAAQ,CAAC,EAAE,SAAS,CAAC,OAAO,CAAC,CAAC;IAC/C,gBAAgB,CAAC,iBAAiB,EAAE,gBAAgB,CAAC;IACrD,gBAAgB,CAAC,SAAS,CAAC,EAAE,OAAO,CAAC;IACrC,gBAAgB,CAAC,YAAY,CAAC,EAAE,OAAO,CAAC;IACxC,gBAAgB,CAAC,WAAW,CAAC,EAAE,OAAO,CAAC;IACvC,gBAAgB,CAAC,SAAS,UAAS;IACnC,gBAAgB,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACxD,gBAAgB,CAAC,oBAAoB,EAAE,MAAM,EAAE,CAAM;IACrD,gBAAgB,CAAC,aAAa,CAAC,EAAE,UAAU,GAAG,WAAW,CAAC;IAC1D,gBAAgB,CAAC,YAAY,CAAC,EAAE,iBAAiB,CAAC;IAClD,gBAAgB,CAAC,eAAe,CAAC,EAAE,MAAM,CAAC;IAC1C,gBAAgB,CAAC,cAAc,CAAC,EAAE,aAAa,CAAC;IAChD,gBAAgB,CAAC,WAAW,UAAS;IACrC,gBAAgB,CAAC,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IACvC,gBAAgB,CAAC,cAAc,CAAC,EAAE,MAAM,CAAC;IAEzC;;;OAGG;gBACS,IAAI,EAAE,MAAM,EAAE,QAAQ,GAAE,gBAAqB;IAazD;;;;;OAKG;IACH,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,iBAAiB,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,CAAC;IAKjE;;;;;;;;;;;;;;;;;OAiBG;IACH,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,iBAAiB,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,CAAC;IAOrE;;;;;;;;;;;;;;OAcG;IACH,UAAU,CAAC,CAAC,SAAS,MAAM,EACvB,IAAI,EAAE,CAAC,EACP,WAAW,CAAC,EAAE,MAAM,GACrB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAAC,CAAC,EAAE,MAAM,CAAC,EAAE,IAAI,CAAC;IAKhE;;;;;;OAMG;IACH,kBAAkB,CAAC,CAAC,SAAS,MAAM,EAC/B,IAAI,EAAE,CAAC,EACP,WAAW,CAAC,EAAE,MAAM,GACrB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC,EAAE,IAAI,CAAC;IAMzE;;;;;;OAMG;IACH,UAAU,CAAC,CAAC,SAAS,MAAM,EACvB,IAAI,EAAE,CAAC,EACP,WAAW,CAAC,EAAE,MAAM,GACrB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAAC,CAAC,EAAE,MAAM,CAAC,EAAE,IAAI,CAAC;IAKhE;;;;;;OAMG;IACH,kBAAkB,CAAC,CAAC,SAAS,MAAM,EAC/B,IAAI,EAAE,CAAC,EACP,WAAW,CAAC,EAAE,MAAM,GACrB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC,EAAE,IAAI,CAAC;IAMzE;;;;;;OAMG;IACH,WAAW,CAAC,CAAC,SAAS,MAAM,EACxB,IAAI,EAAE,CAAC,EACP,WAAW,CAAC,EAAE,MAAM,GACrB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAAC,CAAC,EAAE,OAAO,CAAC,EAAE,IAAI,CAAC;IAKjE;;;;;;OAMG;IACH,mBAAmB,CAAC,CAAC,SAAS,MAAM,EAChC,IAAI,EAAE,CAAC,EACP,WAAW,CAAC,EAAE,MAAM,GACrB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC,EAAE,IAAI,CAAC;IAM1E;;;;;;;;;;;;;;;OAeG;IACH,QAAQ,CAAC,CAAC,SAAS,MAAM,EAAE,CAAC,SAAS,MAAM,EACvC,IAAI,EAAE,CAAC,EACP,MAAM,EAAE,SAAS,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,CAAC,EAC5B,WAAW,CAAC,EAAE,MAAM,GACrB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,IAAI,CAAC;IAM3D;;;;;;;OAOG;IACH,gBAAgB,CAAC,CAAC,SAAS,MAAM,EAAE,CAAC,SAAS,MAAM,EAC/C,IAAI,EAAE,CAAC,EACP,MAAM,EAAE,SAAS,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,CAAC,EAC5B,WAAW,CAAC,EAAE,MAAM,GACrB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,IAAI,CAAC;IAMpE;;;;;;;;;;;;;;;;OAgBG;IACH,SAAS,CAAC,CAAC,SAAS,MAAM,EAAE,CAAC,SAAS,QAAQ,GAAG,QAAQ,GAAG,SAAS,EACjE,IAAI,EAAE,CAAC,EACP,QAAQ,EAAE,CAAC,EACX,WAAW,CAAC,EAAE,MAAM,GACrB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,SAAS,QAAQ,GAAG,MAAM,GAAG,CAAC,SAAS,QAAQ,GAAG,MAAM,GAAG,OAAO,CAAC,EAAE,CAAC,EAAE,IAAI,CAAC;IAMjI;;;;;;;OAOG;IACH,iBAAiB,CAAC,CAAC,SAAS,MAAM,EAAE,CAAC,SAAS,QAAQ,GAAG,QAAQ,GAAG,SAAS,EACzE,IAAI,EAAE,CAAC,EACP,QAAQ,EAAE,CAAC,EACX,WAAW,CAAC,EAAE,MAAM,GACrB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,SAAS,QAAQ,GAAG,MAAM,GAAG,CAAC,SAAS,QAAQ,GAAG,MAAM,GAAG,OAAO,CAAC,EAAE,CAAC,CAAC,EAAE,IAAI,CAAC;IAQ1I;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA6BG;IACH,GAAG,CAAC,QAAQ,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACxC,EAAE,EAAE,oBAAoB,CAAC,IAAI,EAAE,QAAQ,CAAC,GACzC,iBAAiB,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,GAAG,QAAQ,CAAC;IACvD,GAAG,CAAC,QAAQ,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACxC,EAAE,EAAE,CAAC,IAAI,EAAE;QAAE,GAAG,EAAE,IAAI,CAAC;QAAC,IAAI,EAAE,CAAC,WAAW,EAAE,IAAI,GAAG,QAAQ,KAAK,OAAO,CAAC,YAAY,CAAC,CAAA;KAAE,KAAK,OAAO,CAAC,YAAY,CAAC,GAClH,iBAAiB,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,GAAG,QAAQ,CAAC;IAkCvD;;;;;;;;;OASG;IACH,OAAO,CAAC,SAAS,EAAE,SAAS,CAAC,OAAO,CAAC,GAAG,iBAAiB,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,CAAC;IAKjF;;;;;;;;OAQG;IACH,IAAI,CAAC,GAAG,IAAI,EAAE,MAAM,EAAE,GAAG,iBAAiB,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,CAAC;IAOlE,8DAA8D;IAC9D,QAAQ,IAAI,iBAAiB,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,CAAC;IAKrD,6DAA6D;IAC7D,WAAW,IAAI,iBAAiB,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,CAAC;IAKxD,6DAA6D;IAC7D,UAAU,IAAI,iBAAiB,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,CAAC;IAKvD;;;;OAIG;IACH,eAAe,IAAI,iBAAiB,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,CAAC;IAK5D;;;;;OAKG;IACH,WAAW,CAAC,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,iBAAiB,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,CAAC;IAOlF;;;;;OAKG;IACH,WAAW,CAAC,GAAG,QAAQ,EAAE,MAAM,EAAE,GAAG,iBAAiB,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,CAAC;IAK7E;;;;OAIG;IACH,MAAM,IAAI,iBAAiB,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,CAAC;IAKnD;;;;OAIG;IACH,KAAK,IAAI,iBAAiB,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,CAAC;IAOlD;;;;;OAKG;IACH,WAAW,CAAC,MAAM,EAAE,iBAAiB,GAAG,iBAAiB,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,CAAC;IAKjF;;;;;OAKG;IACH,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,iBAAiB,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,CAAC;IAOhE;;;;;;;;;;;;;;;;;;;;;;;;;;OA0BG;IACH,SAAS,CAAC,MAAM,CAAC,EAAE,aAAa,GAAG,iBAAiB,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,CAAC;IAO5E;;;;;;;;;;;;;;;;;;;;;;;;OAwBG;IACH,SAAS,CACL,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,EACzB,UAAU,CAAC,EAAE,MAAM,GACpB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,CAAC;IAQ5C;;;;;;;;;;;;;;;;;;;OAmBG;IACH,MAAM,CACF,OAAO,EAAE,CACL,KAAK,EAAE,MAAM,SAAS,IAAI,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,EAC7D,GAAG,EAAE,IAAI,KACR,OAAO,CAAC,YAAY,GAAG,OAAO,CAAC,GACrC,kBAAkB,CAAC,QAAQ,CAAC;IAI/B;;;OAGG;IACH,OAAO,CACH,OAAO,EAAE,CACL,IAAI,EAAE;QAAE,KAAK,EAAE,MAAM,SAAS,IAAI,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC;QAAC,GAAG,EAAE,IAAI,CAAA;KAAE,KACjF,OAAO,CAAC,YAAY,GAAG,OAAO,CAAC,GACrC,kBAAkB,CAAC,QAAQ,CAAC;IAO/B,gBAAgB;IAChB,OAAO,CAAC,MAAM;CA0IjB"}
+{"version":3,"file":"FluentToolBuilder.d.ts","sourceRoot":"","sources":["../../../src/core/builder/FluentToolBuilder.ts"],"names":[],"mappings":"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"}