@vurb/core 3.2.0

package/dist/core/execution/PipelineHooks.d.ts

@@ -0,0 +1,46 @@
+/**
+ * PipelineHooks — Strategy Pattern for Execution Observability
+ *
+ * Defines the hook interface used to instrument the tool execution
+ * pipeline without duplicating the core flow. The fast path passes
+ * no hooks (zero overhead); debug and traced paths supply their
+ * strategy via factory methods.
+ *
+ * @module
+ */
+import { type ToolResponse } from '../response.js';
+/**
+ * Hooks for observability instrumentation on each pipeline step.
+ *
+ * Each hook is called at the corresponding step of the execution
+ * pipeline: route → resolve → validate → middleware → execute.
+ */
+export interface PipelineHooks {
+    /** When true, runChain rethrows exceptions (traced path handles them). */
+    readonly rethrow?: boolean;
+    onRouteError?(): void;
+    onRouteOk?(action: string): void;
+    onResolveError?(action: string): void;
+    onValidateError?(action: string, durationMs: number): void;
+    onValidateOk?(action: string, durationMs: number): void;
+    onMiddleware?(action: string, chainLength: number): void;
+    onExecuteOk?(action: string, response: ToolResponse): void;
+    onExecuteError?(action: string, err: unknown): void;
+    /** Wraps every response before returning (used by traced path for span finalization). */
+    wrapResponse?(response: ToolResponse): ToolResponse;
+}
+export declare function computeResponseSize(response: ToolResponse): number;
+/**
+ * Merge two PipelineHooks into one that calls both in sequence.
+ *
+ * When both `primary` and `secondary` define the same hook,
+ * the merged hook calls `primary` first, then `secondary`.
+ *
+ * Returns `primary` if `secondary` is undefined (zero allocation).
+ *
+ * Used to layer telemetry emission on top of debug or traced hooks.
+ *
+ * @internal
+ */
+export declare function mergeHooks(primary: PipelineHooks, secondary: PipelineHooks | undefined): PipelineHooks;
+//# sourceMappingURL=PipelineHooks.d.ts.map

package/dist/core/execution/PipelineHooks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PipelineHooks.d.ts","sourceRoot":"","sources":["../../../src/core/execution/PipelineHooks.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,OAAO,EAAE,KAAK,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAInD;;;;;GAKG;AACH,MAAM,WAAW,aAAa;IAC1B,0EAA0E;IAC1E,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC;IAC3B,YAAY,CAAC,IAAI,IAAI,CAAC;IACtB,SAAS,CAAC,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACjC,cAAc,CAAC,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtC,eAAe,CAAC,CAAC,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3D,YAAY,CAAC,CAAC,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IACxD,YAAY,CAAC,CAAC,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IACzD,WAAW,CAAC,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,YAAY,GAAG,IAAI,CAAC;IAC3D,cAAc,CAAC,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,OAAO,GAAG,IAAI,CAAC;IACpD,yFAAyF;IACzF,YAAY,CAAC,CAAC,QAAQ,EAAE,YAAY,GAAG,YAAY,CAAC;CACvD;AAeD,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,YAAY,GAAG,MAAM,CAMlE;AAID;;;;;;;;;;;GAWG;AACH,wBAAgB,UAAU,CACtB,OAAO,EAAE,aAAa,EACtB,SAAS,EAAE,aAAa,GAAG,SAAS,GACrC,aAAa,CAoBf"}

package/dist/core/execution/PipelineHooks.js

@@ -0,0 +1,66 @@
+/**
+ * PipelineHooks — Strategy Pattern for Execution Observability
+ *
+ * Defines the hook interface used to instrument the tool execution
+ * pipeline without duplicating the core flow. The fast path passes
+ * no hooks (zero overhead); debug and traced paths supply their
+ * strategy via factory methods.
+ *
+ * @module
+ */
+import {} from '../response.js';
+// ── Utilities ────────────────────────────────────────────
+/**
+ * Compute the UTF-8 byte size of a ToolResponse.
+ *
+ * Sums the byte length of all text content blocks.
+ * Uses TextEncoder for UTF-8 accurate byte measurement,
+ * consistent with EgressGuard's byte measurement.
+ *
+ * Used by tracing to record `mcp.response_size` on spans.
+ */
+const _sizeEncoder = new TextEncoder();
+export function computeResponseSize(response) {
+    let size = 0;
+    for (const c of response.content) {
+        if ('text' in c && typeof c.text === 'string')
+            size += _sizeEncoder.encode(c.text).byteLength;
+    }
+    return size;
+}
+// ── Hook Merging ─────────────────────────────────────────
+/**
+ * Merge two PipelineHooks into one that calls both in sequence.
+ *
+ * When both `primary` and `secondary` define the same hook,
+ * the merged hook calls `primary` first, then `secondary`.
+ *
+ * Returns `primary` if `secondary` is undefined (zero allocation).
+ *
+ * Used to layer telemetry emission on top of debug or traced hooks.
+ *
+ * @internal
+ */
+export function mergeHooks(primary, secondary) {
+    if (!secondary)
+        return primary;
+    const merged = {
+        rethrow: !!(primary.rethrow || secondary.rethrow),
+        onRouteError: () => { primary.onRouteError?.(); secondary.onRouteError?.(); },
+        onRouteOk: (a) => { primary.onRouteOk?.(a); secondary.onRouteOk?.(a); },
+        onResolveError: (a) => { primary.onResolveError?.(a); secondary.onResolveError?.(a); },
+        onValidateError: (a, d) => { primary.onValidateError?.(a, d); secondary.onValidateError?.(a, d); },
+        onValidateOk: (a, d) => { primary.onValidateOk?.(a, d); secondary.onValidateOk?.(a, d); },
+        onMiddleware: (a, c) => { primary.onMiddleware?.(a, c); secondary.onMiddleware?.(a, c); },
+        onExecuteOk: (a, r) => { primary.onExecuteOk?.(a, r); secondary.onExecuteOk?.(a, r); },
+        onExecuteError: (a, e) => { primary.onExecuteError?.(a, e); secondary.onExecuteError?.(a, e); },
+    };
+    if (primary.wrapResponse) {
+        merged.wrapResponse = (r) => { const wrapped = primary.wrapResponse(r); return secondary.wrapResponse?.(wrapped) ?? wrapped; };
+    }
+    else if (secondary.wrapResponse) {
+        merged.wrapResponse = secondary.wrapResponse;
+    }
+    return merged;
+}
+//# sourceMappingURL=PipelineHooks.js.map

package/dist/core/execution/PipelineHooks.js.map

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

package/dist/core/execution/ProgressHelper.d.ts

@@ -0,0 +1,67 @@
+/**
+ * ProgressHelper — Streaming Progress Support for Async Generators
+ *
+ * Enables tool handlers to report incremental progress via `yield`,
+ * hiding the underlying MCP progress notification protocol.
+ *
+ * When no server is attached, progress events are silently consumed.
+ * When attached, each yielded progress object is sent as a
+ * `notifications/progress` packet to the MCP client.
+ *
+ * @example
+ * ```typescript
+ * handler: async function* (ctx, args) {
+ *     yield progress(10, 'Cloning repository...');
+ *     const files = await clone(args.url);
+ *
+ *     yield progress(50, 'Building AST...');
+ *     const ast = buildAST(files);
+ *
+ *     return success(ast);
+ * }
+ * ```
+ *
+ * @module
+ */
+/**
+ * A progress notification emitted via `yield` in a generator handler.
+ *
+ * @see {@link progress} for the factory function
+ */
+export interface ProgressEvent {
+    readonly __brand: 'ProgressEvent';
+    /** Completion percentage (0–100) */
+    readonly percent: number;
+    /** Human-readable status message */
+    readonly message: string;
+}
+/**
+ * Callback that receives progress events during generator execution.
+ * By default, a no-op. The server attachment injects a real implementation
+ * that forwards to MCP `notifications/progress`.
+ */
+export type ProgressSink = (event: ProgressEvent) => void;
+/**
+ * Create a progress event to yield from a generator handler.
+ *
+ * @param percent - Completion percentage (0–100)
+ * @param message - Human-readable status message
+ * @returns A {@link ProgressEvent} to be yielded
+ *
+ * @example
+ * ```typescript
+ * handler: async function* (ctx, args) {
+ *     yield progress(10, 'Starting...');
+ *     // ... work ...
+ *     yield progress(90, 'Almost done...');
+ *     return success('Done');
+ * }
+ * ```
+ */
+export declare function progress(percent: number, message: string): ProgressEvent;
+/**
+ * Type guard to check if a yielded value is a ProgressEvent.
+ * @internal
+ */
+export declare function isProgressEvent(value: unknown): value is ProgressEvent;
+//# sourceMappingURL=ProgressHelper.d.ts.map

package/dist/core/execution/ProgressHelper.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ProgressHelper.d.ts","sourceRoot":"","sources":["../../../src/core/execution/ProgressHelper.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAMH;;;;GAIG;AACH,MAAM,WAAW,aAAa;IAC1B,QAAQ,CAAC,OAAO,EAAE,eAAe,CAAC;IAClC,oCAAoC;IACpC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,oCAAoC;IACpC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC5B;AAED;;;;GAIG;AACH,MAAM,MAAM,YAAY,GAAG,CAAC,KAAK,EAAE,aAAa,KAAK,IAAI,CAAC;AAM1D;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,aAAa,CAExE;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,aAAa,CAOtE"}

package/dist/core/execution/ProgressHelper.js

@@ -0,0 +1,59 @@
+/**
+ * ProgressHelper — Streaming Progress Support for Async Generators
+ *
+ * Enables tool handlers to report incremental progress via `yield`,
+ * hiding the underlying MCP progress notification protocol.
+ *
+ * When no server is attached, progress events are silently consumed.
+ * When attached, each yielded progress object is sent as a
+ * `notifications/progress` packet to the MCP client.
+ *
+ * @example
+ * ```typescript
+ * handler: async function* (ctx, args) {
+ *     yield progress(10, 'Cloning repository...');
+ *     const files = await clone(args.url);
+ *
+ *     yield progress(50, 'Building AST...');
+ *     const ast = buildAST(files);
+ *
+ *     return success(ast);
+ * }
+ * ```
+ *
+ * @module
+ */
+// ============================================================================
+// Factory
+// ============================================================================
+/**
+ * Create a progress event to yield from a generator handler.
+ *
+ * @param percent - Completion percentage (0–100)
+ * @param message - Human-readable status message
+ * @returns A {@link ProgressEvent} to be yielded
+ *
+ * @example
+ * ```typescript
+ * handler: async function* (ctx, args) {
+ *     yield progress(10, 'Starting...');
+ *     // ... work ...
+ *     yield progress(90, 'Almost done...');
+ *     return success('Done');
+ * }
+ * ```
+ */
+export function progress(percent, message) {
+    return { __brand: 'ProgressEvent', percent, message };
+}
+/**
+ * Type guard to check if a yielded value is a ProgressEvent.
+ * @internal
+ */
+export function isProgressEvent(value) {
+    return (typeof value === 'object' &&
+        value !== null &&
+        '__brand' in value &&
+        value.__brand === 'ProgressEvent');
+}
+//# sourceMappingURL=ProgressHelper.js.map

package/dist/core/execution/ProgressHelper.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ProgressHelper.js","sourceRoot":"","sources":["../../../src/core/execution/ProgressHelper.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AA0BH,+EAA+E;AAC/E,UAAU;AACV,+EAA+E;AAE/E;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,UAAU,QAAQ,CAAC,OAAe,EAAE,OAAe;IACrD,OAAO,EAAE,OAAO,EAAE,eAAe,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC;AAC1D,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,eAAe,CAAC,KAAc;IAC1C,OAAO,CACH,OAAO,KAAK,KAAK,QAAQ;QACzB,KAAK,KAAK,IAAI;QACd,SAAS,IAAI,KAAK;QACjB,KAA8B,CAAC,OAAO,KAAK,eAAe,CAC9D,CAAC;AACN,CAAC"}

package/dist/core/execution/ValidationErrorFormatter.d.ts

@@ -0,0 +1,34 @@
+/**
+ * ValidationErrorFormatter — LLM-Friendly Zod Error Translation
+ *
+ * Translates raw ZodIssue arrays into directive correction prompts
+ * that guide the LLM to fix its input on the next call.
+ *
+ * Instead of returning:
+ *   "Validation failed: email: Invalid"
+ *
+ * It produces structured XML:
+ *   <validation_error action="users/create">
+ *   <field name="email">Invalid email format. You sent: 'admin@local'. Expected: a valid email address.</field>
+ *   <field name="age">Number must be >= 18. You sent: 10.</field>
+ *   <recovery>Fix the fields above and call the tool again. Do not explain the error.</recovery>
+ *   </validation_error>
+ *
+ * This dramatically reduces LLM retry loops by providing actionable,
+ * unambiguous correction instructions.
+ *
+ * Pure-function module: no state, no side effects.
+ *
+ * @module
+ */
+import { type ZodIssue } from 'zod';
+/**
+ * Format Zod validation issues into an LLM-friendly correction prompt.
+ *
+ * @param issues - Array of ZodIssue from safeParse failure
+ * @param actionKey - The action key (e.g. "users.create") for context
+ * @param sentArgs - The raw args the LLM sent (for "You sent:" hints)
+ * @returns A formatted string optimized for LLM self-correction
+ */
+export declare function formatValidationError(issues: readonly ZodIssue[], actionKey: string, sentArgs: Record<string, unknown>): string;
+//# sourceMappingURL=ValidationErrorFormatter.d.ts.map

package/dist/core/execution/ValidationErrorFormatter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ValidationErrorFormatter.d.ts","sourceRoot":"","sources":["../../../src/core/execution/ValidationErrorFormatter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,OAAO,EAAE,KAAK,QAAQ,EAAE,MAAM,KAAK,CAAC;AAKpC;;;;;;;GAOG;AACH,wBAAgB,qBAAqB,CACjC,MAAM,EAAE,SAAS,QAAQ,EAAE,EAC3B,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAClC,MAAM,CA6BR"}

package/dist/core/execution/ValidationErrorFormatter.js

@@ -0,0 +1,193 @@
+/**
+ * ValidationErrorFormatter — LLM-Friendly Zod Error Translation
+ *
+ * Translates raw ZodIssue arrays into directive correction prompts
+ * that guide the LLM to fix its input on the next call.
+ *
+ * Instead of returning:
+ *   "Validation failed: email: Invalid"
+ *
+ * It produces structured XML:
+ *   <validation_error action="users/create">
+ *   <field name="email">Invalid email format. You sent: 'admin@local'. Expected: a valid email address.</field>
+ *   <field name="age">Number must be >= 18. You sent: 10.</field>
+ *   <recovery>Fix the fields above and call the tool again. Do not explain the error.</recovery>
+ *   </validation_error>
+ *
+ * This dramatically reduces LLM retry loops by providing actionable,
+ * unambiguous correction instructions.
+ *
+ * Pure-function module: no state, no side effects.
+ *
+ * @module
+ */
+import {} from 'zod';
+import { escapeXml, escapeXmlAttr } from '../response.js';
+// ── Public API ───────────────────────────────────────────
+/**
+ * Format Zod validation issues into an LLM-friendly correction prompt.
+ *
+ * @param issues - Array of ZodIssue from safeParse failure
+ * @param actionKey - The action key (e.g. "users.create") for context
+ * @param sentArgs - The raw args the LLM sent (for "You sent:" hints)
+ * @returns A formatted string optimized for LLM self-correction
+ */
+export function formatValidationError(issues, actionKey, sentArgs) {
+    const parts = [];
+    parts.push(`<validation_error action="${escapeXmlAttr(actionKey)}">`);
+    for (const issue of issues) {
+        const fieldPath = issue.path.length > 0
+            ? issue.path.join('.')
+            : '(root)';
+        const sentValue = resolveValue(sentArgs, issue.path);
+        const sentHint = formatSentValue(sentValue);
+        const suggestion = buildSuggestion(issue);
+        let detail = issue.message;
+        if (sentHint) {
+            detail += ` You sent: ${sentHint}.`;
+        }
+        if (suggestion) {
+            detail += ` ${suggestion}`;
+        }
+        parts.push(`<field name="${escapeXmlAttr(fieldPath)}">${escapeXml(detail)}</field>`);
+    }
+    parts.push('<recovery>Fix the fields above and call the tool again. Do not explain the error.</recovery>');
+    parts.push('</validation_error>');
+    return parts.join('\n');
+}
+// ── Suggestion Builder ───────────────────────────────────
+/**
+ * Build an actionable suggestion from Zod issue metadata.
+ *
+ * Each ZodIssueCode has different metadata fields we can use
+ * to generate a precise correction hint.
+ */
+function buildSuggestion(issue) {
+    switch (issue.code) {
+        case 'invalid_type':
+            return `Expected type: ${issue.expected}.`;
+        case 'invalid_string':
+            return buildStringSuggestion(issue);
+        case 'too_small':
+            return buildTooSmallSuggestion(issue);
+        case 'too_big':
+            return buildTooBigSuggestion(issue);
+        case 'invalid_enum_value': {
+            const opts = issue.options;
+            return `Valid options: ${opts.map(o => `'${o}'`).join(', ')}.`;
+        }
+        case 'invalid_literal': {
+            const expected = issue.expected;
+            return `Expected exactly: ${JSON.stringify(expected)}.`;
+        }
+        case 'invalid_union':
+            return `Value didn't match any of the expected formats.`;
+        case 'unrecognized_keys': {
+            const keys = issue.keys;
+            return `Remove or correct unrecognized fields: ${keys.map(k => `'${k}'`).join(', ')}. Check for typos.`;
+        }
+        case 'invalid_date':
+            return 'Expected a valid date string (ISO 8601).';
+        case 'custom':
+            return undefined; // Custom validators already have descriptive messages
+        default:
+            return undefined;
+    }
+}
+function buildStringSuggestion(issue) {
+    switch (issue.validation) {
+        case 'email':
+            return 'Expected: a valid email address (e.g. user@example.com).';
+        case 'url':
+            return 'Expected: a valid URL (e.g. https://example.com).';
+        case 'uuid':
+            return 'Expected: a valid UUID (e.g. 123e4567-e89b-12d3-a456-426614174000).';
+        case 'cuid':
+            return 'Expected: a valid CUID.';
+        case 'datetime':
+            return 'Expected: an ISO 8601 datetime (e.g. 2024-01-15T10:30:00Z).';
+        case 'ip':
+            return 'Expected: a valid IP address.';
+        case 'emoji':
+            return 'Expected: a valid emoji character.';
+        case 'regex':
+            return 'Value does not match the required pattern.';
+        default:
+            return undefined;
+    }
+}
+function buildTooSmallSuggestion(issue) {
+    const bound = issue.inclusive ? '>=' : '>';
+    switch (issue.type) {
+        case 'string':
+            return `Minimum length: ${issue.minimum} character${issue.minimum === 1 ? '' : 's'}.`;
+        case 'number':
+        case 'bigint':
+            return `Must be ${bound} ${issue.minimum}.`;
+        case 'array':
+            return `Minimum ${issue.minimum} item${issue.minimum === 1 ? '' : 's'}.`;
+        case 'date':
+            return `Must be after ${new Date(issue.minimum).toISOString()}.`;
+        default:
+            return `Must be ${bound} ${issue.minimum}.`;
+    }
+}
+function buildTooBigSuggestion(issue) {
+    const bound = issue.inclusive ? '<=' : '<';
+    switch (issue.type) {
+        case 'string':
+            return `Maximum length: ${issue.maximum} character${issue.maximum === 1 ? '' : 's'}.`;
+        case 'number':
+        case 'bigint':
+            return `Must be ${bound} ${issue.maximum}.`;
+        case 'array':
+            return `Maximum ${issue.maximum} item${issue.maximum === 1 ? '' : 's'}.`;
+        default:
+            return `Must be ${bound} ${issue.maximum}.`;
+    }
+}
+// ── Value Resolution ─────────────────────────────────────
+/**
+ * Resolve a nested value from an object using a ZodIssue path.
+ * Returns undefined if the path doesn't exist.
+ */
+function resolveValue(obj, path) {
+    if (path.length === 0)
+        return undefined;
+    let current = obj;
+    for (const key of path) {
+        if (current === null || current === undefined)
+            return undefined;
+        if (typeof current === 'object') {
+            current = current[key];
+        }
+        else {
+            return undefined;
+        }
+    }
+    return current;
+}
+/**
+ * Format a sent value for display in the error message.
+ * Truncates long strings and handles undefined gracefully.
+ */
+function formatSentValue(value) {
+    if (value === undefined)
+        return '(missing)';
+    if (value === null)
+        return 'null';
+    if (typeof value === 'string') {
+        const truncated = value.length > 50
+            ? value.slice(0, 47) + '...'
+            : value;
+        return `'${truncated}'`;
+    }
+    if (typeof value === 'number' || typeof value === 'boolean') {
+        return String(value);
+    }
+    if (Array.isArray(value)) {
+        return `array(${value.length})`;
+    }
+    return JSON.stringify(value).slice(0, 50);
+}
+//# sourceMappingURL=ValidationErrorFormatter.js.map

package/dist/core/execution/ValidationErrorFormatter.js.map

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

package/dist/core/execution/index.d.ts

@@ -0,0 +1,9 @@
+/** Execution Bounded Context — Barrel Export */
+export { parseDiscriminator, resolveAction, validateArgs, runChain, type ExecutionContext, type GeneratorResultEnvelope, } from './ExecutionPipeline.js';
+export { compileMiddlewareChains, wrapChain, type CompiledChain } from './MiddlewareCompiler.js';
+export { progress, isProgressEvent, type ProgressEvent, type ProgressSink } from './ProgressHelper.js';
+export { computeResponseSize, type PipelineHooks } from './PipelineHooks.js';
+export { ConcurrencyGuard, type ConcurrencyConfig, createConcurrencyGuard } from './ConcurrencyGuard.js';
+export { applyEgressGuard, type EgressConfig } from './EgressGuard.js';
+export { MutationSerializer } from './MutationSerializer.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/core/execution/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/core/execution/index.ts"],"names":[],"mappings":"AAAA,gDAAgD;AAChD,OAAO,EACH,kBAAkB,EAAE,aAAa,EAAE,YAAY,EAAE,QAAQ,EACzD,KAAK,gBAAgB,EAAE,KAAK,uBAAuB,GACtD,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAAE,uBAAuB,EAAE,SAAS,EAAE,KAAK,aAAa,EAAE,MAAM,yBAAyB,CAAC;AACjG,OAAO,EAAE,QAAQ,EAAE,eAAe,EAAE,KAAK,aAAa,EAAE,KAAK,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACvG,OAAO,EAAE,mBAAmB,EAAE,KAAK,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAC7E,OAAO,EAAE,gBAAgB,EAAE,KAAK,iBAAiB,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAC;AACzG,OAAO,EAAE,gBAAgB,EAAE,KAAK,YAAY,EAAE,MAAM,kBAAkB,CAAC;AACvE,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC"}

package/dist/core/execution/index.js

@@ -0,0 +1,9 @@
+/** Execution Bounded Context — Barrel Export */
+export { parseDiscriminator, resolveAction, validateArgs, runChain, } from './ExecutionPipeline.js';
+export { compileMiddlewareChains, wrapChain } from './MiddlewareCompiler.js';
+export { progress, isProgressEvent } from './ProgressHelper.js';
+export { computeResponseSize } from './PipelineHooks.js';
+export { ConcurrencyGuard, createConcurrencyGuard } from './ConcurrencyGuard.js';
+export { applyEgressGuard } from './EgressGuard.js';
+export { MutationSerializer } from './MutationSerializer.js';
+//# sourceMappingURL=index.js.map

package/dist/core/execution/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/core/execution/index.ts"],"names":[],"mappings":"AAAA,gDAAgD;AAChD,OAAO,EACH,kBAAkB,EAAE,aAAa,EAAE,YAAY,EAAE,QAAQ,GAE5D,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAAE,uBAAuB,EAAE,SAAS,EAAsB,MAAM,yBAAyB,CAAC;AACjG,OAAO,EAAE,QAAQ,EAAE,eAAe,EAAyC,MAAM,qBAAqB,CAAC;AACvG,OAAO,EAAE,mBAAmB,EAAsB,MAAM,oBAAoB,CAAC;AAC7E,OAAO,EAAE,gBAAgB,EAA0B,sBAAsB,EAAE,MAAM,uBAAuB,CAAC;AACzG,OAAO,EAAE,gBAAgB,EAAqB,MAAM,kBAAkB,CAAC;AACvE,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC"}

package/dist/core/index.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Core — Barrel Export
+ *
+ * Public API for the core tool consolidation engine.
+ * Contains only the foundational building blocks: response helpers,
+ * result monad, types, builder, registry, schema, execution, and middleware.
+ */
+export { success, error, required, toonSuccess, toolError } from './response.js';
+export type { ToolResponse, ToolErrorOptions, ErrorCode, ErrorSeverity } from './response.js';
+export { succeed, fail } from './result.js';
+export type { Result, Success, Failure } from './result.js';
+export type { ToolBuilder, ActionMetadata, InternalAction, MiddlewareFn, ActionConfig, StateSyncHint, } from './types.js';
+export { GroupedToolBuilder, ActionGroupBuilder, createTool, defineTool } from './builder/index.js';
+export { FluentToolBuilder } from './builder/index.js';
+export { FluentRouter } from './builder/index.js';
+export type { GroupConfigurator, ToolConfig, ActionDef, GroupDef } from './builder/index.js';
+export type { SemanticDefaults } from './builder/index.js';
+export { ToolRegistry } from './registry/index.js';
+export type { ToolFilter } from './registry/index.js';
+export { generateToonDescription } from './schema/index.js';
+export { progress } from './execution/index.js';
+export type { ProgressEvent, ProgressSink } from './execution/index.js';
+export type { ConcurrencyConfig } from './execution/index.js';
+export type { EgressConfig } from './execution/index.js';
+export type { SandboxConfig, SandboxResult, SandboxErrorCode } from '../sandbox/index.js';
+export { defineMiddleware, resolveMiddleware } from './middleware/index.js';
+export type { MiddlewareDefinition, MergeContext, InferContextOut } from './middleware/index.js';
+export { initVurb } from './initVurb.js';
+export type { VurbInstance } from './initVurb.js';
+export { createGroup } from './createGroup.js';
+export type { GroupConfig, GroupAction, CompiledGroup } from './createGroup.js';
+export { toStandardValidator, fromZodSchema, isStandardSchema, autoValidator, } from './StandardSchema.js';
+export type { StandardSchemaV1, StandardSchemaIssue, InferStandardOutput, VurbValidator, ValidationResult, } from './StandardSchema.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/core/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/core/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AACjF,YAAY,EAAE,YAAY,EAAE,gBAAgB,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAC9F,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,aAAa,CAAC;AAC5C,YAAY,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAG5D,YAAY,EACR,WAAW,EAAE,cAAc,EAC3B,cAAc,EAAE,YAAY,EAC5B,YAAY,EAAE,aAAa,GAC9B,MAAM,YAAY,CAAC;AAGpB,OAAO,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AACpG,OAAO,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AACvD,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,YAAY,EAAE,iBAAiB,EAAE,UAAU,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAC7F,YAAY,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAG3D,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,YAAY,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAGtD,OAAO,EAAE,uBAAuB,EAAE,MAAM,mBAAmB,CAAC;AAG5D,OAAO,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAChD,YAAY,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AACxE,YAAY,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAC9D,YAAY,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAGzD,YAAY,EAAE,aAAa,EAAE,aAAa,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAG1F,OAAO,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAC5E,YAAY,EAAE,oBAAoB,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAGjG,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AACzC,YAAY,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAGlD,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAC/C,YAAY,EAAE,WAAW,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAGhF,OAAO,EACH,mBAAmB,EAAE,aAAa,EAAE,gBAAgB,EAAE,aAAa,GACtE,MAAM,qBAAqB,CAAC;AAC7B,YAAY,EACR,gBAAgB,EAAE,mBAAmB,EAAE,mBAAmB,EAC1D,aAAa,EAAE,gBAAgB,GAClC,MAAM,qBAAqB,CAAC"}

package/dist/core/index.js

@@ -0,0 +1,29 @@
+/**
+ * Core — Barrel Export
+ *
+ * Public API for the core tool consolidation engine.
+ * Contains only the foundational building blocks: response helpers,
+ * result monad, types, builder, registry, schema, execution, and middleware.
+ */
+// ── Cross-cutting ────────────────────────────────────────
+export { success, error, required, toonSuccess, toolError } from './response.js';
+export { succeed, fail } from './result.js';
+// ── Builder ──────────────────────────────────────────────
+export { GroupedToolBuilder, ActionGroupBuilder, createTool, defineTool } from './builder/index.js';
+export { FluentToolBuilder } from './builder/index.js';
+export { FluentRouter } from './builder/index.js';
+// ── Registry ─────────────────────────────────────────────
+export { ToolRegistry } from './registry/index.js';
+// ── Schema (public strategies) ───────────────────────────
+export { generateToonDescription } from './schema/index.js';
+// ── Execution (progress streaming + runtime guards) ──────
+export { progress } from './execution/index.js';
+// ── Middleware (context derivation) ──────────────────────
+export { defineMiddleware, resolveMiddleware } from './middleware/index.js';
+// ── Vurb Initializer (tRPC-style) ─────────────────────
+export { initVurb } from './initVurb.js';
+// ── Functional Core ──────────────────────────────────────
+export { createGroup } from './createGroup.js';
+// ── Standard Schema ──────────────────────────────────────
+export { toStandardValidator, fromZodSchema, isStandardSchema, autoValidator, } from './StandardSchema.js';
+//# sourceMappingURL=index.js.map

package/dist/core/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/core/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,4DAA4D;AAC5D,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAEjF,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,aAAa,CAAC;AAU5C,4DAA4D;AAC5D,OAAO,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AACpG,OAAO,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AACvD,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAIlD,4DAA4D;AAC5D,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAGnD,4DAA4D;AAC5D,OAAO,EAAE,uBAAuB,EAAE,MAAM,mBAAmB,CAAC;AAE5D,4DAA4D;AAC5D,OAAO,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAQhD,4DAA4D;AAC5D,OAAO,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAG5E,yDAAyD;AACzD,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAGzC,4DAA4D;AAC5D,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAG/C,4DAA4D;AAC5D,OAAO,EACH,mBAAmB,EAAE,aAAa,EAAE,gBAAgB,EAAE,aAAa,GACtE,MAAM,qBAAqB,CAAC"}