@agentforge/core 0.16.86 → 0.16.88

package/dist/index.cjs

@@ -316,8 +316,6 @@ var MissingDescriptionError = class extends Error {
     this.fieldType = fieldType;
     this.name = "MissingDescriptionError";
   }
-  fieldPath;
-  fieldType;
 };
 function validateSchemaDescriptions(schema, fieldPath = []) {
   const def = schema._def;
@@ -608,9 +606,6 @@ var ToolBuilder = class _ToolBuilder {
     this._schema = _schema;
     this._invoke = _invoke;
   }
-  metadata;
-  _schema;
-  _invoke;
   name(name) {
     this.metadata.name = name;
     return this;
@@ -2462,52 +2457,35 @@ function createMiddlewareContext() {
   };
 }
 
-// src/langgraph/observability/metrics.ts
+// src/langgraph/observability/metrics/contracts.ts
 var MetricType = /* @__PURE__ */ ((MetricType2) => {
   MetricType2["COUNTER"] = "counter";
   MetricType2["GAUGE"] = "gauge";
   MetricType2["HISTOGRAM"] = "histogram";
   return MetricType2;
 })(MetricType || {});
-var MetricsImpl = class {
-  name;
+
+// src/langgraph/observability/metrics/collector.ts
+var InMemoryMetrics = class {
+  constructor(namespace) {
+    this.namespace = namespace;
+  }
   metrics = [];
   counters = /* @__PURE__ */ new Map();
-  constructor(name) {
-    this.name = name;
-  }
   increment(name, value = 1, labels) {
     const key = this.getKey(name, labels);
-    const current = this.counters.get(key) ?? 0;
-    this.counters.set(key, current + value);
-    this.record({
-      type: "counter" /* COUNTER */,
-      name: this.prefixName(name),
-      value: current + value,
-      timestamp: Date.now(),
-      labels
-    });
+    const nextValue = (this.counters.get(key) ?? 0) + value;
+    this.counters.set(key, nextValue);
+    this.record("counter" /* COUNTER */, name, nextValue, labels);
   }
   decrement(name, value = 1, labels) {
     this.increment(name, -value, labels);
   }
   gauge(name, value, labels) {
-    this.record({
-      type: "gauge" /* GAUGE */,
-      name: this.prefixName(name),
-      value,
-      timestamp: Date.now(),
-      labels
-    });
+    this.record("gauge" /* GAUGE */, name, value, labels);
   }
   histogram(name, value, labels) {
-    this.record({
-      type: "histogram" /* HISTOGRAM */,
-      name: this.prefixName(name),
-      value,
-      timestamp: Date.now(),
-      labels
-    });
+    this.record("histogram" /* HISTOGRAM */, name, value, labels);
   }
   startTimer(name, labels) {
     const startTime = Date.now();
@@ -2526,20 +2504,18 @@ var MetricsImpl = class {
     this.metrics = [];
     this.counters.clear();
   }
-  record(entry) {
-    this.metrics.push(entry);
-  }
-  prefixName(name) {
-    return `${this.name}.${name}`;
+  record(type, name, value, labels) {
+    this.metrics.push({ type, name: `${this.namespace}.${name}`, value, timestamp: Date.now(), labels });
   }
   getKey(name, labels) {
-    const labelStr = labels ? JSON.stringify(labels) : "";
-    return `${name}:${labelStr}`;
+    return `${name}:${labels ? JSON.stringify(labels) : ""}`;
   }
 };
 function createMetrics(name) {
-  return new MetricsImpl(name);
+  return new InMemoryMetrics(name);
 }
+
+// src/langgraph/observability/metrics/node-instrumentation.ts
 function withMetrics(node, options) {
   const {
     name,
@@ -2549,23 +2525,17 @@ function withMetrics(node, options) {
     metrics = createMetrics(name)
   } = options;
   return async (state) => {
-    if (trackInvocations) {
-      metrics.increment(`${name}.invocations`);
-    }
+    if (trackInvocations) metrics.increment(`${name}.invocations`);
     const timer = trackDuration ? metrics.startTimer(`${name}.duration`) : null;
     try {
       const result = await Promise.resolve(node(state));
       metrics.increment(`${name}.success`);
       return result;
     } catch (error) {
-      if (trackErrors) {
-        metrics.increment(`${name}.errors`);
-      }
+      if (trackErrors) metrics.increment(`${name}.errors`);
       throw error;
     } finally {
-      if (timer) {
-        timer.end();
-      }
+      timer?.end();
     }
   };
 }
@@ -2934,8 +2904,6 @@ var LRUCache = class {
     this.maxSize = maxSize;
     this.evictionStrategy = evictionStrategy;
   }
-  maxSize;
-  evictionStrategy;
   cache = /* @__PURE__ */ new Map();
   get(key) {
     const entry = this.cache.get(key);
@@ -3084,8 +3052,6 @@ var TokenBucket = class {
     this.tokens = maxTokens;
     this.lastRefill = Date.now();
   }
-  maxTokens;
-  refillRate;
   tokens;
   lastRefill;
   tryConsume() {
@@ -3113,8 +3079,6 @@ var SlidingWindow = class {
     this.maxRequests = maxRequests;
     this.windowMs = windowMs;
   }
-  maxRequests;
-  windowMs;
   requests = [];
   tryConsume() {
     const now = Date.now();
@@ -3135,8 +3099,6 @@ var FixedWindow = class {
     this.windowMs = windowMs;
     this.windowStart = Date.now();
   }
-  maxRequests;
-  windowMs;
   count = 0;
   windowStart;
   tryConsume() {
@@ -3176,11 +3138,6 @@ var RateLimiterRegistry = class {
     this.onRateLimitExceeded = onRateLimitExceeded;
     this.onRateLimitReset = onRateLimitReset;
   }
-  maxRequests;
-  windowMs;
-  strategy;
-  onRateLimitExceeded;
-  onRateLimitReset;
   limiters = /* @__PURE__ */ new Map();
   async execute(state, key, executor) {
     const limiter = this.getOrCreate(key);
@@ -3349,13 +3306,6 @@ var ConcurrencyController = class {
     this.onQueueFull = onQueueFull;
     this.queueTimeout = queueTimeout;
   }
-  maxConcurrent;
-  maxQueueSize;
-  onQueued;
-  onExecutionStart;
-  onExecutionComplete;
-  onQueueFull;
-  queueTimeout;
   activeCount = 0;
   queue = [];
   async execute(state, priority, executor) {
@@ -4643,7 +4593,6 @@ var MockDatabaseConnection = class {
   constructor(config) {
     this.config = config;
   }
-  config;
   closed = false;
   async query(_sql, _params) {
     if (this.closed) {
@@ -4686,7 +4635,6 @@ var DatabasePool = class {
       healthCheck: options.healthCheck
     });
   }
-  options;
   pool;
   async acquire() {
     return this.pool.acquire();
@@ -4729,7 +4677,6 @@ var MockHttpClient = class {
   constructor(_config) {
     this._config = _config;
   }
-  _config;
   closed = false;
   async get(url, config) {
     return this.request({ ...config, url, method: "GET" });
@@ -4788,7 +4735,6 @@ var HttpPool = class {
       healthCheck: options.healthCheck
     });
   }
-  options;
   pool;
   async acquire() {
     return this.pool.acquire();
@@ -4823,7 +4769,6 @@ var MemoryManager = class {
   constructor(options) {
     this.options = options;
   }
-  options;
   cleanupHandlers = /* @__PURE__ */ new Map();
   checkTimer;
   leakDetectionTimer;
@@ -4933,7 +4878,6 @@ var BatchProcessor = class {
   constructor(options) {
     this.options = options;
   }
-  options;
   pending = [];
   timer;
   processing = false;
@@ -5040,7 +4984,6 @@ var CircuitBreaker = class {
   constructor(options) {
     this.options = options;
   }
-  options;
   state = "closed";
   failures = 0;
   successes = 0;
@@ -5176,7 +5119,6 @@ var HealthChecker = class {
   constructor(options) {
     this.options = options;
   }
-  options;
   checkTimer;
   lastReport;
   startTime = Date.now();
@@ -5523,7 +5465,6 @@ var AlertManager = class {
   constructor(options) {
     this.options = options;
   }
-  options;
   lastAlertTime = /* @__PURE__ */ new Map();
   monitorTimer;
   running = false;
@@ -5598,7 +5539,6 @@ var AuditLogger = class {
       this.startCleanup();
     }
   }
-  options;
   logs = [];
   cleanupTimer;
   async log(entry) {
@@ -5714,9 +5654,11 @@ function createAuditLogger(options) {
   return new AuditLogger(options);
 }
 
-// src/prompt-loader/index.ts
+// src/prompt-loader/file-loader.ts
 var import_fs = require("fs");
 var import_path = require("path");
+
+// src/prompt-loader/variables.ts
 var MAX_VARIABLE_LENGTH = 500;
 function createPromptVariableMap() {
   return /* @__PURE__ */ Object.create(null);
@@ -5728,9 +5670,7 @@ function isRenderTemplateOptions(value) {
   return isPromptVariableMap(value) && (Object.prototype.hasOwnProperty.call(value, "trustedVariables") || Object.prototype.hasOwnProperty.call(value, "untrustedVariables"));
 }
 function normalizeVariableMap(value) {
-  if (!isPromptVariableMap(value)) {
-    return createPromptVariableMap();
-  }
+  if (!isPromptVariableMap(value)) return createPromptVariableMap();
   return Object.assign(createPromptVariableMap(), value);
 }
 function sanitizeVariableMap(variables) {
@@ -5741,11 +5681,7 @@ function sanitizeVariableMap(variables) {
   return sanitizedVariables;
 }
 function mergeVariableMaps(baseVariables, overrideVariables) {
-  return Object.assign(
-    createPromptVariableMap(),
-    baseVariables,
-    overrideVariables
-  );
+  return Object.assign(createPromptVariableMap(), baseVariables, overrideVariables);
 }
 function sanitizeValue(value) {
   if (value === void 0 || value === null) return "";
@@ -5754,10 +5690,12 @@ function sanitizeValue(value) {
   sanitized = sanitized.replace(/[\r\n]+/g, " ");
   sanitized = sanitized.trim().replace(/\s+/g, " ");
   if (sanitized.length > MAX_VARIABLE_LENGTH) {
-    sanitized = sanitized.substring(0, MAX_VARIABLE_LENGTH) + "...";
+    sanitized = `${sanitized.substring(0, MAX_VARIABLE_LENGTH)}...`;
   }
   return sanitized;
 }
+
+// src/prompt-loader/renderer.ts
 function renderTemplate(template, options) {
   let rawVariables;
   let sanitizedVariables;
@@ -5773,17 +5711,18 @@ function renderTemplate(template, options) {
     rawVariables = normalizeVariableMap(options);
     sanitizedVariables = rawVariables;
   }
-  let result = template;
-  result = result.replace(/\{\{#if\s+(\w+)\}\}([\s\S]*?)\{\{\/if\}\}/g, (_, varName, content) => {
-    return rawVariables[varName] ? content : "";
-  });
-  result = result.replace(/\{\{(\w+)\}\}/g, (_, varName) => {
-    const value = sanitizedVariables[varName];
-    if (value === void 0 || value === null) return "";
-    return String(value);
+  let result = template.replace(
+    /\{\{#if\s+(\w+)\}\}([\s\S]*?)\{\{\/if\}\}/g,
+    (_, variableName, content) => rawVariables[variableName] ? content : ""
+  );
+  result = result.replace(/\{\{(\w+)\}\}/g, (_, variableName) => {
+    const value = sanitizedVariables[variableName];
+    return value === void 0 || value === null ? "" : String(value);
   });
   return result;
 }
+
+// src/prompt-loader/file-loader.ts
 function loadPrompt(promptName, options = {}, promptsDir) {
   const baseDir = promptsDir || (0, import_path.join)(process.cwd(), "prompts");
   const promptPath = (0, import_path.join)(baseDir, `${promptName}.md`);

package/dist/index.d.cts

@@ -1,4 +1,4 @@
-import { z, ZodType, ZodTypeDef, ZodTypeAny, output } from 'zod';
+import { z, ZodTypeAny, output, ZodType, ZodTypeDef } from 'zod';
 import * as _langchain_core_tools from '@langchain/core/tools';
 import { DynamicStructuredTool } from '@langchain/core/tools';
 import * as _langchain_langgraph from '@langchain/langgraph';
@@ -724,7 +724,7 @@ declare class ToolRegistry {
     on(event: RegistryEvent, handler: EventHandler): void;
     off(event: RegistryEvent, handler: EventHandler): void;
     private emit;
-    toLangChainTools(): _langchain_core_tools.DynamicStructuredTool<_langchain_core_tools.ToolSchemaBase, any, any, any, unknown, string>[];
+    toLangChainTools(): _langchain_core_tools.DynamicStructuredTool<_langchain_core_tools.ToolSchemaBase, any, any, any, string>[];
     generatePrompt(options?: PromptOptions): string;
 }
 
@@ -2202,22 +2202,13 @@ declare class TimeoutError extends Error {
  */
 declare function withTimeout<State>(node: (state: State) => State | Promise<State> | Partial<State> | Promise<Partial<State>>, options: TimeoutOptions<State>): (state: State) => Promise<State | Partial<State>>;
 
-/**
- * Metrics Collection Utilities
- *
- * Provides utilities for collecting performance and usage metrics.
- */
-/**
- * Metric types
- */
+/** Metric types supported by the in-memory collector. */
 declare enum MetricType {
     COUNTER = "counter",
     GAUGE = "gauge",
     HISTOGRAM = "histogram"
 }
-/**
- * Metric entry
- */
+/** A recorded metric sample. */
 interface MetricEntry {
     type: MetricType;
     name: string;
@@ -2225,125 +2216,49 @@ interface MetricEntry {
     timestamp: number;
     labels?: Record<string, string>;
 }
-/**
- * Timer interface for measuring durations
- */
+/** A running duration measurement. */
 interface Timer {
-    /**
-     * End the timer and record the duration
-     */
     end(): number;
 }
-/**
- * Metrics collector interface
- */
+/** Public metrics collector contract. */
 interface Metrics {
-    /**
-     * Increment a counter metric
-     */
     increment(name: string, value?: number, labels?: Record<string, string>): void;
-    /**
-     * Decrement a counter metric
-     */
     decrement(name: string, value?: number, labels?: Record<string, string>): void;
-    /**
-     * Set a gauge metric
-     */
     gauge(name: string, value: number, labels?: Record<string, string>): void;
-    /**
-     * Record a histogram value
-     */
     histogram(name: string, value: number, labels?: Record<string, string>): void;
-    /**
-     * Start a timer for measuring duration
-     */
     startTimer(name: string, labels?: Record<string, string>): Timer;
-    /**
-     * Get all recorded metrics
-     */
     getMetrics(): MetricEntry[];
-    /**
-     * Clear all metrics
-     */
     clear(): void;
 }
-/**
- * Create a metrics collector.
- *
- * @example
- * ```typescript
- * import { createMetrics } from '@agentforge/core';
- *
- * const metrics = createMetrics('my-agent');
- *
- * // Track counters
- * metrics.increment('requests.total');
- * metrics.increment('requests.success');
- *
- * // Track gauges
- * metrics.gauge('active.connections', 5);
- *
- * // Track histograms
- * metrics.histogram('request.duration', 150);
- *
- * // Track timers
- * const timer = metrics.startTimer('operation.duration');
- * // ... do work ...
- * timer.end();
- * ```
- *
- * @param name - Metrics namespace (typically the agent or component name)
- * @returns A metrics collector instance
- */
-declare function createMetrics(name: string): Metrics;
-/**
- * Options for metrics tracking on nodes
- */
+/** Options controlling automatic node instrumentation. */
 interface MetricsNodeOptions {
-    /**
-     * Name for the metrics
-     */
+    /** Name used to identify the instrumented node. */
     name: string;
     /**
-     * Whether to track execution duration
+     * Whether to track execution duration.
      * @default true
      */
     trackDuration?: boolean;
     /**
-     * Whether to track errors
+     * Whether to track errors.
      * @default true
      */
     trackErrors?: boolean;
     /**
-     * Whether to track invocation count
+     * Whether to track invocation count.
      * @default true
      */
     trackInvocations?: boolean;
     /**
-     * Metrics collector to use
-     * If not provided, a new one will be created
+     * Metrics collector to use. A new collector is created when omitted.
      */
     metrics?: Metrics;
 }
-/**
- * Wrap a node function with automatic metrics tracking.
- *
- * @example
- * ```typescript
- * import { withMetrics, createMetrics } from '@agentforge/core';
- *
- * const metrics = createMetrics('my-agent');
- *
- * const metricNode = withMetrics(myNode, {
- *   name: 'research-node',
- *   metrics,
- * });
- * ```
- *
- * @param node - The node function to wrap
- * @param options - Metrics tracking options
- * @returns A wrapped node function with metrics tracking
- */
+
+/** Create an in-memory metrics collector for a namespace. */
+declare function createMetrics(name: string): Metrics;
+
+/** Wrap a node function with automatic metrics tracking. */
 declare function withMetrics<State>(node: (state: State) => State | Promise<State> | Partial<State> | Promise<Partial<State>>, options: MetricsNodeOptions): (state: State) => Promise<State | Partial<State>>;
 
 /**
@@ -4590,115 +4505,36 @@ declare class AuditLogger {
 }
 declare function createAuditLogger(options?: AuditLoggerOptions): AuditLogger;
 
-/**
- * Prompt Template Loader
- *
- * Utility for loading and rendering prompt templates from .md files.
- * Supports variable substitution and conditional blocks.
- *
- * SECURITY: This module includes protection against prompt injection attacks
- * by sanitizing variable values before substitution.
- */
 type PromptVariableValue = unknown;
 type PromptVariableMap = Record<string, PromptVariableValue>;
-/**
- * Options for rendering templates with security controls
- */
+/** Options for rendering templates with trusted and untrusted variables. */
 interface RenderTemplateOptions {
-    /**
-     * Variables from trusted sources (config files, hardcoded values)
-     * These will NOT be sanitized
-     */
+    /** Variables from trusted sources. These values are not sanitized. */
     trustedVariables?: PromptVariableMap;
-    /**
-     * Variables from untrusted sources (user input, API calls, databases)
-     * These WILL be sanitized to prevent prompt injection
-     */
+    /** Variables from untrusted sources. These values are sanitized. */
     untrustedVariables?: PromptVariableMap;
 }
+
 /**
- * Sanitize a value to prevent prompt injection attacks
- *
- * Protections:
- * - Removes markdown headers (prevents structure hijacking)
- * - Removes newlines (prevents multi-line injection)
- * - Limits length (prevents prompt bloat)
- *
- * @param value - The value to sanitize
- * @returns Sanitized string safe for use in prompts
+ * Load and render a Markdown prompt template from a custom directory or the
+ * `prompts` directory beneath the current working directory.
  */
-declare function sanitizeValue(value: unknown): string;
+declare function loadPrompt(promptName: string, options?: RenderTemplateOptions | PromptVariableMap, promptsDir?: string): string;
+
 /**
- * Render a template string with variable substitution
- *
- * Supports:
- * - Simple variables: {{variableName}}
- * - Conditional blocks: {{#if variableName}}...{{/if}}
- *
- * SECURITY: Distinguishes between trusted and untrusted variables.
- * - Trusted variables (from config) are used as-is
- * - Untrusted variables (from user input) are sanitized
- * - Only own enumerable properties are considered from provided variable maps
- *   or backwards-compatible plain objects
- *
- * @param template - Template string with {{variable}} placeholders
- * @param options - Variables and security options
- * @returns Rendered template string
- *
- * @example
- * ```typescript
- * // Safe: Trusted variables from config
- * const result = renderTemplate(template, {
- *   trustedVariables: {
- *     companyName: 'Acme Corp',  // From config file
- *     premium: true
- *   }
- * });
- *
- * // Safe: Untrusted variables are sanitized
- * const result = renderTemplate(template, {
- *   untrustedVariables: {
- *     userName: req.body.name,  // User input - will be sanitized
- *   }
- * });
- *
- * // Mixed: Some trusted, some untrusted
- * const result = renderTemplate(template, {
- *   trustedVariables: {
- *     companyName: 'Acme Corp',  // From config
- *   },
- *   untrustedVariables: {
- *     userName: req.body.name,  // User input
- *   }
- * });
- * ```
+ * Render substitutions and conditional blocks with trusted/untrusted controls.
+ * Trusted values are substituted unchanged, untrusted values are sanitized,
+ * and conditional truthiness is evaluated against the original raw values.
+ * Plain variable maps remain supported as trusted input for compatibility.
  */
 declare function renderTemplate(template: string, options: RenderTemplateOptions | PromptVariableMap): string;
+
 /**
- * Load and render a prompt template from a .md file
- *
- * Looks for prompts in a `prompts/` directory relative to the caller's location.
- *
- * @param promptName - Name of the prompt file (without .md extension)
- * @param options - Variables and security options
- * @param promptsDir - Optional custom prompts directory path
- * @returns Rendered prompt string
- *
- * @example
- * ```typescript
- * // Backwards compatible: all variables treated as trusted
- * loadPrompt('system', { companyName: 'Acme' });
- *
- * // Explicit: separate trusted and untrusted
- * loadPrompt('system', {
- *   trustedVariables: { companyName: 'Acme' },
- *   untrustedVariables: { userName: userInput }
- * });
+ * Sanitize an untrusted value before prompt substitution.
  *
- * // Custom prompts directory
- * loadPrompt('system', { companyName: 'Acme' }, '/path/to/prompts');
- * ```
+ * Removes Markdown header markers and line breaks, collapses whitespace,
+ * and limits output to 500 characters plus an ellipsis.
  */
-declare function loadPrompt(promptName: string, options?: RenderTemplateOptions | PromptVariableMap, promptsDir?: string): string;
+declare function sanitizeValue(value: unknown): string;
 
 export { AgentError, type AgentResumedEventData, type AgentWaitingEventData, type AggregateNode, type Alert, type AlertChannel, AlertManager, type AlertManagerOptions, type AlertRule, type AlertSeverity, type AnyInterrupt, type ApprovalRequiredInterrupt, type AuditLogEntry, type AuditLogQuery, AuditLogger, type AuditLoggerOptions, type BackoffStrategy, type BatchOptions, BatchProcessor, type BatchProcessorOptions, type BatchStats, type CacheKeyGenerator, type CachingOptions, type CheckInterruptOptions, type CheckpointHistoryOptions, type CheckpointerOptions, type ChunkOptions, CircuitBreaker, type CircuitBreakerOptions, type CircuitBreakerStats, type CircuitState, type ComposeGraphsOptions, type ComposeOptions, type ComposeToolConfig, type ComposedTool, type ConcurrencyOptions, type ConditionalConfig, type ConditionalRouter, type ConditionalRouterConfig, ConnectionPool, type ConnectionPoolOptions, type ConversationConfig, type CustomAlertChannel, type CustomInterrupt, type DatabaseConfig, type DatabaseConnection, DatabasePool, type DatabasePoolOptions, type DatabaseQueryParams, type DatabaseQueryResult, type DevelopmentPresetOptions, type EmailAlertChannel, type ErrorContext, type ErrorHandlerOptions, type ErrorReporter, type ErrorReporterOptions, type EventHandler, type EvictionStrategy, type ExecutionMetrics, type GenericAlertChannel, type HealthCheck, type HealthCheckConfig, type HealthCheckResult, HealthChecker, type HealthCheckerOptions, type HealthReport, type HealthStatus, type HttpClient, type HttpConfig, HttpPool, type HttpPoolConfig, type HttpPoolOptions, type HttpResponse, type HumanInLoopEventData, type HumanInLoopEventType, type HumanRequest, type HumanRequestEventData, type HumanRequestInterrupt, type HumanRequestPriority, type HumanRequestStatus, type HumanResponseEventData, type InterruptData, type InterruptEventData, type InterruptType, type JsonObject, type JsonPrimitive, type JsonValue, type LangSmithConfig, type LogEntry, LogLevel, type Logger, type LoggerOptions, type LoggingOptions, ManagedTool, type ManagedToolConfig, type ManagedToolStats, MemoryManager, type MemoryManagerOptions, type MemoryStats, type MetricEntry, MetricType, type Metrics, type MetricsNodeOptions, type Middleware, MiddlewareChain, type MiddlewareContext, type MiddlewareFactory, type MiddlewareMetadata, type MiddlewareWithMetadata, MissingDescriptionError, type MockExecutionRuntimeOptions, type MockToolConfig, type MockToolResponse, type NodeFunction, type NodeFunctionWithContext, type ParallelNode, type ParallelWorkflowConfig, type ParallelWorkflowOptions, type PoolConfig, type PoolStats, type Priority$1 as Priority, type ProductionPresetOptions, type ProfileReport, type ProfileSample, type ProfileStats, Profiler, type ProfilerOptions, type Progress, type ProgressTracker, type ProgressTrackerOptions, type PromptOptions, type PromptVariableMap, type PromptVariableValue, type RateLimitOptions, type RateLimitStrategy, type ReducerFunction, RegistryEvent, type RenderTemplateOptions, type RequestConfig, type ResumeCommand, type ResumeEventData, type ResumeOptions, type RetryOptions, type RetryPolicy, type RouteCondition, type RouteMap, type RouteName, type SSEEvent, type SSEFormatter, type SSEFormatterOptions, type SequentialNode, type SequentialWorkflowOptions, type SimpleMiddleware, type SlackAlertChannel, type SqliteCheckpointerOptions, type StateChannelConfig, type SubgraphBuilder, type TestingPresetOptions, type ThreadConfig, type ThreadInfo, type ThreadStatus, type ThrottleOptions, TimeoutError, type TimeoutOptions, type Timer, type Tool, type BackoffStrategy$1 as ToolBackoffStrategy, ToolBuilder, ToolCategory, ToolCategorySchema, type ToolExample, ToolExampleSchema, type ToolExecution, type ToolExecutorConfig, type ToolHealthCheckResult, type ToolInvocation, type ToolMetadata, ToolMetadataSchema, ToolNameSchema, ToolRegistry, type ToolRelations, ToolRelationsSchema, type ToolSimulatorConfig, type TracingOptions, type ValidationErrorHandler, type ValidationMode, type ValidationOptions, type ValidatorFunction, type WebSocketBinaryData, type WebSocketCloseReason, type WebSocketCloseReasonFor, type WebSocketConnection, type WebSocketEvent, type WebSocketEventHandler, type WebSocketHandlerOptions, type WebSocketMessage, type WebSocketMessageFor, type WebSocketRawMessage, type WebSocketSendTarget, type WebhookAlertChannel, batch, broadcast, cache, chain, chunk, clearThread, collect, compose, composeGraphs, composeTool, composeWithOptions, conditional, configureLangSmith, createAlertManager, createApprovalRequiredInterrupt, createAuditLogger, createBatchProcessor, createBinaryRouter, createCircuitBreaker, createConditionalRouter, createConnectionPool, createConversationConfig, createCustomInterrupt, createDatabasePool, createErrorReporter, createHealthChecker, createHeartbeat, createHttpPool, createHumanRequestInterrupt, createLogger, createManagedTool, createMemoryCheckpointer, createMemoryManager, createMessage, createMetrics, createMiddlewareContext, createMockTool, createMultiRouter, createParallelWorkflow, createProfiler, createProgressTracker, createSSEFormatter, createSequentialWorkflow, createSharedCache, createSharedConcurrencyController, createSharedRateLimiter, createSqliteCheckpointer, createStateAnnotation, createSubgraph, createThreadConfig, createTool, createToolExecutor, createToolSimulator, createToolUnsafe, createWebSocketHandler, development, filter, formatAgentResumedEvent, formatAgentWaitingEvent, formatHumanRequestEvent, formatHumanResponseEvent, formatInterruptEvent, formatResumeEvent, generateThreadId, getCheckpointHistory, getLangSmithConfig, getLatestCheckpoint, getMissingDescriptions, getThreadStatus, getToolDescription, getToolJsonSchema, isApprovalRequiredInterrupt, isCustomInterrupt, isHumanRequestInterrupt, isMemoryCheckpointer, isTracingEnabled, loadPrompt, map, merge, mergeState, parallel, parseSSEEvent, presets, production, reduce, renderTemplate, retry, runMockExecution, safeValidateSchemaDescriptions, sanitizeValue, sendMessage, sequential, sequentialBuilder, take, testing, throttle, timeout, toLangChainTool, toLangChainTools, toolBuilder, validateSchemaDescriptions, validateState, validateTool, validateToolMetadata, validateToolName, withCache, withConcurrency, withErrorHandler, withLogging, withMetrics, withRateLimit, withRetry, withTimeout, withTracing, withValidation };

package/dist/index.d.ts

@@ -1,4 +1,4 @@
-import { z, ZodType, ZodTypeDef, ZodTypeAny, output } from 'zod';
+import { z, ZodTypeAny, output, ZodType, ZodTypeDef } from 'zod';
 import * as _langchain_core_tools from '@langchain/core/tools';
 import { DynamicStructuredTool } from '@langchain/core/tools';
 import * as _langchain_langgraph from '@langchain/langgraph';
@@ -724,7 +724,7 @@ declare class ToolRegistry {
     on(event: RegistryEvent, handler: EventHandler): void;
     off(event: RegistryEvent, handler: EventHandler): void;
     private emit;
-    toLangChainTools(): _langchain_core_tools.DynamicStructuredTool<_langchain_core_tools.ToolSchemaBase, any, any, any, unknown, string>[];
+    toLangChainTools(): _langchain_core_tools.DynamicStructuredTool<_langchain_core_tools.ToolSchemaBase, any, any, any, string>[];
     generatePrompt(options?: PromptOptions): string;
 }
 
@@ -2202,22 +2202,13 @@ declare class TimeoutError extends Error {
  */
 declare function withTimeout<State>(node: (state: State) => State | Promise<State> | Partial<State> | Promise<Partial<State>>, options: TimeoutOptions<State>): (state: State) => Promise<State | Partial<State>>;
 
-/**
- * Metrics Collection Utilities
- *
- * Provides utilities for collecting performance and usage metrics.
- */
-/**
- * Metric types
- */
+/** Metric types supported by the in-memory collector. */
 declare enum MetricType {
     COUNTER = "counter",
     GAUGE = "gauge",
     HISTOGRAM = "histogram"
 }
-/**
- * Metric entry
- */
+/** A recorded metric sample. */
 interface MetricEntry {
     type: MetricType;
     name: string;
@@ -2225,125 +2216,49 @@ interface MetricEntry {
     timestamp: number;
     labels?: Record<string, string>;
 }
-/**
- * Timer interface for measuring durations
- */
+/** A running duration measurement. */
 interface Timer {
-    /**
-     * End the timer and record the duration
-     */
     end(): number;
 }
-/**
- * Metrics collector interface
- */
+/** Public metrics collector contract. */
 interface Metrics {
-    /**
-     * Increment a counter metric
-     */
     increment(name: string, value?: number, labels?: Record<string, string>): void;
-    /**
-     * Decrement a counter metric
-     */
     decrement(name: string, value?: number, labels?: Record<string, string>): void;
-    /**
-     * Set a gauge metric
-     */
     gauge(name: string, value: number, labels?: Record<string, string>): void;
-    /**
-     * Record a histogram value
-     */
     histogram(name: string, value: number, labels?: Record<string, string>): void;
-    /**
-     * Start a timer for measuring duration
-     */
     startTimer(name: string, labels?: Record<string, string>): Timer;
-    /**
-     * Get all recorded metrics
-     */
     getMetrics(): MetricEntry[];
-    /**
-     * Clear all metrics
-     */
     clear(): void;
 }
-/**
- * Create a metrics collector.
- *
- * @example
- * ```typescript
- * import { createMetrics } from '@agentforge/core';
- *
- * const metrics = createMetrics('my-agent');
- *
- * // Track counters
- * metrics.increment('requests.total');
- * metrics.increment('requests.success');
- *
- * // Track gauges
- * metrics.gauge('active.connections', 5);
- *
- * // Track histograms
- * metrics.histogram('request.duration', 150);
- *
- * // Track timers
- * const timer = metrics.startTimer('operation.duration');
- * // ... do work ...
- * timer.end();
- * ```
- *
- * @param name - Metrics namespace (typically the agent or component name)
- * @returns A metrics collector instance
- */
-declare function createMetrics(name: string): Metrics;
-/**
- * Options for metrics tracking on nodes
- */
+/** Options controlling automatic node instrumentation. */
 interface MetricsNodeOptions {
-    /**
-     * Name for the metrics
-     */
+    /** Name used to identify the instrumented node. */
     name: string;
     /**
-     * Whether to track execution duration
+     * Whether to track execution duration.
      * @default true
      */
     trackDuration?: boolean;
     /**
-     * Whether to track errors
+     * Whether to track errors.
      * @default true
      */
     trackErrors?: boolean;
     /**
-     * Whether to track invocation count
+     * Whether to track invocation count.
      * @default true
      */
     trackInvocations?: boolean;
     /**
-     * Metrics collector to use
-     * If not provided, a new one will be created
+     * Metrics collector to use. A new collector is created when omitted.
      */
     metrics?: Metrics;
 }
-/**
- * Wrap a node function with automatic metrics tracking.
- *
- * @example
- * ```typescript
- * import { withMetrics, createMetrics } from '@agentforge/core';
- *
- * const metrics = createMetrics('my-agent');
- *
- * const metricNode = withMetrics(myNode, {
- *   name: 'research-node',
- *   metrics,
- * });
- * ```
- *
- * @param node - The node function to wrap
- * @param options - Metrics tracking options
- * @returns A wrapped node function with metrics tracking
- */
+
+/** Create an in-memory metrics collector for a namespace. */
+declare function createMetrics(name: string): Metrics;
+
+/** Wrap a node function with automatic metrics tracking. */
 declare function withMetrics<State>(node: (state: State) => State | Promise<State> | Partial<State> | Promise<Partial<State>>, options: MetricsNodeOptions): (state: State) => Promise<State | Partial<State>>;
 
 /**
@@ -4590,115 +4505,36 @@ declare class AuditLogger {
 }
 declare function createAuditLogger(options?: AuditLoggerOptions): AuditLogger;
 
-/**
- * Prompt Template Loader
- *
- * Utility for loading and rendering prompt templates from .md files.
- * Supports variable substitution and conditional blocks.
- *
- * SECURITY: This module includes protection against prompt injection attacks
- * by sanitizing variable values before substitution.
- */
 type PromptVariableValue = unknown;
 type PromptVariableMap = Record<string, PromptVariableValue>;
-/**
- * Options for rendering templates with security controls
- */
+/** Options for rendering templates with trusted and untrusted variables. */
 interface RenderTemplateOptions {
-    /**
-     * Variables from trusted sources (config files, hardcoded values)
-     * These will NOT be sanitized
-     */
+    /** Variables from trusted sources. These values are not sanitized. */
     trustedVariables?: PromptVariableMap;
-    /**
-     * Variables from untrusted sources (user input, API calls, databases)
-     * These WILL be sanitized to prevent prompt injection
-     */
+    /** Variables from untrusted sources. These values are sanitized. */
     untrustedVariables?: PromptVariableMap;
 }
+
 /**
- * Sanitize a value to prevent prompt injection attacks
- *
- * Protections:
- * - Removes markdown headers (prevents structure hijacking)
- * - Removes newlines (prevents multi-line injection)
- * - Limits length (prevents prompt bloat)
- *
- * @param value - The value to sanitize
- * @returns Sanitized string safe for use in prompts
+ * Load and render a Markdown prompt template from a custom directory or the
+ * `prompts` directory beneath the current working directory.
  */
-declare function sanitizeValue(value: unknown): string;
+declare function loadPrompt(promptName: string, options?: RenderTemplateOptions | PromptVariableMap, promptsDir?: string): string;
+
 /**
- * Render a template string with variable substitution
- *
- * Supports:
- * - Simple variables: {{variableName}}
- * - Conditional blocks: {{#if variableName}}...{{/if}}
- *
- * SECURITY: Distinguishes between trusted and untrusted variables.
- * - Trusted variables (from config) are used as-is
- * - Untrusted variables (from user input) are sanitized
- * - Only own enumerable properties are considered from provided variable maps
- *   or backwards-compatible plain objects
- *
- * @param template - Template string with {{variable}} placeholders
- * @param options - Variables and security options
- * @returns Rendered template string
- *
- * @example
- * ```typescript
- * // Safe: Trusted variables from config
- * const result = renderTemplate(template, {
- *   trustedVariables: {
- *     companyName: 'Acme Corp',  // From config file
- *     premium: true
- *   }
- * });
- *
- * // Safe: Untrusted variables are sanitized
- * const result = renderTemplate(template, {
- *   untrustedVariables: {
- *     userName: req.body.name,  // User input - will be sanitized
- *   }
- * });
- *
- * // Mixed: Some trusted, some untrusted
- * const result = renderTemplate(template, {
- *   trustedVariables: {
- *     companyName: 'Acme Corp',  // From config
- *   },
- *   untrustedVariables: {
- *     userName: req.body.name,  // User input
- *   }
- * });
- * ```
+ * Render substitutions and conditional blocks with trusted/untrusted controls.
+ * Trusted values are substituted unchanged, untrusted values are sanitized,
+ * and conditional truthiness is evaluated against the original raw values.
+ * Plain variable maps remain supported as trusted input for compatibility.
  */
 declare function renderTemplate(template: string, options: RenderTemplateOptions | PromptVariableMap): string;
+
 /**
- * Load and render a prompt template from a .md file
- *
- * Looks for prompts in a `prompts/` directory relative to the caller's location.
- *
- * @param promptName - Name of the prompt file (without .md extension)
- * @param options - Variables and security options
- * @param promptsDir - Optional custom prompts directory path
- * @returns Rendered prompt string
- *
- * @example
- * ```typescript
- * // Backwards compatible: all variables treated as trusted
- * loadPrompt('system', { companyName: 'Acme' });
- *
- * // Explicit: separate trusted and untrusted
- * loadPrompt('system', {
- *   trustedVariables: { companyName: 'Acme' },
- *   untrustedVariables: { userName: userInput }
- * });
+ * Sanitize an untrusted value before prompt substitution.
  *
- * // Custom prompts directory
- * loadPrompt('system', { companyName: 'Acme' }, '/path/to/prompts');
- * ```
+ * Removes Markdown header markers and line breaks, collapses whitespace,
+ * and limits output to 500 characters plus an ellipsis.
  */
-declare function loadPrompt(promptName: string, options?: RenderTemplateOptions | PromptVariableMap, promptsDir?: string): string;
+declare function sanitizeValue(value: unknown): string;
 
 export { AgentError, type AgentResumedEventData, type AgentWaitingEventData, type AggregateNode, type Alert, type AlertChannel, AlertManager, type AlertManagerOptions, type AlertRule, type AlertSeverity, type AnyInterrupt, type ApprovalRequiredInterrupt, type AuditLogEntry, type AuditLogQuery, AuditLogger, type AuditLoggerOptions, type BackoffStrategy, type BatchOptions, BatchProcessor, type BatchProcessorOptions, type BatchStats, type CacheKeyGenerator, type CachingOptions, type CheckInterruptOptions, type CheckpointHistoryOptions, type CheckpointerOptions, type ChunkOptions, CircuitBreaker, type CircuitBreakerOptions, type CircuitBreakerStats, type CircuitState, type ComposeGraphsOptions, type ComposeOptions, type ComposeToolConfig, type ComposedTool, type ConcurrencyOptions, type ConditionalConfig, type ConditionalRouter, type ConditionalRouterConfig, ConnectionPool, type ConnectionPoolOptions, type ConversationConfig, type CustomAlertChannel, type CustomInterrupt, type DatabaseConfig, type DatabaseConnection, DatabasePool, type DatabasePoolOptions, type DatabaseQueryParams, type DatabaseQueryResult, type DevelopmentPresetOptions, type EmailAlertChannel, type ErrorContext, type ErrorHandlerOptions, type ErrorReporter, type ErrorReporterOptions, type EventHandler, type EvictionStrategy, type ExecutionMetrics, type GenericAlertChannel, type HealthCheck, type HealthCheckConfig, type HealthCheckResult, HealthChecker, type HealthCheckerOptions, type HealthReport, type HealthStatus, type HttpClient, type HttpConfig, HttpPool, type HttpPoolConfig, type HttpPoolOptions, type HttpResponse, type HumanInLoopEventData, type HumanInLoopEventType, type HumanRequest, type HumanRequestEventData, type HumanRequestInterrupt, type HumanRequestPriority, type HumanRequestStatus, type HumanResponseEventData, type InterruptData, type InterruptEventData, type InterruptType, type JsonObject, type JsonPrimitive, type JsonValue, type LangSmithConfig, type LogEntry, LogLevel, type Logger, type LoggerOptions, type LoggingOptions, ManagedTool, type ManagedToolConfig, type ManagedToolStats, MemoryManager, type MemoryManagerOptions, type MemoryStats, type MetricEntry, MetricType, type Metrics, type MetricsNodeOptions, type Middleware, MiddlewareChain, type MiddlewareContext, type MiddlewareFactory, type MiddlewareMetadata, type MiddlewareWithMetadata, MissingDescriptionError, type MockExecutionRuntimeOptions, type MockToolConfig, type MockToolResponse, type NodeFunction, type NodeFunctionWithContext, type ParallelNode, type ParallelWorkflowConfig, type ParallelWorkflowOptions, type PoolConfig, type PoolStats, type Priority$1 as Priority, type ProductionPresetOptions, type ProfileReport, type ProfileSample, type ProfileStats, Profiler, type ProfilerOptions, type Progress, type ProgressTracker, type ProgressTrackerOptions, type PromptOptions, type PromptVariableMap, type PromptVariableValue, type RateLimitOptions, type RateLimitStrategy, type ReducerFunction, RegistryEvent, type RenderTemplateOptions, type RequestConfig, type ResumeCommand, type ResumeEventData, type ResumeOptions, type RetryOptions, type RetryPolicy, type RouteCondition, type RouteMap, type RouteName, type SSEEvent, type SSEFormatter, type SSEFormatterOptions, type SequentialNode, type SequentialWorkflowOptions, type SimpleMiddleware, type SlackAlertChannel, type SqliteCheckpointerOptions, type StateChannelConfig, type SubgraphBuilder, type TestingPresetOptions, type ThreadConfig, type ThreadInfo, type ThreadStatus, type ThrottleOptions, TimeoutError, type TimeoutOptions, type Timer, type Tool, type BackoffStrategy$1 as ToolBackoffStrategy, ToolBuilder, ToolCategory, ToolCategorySchema, type ToolExample, ToolExampleSchema, type ToolExecution, type ToolExecutorConfig, type ToolHealthCheckResult, type ToolInvocation, type ToolMetadata, ToolMetadataSchema, ToolNameSchema, ToolRegistry, type ToolRelations, ToolRelationsSchema, type ToolSimulatorConfig, type TracingOptions, type ValidationErrorHandler, type ValidationMode, type ValidationOptions, type ValidatorFunction, type WebSocketBinaryData, type WebSocketCloseReason, type WebSocketCloseReasonFor, type WebSocketConnection, type WebSocketEvent, type WebSocketEventHandler, type WebSocketHandlerOptions, type WebSocketMessage, type WebSocketMessageFor, type WebSocketRawMessage, type WebSocketSendTarget, type WebhookAlertChannel, batch, broadcast, cache, chain, chunk, clearThread, collect, compose, composeGraphs, composeTool, composeWithOptions, conditional, configureLangSmith, createAlertManager, createApprovalRequiredInterrupt, createAuditLogger, createBatchProcessor, createBinaryRouter, createCircuitBreaker, createConditionalRouter, createConnectionPool, createConversationConfig, createCustomInterrupt, createDatabasePool, createErrorReporter, createHealthChecker, createHeartbeat, createHttpPool, createHumanRequestInterrupt, createLogger, createManagedTool, createMemoryCheckpointer, createMemoryManager, createMessage, createMetrics, createMiddlewareContext, createMockTool, createMultiRouter, createParallelWorkflow, createProfiler, createProgressTracker, createSSEFormatter, createSequentialWorkflow, createSharedCache, createSharedConcurrencyController, createSharedRateLimiter, createSqliteCheckpointer, createStateAnnotation, createSubgraph, createThreadConfig, createTool, createToolExecutor, createToolSimulator, createToolUnsafe, createWebSocketHandler, development, filter, formatAgentResumedEvent, formatAgentWaitingEvent, formatHumanRequestEvent, formatHumanResponseEvent, formatInterruptEvent, formatResumeEvent, generateThreadId, getCheckpointHistory, getLangSmithConfig, getLatestCheckpoint, getMissingDescriptions, getThreadStatus, getToolDescription, getToolJsonSchema, isApprovalRequiredInterrupt, isCustomInterrupt, isHumanRequestInterrupt, isMemoryCheckpointer, isTracingEnabled, loadPrompt, map, merge, mergeState, parallel, parseSSEEvent, presets, production, reduce, renderTemplate, retry, runMockExecution, safeValidateSchemaDescriptions, sanitizeValue, sendMessage, sequential, sequentialBuilder, take, testing, throttle, timeout, toLangChainTool, toLangChainTools, toolBuilder, validateSchemaDescriptions, validateState, validateTool, validateToolMetadata, validateToolName, withCache, withConcurrency, withErrorHandler, withLogging, withMetrics, withRateLimit, withRetry, withTimeout, withTracing, withValidation };

package/dist/index.js

@@ -140,8 +140,6 @@ var MissingDescriptionError = class extends Error {
     this.fieldType = fieldType;
     this.name = "MissingDescriptionError";
   }
-  fieldPath;
-  fieldType;
 };
 function validateSchemaDescriptions(schema, fieldPath = []) {
   const def = schema._def;
@@ -432,9 +430,6 @@ var ToolBuilder = class _ToolBuilder {
     this._schema = _schema;
     this._invoke = _invoke;
   }
-  metadata;
-  _schema;
-  _invoke;
   name(name) {
     this.metadata.name = name;
     return this;
@@ -2286,52 +2281,35 @@ function createMiddlewareContext() {
   };
 }
 
-// src/langgraph/observability/metrics.ts
+// src/langgraph/observability/metrics/contracts.ts
 var MetricType = /* @__PURE__ */ ((MetricType2) => {
   MetricType2["COUNTER"] = "counter";
   MetricType2["GAUGE"] = "gauge";
   MetricType2["HISTOGRAM"] = "histogram";
   return MetricType2;
 })(MetricType || {});
-var MetricsImpl = class {
-  name;
+
+// src/langgraph/observability/metrics/collector.ts
+var InMemoryMetrics = class {
+  constructor(namespace) {
+    this.namespace = namespace;
+  }
   metrics = [];
   counters = /* @__PURE__ */ new Map();
-  constructor(name) {
-    this.name = name;
-  }
   increment(name, value = 1, labels) {
     const key = this.getKey(name, labels);
-    const current = this.counters.get(key) ?? 0;
-    this.counters.set(key, current + value);
-    this.record({
-      type: "counter" /* COUNTER */,
-      name: this.prefixName(name),
-      value: current + value,
-      timestamp: Date.now(),
-      labels
-    });
+    const nextValue = (this.counters.get(key) ?? 0) + value;
+    this.counters.set(key, nextValue);
+    this.record("counter" /* COUNTER */, name, nextValue, labels);
   }
   decrement(name, value = 1, labels) {
     this.increment(name, -value, labels);
   }
   gauge(name, value, labels) {
-    this.record({
-      type: "gauge" /* GAUGE */,
-      name: this.prefixName(name),
-      value,
-      timestamp: Date.now(),
-      labels
-    });
+    this.record("gauge" /* GAUGE */, name, value, labels);
   }
   histogram(name, value, labels) {
-    this.record({
-      type: "histogram" /* HISTOGRAM */,
-      name: this.prefixName(name),
-      value,
-      timestamp: Date.now(),
-      labels
-    });
+    this.record("histogram" /* HISTOGRAM */, name, value, labels);
   }
   startTimer(name, labels) {
     const startTime = Date.now();
@@ -2350,20 +2328,18 @@ var MetricsImpl = class {
     this.metrics = [];
     this.counters.clear();
   }
-  record(entry) {
-    this.metrics.push(entry);
-  }
-  prefixName(name) {
-    return `${this.name}.${name}`;
+  record(type, name, value, labels) {
+    this.metrics.push({ type, name: `${this.namespace}.${name}`, value, timestamp: Date.now(), labels });
   }
   getKey(name, labels) {
-    const labelStr = labels ? JSON.stringify(labels) : "";
-    return `${name}:${labelStr}`;
+    return `${name}:${labels ? JSON.stringify(labels) : ""}`;
   }
 };
 function createMetrics(name) {
-  return new MetricsImpl(name);
+  return new InMemoryMetrics(name);
 }
+
+// src/langgraph/observability/metrics/node-instrumentation.ts
 function withMetrics(node, options) {
   const {
     name,
@@ -2373,23 +2349,17 @@ function withMetrics(node, options) {
     metrics = createMetrics(name)
   } = options;
   return async (state) => {
-    if (trackInvocations) {
-      metrics.increment(`${name}.invocations`);
-    }
+    if (trackInvocations) metrics.increment(`${name}.invocations`);
     const timer = trackDuration ? metrics.startTimer(`${name}.duration`) : null;
     try {
       const result = await Promise.resolve(node(state));
       metrics.increment(`${name}.success`);
       return result;
     } catch (error) {
-      if (trackErrors) {
-        metrics.increment(`${name}.errors`);
-      }
+      if (trackErrors) metrics.increment(`${name}.errors`);
       throw error;
     } finally {
-      if (timer) {
-        timer.end();
-      }
+      timer?.end();
     }
   };
 }
@@ -2758,8 +2728,6 @@ var LRUCache = class {
     this.maxSize = maxSize;
     this.evictionStrategy = evictionStrategy;
   }
-  maxSize;
-  evictionStrategy;
   cache = /* @__PURE__ */ new Map();
   get(key) {
     const entry = this.cache.get(key);
@@ -2908,8 +2876,6 @@ var TokenBucket = class {
     this.tokens = maxTokens;
     this.lastRefill = Date.now();
   }
-  maxTokens;
-  refillRate;
   tokens;
   lastRefill;
   tryConsume() {
@@ -2937,8 +2903,6 @@ var SlidingWindow = class {
     this.maxRequests = maxRequests;
     this.windowMs = windowMs;
   }
-  maxRequests;
-  windowMs;
   requests = [];
   tryConsume() {
     const now = Date.now();
@@ -2959,8 +2923,6 @@ var FixedWindow = class {
     this.windowMs = windowMs;
     this.windowStart = Date.now();
   }
-  maxRequests;
-  windowMs;
   count = 0;
   windowStart;
   tryConsume() {
@@ -3000,11 +2962,6 @@ var RateLimiterRegistry = class {
     this.onRateLimitExceeded = onRateLimitExceeded;
     this.onRateLimitReset = onRateLimitReset;
   }
-  maxRequests;
-  windowMs;
-  strategy;
-  onRateLimitExceeded;
-  onRateLimitReset;
   limiters = /* @__PURE__ */ new Map();
   async execute(state, key, executor) {
     const limiter = this.getOrCreate(key);
@@ -3173,13 +3130,6 @@ var ConcurrencyController = class {
     this.onQueueFull = onQueueFull;
     this.queueTimeout = queueTimeout;
   }
-  maxConcurrent;
-  maxQueueSize;
-  onQueued;
-  onExecutionStart;
-  onExecutionComplete;
-  onQueueFull;
-  queueTimeout;
   activeCount = 0;
   queue = [];
   async execute(state, priority, executor) {
@@ -4467,7 +4417,6 @@ var MockDatabaseConnection = class {
   constructor(config) {
     this.config = config;
   }
-  config;
   closed = false;
   async query(_sql, _params) {
     if (this.closed) {
@@ -4510,7 +4459,6 @@ var DatabasePool = class {
       healthCheck: options.healthCheck
     });
   }
-  options;
   pool;
   async acquire() {
     return this.pool.acquire();
@@ -4553,7 +4501,6 @@ var MockHttpClient = class {
   constructor(_config) {
     this._config = _config;
   }
-  _config;
   closed = false;
   async get(url, config) {
     return this.request({ ...config, url, method: "GET" });
@@ -4612,7 +4559,6 @@ var HttpPool = class {
       healthCheck: options.healthCheck
     });
   }
-  options;
   pool;
   async acquire() {
     return this.pool.acquire();
@@ -4647,7 +4593,6 @@ var MemoryManager = class {
   constructor(options) {
     this.options = options;
   }
-  options;
   cleanupHandlers = /* @__PURE__ */ new Map();
   checkTimer;
   leakDetectionTimer;
@@ -4757,7 +4702,6 @@ var BatchProcessor = class {
   constructor(options) {
     this.options = options;
   }
-  options;
   pending = [];
   timer;
   processing = false;
@@ -4864,7 +4808,6 @@ var CircuitBreaker = class {
   constructor(options) {
     this.options = options;
   }
-  options;
   state = "closed";
   failures = 0;
   successes = 0;
@@ -5000,7 +4943,6 @@ var HealthChecker = class {
   constructor(options) {
     this.options = options;
   }
-  options;
   checkTimer;
   lastReport;
   startTime = Date.now();
@@ -5347,7 +5289,6 @@ var AlertManager = class {
   constructor(options) {
     this.options = options;
   }
-  options;
   lastAlertTime = /* @__PURE__ */ new Map();
   monitorTimer;
   running = false;
@@ -5422,7 +5363,6 @@ var AuditLogger = class {
       this.startCleanup();
     }
   }
-  options;
   logs = [];
   cleanupTimer;
   async log(entry) {
@@ -5538,9 +5478,11 @@ function createAuditLogger(options) {
   return new AuditLogger(options);
 }
 
-// src/prompt-loader/index.ts
+// src/prompt-loader/file-loader.ts
 import { readFileSync } from "fs";
 import { join } from "path";
+
+// src/prompt-loader/variables.ts
 var MAX_VARIABLE_LENGTH = 500;
 function createPromptVariableMap() {
   return /* @__PURE__ */ Object.create(null);
@@ -5552,9 +5494,7 @@ function isRenderTemplateOptions(value) {
   return isPromptVariableMap(value) && (Object.prototype.hasOwnProperty.call(value, "trustedVariables") || Object.prototype.hasOwnProperty.call(value, "untrustedVariables"));
 }
 function normalizeVariableMap(value) {
-  if (!isPromptVariableMap(value)) {
-    return createPromptVariableMap();
-  }
+  if (!isPromptVariableMap(value)) return createPromptVariableMap();
   return Object.assign(createPromptVariableMap(), value);
 }
 function sanitizeVariableMap(variables) {
@@ -5565,11 +5505,7 @@ function sanitizeVariableMap(variables) {
   return sanitizedVariables;
 }
 function mergeVariableMaps(baseVariables, overrideVariables) {
-  return Object.assign(
-    createPromptVariableMap(),
-    baseVariables,
-    overrideVariables
-  );
+  return Object.assign(createPromptVariableMap(), baseVariables, overrideVariables);
 }
 function sanitizeValue(value) {
   if (value === void 0 || value === null) return "";
@@ -5578,10 +5514,12 @@ function sanitizeValue(value) {
   sanitized = sanitized.replace(/[\r\n]+/g, " ");
   sanitized = sanitized.trim().replace(/\s+/g, " ");
   if (sanitized.length > MAX_VARIABLE_LENGTH) {
-    sanitized = sanitized.substring(0, MAX_VARIABLE_LENGTH) + "...";
+    sanitized = `${sanitized.substring(0, MAX_VARIABLE_LENGTH)}...`;
   }
   return sanitized;
 }
+
+// src/prompt-loader/renderer.ts
 function renderTemplate(template, options) {
   let rawVariables;
   let sanitizedVariables;
@@ -5597,17 +5535,18 @@ function renderTemplate(template, options) {
     rawVariables = normalizeVariableMap(options);
     sanitizedVariables = rawVariables;
   }
-  let result = template;
-  result = result.replace(/\{\{#if\s+(\w+)\}\}([\s\S]*?)\{\{\/if\}\}/g, (_, varName, content) => {
-    return rawVariables[varName] ? content : "";
-  });
-  result = result.replace(/\{\{(\w+)\}\}/g, (_, varName) => {
-    const value = sanitizedVariables[varName];
-    if (value === void 0 || value === null) return "";
-    return String(value);
+  let result = template.replace(
+    /\{\{#if\s+(\w+)\}\}([\s\S]*?)\{\{\/if\}\}/g,
+    (_, variableName, content) => rawVariables[variableName] ? content : ""
+  );
+  result = result.replace(/\{\{(\w+)\}\}/g, (_, variableName) => {
+    const value = sanitizedVariables[variableName];
+    return value === void 0 || value === null ? "" : String(value);
   });
   return result;
 }
+
+// src/prompt-loader/file-loader.ts
 function loadPrompt(promptName, options = {}, promptsDir) {
   const baseDir = promptsDir || join(process.cwd(), "prompts");
   const promptPath = join(baseDir, `${promptName}.md`);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agentforge/core",
-  "version": "0.16.86",
+  "version": "0.16.88",
   "description": "Production-ready TypeScript agent framework built on LangGraph with orchestration, middleware, and typed abstractions.",
   "type": "module",
   "main": "./dist/index.cjs",