mcp-ai-agent-guidelines 0.13.1 → 0.14.0

package/dist/domain/base-strategy/execution-trace.d.ts

@@ -0,0 +1,142 @@
+/**
+ * Execution Trace - records decisions, metrics, and errors during strategy execution.
+ *
+ * The trace is mutable during execution but provides immutable snapshots for export.
+ * This domain-level trace is distinct from the legacy strategies/shared ExecutionTrace.
+ */
+import type { Decision, ExecutionTraceData, TracedError } from "./types.js";
+type IdGenerator = () => string;
+type Clock = () => Date;
+interface ExecutionTraceOptions {
+    readonly executionId?: string;
+    readonly startedAt?: Date;
+    readonly now?: Clock;
+    readonly idGenerator?: IdGenerator;
+    readonly onFallbackId?: (fallbackId: string) => void;
+}
+/**
+ * Execution Trace - records decisions, metrics, and errors during strategy execution.
+ *
+ * The trace is mutable during execution but provides immutable snapshots for export.
+ *
+ * @example
+ * ```typescript
+ * const trace = new ExecutionTrace('my-strategy', '1.0.0');
+ *
+ * trace.recordDecision(
+ *   'select-template',
+ *   'Selected enterprise template based on input size',
+ *   { inputSize: 1500, threshold: 1000 }
+ * );
+ *
+ * trace.recordMetric('generation_time_ms', 250);
+ *
+ * try {
+ *   // operation
+ * } catch (error) {
+ *   trace.recordError(error, { operation: 'template-render' });
+ * }
+ *
+ * // Export for debugging
+ * const markdown = trace.toMarkdown();
+ * ```
+ */
+export declare class ExecutionTrace {
+    private readonly strategyName;
+    private readonly strategyVersion;
+    private readonly executionId;
+    private readonly startedAt;
+    private completedAt;
+    private readonly now;
+    private readonly idGenerator;
+    private readonly _decisions;
+    private readonly _metrics;
+    private readonly _errors;
+    constructor(strategyName: string, strategyVersion: string, options?: ExecutionTraceOptions);
+    /**
+     * Record a decision made during execution.
+     *
+     * @param category - Decision category (e.g., 'validation', 'generation', 'selection')
+     * @param description - Human-readable description of the decision
+     * @param context - Additional context (must be JSON-serializable)
+     * @returns The recorded decision
+     */
+    recordDecision(category: string, description: string, context?: Record<string, unknown>): Decision;
+    /**
+     * Record a numeric metric.
+     *
+     * @param name - Metric name (e.g., 'generation_time_ms', 'token_count')
+     * @param value - Metric value
+     */
+    recordMetric(name: string, value: number): void;
+    /**
+     * Increment a counter metric.
+     *
+     * @param name - Counter name
+     * @param increment - Amount to increment (default: 1)
+     */
+    incrementMetric(name: string, increment?: number): void;
+    /**
+     * Record an error with context.
+     *
+     * @param error - The error that occurred
+     * @param context - Additional context at time of error
+     */
+    recordError(error: Error, context?: Record<string, unknown>): void;
+    /**
+     * Mark the trace as complete.
+     */
+    complete(): void;
+    /**
+     * Get all recorded decisions.
+     */
+    get decisions(): readonly Decision[];
+    /**
+     * Get all recorded metrics.
+     */
+    get metrics(): Readonly<Record<string, number>>;
+    /**
+     * Get all recorded errors.
+     */
+    get errors(): readonly TracedError[];
+    /**
+     * Get current duration in milliseconds.
+     */
+    get durationMs(): number;
+    /**
+     * Check if any errors were recorded.
+     */
+    get hasErrors(): boolean;
+    /**
+     * Get decisions filtered by category.
+     */
+    getDecisionsByCategory(category: string): readonly Decision[];
+    /**
+     * Export trace as immutable data object.
+     */
+    toData(): ExecutionTraceData;
+    /**
+     * Export trace as JSON string.
+     */
+    toJSON(): string;
+    /**
+     * Export trace as Markdown for human-readable debugging.
+     */
+    toMarkdown(): string;
+    /**
+     * Sanitize context to ensure it's JSON-serializable.
+     * Circular detection is scoped to the current traversal path; shared references
+     * are serialized independently rather than de-duplicated (for example, if the
+     * same object is referenced by two sibling keys, each key gets its own copy).
+     * This can increase trace size when large objects are referenced multiple times.
+     */
+    private sanitizeContext;
+    private sanitizeValue;
+    private cloneDecision;
+    private cloneError;
+    private cloneDate;
+    private cloneContext;
+    private isRecord;
+}
+export {};
+//# sourceMappingURL=execution-trace.d.ts.map

package/dist/domain/base-strategy/execution-trace.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"execution-trace.d.ts","sourceRoot":"","sources":["../../../src/domain/base-strategy/execution-trace.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,kBAAkB,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAE5E,KAAK,WAAW,GAAG,MAAM,MAAM,CAAC;AAChC,KAAK,KAAK,GAAG,MAAM,IAAI,CAAC;AAExB,UAAU,qBAAqB;IAC9B,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,SAAS,CAAC,EAAE,IAAI,CAAC;IAC1B,QAAQ,CAAC,GAAG,CAAC,EAAE,KAAK,CAAC;IACrB,QAAQ,CAAC,WAAW,CAAC,EAAE,WAAW,CAAC;IACnC,QAAQ,CAAC,YAAY,CAAC,EAAE,CAAC,UAAU,EAAE,MAAM,KAAK,IAAI,CAAC;CACrD;AAsBD;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,qBAAa,cAAc;IAYzB,OAAO,CAAC,QAAQ,CAAC,YAAY;IAC7B,OAAO,CAAC,QAAQ,CAAC,eAAe;IAZjC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAS;IACrC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAO;IACjC,OAAO,CAAC,WAAW,CAAqB;IACxC,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAQ;IAC5B,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAc;IAE1C,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAkB;IAC7C,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAA8B;IACvD,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAqB;gBAG3B,YAAY,EAAE,MAAM,EACpB,eAAe,EAAE,MAAM,EACxC,OAAO,GAAE,qBAA0B;IAiBpC;;;;;;;OAOG;IACH,cAAc,CACb,QAAQ,EAAE,MAAM,EAChB,WAAW,EAAE,MAAM,EACnB,OAAO,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM,GACnC,QAAQ;IAaX;;;;;OAKG;IACH,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI;IAI/C;;;;;OAKG;IACH,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,SAAI,GAAG,IAAI;IAIlD;;;;;OAKG;IACH,WAAW,CAAC,KAAK,EAAE,KAAK,EAAE,OAAO,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM,GAAG,IAAI;IAUtE;;OAEG;IACH,QAAQ,IAAI,IAAI;IAShB;;OAEG;IACH,IAAI,SAAS,IAAI,SAAS,QAAQ,EAAE,CAEnC;IAED;;OAEG;IACH,IAAI,OAAO,IAAI,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAE9C;IAED;;OAEG;IACH,IAAI,MAAM,IAAI,SAAS,WAAW,EAAE,CAEnC;IAED;;OAEG;IACH,IAAI,UAAU,IAAI,MAAM,CAGvB;IAED;;OAEG;IACH,IAAI,SAAS,IAAI,OAAO,CAEvB;IAED;;OAEG;IACH,sBAAsB,CAAC,QAAQ,EAAE,MAAM,GAAG,SAAS,QAAQ,EAAE;IAQ7D;;OAEG;IACH,MAAM,IAAI,kBAAkB;IAe5B;;OAEG;IACH,MAAM,IAAI,MAAM;IAIhB;;OAEG;IACH,UAAU,IAAI,MAAM;IAwFpB;;;;;;OAMG;IACH,OAAO,CAAC,eAAe;IAOvB,OAAO,CAAC,aAAa;IAgFrB,OAAO,CAAC,aAAa;IAQrB,OAAO,CAAC,UAAU;IAQlB,OAAO,CAAC,SAAS;IAIjB,OAAO,CAAC,YAAY;IASpB,OAAO,CAAC,QAAQ;CAGhB"}

package/dist/domain/base-strategy/execution-trace.js

@@ -0,0 +1,377 @@
+/**
+ * Execution Trace - records decisions, metrics, and errors during strategy execution.
+ *
+ * The trace is mutable during execution but provides immutable snapshots for export.
+ * This domain-level trace is distinct from the legacy strategies/shared ExecutionTrace.
+ */
+const defaultClock = () => new Date();
+const defaultIdGenerator = () => {
+    const cryptoApi = globalThis.crypto;
+    if (cryptoApi?.randomUUID) {
+        return cryptoApi.randomUUID();
+    }
+    // Fallback IDs are not cryptographically secure; use the idGenerator option in
+    // ExecutionTraceOptions to inject a custom ID generator if stronger guarantees
+    // are required (or use onFallbackId to surface a warning to callers).
+    return generateFallbackUUID();
+};
+const generateFallbackUUID = () => "xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx".replace(/[xy]/g, (char) => {
+    const randomValue = Math.floor(Math.random() * 16);
+    const value = char === "x" ? randomValue : (randomValue & 0x3) | 0x8;
+    return value.toString(16);
+});
+/**
+ * Execution Trace - records decisions, metrics, and errors during strategy execution.
+ *
+ * The trace is mutable during execution but provides immutable snapshots for export.
+ *
+ * @example
+ * ```typescript
+ * const trace = new ExecutionTrace('my-strategy', '1.0.0');
+ *
+ * trace.recordDecision(
+ *   'select-template',
+ *   'Selected enterprise template based on input size',
+ *   { inputSize: 1500, threshold: 1000 }
+ * );
+ *
+ * trace.recordMetric('generation_time_ms', 250);
+ *
+ * try {
+ *   // operation
+ * } catch (error) {
+ *   trace.recordError(error, { operation: 'template-render' });
+ * }
+ *
+ * // Export for debugging
+ * const markdown = trace.toMarkdown();
+ * ```
+ */
+export class ExecutionTrace {
+    strategyName;
+    strategyVersion;
+    executionId;
+    startedAt;
+    completedAt = null;
+    now;
+    idGenerator;
+    _decisions = [];
+    _metrics = {};
+    _errors = [];
+    constructor(strategyName, strategyVersion, options = {}) {
+        this.strategyName = strategyName;
+        this.strategyVersion = strategyVersion;
+        const usingDefaultIdGenerator = !options.executionId && !options.idGenerator;
+        this.now = options.now ?? defaultClock;
+        this.idGenerator = options.idGenerator ?? defaultIdGenerator;
+        this.executionId = options.executionId ?? this.idGenerator();
+        this.startedAt = options.startedAt ?? this.now();
+        if (usingDefaultIdGenerator && !globalThis.crypto?.randomUUID) {
+            options.onFallbackId?.(this.executionId);
+        }
+    }
+    // ============================================
+    // Recording Methods
+    // ============================================
+    /**
+     * Record a decision made during execution.
+     *
+     * @param category - Decision category (e.g., 'validation', 'generation', 'selection')
+     * @param description - Human-readable description of the decision
+     * @param context - Additional context (must be JSON-serializable)
+     * @returns The recorded decision
+     */
+    recordDecision(category, description, context = {}) {
+        const decision = {
+            id: this.idGenerator(),
+            timestamp: this.now(),
+            category,
+            description,
+            context: this.sanitizeContext(context),
+        };
+        this._decisions.push(decision);
+        return decision;
+    }
+    /**
+     * Record a numeric metric.
+     *
+     * @param name - Metric name (e.g., 'generation_time_ms', 'token_count')
+     * @param value - Metric value
+     */
+    recordMetric(name, value) {
+        this._metrics[name] = value;
+    }
+    /**
+     * Increment a counter metric.
+     *
+     * @param name - Counter name
+     * @param increment - Amount to increment (default: 1)
+     */
+    incrementMetric(name, increment = 1) {
+        this._metrics[name] = (this._metrics[name] ?? 0) + increment;
+    }
+    /**
+     * Record an error with context.
+     *
+     * @param error - The error that occurred
+     * @param context - Additional context at time of error
+     */
+    recordError(error, context = {}) {
+        this._errors.push({
+            timestamp: this.now(),
+            category: error.name || "Error",
+            message: error.message,
+            stack: error.stack,
+            context: this.sanitizeContext(context),
+        });
+    }
+    /**
+     * Mark the trace as complete.
+     */
+    complete() {
+        this.completedAt = this.now();
+        this.recordMetric("total_duration_ms", this.durationMs);
+    }
+    // ============================================
+    // Query Methods
+    // ============================================
+    /**
+     * Get all recorded decisions.
+     */
+    get decisions() {
+        return this._decisions.map((decision) => this.cloneDecision(decision));
+    }
+    /**
+     * Get all recorded metrics.
+     */
+    get metrics() {
+        return { ...this._metrics };
+    }
+    /**
+     * Get all recorded errors.
+     */
+    get errors() {
+        return this._errors.map((error) => this.cloneError(error));
+    }
+    /**
+     * Get current duration in milliseconds.
+     */
+    get durationMs() {
+        const endTime = this.completedAt ?? this.now();
+        return endTime.getTime() - this.startedAt.getTime();
+    }
+    /**
+     * Check if any errors were recorded.
+     */
+    get hasErrors() {
+        return this._errors.length > 0;
+    }
+    /**
+     * Get decisions filtered by category.
+     */
+    getDecisionsByCategory(category) {
+        return this._decisions.filter((d) => d.category === category);
+    }
+    // ============================================
+    // Export Methods
+    // ============================================
+    /**
+     * Export trace as immutable data object.
+     */
+    toData() {
+        return {
+            executionId: this.executionId,
+            strategyName: this.strategyName,
+            strategyVersion: this.strategyVersion,
+            startedAt: this.cloneDate(this.startedAt),
+            completedAt: this.completedAt ? this.cloneDate(this.completedAt) : null,
+            decisions: this._decisions.map((decision) => this.cloneDecision(decision)),
+            metrics: { ...this._metrics },
+            errors: this._errors.map((error) => this.cloneError(error)),
+        };
+    }
+    /**
+     * Export trace as JSON string.
+     */
+    toJSON() {
+        return JSON.stringify(this.toData(), null, 2);
+    }
+    /**
+     * Export trace as Markdown for human-readable debugging.
+     */
+    toMarkdown() {
+        const lines = [];
+        // Header
+        lines.push(`# Execution Trace: ${this.strategyName} v${this.strategyVersion}`);
+        lines.push("");
+        lines.push(`**Execution ID**: \`${this.executionId}\``);
+        lines.push(`**Started**: ${this.startedAt.toISOString()}`);
+        if (this.completedAt) {
+            lines.push(`**Completed**: ${this.completedAt.toISOString()}`);
+        }
+        lines.push(`**Duration**: ${this.durationMs}ms`);
+        lines.push("");
+        // Metrics
+        if (Object.keys(this._metrics).length > 0) {
+            lines.push("## Metrics");
+            lines.push("");
+            lines.push("| Metric | Value |");
+            lines.push("|--------|-------|");
+            for (const [name, value] of Object.entries(this._metrics)) {
+                lines.push(`| ${name} | ${value} |`);
+            }
+            lines.push("");
+        }
+        // Decisions
+        if (this._decisions.length > 0) {
+            lines.push("## Decisions");
+            lines.push("");
+            for (const decision of this._decisions) {
+                lines.push(`### ${decision.category}`);
+                lines.push("");
+                lines.push(`**Time**: ${decision.timestamp.toISOString()}`);
+                lines.push("");
+                lines.push(decision.description);
+                lines.push("");
+                if (Object.keys(decision.context).length > 0) {
+                    lines.push("**Context**:");
+                    lines.push("```json");
+                    lines.push(JSON.stringify(decision.context, null, 2));
+                    lines.push("```");
+                    lines.push("");
+                }
+            }
+        }
+        // Errors
+        if (this._errors.length > 0) {
+            lines.push("## Errors");
+            lines.push("");
+            for (const error of this._errors) {
+                lines.push(`### ${error.category}`);
+                lines.push("");
+                lines.push(`**Time**: ${error.timestamp.toISOString()}`);
+                lines.push(`**Message**: ${error.message}`);
+                lines.push("");
+                if (error.stack) {
+                    lines.push("**Stack**:");
+                    lines.push("```");
+                    lines.push(error.stack);
+                    lines.push("```");
+                    lines.push("");
+                }
+                if (Object.keys(error.context).length > 0) {
+                    lines.push("**Context**:");
+                    lines.push("```json");
+                    lines.push(JSON.stringify(error.context, null, 2));
+                    lines.push("```");
+                    lines.push("");
+                }
+            }
+        }
+        return lines.join("\n");
+    }
+    // ============================================
+    // Private Helpers
+    // ============================================
+    /**
+     * Sanitize context to ensure it's JSON-serializable.
+     * Circular detection is scoped to the current traversal path; shared references
+     * are serialized independently rather than de-duplicated (for example, if the
+     * same object is referenced by two sibling keys, each key gets its own copy).
+     * This can increase trace size when large objects are referenced multiple times.
+     */
+    sanitizeContext(context) {
+        const sanitized = this.sanitizeValue(context, new WeakSet());
+        return this.isRecord(sanitized) ? sanitized : {};
+    }
+    sanitizeValue(value, path) {
+        if (value === null) {
+            return null;
+        }
+        if (typeof value === "string" || typeof value === "number") {
+            return value;
+        }
+        if (typeof value === "boolean") {
+            return value;
+        }
+        if (typeof value === "bigint" ||
+            typeof value === "symbol" ||
+            typeof value === "function" ||
+            typeof value === "undefined") {
+            return String(value);
+        }
+        if (value instanceof Date) {
+            return value.toISOString();
+        }
+        if (value instanceof RegExp) {
+            return value.toString();
+        }
+        if (value instanceof Error) {
+            return {
+                name: value.name,
+                message: value.message,
+                stack: value.stack,
+            };
+        }
+        if (value instanceof Map) {
+            // Map entries are serialized as [key, value] tuples with stringified keys.
+            // Non-string keys that stringify to the same value may collide (for example,
+            // keys 1 and "1" both stringify to "1"), which risks data loss.
+            // Prefer string keys for traceable context.
+            return Array.from(value.entries()).map(([key, entryValue]) => [
+                String(key),
+                this.sanitizeValue(entryValue, path),
+            ]);
+        }
+        if (value instanceof Set) {
+            return Array.from(value.values()).map((entryValue) => this.sanitizeValue(entryValue, path));
+        }
+        if (Array.isArray(value)) {
+            return value.map((entryValue) => this.sanitizeValue(entryValue, path));
+        }
+        if (typeof value === "object") {
+            if (path.has(value)) {
+                return "[Circular]";
+            }
+            path.add(value);
+            try {
+                const result = {};
+                for (const [key, entryValue] of Object.entries(value)) {
+                    result[key] = this.sanitizeValue(entryValue, path);
+                }
+                return result;
+            }
+            finally {
+                path.delete(value);
+            }
+        }
+        return String(value);
+    }
+    cloneDecision(decision) {
+        return {
+            ...decision,
+            timestamp: this.cloneDate(decision.timestamp),
+            context: this.cloneContext(decision.context),
+        };
+    }
+    cloneError(error) {
+        return {
+            ...error,
+            timestamp: this.cloneDate(error.timestamp),
+            context: this.cloneContext(error.context),
+        };
+    }
+    cloneDate(date) {
+        return new Date(date.getTime());
+    }
+    cloneContext(context) {
+        if (typeof structuredClone === "function") {
+            return structuredClone(context);
+        }
+        return JSON.parse(JSON.stringify(context));
+    }
+    isRecord(value) {
+        return typeof value === "object" && value !== null && !Array.isArray(value);
+    }
+}
+//# sourceMappingURL=execution-trace.js.map

package/dist/domain/base-strategy/execution-trace.js.map

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

package/dist/domain/base-strategy/index.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Base Strategy domain module.
+ *
+ * Provides ExecutionTrace for logging decisions, metrics, and errors
+ * during strategy execution.
+ */
+export { ExecutionTrace } from "./execution-trace.js";
+export { createTrace, mergeTraces, startTiming, withErrorTracing, } from "./trace-utils.js";
+export type { Decision, ExecutionTraceData, TracedError } from "./types.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/domain/base-strategy/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/domain/base-strategy/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAEtD,OAAO,EACN,WAAW,EACX,WAAW,EACX,WAAW,EACX,gBAAgB,GAChB,MAAM,kBAAkB,CAAC;AAE1B,YAAY,EAAE,QAAQ,EAAE,kBAAkB,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC"}

package/dist/domain/base-strategy/index.js

@@ -0,0 +1,11 @@
+/**
+ * Base Strategy domain module.
+ *
+ * Provides ExecutionTrace for logging decisions, metrics, and errors
+ * during strategy execution.
+ */
+// Core class
+export { ExecutionTrace } from "./execution-trace.js";
+// Utilities
+export { createTrace, mergeTraces, startTiming, withErrorTracing, } from "./trace-utils.js";
+//# sourceMappingURL=index.js.map

package/dist/domain/base-strategy/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/domain/base-strategy/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,aAAa;AACb,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,YAAY;AACZ,OAAO,EACN,WAAW,EACX,WAAW,EACX,WAAW,EACX,gBAAgB,GAChB,MAAM,kBAAkB,CAAC"}

package/dist/domain/base-strategy/trace-utils.d.ts

@@ -0,0 +1,59 @@
+/**
+ * Utility functions for working with ExecutionTrace.
+ *
+ * Provides factory functions, timing helpers, and trace aggregation utilities.
+ */
+import { ExecutionTrace } from "./execution-trace.js";
+import type { ExecutionTraceData } from "./types.js";
+/**
+ * Create a new execution trace for a strategy.
+ *
+ * @param strategyName - Name of the strategy
+ * @param strategyVersion - Version of the strategy
+ * @returns New ExecutionTrace instance
+ */
+export declare function createTrace(strategyName: string, strategyVersion: string): ExecutionTrace;
+/**
+ * Merge multiple traces into a summary.
+ *
+ * Useful for aggregating traces from sub-strategies or parallel execution.
+ */
+export declare function mergeTraces(traces: ExecutionTraceData[]): {
+    totalDuration: number;
+    totalDecisions: number;
+    totalErrors: number;
+    metrics: Record<string, number>;
+};
+/**
+ * Create a timing helper for measuring durations.
+ *
+ * @param trace - Trace to record timing to
+ * @param metricName - Name of the timing metric
+ * @returns Function to call when operation completes
+ *
+ * @example
+ * ```typescript
+ * const endTiming = startTiming(trace, 'generation_time_ms');
+ * await generateDocument();
+ * endTiming(); // Records duration to trace
+ * ```
+ */
+export declare function startTiming(trace: ExecutionTrace, metricName: string): () => number;
+/**
+ * Wrap an async operation with automatic error tracing.
+ *
+ * @param trace - Trace to record to
+ * @param operation - Async operation to wrap
+ * @param context - Context to include if error occurs
+ *
+ * @example
+ * ```typescript
+ * const result = await withErrorTracing(
+ *   trace,
+ *   () => fetchData(url),
+ *   { url, operation: 'fetch-data' }
+ * );
+ * ```
+ */
+export declare function withErrorTracing<T>(trace: ExecutionTrace, operation: () => Promise<T>, context?: Record<string, unknown>): Promise<T>;
+//# sourceMappingURL=trace-utils.d.ts.map

package/dist/domain/base-strategy/trace-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"trace-utils.d.ts","sourceRoot":"","sources":["../../../src/domain/base-strategy/trace-utils.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAErD;;;;;;GAMG;AACH,wBAAgB,WAAW,CAC1B,YAAY,EAAE,MAAM,EACpB,eAAe,EAAE,MAAM,GACrB,cAAc,CAEhB;AAED;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,MAAM,EAAE,kBAAkB,EAAE,GAAG;IAC1D,aAAa,EAAE,MAAM,CAAC;IACtB,cAAc,EAAE,MAAM,CAAC;IACvB,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAChC,CAoBA;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,WAAW,CAC1B,KAAK,EAAE,cAAc,EACrB,UAAU,EAAE,MAAM,GAChB,MAAM,MAAM,CAQd;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAsB,gBAAgB,CAAC,CAAC,EACvC,KAAK,EAAE,cAAc,EACrB,SAAS,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EAC3B,OAAO,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM,GACnC,OAAO,CAAC,CAAC,CAAC,CAUZ"}