@juspay/neurolink 9.54.6 → 9.54.7

package/dist/cli/commands/config.d.ts

@@ -5,126 +5,7 @@
  * Enhanced configuration system with interactive setup,
  * multi-profile support, and smart validation.
  */
-import { z } from "zod";
-declare const ConfigSchema: z.ZodObject<{
-    defaultProvider: z.ZodDefault<z.ZodEnum<{
-        bedrock: "bedrock";
-        openai: "openai";
-        vertex: "vertex";
-        anthropic: "anthropic";
-        azure: "azure";
-        "google-ai": "google-ai";
-        huggingface: "huggingface";
-        ollama: "ollama";
-        mistral: "mistral";
-        auto: "auto";
-    }>>;
-    providers: z.ZodDefault<z.ZodObject<{
-        openai: z.ZodOptional<z.ZodObject<{
-            apiKey: z.ZodOptional<z.ZodString>;
-            model: z.ZodDefault<z.ZodString>;
-            baseURL: z.ZodOptional<z.ZodString>;
-        }, z.core.$strip>>;
-        bedrock: z.ZodOptional<z.ZodObject<{
-            region: z.ZodOptional<z.ZodString>;
-            accessKeyId: z.ZodOptional<z.ZodString>;
-            secretAccessKey: z.ZodOptional<z.ZodString>;
-            sessionToken: z.ZodOptional<z.ZodString>;
-            model: z.ZodDefault<z.ZodString>;
-        }, z.core.$strip>>;
-        vertex: z.ZodOptional<z.ZodObject<{
-            projectId: z.ZodOptional<z.ZodString>;
-            location: z.ZodDefault<z.ZodString>;
-            credentials: z.ZodOptional<z.ZodString>;
-            serviceAccountKey: z.ZodOptional<z.ZodString>;
-            clientEmail: z.ZodOptional<z.ZodString>;
-            privateKey: z.ZodOptional<z.ZodString>;
-            model: z.ZodDefault<z.ZodString>;
-        }, z.core.$strip>>;
-        anthropic: z.ZodOptional<z.ZodObject<{
-            apiKey: z.ZodOptional<z.ZodString>;
-            model: z.ZodDefault<z.ZodString>;
-        }, z.core.$strip>>;
-        azure: z.ZodOptional<z.ZodObject<{
-            apiKey: z.ZodOptional<z.ZodString>;
-            endpoint: z.ZodOptional<z.ZodString>;
-            deploymentId: z.ZodOptional<z.ZodString>;
-            model: z.ZodDefault<z.ZodString>;
-        }, z.core.$strip>>;
-        "google-ai": z.ZodOptional<z.ZodObject<{
-            apiKey: z.ZodOptional<z.ZodString>;
-            model: z.ZodDefault<z.ZodString>;
-        }, z.core.$strip>>;
-        huggingface: z.ZodOptional<z.ZodObject<{
-            apiKey: z.ZodOptional<z.ZodString>;
-            model: z.ZodDefault<z.ZodString>;
-        }, z.core.$strip>>;
-        ollama: z.ZodOptional<z.ZodObject<{
-            baseUrl: z.ZodDefault<z.ZodString>;
-            model: z.ZodDefault<z.ZodString>;
-            timeout: z.ZodDefault<z.ZodNumber>;
-        }, z.core.$strip>>;
-        mistral: z.ZodOptional<z.ZodObject<{
-            apiKey: z.ZodOptional<z.ZodString>;
-            model: z.ZodDefault<z.ZodString>;
-        }, z.core.$strip>>;
-    }, z.core.$strip>>;
-    profiles: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodAny>>;
-    preferences: z.ZodDefault<z.ZodObject<{
-        outputFormat: z.ZodDefault<z.ZodEnum<{
-            text: "text";
-            json: "json";
-            yaml: "yaml";
-        }>>;
-        temperature: z.ZodDefault<z.ZodNumber>;
-        maxTokens: z.ZodOptional<z.ZodNumber>;
-        enableLogging: z.ZodDefault<z.ZodBoolean>;
-        enableCaching: z.ZodDefault<z.ZodBoolean>;
-        cacheStrategy: z.ZodDefault<z.ZodEnum<{
-            file: "file";
-            redis: "redis";
-            memory: "memory";
-        }>>;
-        defaultEvaluationDomain: z.ZodOptional<z.ZodString>;
-        enableAnalyticsByDefault: z.ZodDefault<z.ZodBoolean>;
-        enableEvaluationByDefault: z.ZodDefault<z.ZodBoolean>;
-    }, z.core.$strip>>;
-    domains: z.ZodDefault<z.ZodObject<{
-        healthcare: z.ZodDefault<z.ZodObject<{
-            evaluationCriteria: z.ZodDefault<z.ZodArray<z.ZodString>>;
-            analyticsConfig: z.ZodDefault<z.ZodObject<{
-                trackPatientData: z.ZodDefault<z.ZodBoolean>;
-                trackDiagnosticAccuracy: z.ZodDefault<z.ZodBoolean>;
-                trackTreatmentOutcomes: z.ZodDefault<z.ZodBoolean>;
-            }, z.core.$strip>>;
-        }, z.core.$strip>>;
-        analytics: z.ZodDefault<z.ZodObject<{
-            evaluationCriteria: z.ZodDefault<z.ZodArray<z.ZodString>>;
-            analyticsConfig: z.ZodDefault<z.ZodObject<{
-                trackDataQuality: z.ZodDefault<z.ZodBoolean>;
-                trackModelPerformance: z.ZodDefault<z.ZodBoolean>;
-                trackBusinessImpact: z.ZodDefault<z.ZodBoolean>;
-            }, z.core.$strip>>;
-        }, z.core.$strip>>;
-        finance: z.ZodDefault<z.ZodObject<{
-            evaluationCriteria: z.ZodDefault<z.ZodArray<z.ZodString>>;
-            analyticsConfig: z.ZodDefault<z.ZodObject<{
-                trackRiskMetrics: z.ZodDefault<z.ZodBoolean>;
-                trackRegulatory: z.ZodDefault<z.ZodBoolean>;
-                trackPortfolioImpact: z.ZodDefault<z.ZodBoolean>;
-            }, z.core.$strip>>;
-        }, z.core.$strip>>;
-        ecommerce: z.ZodDefault<z.ZodObject<{
-            evaluationCriteria: z.ZodDefault<z.ZodArray<z.ZodString>>;
-            analyticsConfig: z.ZodDefault<z.ZodObject<{
-                trackConversions: z.ZodDefault<z.ZodBoolean>;
-                trackUserBehavior: z.ZodDefault<z.ZodBoolean>;
-                trackRevenueImpact: z.ZodDefault<z.ZodBoolean>;
-            }, z.core.$strip>>;
-        }, z.core.$strip>>;
-    }, z.core.$strip>>;
-}, z.core.$strip>;
-type NeuroLinkConfig = z.infer<typeof ConfigSchema>;
+import { type CliNeuroLinkConfig } from "../../lib/types/index.js";
 export declare class ConfigManager {
     private configDir;
     private configFile;
@@ -189,11 +70,11 @@ export declare class ConfigManager {
     /**
      * Get current configuration
      */
-    getConfig(): NeuroLinkConfig;
+    getConfig(): CliNeuroLinkConfig;
     /**
      * Update configuration
      */
-    updateConfig(updates: Partial<NeuroLinkConfig>): void;
+    updateConfig(updates: Partial<CliNeuroLinkConfig>): void;
     /**
      * Show current configuration
      */
@@ -211,4 +92,3 @@ export declare class ConfigManager {
     resetConfig(): void;
 }
 export declare const configManager: ConfigManager;
-export {};

package/dist/cli/commands/config.js

@@ -14,8 +14,10 @@ import { z } from "zod";
 import { CLI_LIMITS } from "../../lib/core/constants.js";
 import { logger } from "../../lib/utils/logger.js";
 import { getTopModelChoices } from "../../lib/utils/modelChoices.js";
-import { AIProviderName } from "../../lib/types/index.js";
-// Configuration schema for validation
+import { AIProviderName, } from "../../lib/types/index.js";
+// Configuration schema for validation. Annotated with
+// z.ZodType<CliNeuroLinkConfig> so drift between the canonical structural
+// type in src/lib/types/cli.ts and this runtime schema fails at compile time.
 const ConfigSchema = z.object({
     defaultProvider: z
         .enum([

package/dist/cli/commands/evaluate.d.ts

@@ -6,24 +6,7 @@
  * Supports subcommands: run, score, report, presets, scorers (list-scorers)
  */
 import type { CommandModule } from "yargs";
-/**
- * Base evaluate command arguments
- */
-type BaseEvaluateArgs = {
-    json?: boolean;
-    verbose?: boolean;
-    format?: "text" | "json" | "table";
-};
-/**
- * Direct evaluate command arguments (main command)
- */
-type DirectEvaluateArgs = BaseEvaluateArgs & {
-    input?: string;
-    query?: string;
-    scorers?: string[];
-    context?: string;
-    threshold?: number;
-};
+import type { DirectEvaluateArgs } from "../../lib/types/index.js";
 /**
  * Main evaluate command with subcommands
  */
@@ -45,4 +28,3 @@ export declare class EvaluateCommandFactory {
      */
     static listPipelines(): void;
 }
-export {};

package/dist/cli/commands/proxy.d.ts

@@ -10,7 +10,7 @@
  * (generate/stream), with an optional ModelRouter for model remapping.
  */
 import type { CommandModule } from "yargs";
-import type { ProxyStartArgs, ProxyStatusArgs, ProxyGuardArgs, ProxyTelemetryArgs } from "../../lib/types/index.js";
+import type { ProxyGuardArgs, ProxyStartArgs, ProxyStatusArgs, ProxyTelemetryArgs } from "../../lib/types/index.js";
 export declare function mapClaudeErrorTypeToStatus(errorType?: string): number;
 export declare const proxyStartCommand: CommandModule<object, ProxyStartArgs>;
 export declare const proxyStatusCommand: CommandModule<object, ProxyStatusArgs>;

package/dist/cli/commands/proxy.js

@@ -1131,6 +1131,9 @@ export const proxyStartCommand = {
         await startProxyCommandHandler(argv);
     },
 };
+// =============================================================================
+// STATUS DISPLAY HELPERS
+// =============================================================================
 function printStatusStats(stats) {
     console.info(`\n  Stats:`);
     if (stats.totalAttempts !== undefined) {

package/dist/cli/commands/rag.js

@@ -167,6 +167,9 @@ async function getEmbeddingModel(provider, model) {
     logger.warn(`No default embedding model for provider ${resolvedProvider}, falling back to OpenAI text-embedding-3-small`);
     return { provider: "openai", model: "text-embedding-3-small" };
 }
+/**
+ * Chunk subcommand arguments
+ */
 /**
  * In-memory storage for indexed documents
  * In production, this would be persisted to a vector database

package/dist/cli/commands/setup-anthropic.d.ts

@@ -8,9 +8,5 @@
  *
  * Follows the same UX patterns as setup-openai and setup-google-ai
  */
-type AnthropicSetupArgv = {
-    check?: boolean;
-    nonInteractive?: boolean;
-};
-export declare function handleAnthropicSetup(argv: AnthropicSetupArgv): Promise<void>;
-export {};
+import { type ProviderSetupArgv } from "../../lib/types/index.js";
+export declare function handleAnthropicSetup(argv: ProviderSetupArgv): Promise<void>;

package/dist/cli/commands/setup-anthropic.js

@@ -15,7 +15,7 @@ import chalk from "chalk";
 import ora from "ora";
 import { logger } from "../../lib/utils/logger.js";
 import { getTopModelChoices } from "../../lib/utils/modelChoices.js";
-import { AIProviderName } from "../../lib/types/index.js";
+import { AIProviderName, } from "../../lib/types/index.js";
 import { maskCredential } from "../utils/maskCredential.js";
 export async function handleAnthropicSetup(argv) {
     try {

package/dist/cli/commands/setup-azure.d.ts

@@ -9,9 +9,5 @@
  *
  * Follows the same UX patterns as other setup commands
  */
-type AzureSetupArgv = {
-    check?: boolean;
-    nonInteractive?: boolean;
-};
-export declare function handleAzureSetup(argv: AzureSetupArgv): Promise<void>;
-export {};
+import { type ProviderSetupArgv } from "../../lib/types/index.js";
+export declare function handleAzureSetup(argv: ProviderSetupArgv): Promise<void>;

package/dist/cli/commands/setup-azure.js

@@ -15,7 +15,7 @@ import ora from "ora";
 import { logger } from "../../lib/utils/logger.js";
 import { updateEnvFile as updateEnvFileShared, displayEnvUpdateSummary, } from "../utils/envManager.js";
 import { getTopModelChoices } from "../../lib/utils/modelChoices.js";
-import { AIProviderName } from "../../lib/types/index.js";
+import { AIProviderName, } from "../../lib/types/index.js";
 import { maskCredential } from "../utils/maskCredential.js";
 export async function handleAzureSetup(argv) {
     try {

package/dist/cli/commands/setup-bedrock.d.ts

@@ -5,9 +5,5 @@
  * Checks for AWS_ACCESS_KEY_ID and AWS_SECRET_ACCESS_KEY
  * Auto-detects AWS CLI configuration, prompts for missing config, updates .env safely
  */
-type BedrockSetupArgv = {
-    check?: boolean;
-    nonInteractive?: boolean;
-};
-export declare function handleBedrockSetup(argv: BedrockSetupArgv): Promise<void>;
-export {};
+import { type ProviderSetupArgv } from "../../lib/types/index.js";
+export declare function handleBedrockSetup(argv: ProviderSetupArgv): Promise<void>;

package/dist/cli/commands/setup-bedrock.js

@@ -14,7 +14,7 @@ import ora from "ora";
 import { logger } from "../../lib/utils/logger.js";
 import { updateEnvFile as envUpdate } from "../utils/envManager.js";
 import { getTopModelChoices } from "../../lib/utils/modelChoices.js";
-import { AIProviderName } from "../../lib/types/index.js";
+import { AIProviderName, } from "../../lib/types/index.js";
 import { maskCredential } from "../utils/maskCredential.js";
 export async function handleBedrockSetup(argv) {
     try {

package/dist/cli/commands/setup-gcp.d.ts

@@ -10,9 +10,5 @@
  * All methods require GOOGLE_VERTEX_PROJECT
  * Optional: GOOGLE_VERTEX_LOCATION (defaults to 'us-central1')
  */
-type GCPSetupArgv = {
-    check?: boolean;
-    nonInteractive?: boolean;
-};
-export declare function handleGCPSetup(argv: GCPSetupArgv): Promise<void>;
-export {};
+import type { ProviderSetupArgv } from "../../lib/types/index.js";
+export declare function handleGCPSetup(argv: ProviderSetupArgv): Promise<void>;

package/dist/cli/commands/setup-google-ai.d.ts

@@ -8,9 +8,5 @@
  *
  * Follows the same UX patterns as setup-openai and setup-gcp
  */
-type GoogleAISetupArgv = {
-    check?: boolean;
-    nonInteractive?: boolean;
-};
-export declare function handleGoogleAISetup(argv: GoogleAISetupArgv): Promise<void>;
-export {};
+import { type ProviderSetupArgv } from "../../lib/types/index.js";
+export declare function handleGoogleAISetup(argv: ProviderSetupArgv): Promise<void>;

package/dist/cli/commands/setup-google-ai.js

@@ -16,7 +16,7 @@ import { logger } from "../../lib/utils/logger.js";
 import { GoogleAIModels } from "../../lib/constants/enums.js";
 import { updateEnvFile as updateEnvFileManager, displayEnvUpdateSummary, } from "../utils/envManager.js";
 import { getTopModelChoices } from "../../lib/utils/modelChoices.js";
-import { AIProviderName } from "../../lib/types/index.js";
+import { AIProviderName, } from "../../lib/types/index.js";
 import { maskCredential } from "../utils/maskCredential.js";
 /**
  * Get the runtime default model that matches the provider implementation

package/dist/cli/commands/setup-huggingface.d.ts

@@ -1,8 +1,4 @@
 import type { Arguments, CommandBuilder } from "yargs";
-type SetupHuggingFaceArgs = {
-    check?: boolean;
-    "non-interactive"?: boolean;
-};
+import type { SetupHuggingFaceArgs } from "../../lib/types/index.js";
 export declare const handleHuggingFaceSetup: (argv: Arguments<SetupHuggingFaceArgs>) => Promise<void>;
 export declare const setupHuggingFaceBuilder: CommandBuilder;
-export {};

package/dist/cli/commands/setup-mistral.d.ts

@@ -1,8 +1,4 @@
 import type { Arguments, CommandBuilder } from "yargs";
-type SetupMistralArgs = {
-    check?: boolean;
-    "non-interactive"?: boolean;
-};
+import type { SetupMistralArgs } from "../../lib/types/index.js";
 export declare const handleMistralSetup: (argv: Arguments<SetupMistralArgs>) => Promise<void>;
 export declare const setupMistralBuilder: CommandBuilder;
-export {};

package/dist/cli/commands/setup-openai.d.ts

@@ -8,9 +8,5 @@
  *
  * Follows the same UX patterns as setup-gcp and setup-bedrock
  */
-type OpenAISetupArgv = {
-    check?: boolean;
-    nonInteractive?: boolean;
-};
-export declare function handleOpenAISetup(argv: OpenAISetupArgv): Promise<void>;
-export {};
+import { type ProviderSetupArgv } from "../../lib/types/index.js";
+export declare function handleOpenAISetup(argv: ProviderSetupArgv): Promise<void>;

package/dist/cli/commands/setup-openai.js

@@ -15,7 +15,7 @@ import chalk from "chalk";
 import ora from "ora";
 import { logger } from "../../lib/utils/logger.js";
 import { getTopModelChoices } from "../../lib/utils/modelChoices.js";
-import { AIProviderName } from "../../lib/types/index.js";
+import { AIProviderName, } from "../../lib/types/index.js";
 import { maskCredential } from "../utils/maskCredential.js";
 export async function handleOpenAISetup(argv) {
     try {

package/dist/cli/commands/setup.d.ts

@@ -5,15 +5,8 @@
  * Provides a beautiful welcome experience for new users and guided
  * provider selection, while delegating to existing setup commands.
  */
-type SetupArgs = {
-    provider?: string;
-    list?: boolean;
-    status?: boolean;
-    interactive?: boolean;
-    help?: boolean;
-};
+import type { SetupArgs } from "../../lib/types/index.js";
 /**
  * Main setup command handler
  */
 export declare function handleSetup(argv: SetupArgs): Promise<void>;
-export {};

package/dist/cli/commands/task.js

@@ -864,4 +864,5 @@ function formatDuration(ms) {
     }
     return `${ms / 86_400_000}d`;
 }
+// ── Arg Types ───────────────────────────────────────────
 //# sourceMappingURL=task.js.map

package/dist/cli/commands/voiceServer.d.ts

@@ -1,6 +1,3 @@
 import type { CommandModule } from "yargs";
-type VoiceServerArgs = {
-    port: number;
-};
+import type { VoiceServerArgs } from "../../lib/types/index.js";
 export declare const voiceServerCommand: CommandModule<object, VoiceServerArgs>;
-export {};

package/dist/cli/loop/session.js

@@ -5,6 +5,8 @@ import { NeuroLink } from "../../lib/neurolink.js";
 import { globalSession } from "../../lib/session/globalSessionState.js";
 import { logger } from "../../lib/utils/logger.js";
 import { displayConversationPreview, displaySessionMessage, getConversationPreview, loadCommandHistory, parseValue, restoreSessionVariables, saveCommandToHistory, verifyConversationContext, } from "../../lib/utils/loopUtils.js";
+import { SpanStatusCode } from "@opentelemetry/api";
+import { tracers } from "../../lib/telemetry/tracers.js";
 import { handleError } from "../errorHandler.js";
 import { ConversationSelector } from "./conversationSelector.js";
 import { textGenerationOptionsSchema } from "./optionsSchema.js";
@@ -108,19 +110,38 @@ export class LoopSession {
                     // Default: treat as stream command with array format
                     processedCommand = ["stream", command];
                 }
-                // Execute the command
+                // Execute the command within an OTel span for per-turn visibility.
                 // The .fail() handler in cli.ts is now session-aware and will
                 // handle all parsing and validation errors without exiting the loop.
                 // We create a fresh instance for each command to prevent state pollution.
-                const yargsInstance = this.initializeCliParser();
-                await yargsInstance
-                    .scriptName("")
-                    .fail((msg, err) => {
-                    // Re-throw the error to be caught by the outer catch block
-                    throw err || new Error(msg);
-                })
-                    .exitProcess(false)
-                    .parse(processedCommand);
+                await tracers.sdk.startActiveSpan("neurolink.cli.turn", async (turnSpan) => {
+                    try {
+                        turnSpan.setAttribute("cli.command", typeof processedCommand === "string"
+                            ? processedCommand.slice(0, 100)
+                            : (processedCommand[0] ?? "unknown"));
+                        turnSpan.setAttribute("cli.session_id", this.sessionId ?? "none");
+                        const yargsInstance = this.initializeCliParser();
+                        await yargsInstance
+                            .scriptName("")
+                            .fail((msg, err) => {
+                            throw err || new Error(msg);
+                        })
+                            .exitProcess(false)
+                            .parse(processedCommand);
+                    }
+                    catch (e) {
+                        const err = e instanceof Error ? e : new Error(String(e));
+                        turnSpan.recordException(err);
+                        turnSpan.setStatus({
+                            code: SpanStatusCode.ERROR,
+                            message: err.message,
+                        });
+                        throw e;
+                    }
+                    finally {
+                        turnSpan.end();
+                    }
+                });
                 // Check context budget after each generation command
                 await this.checkContextBudgetWarning();
             }

package/dist/cli/utils/interactiveSetup.d.ts

@@ -5,20 +5,8 @@
  * credential collection, testing, and environment file management.
  */
 import { AIProviderName } from "../../lib/constants/enums.js";
-import type { SetupResult } from "../../lib/types/index.js";
-type ProviderConfig = {
-    id: AIProviderName;
-    name: string;
-    description: string;
-    envVars: Array<{
-        key: string;
-        prompt: string;
-        secure?: boolean;
-        default?: string;
-        optional?: boolean;
-    }>;
-};
-export declare const PROVIDER_CONFIGS: ProviderConfig[];
+import type { InteractiveProviderConfig, SetupResult } from "../../lib/types/index.js";
+export declare const PROVIDER_CONFIGS: InteractiveProviderConfig[];
 /**
  * Run the interactive setup wizard
  */
@@ -36,4 +24,3 @@ export declare function testProviderConnectivity(providers: AIProviderName[], qu
  * Display setup summary
  */
 export declare function displaySetupSummary(result: SetupResult, quiet?: boolean): void;
-export {};

package/dist/cli/utils/videoFileUtils.d.ts

@@ -7,20 +7,7 @@
  *
  * @module cli/utils/videoFileUtils
  */
-import type { VideoGenerationResult } from "../../lib/types/index.js";
-/**
- * Result of saving video to file
- */
-type VideoSaveResult = {
-    /** Whether the save was successful */
-    success: boolean;
-    /** Full path to the saved file */
-    path: string;
-    /** File size in bytes */
-    size: number;
-    /** Error message if failed */
-    error?: string;
-};
+import type { VideoGenerationResult, VideoSaveResult } from "../../lib/types/index.js";
 /**
  * Format file size in human-readable format
  *
@@ -109,4 +96,3 @@ export declare function isVideoGenerationResult(obj: unknown): obj is VideoGener
  * @returns Formatted metadata summary string
  */
 export declare function getVideoMetadataSummary(video: VideoGenerationResult): string;
-export {};

package/dist/client/aiSdkAdapter.d.ts

@@ -7,7 +7,7 @@
  *
  * @module @neurolink/ai-sdk
  */
-import type { ClientLanguageModel, ClientLanguageModelCallOptions, ClientLanguageModelResponse, ClientLanguageModelStreamResponse, NeuroLinkProviderOptions, ClientModelOptions } from "../types/index.js";
+import type { ClientLanguageModel, ClientLanguageModelCallOptions, ClientLanguageModelResponse, ClientLanguageModelStreamResponse, ClientModelOptions, NeuroLinkProviderOptions } from "../types/index.js";
 import { NeuroLinkClient } from "./httpClient.js";
 /**
  * NeuroLink Language Model implementation compatible with Vercel AI SDK

package/dist/client/aiSdkAdapter.js

@@ -107,6 +107,7 @@ export class NeuroLinkLanguageModel {
         }
         // Extract system message if present
         const systemPrompt = system ?? messages?.find((m) => m.role === "system")?.content;
+        // ---- Async queue (push/pull pattern) ----
         const buffer = [];
         let finished = false;
         let notifyConsumer = null;

package/dist/client/httpClient.d.ts

@@ -99,6 +99,7 @@ export declare class NeuroLinkClient {
      * Execute HTTP request with middleware and retry logic
      */
     private request;
+    private _doRequest;
     /**
      * Generate text using AI models
      *

package/dist/client/httpClient.js

@@ -8,6 +8,8 @@
  */
 import { HttpError, ClientNetworkError, ClientTimeoutError } from "./errors.js";
 import { logger } from "../utils/logger.js";
+import { tracers } from "../telemetry/tracers.js";
+import { withClientSpan } from "../telemetry/withSpan.js";
 // =============================================================================
 // Shared Utilities
 // =============================================================================
@@ -184,6 +186,17 @@ export class NeuroLinkClient {
      * Execute HTTP request with middleware and retry logic
      */
     async request(method, path, body, options) {
+        return withClientSpan({
+            name: "neurolink.client.http.request",
+            tracer: tracers.http,
+            attributes: {
+                "http.method": method,
+                "http.route": path,
+                "http.url": `${this.config.baseUrl}${path}`,
+            },
+        }, async () => this._doRequest(method, path, body, options));
+    }
+    async _doRequest(method, path, body, options) {
         const url = `${this.config.baseUrl}${path}`;
         const requestId = this.generateRequestId();
         const { retry } = this.config;

package/dist/client/sseClient.d.ts

@@ -49,6 +49,7 @@ export declare class NeuroLinkSSE {
      * Stream from an endpoint using SSE
      */
     stream(path: string, options?: SSERequestOptions, callbacks?: ClientStreamCallbacks): Promise<void>;
+    private _streamInternal;
     /**
      * Abort the current stream
      */

package/dist/client/sseClient.js

@@ -7,7 +7,10 @@
  *
  * @module @neurolink/client/sseClient
  */
+import { SpanStatusCode } from "@opentelemetry/api";
 import { logger } from "../utils/logger.js";
+import { withClientSpan } from "../telemetry/withSpan.js";
+import { tracers } from "../telemetry/tracers.js";
 // =============================================================================
 // SSE Client Implementation
 // =============================================================================
@@ -69,6 +72,32 @@ export class NeuroLinkSSE {
      * Stream from an endpoint using SSE
      */
     async stream(path, options = {}, callbacks = {}) {
+        return withClientSpan({
+            name: "neurolink.client.sse.stream",
+            tracer: tracers.http,
+            attributes: {
+                "http.method": options.body ? "POST" : "GET",
+                "http.route": path,
+                "http.url": this.buildUrl(path),
+                "sse.auto_reconnect": this.config.autoReconnect,
+                "sse.native_event_source": this.config.useNativeEventSource,
+            },
+        }, async (span) => {
+            // Wrap onError callback so the span is marked failed on stream errors
+            const wrappedCallbacks = {
+                ...callbacks,
+                onError: (error) => {
+                    span.setStatus({
+                        code: SpanStatusCode.ERROR,
+                        message: error?.message ?? "SSE stream error",
+                    });
+                    callbacks.onError?.(error);
+                },
+            };
+            return this._streamInternal(path, options, wrappedCallbacks);
+        });
+    }
+    async _streamInternal(path, options = {}, callbacks = {}) {
         const url = this.buildUrl(path);
         const isGetRequest = !options.body;
         // Use native EventSource for GET requests when configured and available