@juspay/neurolink 9.54.2 → 9.54.4

package/dist/server/streaming/index.js

@@ -2,7 +2,12 @@
  * Streaming Module
  * Exports for data stream protocol and streaming utilities
  */
-export { createDataStreamWriter, DataStreamResponse, createDataStreamResponse, 
+export { 
+// Types
+// Writer
+createDataStreamWriter, 
+// Response
+DataStreamResponse, createDataStreamResponse, 
 // Helpers
 pipeAsyncIterableToDataStream, createSSEHeaders, createNDJSONHeaders, 
 // SSE Event Formatting

package/dist/server/utils/redaction.d.ts

@@ -1,11 +1,4 @@
-/**
- * Stream Chunk Redaction Utilities
- * Sanitizes sensitive data from stream chunks before client delivery
- *
- * NOTE: Redaction is DISABLED by default. Enable via config.enabled = true
- */
-import type { DataStreamEvent } from "../streaming/dataStream.js";
-import type { RedactionConfig } from "../types.js";
+import type { RedactionConfig, DataStreamEvent } from "../../types/index.js";
 /**
  * Redact sensitive data from a stream chunk.
  *

package/dist/server/utils/redaction.js

@@ -1,9 +1,3 @@
-/**
- * Stream Chunk Redaction Utilities
- * Sanitizes sensitive data from stream chunks before client delivery
- *
- * NOTE: Redaction is DISABLED by default. Enable via config.enabled = true
- */
 /**
  * Default fields to redact from stream chunks
  */

package/dist/server/utils/validation.d.ts

@@ -3,6 +3,7 @@
  * Provides Zod schemas and validation helpers for server routes
  */
 import { z } from "zod";
+import type { ErrorResponse, ServerValidationResult } from "../../types/index.js";
 /**
  * Agent execute request schema
  */
@@ -98,21 +99,6 @@ export declare const EmbedManyRequestSchema: z.ZodObject<{
     provider: z.ZodOptional<z.ZodString>;
     model: z.ZodOptional<z.ZodString>;
 }, z.core.$strip>;
-/**
- * Standardized error response format
- */
-export type ErrorResponse = {
-    error: {
-        code: string;
-        message: string;
-        details?: unknown;
-    };
-    metadata?: {
-        timestamp: string;
-        requestId?: string;
-    };
-    httpStatus?: number;
-};
 /**
  * Type guard to check if a value is an ErrorResponse
  */
@@ -121,27 +107,15 @@ export declare function isErrorResponse(value: unknown): value is ErrorResponse;
  * Create a standardized error response
  */
 export declare function createErrorResponse(code: string, message: string, details?: unknown, requestId?: string, httpStatus?: number): ErrorResponse;
-/**
- * Validation result type
- */
-export type ValidationResult<T> = {
-    success: true;
-    data: T;
-    error?: undefined;
-} | {
-    success: false;
-    error: ErrorResponse;
-    data?: undefined;
-};
 /**
  * Validate request body against a Zod schema
  */
-export declare function validateRequest<T>(schema: z.ZodSchema<T>, data: unknown, requestId?: string): ValidationResult<T>;
+export declare function validateRequest<T>(schema: z.ZodSchema<T>, data: unknown, requestId?: string): ServerValidationResult<T>;
 /**
  * Validate query parameters against a Zod schema
  */
-export declare function validateQuery<T>(schema: z.ZodSchema<T>, query: Record<string, string>, requestId?: string): ValidationResult<T>;
+export declare function validateQuery<T>(schema: z.ZodSchema<T>, query: Record<string, string>, requestId?: string): ServerValidationResult<T>;
 /**
  * Validate path parameters against a Zod schema
  */
-export declare function validateParams<T>(schema: z.ZodSchema<T>, params: Record<string, string>, requestId?: string): ValidationResult<T>;
+export declare function validateParams<T>(schema: z.ZodSchema<T>, params: Record<string, string>, requestId?: string): ServerValidationResult<T>;

package/dist/server/utils/validation.js

@@ -127,6 +127,9 @@ export const EmbedManyRequestSchema = z.object({
     provider: z.string().optional(),
     model: z.string().optional(),
 });
+// ============================================
+// Error Response Type Guards / Helpers
+// ============================================
 /**
  * Type guard to check if a value is an ErrorResponse
  */

package/dist/server/voice/frameBus.d.ts

@@ -1,4 +1,4 @@
-import type { Frame } from "./types.js";
+import type { Frame } from "../../types/index.js";
 export declare class FrameBus {
     private handlers;
     subscribe<T extends Frame["type"]>(type: T, fn: (frame: Extract<Frame, {

package/dist/server/voice/voiceWebSocketHandler.d.ts

@@ -4,8 +4,4 @@ import type { Server as HttpServer } from "http";
  * so the env change is scoped to voice mode only.
  */
 export declare function configureVoiceServerEnvironment(): void;
-export type Message = {
-    role: "system" | "user" | "assistant";
-    content: string;
-};
 export declare function setupWebSocket(server: HttpServer): void;

package/dist/server/websocket/WebSocketHandler.d.ts

@@ -4,7 +4,7 @@
  * Provides cross-framework WebSocket handling for real-time AI interactions.
  * Supports connection management, message routing, and graceful shutdown.
  */
-import type { WebSocketConfig, WebSocketHandler as IWebSocketHandler, WebSocketConnection, WebSocketMessage, AuthenticatedUser } from "../types.js";
+import type { WebSocketConfig, WebSocketHandler as IWebSocketHandler, WebSocketConnection, WebSocketMessage, AuthenticatedUser } from "../../types/index.js";
 /**
  * WebSocket connection manager
  */

package/dist/services/server/ai/observability/instrumentation.d.ts

@@ -11,69 +11,7 @@ import { trace } from "@opentelemetry/api";
 import { LoggerProvider } from "@opentelemetry/sdk-logs";
 import { type SpanProcessor } from "@opentelemetry/sdk-trace-base";
 import { NodeTracerProvider } from "@opentelemetry/sdk-trace-node";
-import type { LangfuseConfig } from "../../../../types/observability.js";
-/**
- * Extended context for Langfuse spans
- * Supports all Langfuse trace attributes for rich observability
- */
-export type LangfuseContext = {
-    userId?: string | null;
-    sessionId?: string | null;
-    /** Conversation/thread identifier for grouping related traces */
-    conversationId?: string | null;
-    /** Request identifier for correlating with application logs */
-    requestId?: string | null;
-    /** Custom trace name for better organization in Langfuse UI */
-    traceName?: string | null;
-    /** Custom metadata to attach to spans */
-    metadata?: Record<string, unknown> | null;
-    /**
-     * Explicit operation name (e.g., "ai.streamText", "chat", "embeddings")
-     *
-     * If set, this overrides auto-detection from the span name.
-     * Use this when you want a custom operation name that doesn't match
-     * the auto-detected Vercel AI SDK operation.
-     *
-     * @example
-     * await setLangfuseContext({
-     *   userId: "user@email.com",
-     *   operationName: "customer-support-chat"
-     * }, async () => {
-     *   // Trace name: "user@email.com:customer-support-chat"
-     * });
-     */
-    operationName?: string | null;
-    /**
-     * Override global autoDetectOperationName setting for this context.
-     *
-     * When undefined, uses the global setting from LangfuseConfig.
-     * Set to false to disable auto-detection for this specific context.
-     *
-     * @default undefined (uses global setting, which defaults to true)
-     */
-    autoDetectOperationName?: boolean;
-    /**
-     * Custom attributes to set on all spans within this context.
-     *
-     * These attributes are propagated to every span created within the
-     * AsyncLocalStorage context, enabling application-level context
-     * (e.g., Slack channel name, feature flag, tenant ID) to appear
-     * on all SDK-internal spans.
-     *
-     * @example
-     * await setLangfuseContext({
-     *   userId: "user@email.com",
-     *   customAttributes: {
-     *     "app.slack.channel": "engineering",
-     *     "app.tenant.id": "tenant-123",
-     *     "app.feature.flag": true,
-     *   }
-     * }, async () => {
-     *   // All spans created here will have these attributes
-     * });
-     */
-    customAttributes?: Record<string, string | number | boolean>;
-};
+import type { LangfuseConfig, LangfuseContext } from "../../../../types/index.js";
 /**
  * Initialize OpenTelemetry with Langfuse span processor
  *

package/dist/session/globalSessionState.d.ts

@@ -1,5 +1,5 @@
 import { NeuroLink } from "../neurolink.js";
-import type { ConversationMemoryConfig } from "../types/conversation.js";
+import type { ConversationMemoryConfig } from "../types/index.js";
 type SessionVariableValue = string | number | boolean;
 type LoopSessionState = {
     neurolinkInstance: NeuroLink;

package/dist/tasks/autoresearchTaskExecutor.d.ts

@@ -12,8 +12,7 @@
  * Workers are cached by tag to avoid re-initialization on each tick.
  * Forwards the NeuroLink emitter to each worker for lifecycle events.
  */
-import type { AutoresearchEmitter } from "../types/autoresearchTypes.js";
-import type { NeuroLinkExecutable, Task, TaskRunResult } from "../types/taskTypes.js";
+import type { AutoresearchEmitter, NeuroLinkExecutable, Task, TaskRunResult } from "../types/index.js";
 /**
  * Clear all cached workers. Called by TaskManager.shutdown().
  */

package/dist/tasks/backends/bullmqBackend.d.ts

@@ -6,7 +6,7 @@
  * - One-shot tasks → BullMQ delayed jobs
  * - Survives process restarts (Redis-persisted)
  */
-import { type Task, type TaskBackend, type TaskExecutorFn, type TaskManagerConfig } from "../../types/taskTypes.js";
+import { type Task, type TaskBackend, type TaskExecutorFn, type TaskManagerConfig } from "../../types/index.js";
 export declare class BullMQBackend implements TaskBackend {
     readonly name = "bullmq";
     private queue;

package/dist/tasks/backends/bullmqBackend.js

@@ -9,7 +9,7 @@
 import { Queue, Worker } from "bullmq";
 import { logger } from "../../utils/logger.js";
 import { TaskError } from "../errors.js";
-import { TASK_DEFAULTS, } from "../../types/taskTypes.js";
+import { TASK_DEFAULTS, } from "../../types/index.js";
 const QUEUE_NAME = "neurolink-tasks";
 export class BullMQBackend {
     name = "bullmq";

package/dist/tasks/backends/nodeTimeoutBackend.d.ts

@@ -6,7 +6,7 @@
  * - One-shot tasks → setTimeout
  * - All timers are in-process — lost on restart
  */
-import { type Task, type TaskBackend, type TaskExecutorFn, type TaskManagerConfig } from "../../types/taskTypes.js";
+import { type Task, type TaskBackend, type TaskExecutorFn, type TaskManagerConfig } from "../../types/index.js";
 export declare class NodeTimeoutBackend implements TaskBackend {
     readonly name = "node-timeout";
     private scheduled;

package/dist/tasks/backends/nodeTimeoutBackend.js

@@ -8,7 +8,7 @@
  */
 import { Cron } from "croner";
 import { logger } from "../../utils/logger.js";
-import { TASK_DEFAULTS, } from "../../types/taskTypes.js";
+import { TASK_DEFAULTS, } from "../../types/index.js";
 export class NodeTimeoutBackend {
     name = "node-timeout";
     scheduled = new Map();

package/dist/tasks/backends/taskBackendRegistry.d.ts

@@ -2,7 +2,7 @@
  * TaskBackendRegistry — registration point for all task backend implementations.
  * Follows the same pattern as ProviderRegistry: dynamic imports, lazy registration.
  */
-import type { TaskBackendName, TaskBackendFactoryFn, TaskManagerConfig, TaskBackend } from "../../types/taskTypes.js";
+import type { TaskBackendName, TaskBackendFactoryFn, TaskManagerConfig, TaskBackend } from "../../types/index.js";
 export declare class TaskBackendRegistry {
     private static factories;
     private static registered;

package/dist/tasks/store/fileTaskStore.d.ts

@@ -7,7 +7,7 @@
  *   {logsPath}/{taskId}.jsonl       — run log per task (append-only)
  *   Continuation history is in-memory only (lost on restart).
  */
-import { type Task, type TaskStatus, type TaskRunResult, type TaskStore, type TaskManagerConfig, type ConversationEntry } from "../../types/taskTypes.js";
+import { type Task, type TaskStatus, type TaskRunResult, type TaskStore, type TaskManagerConfig, type ConversationEntry } from "../../types/index.js";
 export declare class FileTaskStore implements TaskStore {
     readonly type: "file";
     private storePath;

package/dist/tasks/store/fileTaskStore.js

@@ -12,7 +12,7 @@ import { appendFile, readFile, rename, unlink, writeFile, } from "node:fs/promis
 import { dirname, join } from "node:path";
 import { logger } from "../../utils/logger.js";
 import { TaskError } from "../errors.js";
-import { TASK_DEFAULTS, } from "../../types/taskTypes.js";
+import { TASK_DEFAULTS, } from "../../types/index.js";
 export class FileTaskStore {
     type = "file";
     storePath;

package/dist/tasks/store/redisTaskStore.d.ts

@@ -7,7 +7,7 @@
  *   neurolink:task:{id}:runs     (List)  — run log entries (newest first)
  *   neurolink:task:{id}:history  (List)  — continuation mode conversation history
  */
-import { type Task, type TaskStatus, type TaskRunResult, type TaskStore, type TaskManagerConfig, type ConversationEntry } from "../../types/taskTypes.js";
+import { type Task, type TaskStatus, type TaskRunResult, type TaskStore, type TaskManagerConfig, type ConversationEntry } from "../../types/index.js";
 export declare class RedisTaskStore implements TaskStore {
     private config;
     readonly type: "redis";

package/dist/tasks/store/redisTaskStore.js

@@ -10,7 +10,7 @@
 import { createClient } from "redis";
 import { logger } from "../../utils/logger.js";
 import { TaskError } from "../errors.js";
-import { TASK_DEFAULTS, } from "../../types/taskTypes.js";
+import { TASK_DEFAULTS, } from "../../types/index.js";
 const KEY_PREFIX = "neurolink:";
 const TASKS_HASH = `${KEY_PREFIX}tasks`;
 function taskRunsKey(taskId) {

package/dist/tasks/taskExecutor.d.ts

@@ -7,8 +7,7 @@
  * - Retry with exponential backoff for transient errors
  * - Run result construction and logging
  */
-import type { AutoresearchEmitter } from "../types/autoresearchTypes.js";
-import type { NeuroLinkExecutable, Task, TaskRunResult, TaskStore } from "../types/taskTypes.js";
+import type { AutoresearchEmitter, NeuroLinkExecutable, Task, TaskRunResult, TaskStore } from "../types/index.js";
 export declare class TaskExecutor {
     private neurolink;
     private store;

package/dist/tasks/taskManager.d.ts

@@ -8,7 +8,7 @@
  *   const neurolink = new NeuroLink({ tasks: { backend: "bullmq" } });
  *   await neurolink.tasks.create({ name: "monitor", prompt: "...", schedule: { type: "interval", every: 60000 } });
  */
-import { type NeuroLinkExecutable, type Task, type TaskDefinition, type TaskManagerConfig, type TaskRunResult, type TaskStatus } from "../types/taskTypes.js";
+import { type NeuroLinkExecutable, type Task, type TaskDefinition, type TaskManagerConfig, type TaskRunResult, type TaskStatus } from "../types/index.js";
 export declare class TaskManager {
     private neurolink;
     private config;

package/dist/tasks/taskManager.js

@@ -9,7 +9,7 @@
  *   await neurolink.tasks.create({ name: "monitor", prompt: "...", schedule: { type: "interval", every: 60000 } });
  */
 import { nanoid } from "nanoid";
-import { TASK_DEFAULTS, } from "../types/taskTypes.js";
+import { TASK_DEFAULTS, } from "../types/index.js";
 import { logger } from "../utils/logger.js";
 import { clearWorkerCache } from "./autoresearchTaskExecutor.js";
 import { TaskBackendRegistry } from "./backends/taskBackendRegistry.js";

package/dist/tasks/tools/taskTools.d.ts

@@ -8,7 +8,7 @@
  * @module tasks/tools/taskTools
  */
 import type { TaskManager } from "../taskManager.js";
-import type { TaskSchedule } from "../../types/taskTypes.js";
+import type { TaskSchedule } from "../../types/index.js";
 /**
  * Create task management tools bound to a TaskManager instance.
  *
@@ -31,7 +31,7 @@ export declare function createTaskTools(manager: TaskManager): {
         name: string;
         prompt: string;
         schedule: {
-            type: "once" | "cron" | "interval";
+            type: "cron" | "interval" | "once";
             expression?: string | undefined;
             timezone?: string | undefined;
             every?: number | undefined;
@@ -58,7 +58,7 @@ export declare function createTaskTools(manager: TaskManager): {
         schedule?: undefined;
     }>;
     listTasks: import("ai").Tool<{
-        status?: "failed" | "pending" | "completed" | "cancelled" | "active" | "paused" | undefined;
+        status?: "failed" | "pending" | "active" | "paused" | "completed" | "cancelled" | undefined;
     }, {
         success: boolean;
         count: number;

package/dist/telemetry/index.d.ts

@@ -1,6 +1,6 @@
-export { TelemetryService, type HealthMetrics } from "./telemetryService.js";
+export { TelemetryService } from "./telemetryService.js";
 export { tracers } from "./tracers.js";
-export { withSpan, withClientSpan, type SpanOptions } from "./withSpan.js";
+export { withSpan, withClientSpan } from "./withSpan.js";
 export { ATTR } from "./attributes.js";
 /**
  * Initialize telemetry for NeuroLink

package/dist/telemetry/telemetryService.d.ts

@@ -1,11 +1,4 @@
-export type HealthMetrics = {
-    timestamp: number;
-    memoryUsage: NodeJS.MemoryUsage;
-    uptime: number;
-    activeConnections: number;
-    errorRate: number;
-    averageResponseTime: number;
-};
+import type { HealthMetrics } from "../types/index.js";
 export declare class TelemetryService {
     private static instance;
     private tracerProvider?;

package/dist/telemetry/withSpan.d.ts

@@ -1,9 +1,4 @@
-import { type Span, type Tracer, SpanKind } from "@opentelemetry/api";
-export type SpanOptions = {
-    name: string;
-    tracer: Tracer;
-    kind?: SpanKind;
-    attributes?: Record<string, string | number | boolean | undefined>;
-};
+import { type Span } from "@opentelemetry/api";
+import type { SpanOptions } from "../types/index.js";
 export declare function withSpan<T>(options: SpanOptions, fn: (span: Span) => Promise<T>): Promise<T>;
 export declare function withClientSpan<T>(options: Omit<SpanOptions, "kind">, fn: (span: Span) => Promise<T>): Promise<T>;

package/dist/telemetry/withSpan.js

@@ -1,4 +1,4 @@
-import { SpanKind, SpanStatusCode, } from "@opentelemetry/api";
+import { SpanKind, SpanStatusCode } from "@opentelemetry/api";
 export async function withSpan(options, fn) {
     const { name, tracer, kind = SpanKind.INTERNAL, attributes } = options;
     return tracer.startActiveSpan(name, { kind }, async (span) => {

package/dist/types/{typeAliases.d.ts → aliases.d.ts}

@@ -113,18 +113,6 @@ export type NumberArray = number[];
  */
 export type OptionalStringArray = StringArray | undefined;
 export type OptionalRecordArray = RecordArray | undefined;
-/**
- * Provider configuration type
- * Common structure for AI provider settings
- */
-export type ProviderConfig = {
-    apiKey?: string;
-    baseUrl?: string;
-    model?: string;
-    timeout?: number;
-    retries?: number;
-    metadata?: StandardRecord;
-};
 /**
  * API response structure
  * Standard response format across providers
@@ -169,15 +157,6 @@ export type EnhancedContext = BasicContext & {
     metadata?: StandardRecord;
     timeout?: number;
 };
-/**
- * Tool execution context with capabilities
- * Full context for complex tool operations
- */
-export type ToolContext = EnhancedContext & {
-    capabilities?: StringArray;
-    permissions?: StringArray;
-    environment?: string;
-};
 /**
  * Standard error structure
  * Consistent error format across the codebase
@@ -259,16 +238,6 @@ export type ServiceConfig = {
     apiKey?: string;
     metadata?: StandardRecord;
 };
-/**
- * Rate limiting configuration
- * Common rate limiting parameters
- */
-export type RateLimitConfig = {
-    enabled?: boolean;
-    requestsPerMinute?: number;
-    requestsPerHour?: number;
-    burstLimit?: number;
-};
 /**
  * Simple success/error result (different from generic OperationResult)
  * Used for basic operation feedback without data payload
@@ -306,7 +275,7 @@ export type ProviderPairResult<T = unknown> = {
  * Tool execution result with enhanced prompt
  * Common pattern in tool orchestration scenarios
  */
-export type ToolExecutionResult = {
+export type OrchestrationResult = {
     toolResults: unknown[];
     enhancedPrompt: string;
 };

package/dist/{lib/types/artifactTypes.d.ts → types/artifact.d.ts}

@@ -39,7 +39,7 @@ export type ArtifactRef = {
  * Default backend: LocalTempArtifactStore (filesystem, single-process).
  * Future backends can implement this interface for S3, Redis blobs, etc.
  */
-export interface ArtifactStore {
+export type ArtifactStore = {
     /**
      * Persist a payload and return a lightweight reference.
      * @param payload  Serialized tool output (JSON string or plain text).
@@ -60,4 +60,4 @@ export interface ArtifactStore {
     cleanup(olderThanMs: number): Promise<number>;
     /** Generate a short preview string from a serialized payload. */
     generatePreview(payload: string): string;
-}
+};

package/dist/{lib/types/authTypes.d.ts → types/auth.d.ts}

@@ -6,8 +6,7 @@
  * All auth type imports should reference this module (or the barrel re-export
  * via src/lib/types/index.ts).
  */
-import type { JsonValue } from "./common.js";
-import type { UnknownRecord } from "./common.js";
+import type { JsonValue, UnknownRecord } from "./common.js";
 /**
  * OAuth tokens structure for storage.
  * Stricter version of OAuthTokens with required fields for persistent storage.
@@ -24,6 +23,22 @@ export type StoredOAuthTokens = {
     /** Optional OAuth scopes granted */
     scope?: string;
 };
+/**
+ * OAuth tokens structure (relaxed version for general use).
+ * Use StoredOAuthTokens when persisting (stricter — expiresAt and tokenType required).
+ */
+export type OAuthTokens = {
+    /** The access token for API authentication */
+    accessToken: string;
+    /** The refresh token for obtaining new access tokens */
+    refreshToken?: string;
+    /** Token expiration timestamp (Unix epoch) */
+    expiresAt?: number;
+    /** Token type (typically "Bearer") */
+    tokenType?: string;
+    /** OAuth scope granted */
+    scope?: string;
+};
 /**
  * Token refresher function type.
  * Takes a refresh token and returns new tokens.
@@ -990,3 +1005,29 @@ export type MastraAuthProvider = AuthTokenValidator & AuthUserAuthorizer & AuthS
     /** Provider configuration */
     readonly config: AuthProviderConfig;
 };
+/**
+ * Session storage interface for SessionManager
+ *
+ * Defines the contract for session storage backends (memory, Redis, custom).
+ * Note: This is a SessionManager-specific interface that uses `set()`/`getUserSessions()`/
+ * `deleteUserSessions()`/`isHealthy()` method names, which differ from the canonical
+ * `SessionStorage` type in `../types/auth.js` (which uses `save()`/`getForUser()`/
+ * `deleteAllForUser()`/`exists()`/`touch()`). Both interfaces coexist because
+ * SessionManager and BaseAuthProvider have separate storage patterns.
+ */
+export type SessionManagerStorage = {
+    /** Get a session by ID */
+    get(sessionId: string): Promise<AuthSession | null>;
+    /** Store a session */
+    set(session: AuthSession): Promise<void>;
+    /** Delete a session */
+    delete(sessionId: string): Promise<void>;
+    /** Get all sessions for a user */
+    getUserSessions(userId: string): Promise<AuthSession[]>;
+    /** Delete all sessions for a user */
+    deleteUserSessions(userId: string): Promise<void>;
+    /** Clear all sessions (for cleanup) */
+    clear(): Promise<void>;
+    /** Health check */
+    isHealthy(): Promise<boolean>;
+};

package/dist/{lib/types/autoresearchTypes.d.ts → types/autoresearch.d.ts}

@@ -5,7 +5,7 @@
  * experiments, evaluates results against a deterministic metric, and
  * keeps or discards each change — running unattended for hours.
  */
-import type { ThinkingLevel } from "./configTypes.js";
+import type { ThinkingLevel } from "./config.js";
 export type MetricDirection = "lower" | "higher";
 export type MetricConfig = {
     name: string;

package/dist/types/circuitBreakerErrors.d.ts

@@ -3,7 +3,7 @@
  * Shared error types for circuit breaker implementations across the codebase.
  * Lives in types/ to avoid circular dependencies between utils/ and mcp/.
  */
-import type { CircuitBreakerState } from "./mcpTypes.js";
+import type { CircuitBreakerState } from "./mcp.js";
 /**
  * Typed error thrown when a circuit breaker is open or half-open call limit is reached.
  * Contains structured metadata so callers can build actionable error messages