langwatch 0.7.1 → 0.8.0

package/dist/{create-S5RDGF3H.js → create-ACGBGFVO.js}

@@ -3,10 +3,10 @@
 var _chunkF6E4XQQUjs = require('./chunk-F6E4XQQU.js');
 
 
-var _chunkDZH6SY3Zjs = require('./chunk-DZH6SY3Z.js');
+var _chunkGC7VHCU5js = require('./chunk-GC7VHCU5.js');
 
 
-var _chunk36XAYVMCjs = require('./chunk-36XAYVMC.js');
+var _chunkWAAQLJ67js = require('./chunk-WAAQLJ67.js');
 require('./chunk-AZHZ4NB4.js');
 require('./chunk-OHM7JUMR.js');
 
@@ -21,7 +21,7 @@ var createCommand = async (name, _options) => {
       process.exit(1);
     }
     _chunkF6E4XQQUjs.checkApiKey.call(void 0, );
-    await _chunkDZH6SY3Zjs.ensureProjectInitialized.call(void 0, );
+    await _chunkGC7VHCU5js.ensureProjectInitialized.call(void 0, );
     const promptPath = path.join(
       process.cwd(),
       "prompts",
@@ -47,11 +47,11 @@ messages:
     content: "{{input}}"
 `;
     fs.writeFileSync(promptPath, defaultContent, "utf8");
-    const promptsConfig = _chunk36XAYVMCjs.FileManager.loadPromptsConfig();
+    const promptsConfig = _chunkWAAQLJ67js.FileManager.loadPromptsConfig();
     const relativePath = path.relative(process.cwd(), promptPath);
     promptsConfig.prompts[name] = `file:${relativePath}`;
-    _chunk36XAYVMCjs.FileManager.savePromptsConfig(promptsConfig);
-    const lock = _chunk36XAYVMCjs.FileManager.loadPromptsLock();
+    _chunkWAAQLJ67js.FileManager.savePromptsConfig(promptsConfig);
+    const lock = _chunkWAAQLJ67js.FileManager.loadPromptsLock();
     lock.prompts[name] = {
       version: 0,
       // Local files start at version 0
@@ -59,7 +59,7 @@ messages:
       materialized: relativePath
       // Store the original file path
     };
-    _chunk36XAYVMCjs.FileManager.savePromptsLock(lock);
+    _chunkWAAQLJ67js.FileManager.savePromptsLock(lock);
     const displayPath = `./${relativePath}`;
     console.log(
       _chalk2.default.green(`\u2713 Created prompt file: ${_chalk2.default.cyan(displayPath)}`)
@@ -77,4 +77,4 @@ messages:
 
 
 exports.createCommand = createCommand;
-//# sourceMappingURL=create-S5RDGF3H.js.map
+//# sourceMappingURL=create-ACGBGFVO.js.map

package/dist/{create-S5RDGF3H.js.map → create-ACGBGFVO.js.map}

@@ -1 +1 @@
-{"version":3,"sources":["/home/runner/work/langwatch/langwatch/typescript-sdk/dist/create-S5RDGF3H.js","../src/cli/commands/create.ts"],"names":[],"mappings":"AAAA;AACE;AACF,sDAA4B;AAC5B;AACE;AACF,sDAA4B;AAC5B;AACE;AACF,sDAA4B;AAC5B,+BAA4B;AAC5B,+BAA4B;AAC5B;AACA;ACZA,+DAAoB;AACpB,uEAAsB;AACtB,4EAAkB;AAOX,IAAM,cAAA,EAAgB,MAAA,CAC3B,IAAA,EACA,QAAA,EAAA,GACkB;AAClB,EAAA,IAAI;AAEF,IAAA,GAAA,CAAI,CAAC,KAAA,GAAQ,IAAA,CAAK,IAAA,CAAK,EAAA,IAAM,EAAA,EAAI;AAC/B,MAAA,OAAA,CAAQ,KAAA,CAAM,eAAA,CAAM,GAAA,CAAI,oCAAoC,CAAC,CAAA;AAC7D,MAAA,OAAA,CAAQ,IAAA,CAAK,CAAC,CAAA;AAAA,IAChB;AAGA,IAAA,0CAAA,CAAY;AAGZ,IAAA,MAAM,uDAAA,CAAyB;AAG/B,IAAA,MAAM,WAAA,EAAkB,IAAA,CAAA,IAAA;AAAA,MACtB,OAAA,CAAQ,GAAA,CAAI,CAAA;AAAA,MACZ,SAAA;AAAA,MACA,CAAA,EAAA;AACF,IAAA;AAEA,IAAA;AACE,MAAA;AAAQ,QAAA;AAER,MAAA;AACA,MAAA;AACF,IAAA;AAGA,IAAA;AACA,IAAA;AACK,MAAA;AACL,IAAA;AAGA,IAAA;AAAuB;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAWpB,IAAA;AAGH,IAAA;AACA,IAAA;AACA,IAAA;AACA,IAAA;AAGA,IAAA;AACA,IAAA;AACE,MAAA;AAAS;AACT,MAAA;AACA,MAAA;AAAc;AAChB,IAAA;AACA,IAAA;AAEA,IAAA;AACA,IAAA;AACE,MAAA;AACF,IAAA;AACA,IAAA;AACA,IAAA;AACF,EAAA;AACE,IAAA;AACE,MAAA;AACA,MAAA;AACF,IAAA;AACA,IAAA;AACF,EAAA;AACF;ADZO;AACA;AACA","file":"/home/runner/work/langwatch/langwatch/typescript-sdk/dist/create-S5RDGF3H.js","sourcesContent":[null,"import * as fs from \"fs\";\nimport * as path from \"path\";\nimport chalk from \"chalk\";\nimport { FileManager } from \"../utils/fileManager\";\nimport { checkApiKey } from \"../utils/apiKey\";\nimport { ensureProjectInitialized } from \"../utils/init\";\n\ntype CreateOptions = Record<string, unknown>;\n\nexport const createCommand = async (\n  name: string,\n  _options: CreateOptions,\n): Promise<void> => {\n  try {\n    // Validate prompt name\n    if (!name || name.trim() === \"\") {\n      console.error(chalk.red(\"Error: Prompt name cannot be empty\"));\n      process.exit(1);\n    }\n\n    // Check API key before doing anything else\n    checkApiKey();\n\n    // Ensure project is initialized\n    await ensureProjectInitialized();\n\n    // Check if file already exists\n    const promptPath = path.join(\n      process.cwd(),\n      \"prompts\",\n      `${name}.prompt.yaml`,\n    );\n\n    if (fs.existsSync(promptPath)) {\n      console.error(\n        chalk.red(`Error: Prompt file already exists at ${promptPath}`),\n      );\n      process.exit(1);\n    }\n\n    // Create prompts directory if it doesn't exist\n    const promptsDir = path.dirname(promptPath);\n    if (!fs.existsSync(promptsDir)) {\n      fs.mkdirSync(promptsDir, { recursive: true });\n    }\n\n    // Default prompt content\n    const defaultContent = `model: openai/gpt-5\nmodelParameters:\n  temperature: 0.7\nmessages:\n  - role: system\n    content: You are a helpful assistant.\n  - role: user\n    content: \"{{input}}\"\n`;\n\n    // Write the file\n    fs.writeFileSync(promptPath, defaultContent, \"utf8\");\n\n    // Add to prompts.json as a file: dependency\n    const promptsConfig = FileManager.loadPromptsConfig();\n    const relativePath = path.relative(process.cwd(), promptPath);\n    promptsConfig.prompts[name] = `file:${relativePath}`;\n    FileManager.savePromptsConfig(promptsConfig);\n\n    // Update lock file\n    const lock = FileManager.loadPromptsLock();\n    lock.prompts[name] = {\n      version: 0, // Local files start at version 0\n      versionId: \"local\",\n      materialized: relativePath, // Store the original file path\n    };\n    FileManager.savePromptsLock(lock);\n\n    const displayPath = `./${relativePath}`;\n    console.log(\n      chalk.green(`✓ Created prompt file: ${chalk.cyan(displayPath)}`),\n    );\n    console.log(chalk.gray(`  Edit this file and then run:`));\n    console.log(chalk.cyan(`  langwatch prompt sync`));\n  } catch (error) {\n    console.error(\n      chalk.red(\"Unexpected error:\"),\n      error instanceof Error ? error.message : error,\n    );\n    process.exit(1);\n  }\n};\n"]}
+{"version":3,"sources":["/home/runner/work/langwatch/langwatch/typescript-sdk/dist/create-ACGBGFVO.js","../src/cli/commands/create.ts"],"names":[],"mappings":"AAAA;AACE;AACF,sDAA4B;AAC5B;AACE;AACF,sDAA4B;AAC5B;AACE;AACF,sDAA4B;AAC5B,+BAA4B;AAC5B,+BAA4B;AAC5B;AACA;ACZA,+DAAoB;AACpB,uEAAsB;AACtB,4EAAkB;AAOX,IAAM,cAAA,EAAgB,MAAA,CAC3B,IAAA,EACA,QAAA,EAAA,GACkB;AAClB,EAAA,IAAI;AAEF,IAAA,GAAA,CAAI,CAAC,KAAA,GAAQ,IAAA,CAAK,IAAA,CAAK,EAAA,IAAM,EAAA,EAAI;AAC/B,MAAA,OAAA,CAAQ,KAAA,CAAM,eAAA,CAAM,GAAA,CAAI,oCAAoC,CAAC,CAAA;AAC7D,MAAA,OAAA,CAAQ,IAAA,CAAK,CAAC,CAAA;AAAA,IAChB;AAGA,IAAA,0CAAA,CAAY;AAGZ,IAAA,MAAM,uDAAA,CAAyB;AAG/B,IAAA,MAAM,WAAA,EAAkB,IAAA,CAAA,IAAA;AAAA,MACtB,OAAA,CAAQ,GAAA,CAAI,CAAA;AAAA,MACZ,SAAA;AAAA,MACA,CAAA,EAAA;AACF,IAAA;AAEA,IAAA;AACE,MAAA;AAAQ,QAAA;AAER,MAAA;AACA,MAAA;AACF,IAAA;AAGA,IAAA;AACA,IAAA;AACK,MAAA;AACL,IAAA;AAGA,IAAA;AAAuB;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAWpB,IAAA;AAGH,IAAA;AACA,IAAA;AACA,IAAA;AACA,IAAA;AAGA,IAAA;AACA,IAAA;AACE,MAAA;AAAS;AACT,MAAA;AACA,MAAA;AAAc;AAChB,IAAA;AACA,IAAA;AAEA,IAAA;AACA,IAAA;AACE,MAAA;AACF,IAAA;AACA,IAAA;AACA,IAAA;AACF,EAAA;AACE,IAAA;AACE,MAAA;AACA,MAAA;AACF,IAAA;AACA,IAAA;AACF,EAAA;AACF;ADZO;AACA;AACA","file":"/home/runner/work/langwatch/langwatch/typescript-sdk/dist/create-ACGBGFVO.js","sourcesContent":[null,"import * as fs from \"fs\";\nimport * as path from \"path\";\nimport chalk from \"chalk\";\nimport { FileManager } from \"../utils/fileManager\";\nimport { checkApiKey } from \"../utils/apiKey\";\nimport { ensureProjectInitialized } from \"../utils/init\";\n\ntype CreateOptions = Record<string, unknown>;\n\nexport const createCommand = async (\n  name: string,\n  _options: CreateOptions,\n): Promise<void> => {\n  try {\n    // Validate prompt name\n    if (!name || name.trim() === \"\") {\n      console.error(chalk.red(\"Error: Prompt name cannot be empty\"));\n      process.exit(1);\n    }\n\n    // Check API key before doing anything else\n    checkApiKey();\n\n    // Ensure project is initialized\n    await ensureProjectInitialized();\n\n    // Check if file already exists\n    const promptPath = path.join(\n      process.cwd(),\n      \"prompts\",\n      `${name}.prompt.yaml`,\n    );\n\n    if (fs.existsSync(promptPath)) {\n      console.error(\n        chalk.red(`Error: Prompt file already exists at ${promptPath}`),\n      );\n      process.exit(1);\n    }\n\n    // Create prompts directory if it doesn't exist\n    const promptsDir = path.dirname(promptPath);\n    if (!fs.existsSync(promptsDir)) {\n      fs.mkdirSync(promptsDir, { recursive: true });\n    }\n\n    // Default prompt content\n    const defaultContent = `model: openai/gpt-5\nmodelParameters:\n  temperature: 0.7\nmessages:\n  - role: system\n    content: You are a helpful assistant.\n  - role: user\n    content: \"{{input}}\"\n`;\n\n    // Write the file\n    fs.writeFileSync(promptPath, defaultContent, \"utf8\");\n\n    // Add to prompts.json as a file: dependency\n    const promptsConfig = FileManager.loadPromptsConfig();\n    const relativePath = path.relative(process.cwd(), promptPath);\n    promptsConfig.prompts[name] = `file:${relativePath}`;\n    FileManager.savePromptsConfig(promptsConfig);\n\n    // Update lock file\n    const lock = FileManager.loadPromptsLock();\n    lock.prompts[name] = {\n      version: 0, // Local files start at version 0\n      versionId: \"local\",\n      materialized: relativePath, // Store the original file path\n    };\n    FileManager.savePromptsLock(lock);\n\n    const displayPath = `./${relativePath}`;\n    console.log(\n      chalk.green(`✓ Created prompt file: ${chalk.cyan(displayPath)}`),\n    );\n    console.log(chalk.gray(`  Edit this file and then run:`));\n    console.log(chalk.cyan(`  langwatch prompt sync`));\n  } catch (error) {\n    console.error(\n      chalk.red(\"Unexpected error:\"),\n      error instanceof Error ? error.message : error,\n    );\n    process.exit(1);\n  }\n};\n"]}

package/dist/{create-LXQB4EFB.mjs → create-YUOTG2TS.mjs}

@@ -3,10 +3,10 @@ import {
 } from "./chunk-DHJKJVY7.mjs";
 import {
   ensureProjectInitialized
-} from "./chunk-AD7QRYIJ.mjs";
+} from "./chunk-MBXENFRR.mjs";
 import {
   FileManager
-} from "./chunk-PYVDTUA6.mjs";
+} from "./chunk-O6D3W3PG.mjs";
 import "./chunk-BTBSMJTY.mjs";
 import "./chunk-URTD2WOC.mjs";
 
@@ -77,4 +77,4 @@ messages:
 export {
   createCommand
 };
-//# sourceMappingURL=create-LXQB4EFB.mjs.map
+//# sourceMappingURL=create-YUOTG2TS.mjs.map

package/dist/{implementation-DsHp9FYU.d.ts → implementation-TF91Gn0l.d.ts}

@@ -1,9 +1,10 @@
 import { BatchSpanProcessor, SpanExporter, ReadableSpan } from '@opentelemetry/sdk-trace-base';
 import { OTLPTraceExporter } from '@opentelemetry/exporter-trace-otlp-http';
+import { ExportResult } from '@opentelemetry/core';
 import { Logger, LogRecord, LoggerProvider } from '@opentelemetry/api-logs';
 import { a as SemConvLogRecordAttributes, S as SemConvAttributes } from './types-DRiQaKFG.js';
 import { TracerProvider } from '@opentelemetry/api';
-import { a as LangWatchTracer } from './types-B9772cUR.js';
+import { a as LangWatchTracer } from './types-CAQOMGrf.js';
 
 /**
  * Filterable Batch Span Exporter for OpenTelemetry
@@ -66,48 +67,181 @@ declare class FilterableBatchSpanProcessor extends BatchSpanProcessor {
     onEnd(span: ReadableSpan): void;
 }
 
+interface Criteria {
+    instrumentationScopeName?: Match[];
+    name?: Match[];
+}
+interface Match {
+    equals?: string;
+    startsWith?: string;
+    matches?: RegExp;
+    ignoreCase?: boolean;
+}
+type TraceFilter = {
+    preset: "vercelAIOnly" | "excludeHttpRequests";
+} | {
+    include: Criteria;
+} | {
+    exclude: Criteria;
+};
+
+/**
+ * Configuration options for the LangWatchTraceExporter.
+ *
+ * @property endpoint - Custom LangWatch endpoint URL. Falls back to LANGWATCH_ENDPOINT env var or default.
+ * @property apiKey - API key for authentication. Falls back to LANGWATCH_API_KEY env var.
+ * @property filters - Array of filters applied sequentially to spans before export.
+ *                     Default: `[{ preset: "excludeHttpRequests" }]` to reduce framework noise.
+ *                     Pass `null` or `[]` to disable all filtering.
+ */
 interface LangWatchTraceExporterOptions {
     endpoint?: string;
     apiKey?: string;
-    includeAllSpans?: boolean;
-    debug?: boolean;
+    filters?: TraceFilter[] | null;
 }
+
 /**
  * LangWatchTraceExporter extends the OpenTelemetry OTLP HTTP trace exporter
  * to send trace data to LangWatch with proper authentication and metadata headers.
  *
- * This exporter automatically configures:
- * - Authorization headers using the provided API key or environment variables/fallback
- * - SDK version and language identification headers
- * - Proper endpoint configuration for LangWatch ingestion using provided URL or environment variables/fallback
+ * ## Features
+ * - Automatic authorization header configuration via API key
+ * - SDK version and runtime identification headers
+ * - Proper endpoint URL construction for LangWatch ingestion
+ * - Intent-based span filtering with presets and custom criteria
  *
- * @example
+ * ## Filtering Behavior
+ * - **Default**: HTTP request spans are excluded to reduce framework noise
+ * - **Pipeline**: Filters are applied sequentially with AND semantics
+ * - **Matching**: All string comparisons are case-sensitive by default
+ * - **Array Syntax**: All criteria require arrays of Match objects for explicit filtering
+ *
+ * ## Filter Types
+ * - **Presets**: Pre-configured common filters (`vercelAIOnly`, `excludeHttpRequests`)
+ * - **Include**: Keep only spans matching criteria (OR within field, AND across fields)
+ * - **Exclude**: Remove spans matching criteria (OR within field, AND across fields)
+ *
+ * @example Basic usage with default filtering
  * ```typescript
  * import { LangWatchTraceExporter } from '@langwatch/observability';
  *
- * // Using environment variables/fallback configuration
+ * // Default: excludes HTTP request spans
  * const exporter = new LangWatchTraceExporter();
+ * ```
+ *
+ * @example Using presets
+ * ```typescript
+ * // Keep only Vercel AI SDK spans
+ * const exporterAI = new LangWatchTraceExporter({
+ *   filters: [{ preset: 'vercelAIOnly' }],
+ * });
+ *
+ * // Explicitly exclude HTTP requests (same as default)
+ * const exporterNoHttp = new LangWatchTraceExporter({
+ *   filters: [{ preset: 'excludeHttpRequests' }],
+ * });
+ *
+ * // No filtering at all (send all spans)
+ * const exporterAll = new LangWatchTraceExporter({
+ *   filters: null, // or filters: []
+ * });
+ * ```
+ *
+ * @example Custom filtering with criteria
+ * ```typescript
+ * // Include only spans with specific scope
+ * const exporter1 = new LangWatchTraceExporter({
+ *   filters: [
+ *     { include: { instrumentationScopeName: [{ equals: 'ai' }] } }
+ *   ],
+ * });
+ *
+ * // Exclude spans by name pattern
+ * const exporter2 = new LangWatchTraceExporter({
+ *   filters: [
+ *     { exclude: { name: [{ startsWith: 'internal.' }] } }
+ *   ],
+ * });
+ *
+ * // Case-insensitive matching
+ * const exporter3 = new LangWatchTraceExporter({
+ *   filters: [
+ *     { include: { name: [{ equals: 'chat.completion', ignoreCase: true }] } }
+ *   ],
+ * });
+ * ```
+ *
+ * @example Filter pipelines (AND semantics)
+ * ```typescript
+ * // Keep AI spans, then remove HTTP requests
+ * const exporter = new LangWatchTraceExporter({
+ *   filters: [
+ *     { include: { instrumentationScopeName: [{ equals: 'ai' }] } },
+ *     { preset: 'excludeHttpRequests' },
+ *   ],
+ * });
+ * ```
+ *
+ * @example OR semantics within a field
+ * ```typescript
+ * // Include spans with name starting with 'chat.' OR 'llm.'
+ * const exporter = new LangWatchTraceExporter({
+ *   filters: [
+ *     {
+ *       include: {
+ *         name: [
+ *           { startsWith: 'chat.' },
+ *           { startsWith: 'llm.' }
+ *         ]
+ *       }
+ *     }
+ *   ],
+ * });
+ * ```
  *
- * // Using custom options
+ * @example Using regex patterns
+ * ```typescript
  * const exporter = new LangWatchTraceExporter({
- *   apiKey: 'your-api-key',
- *   endpoint: 'https://custom.langwatch.com'
+ *   filters: [
+ *     {
+ *       include: {
+ *         name: [{ matches: /^(chat|llm)\./i }]
+ *       }
+ *     }
+ *   ],
  * });
  * ```
  */
 declare class LangWatchTraceExporter extends OTLPTraceExporter {
+    private readonly filters;
     /**
-     * Creates a new LangWatchExporter instance.
+     * Creates a new LangWatchTraceExporter instance.
+     *
+     * @param opts - Configuration options for the exporter
+     * @param opts.apiKey - API key for LangWatch authentication.
+     *                     Falls back to `LANGWATCH_API_KEY` environment variable, then empty string.
+     * @param opts.endpoint - Custom endpoint URL for LangWatch ingestion.
+     *                       Falls back to `LANGWATCH_ENDPOINT` environment variable, then default endpoint.
+     * @param opts.filters - Array of filters applied sequentially to spans before export (AND semantics).
+     *                      When omitted, defaults to `[{ preset: "excludeHttpRequests" }]`.
+     *                      Pass `null` or `[]` to disable all filtering and send all spans.
+     *
+     * @example
+     * ```typescript
+     * // With API key and default filtering
+     * const exporter = new LangWatchTraceExporter({
+     *   apiKey: 'your-api-key'
+     * });
      *
-     * @param opts - Optional configuration options for the exporter
-     * @param opts.apiKey - Optional API key for LangWatch authentication. If not provided,
-     *                     will use environment variables or fallback configuration.
-     * @param opts.endpoint - Optional custom endpoint URL for LangWatch ingestion.
-     *                       If not provided, will use environment variables or fallback configuration.
-     * @param opts.includeAllSpans - Deprecated: This option is deprecated and will be removed in a future version
-     * @param opts.debug - Deprecated: This option is deprecated and will be removed in a future version
+     * // With custom endpoint and no filtering
+     * const exporter = new LangWatchTraceExporter({
+     *   endpoint: 'https://custom.langwatch.ai',
+     *   filters: null
+     * });
+     * ```
      */
     constructor(opts?: LangWatchTraceExporterOptions);
+    export(spans: ReadableSpan[], resultCallback: (result: ExportResult) => void): void;
 }
 
 /**

package/dist/{implementation-nE9dgTwc.d.mts → implementation-pq0g2B5y.d.mts}

@@ -1,9 +1,10 @@
 import { BatchSpanProcessor, SpanExporter, ReadableSpan } from '@opentelemetry/sdk-trace-base';
 import { OTLPTraceExporter } from '@opentelemetry/exporter-trace-otlp-http';
+import { ExportResult } from '@opentelemetry/core';
 import { Logger, LogRecord, LoggerProvider } from '@opentelemetry/api-logs';
 import { a as SemConvLogRecordAttributes, S as SemConvAttributes } from './types-DRiQaKFG.mjs';
 import { TracerProvider } from '@opentelemetry/api';
-import { a as LangWatchTracer } from './types-DbPAi4US.mjs';
+import { a as LangWatchTracer } from './types-DhEYjnRD.mjs';
 
 /**
  * Filterable Batch Span Exporter for OpenTelemetry
@@ -66,48 +67,181 @@ declare class FilterableBatchSpanProcessor extends BatchSpanProcessor {
     onEnd(span: ReadableSpan): void;
 }
 
+interface Criteria {
+    instrumentationScopeName?: Match[];
+    name?: Match[];
+}
+interface Match {
+    equals?: string;
+    startsWith?: string;
+    matches?: RegExp;
+    ignoreCase?: boolean;
+}
+type TraceFilter = {
+    preset: "vercelAIOnly" | "excludeHttpRequests";
+} | {
+    include: Criteria;
+} | {
+    exclude: Criteria;
+};
+
+/**
+ * Configuration options for the LangWatchTraceExporter.
+ *
+ * @property endpoint - Custom LangWatch endpoint URL. Falls back to LANGWATCH_ENDPOINT env var or default.
+ * @property apiKey - API key for authentication. Falls back to LANGWATCH_API_KEY env var.
+ * @property filters - Array of filters applied sequentially to spans before export.
+ *                     Default: `[{ preset: "excludeHttpRequests" }]` to reduce framework noise.
+ *                     Pass `null` or `[]` to disable all filtering.
+ */
 interface LangWatchTraceExporterOptions {
     endpoint?: string;
     apiKey?: string;
-    includeAllSpans?: boolean;
-    debug?: boolean;
+    filters?: TraceFilter[] | null;
 }
+
 /**
  * LangWatchTraceExporter extends the OpenTelemetry OTLP HTTP trace exporter
  * to send trace data to LangWatch with proper authentication and metadata headers.
  *
- * This exporter automatically configures:
- * - Authorization headers using the provided API key or environment variables/fallback
- * - SDK version and language identification headers
- * - Proper endpoint configuration for LangWatch ingestion using provided URL or environment variables/fallback
+ * ## Features
+ * - Automatic authorization header configuration via API key
+ * - SDK version and runtime identification headers
+ * - Proper endpoint URL construction for LangWatch ingestion
+ * - Intent-based span filtering with presets and custom criteria
  *
- * @example
+ * ## Filtering Behavior
+ * - **Default**: HTTP request spans are excluded to reduce framework noise
+ * - **Pipeline**: Filters are applied sequentially with AND semantics
+ * - **Matching**: All string comparisons are case-sensitive by default
+ * - **Array Syntax**: All criteria require arrays of Match objects for explicit filtering
+ *
+ * ## Filter Types
+ * - **Presets**: Pre-configured common filters (`vercelAIOnly`, `excludeHttpRequests`)
+ * - **Include**: Keep only spans matching criteria (OR within field, AND across fields)
+ * - **Exclude**: Remove spans matching criteria (OR within field, AND across fields)
+ *
+ * @example Basic usage with default filtering
  * ```typescript
  * import { LangWatchTraceExporter } from '@langwatch/observability';
  *
- * // Using environment variables/fallback configuration
+ * // Default: excludes HTTP request spans
  * const exporter = new LangWatchTraceExporter();
+ * ```
+ *
+ * @example Using presets
+ * ```typescript
+ * // Keep only Vercel AI SDK spans
+ * const exporterAI = new LangWatchTraceExporter({
+ *   filters: [{ preset: 'vercelAIOnly' }],
+ * });
+ *
+ * // Explicitly exclude HTTP requests (same as default)
+ * const exporterNoHttp = new LangWatchTraceExporter({
+ *   filters: [{ preset: 'excludeHttpRequests' }],
+ * });
+ *
+ * // No filtering at all (send all spans)
+ * const exporterAll = new LangWatchTraceExporter({
+ *   filters: null, // or filters: []
+ * });
+ * ```
+ *
+ * @example Custom filtering with criteria
+ * ```typescript
+ * // Include only spans with specific scope
+ * const exporter1 = new LangWatchTraceExporter({
+ *   filters: [
+ *     { include: { instrumentationScopeName: [{ equals: 'ai' }] } }
+ *   ],
+ * });
+ *
+ * // Exclude spans by name pattern
+ * const exporter2 = new LangWatchTraceExporter({
+ *   filters: [
+ *     { exclude: { name: [{ startsWith: 'internal.' }] } }
+ *   ],
+ * });
+ *
+ * // Case-insensitive matching
+ * const exporter3 = new LangWatchTraceExporter({
+ *   filters: [
+ *     { include: { name: [{ equals: 'chat.completion', ignoreCase: true }] } }
+ *   ],
+ * });
+ * ```
+ *
+ * @example Filter pipelines (AND semantics)
+ * ```typescript
+ * // Keep AI spans, then remove HTTP requests
+ * const exporter = new LangWatchTraceExporter({
+ *   filters: [
+ *     { include: { instrumentationScopeName: [{ equals: 'ai' }] } },
+ *     { preset: 'excludeHttpRequests' },
+ *   ],
+ * });
+ * ```
+ *
+ * @example OR semantics within a field
+ * ```typescript
+ * // Include spans with name starting with 'chat.' OR 'llm.'
+ * const exporter = new LangWatchTraceExporter({
+ *   filters: [
+ *     {
+ *       include: {
+ *         name: [
+ *           { startsWith: 'chat.' },
+ *           { startsWith: 'llm.' }
+ *         ]
+ *       }
+ *     }
+ *   ],
+ * });
+ * ```
  *
- * // Using custom options
+ * @example Using regex patterns
+ * ```typescript
  * const exporter = new LangWatchTraceExporter({
- *   apiKey: 'your-api-key',
- *   endpoint: 'https://custom.langwatch.com'
+ *   filters: [
+ *     {
+ *       include: {
+ *         name: [{ matches: /^(chat|llm)\./i }]
+ *       }
+ *     }
+ *   ],
  * });
  * ```
  */
 declare class LangWatchTraceExporter extends OTLPTraceExporter {
+    private readonly filters;
     /**
-     * Creates a new LangWatchExporter instance.
+     * Creates a new LangWatchTraceExporter instance.
+     *
+     * @param opts - Configuration options for the exporter
+     * @param opts.apiKey - API key for LangWatch authentication.
+     *                     Falls back to `LANGWATCH_API_KEY` environment variable, then empty string.
+     * @param opts.endpoint - Custom endpoint URL for LangWatch ingestion.
+     *                       Falls back to `LANGWATCH_ENDPOINT` environment variable, then default endpoint.
+     * @param opts.filters - Array of filters applied sequentially to spans before export (AND semantics).
+     *                      When omitted, defaults to `[{ preset: "excludeHttpRequests" }]`.
+     *                      Pass `null` or `[]` to disable all filtering and send all spans.
+     *
+     * @example
+     * ```typescript
+     * // With API key and default filtering
+     * const exporter = new LangWatchTraceExporter({
+     *   apiKey: 'your-api-key'
+     * });
      *
-     * @param opts - Optional configuration options for the exporter
-     * @param opts.apiKey - Optional API key for LangWatch authentication. If not provided,
-     *                     will use environment variables or fallback configuration.
-     * @param opts.endpoint - Optional custom endpoint URL for LangWatch ingestion.
-     *                       If not provided, will use environment variables or fallback configuration.
-     * @param opts.includeAllSpans - Deprecated: This option is deprecated and will be removed in a future version
-     * @param opts.debug - Deprecated: This option is deprecated and will be removed in a future version
+     * // With custom endpoint and no filtering
+     * const exporter = new LangWatchTraceExporter({
+     *   endpoint: 'https://custom.langwatch.ai',
+     *   filters: null
+     * });
+     * ```
      */
     constructor(opts?: LangWatchTraceExporterOptions);
+    export(spans: ReadableSpan[], resultCallback: (result: ExportResult) => void): void;
 }
 
 /**

package/dist/index.d.mts

@@ -1,11 +1,12 @@
 import { L as Logger, C as ConsoleLogger, N as NoOpLogger } from './index-D7rKIGrO.mjs';
-export { F as FilterableBatchSpanProcessor, L as LangWatchExporter, S as SpanProcessingExcludeRule, g as getLangWatchLogger, d as getLangWatchTracer } from './implementation-nE9dgTwc.mjs';
+export { F as FilterableBatchSpanProcessor, L as LangWatchExporter, S as SpanProcessingExcludeRule, g as getLangWatchLogger, d as getLangWatchTracer } from './implementation-pq0g2B5y.mjs';
 export { l as attributes } from './types-DRiQaKFG.mjs';
-import { p as paths, P as PromptResponse, g as CreatePromptBody, U as UpdatePromptBody, h as PromptData, i as Prompt } from './types-DbPAi4US.mjs';
+import { p as paths, P as PromptResponse, g as CreatePromptBody, U as UpdatePromptBody, h as PromptData, i as Prompt } from './types-DhEYjnRD.mjs';
 import openApiCreateClient from 'openapi-fetch';
 import { z } from 'zod';
 import '@opentelemetry/sdk-trace-base';
 import '@opentelemetry/exporter-trace-otlp-http';
+import '@opentelemetry/core';
 import '@opentelemetry/api-logs';
 import '@opentelemetry/api';
 import '@opentelemetry/semantic-conventions';
@@ -197,6 +198,8 @@ declare class FileManager {
     private static readonly PROMPTS_LOCK_FILE;
     private static readonly PROMPTS_DIR;
     private static readonly MATERIALIZED_DIR;
+    private static _projectRoot;
+    private static findProjectRoot;
     static getPromptsConfigPath(): string;
     static getPromptsLockPath(): string;
     static getPromptsDir(): string;

package/dist/index.d.ts

@@ -1,11 +1,12 @@
 import { L as Logger, C as ConsoleLogger, N as NoOpLogger } from './index-D7rKIGrO.js';
-export { F as FilterableBatchSpanProcessor, L as LangWatchExporter, S as SpanProcessingExcludeRule, g as getLangWatchLogger, d as getLangWatchTracer } from './implementation-DsHp9FYU.js';
+export { F as FilterableBatchSpanProcessor, L as LangWatchExporter, S as SpanProcessingExcludeRule, g as getLangWatchLogger, d as getLangWatchTracer } from './implementation-TF91Gn0l.js';
 export { l as attributes } from './types-DRiQaKFG.js';
-import { p as paths, P as PromptResponse, g as CreatePromptBody, U as UpdatePromptBody, h as PromptData, i as Prompt } from './types-B9772cUR.js';
+import { p as paths, P as PromptResponse, g as CreatePromptBody, U as UpdatePromptBody, h as PromptData, i as Prompt } from './types-CAQOMGrf.js';
 import openApiCreateClient from 'openapi-fetch';
 import { z } from 'zod';
 import '@opentelemetry/sdk-trace-base';
 import '@opentelemetry/exporter-trace-otlp-http';
+import '@opentelemetry/core';
 import '@opentelemetry/api-logs';
 import '@opentelemetry/api';
 import '@opentelemetry/semantic-conventions';
@@ -197,6 +198,8 @@ declare class FileManager {
     private static readonly PROMPTS_LOCK_FILE;
     private static readonly PROMPTS_DIR;
     private static readonly MATERIALIZED_DIR;
+    private static _projectRoot;
+    private static findProjectRoot;
     static getPromptsConfigPath(): string;
     static getPromptsLockPath(): string;
     static getPromptsDir(): string;

package/dist/index.js

@@ -4,28 +4,28 @@
 
 
 
-var _chunkD7UAKYVIjs = require('./chunk-D7UAKYVI.js');
+var _chunkXHNJY5BPjs = require('./chunk-XHNJY5BP.js');
 
 
 var _chunkSNDTNU3Tjs = require('./chunk-SNDTNU3T.js');
 
 
-var _chunkVMZUN4EFjs = require('./chunk-VMZUN4EF.js');
+var _chunkBP2WGNIVjs = require('./chunk-BP2WGNIV.js');
 
 
 
-var _chunkJ55AV2YWjs = require('./chunk-J55AV2YW.js');
+var _chunkVWZCWYRHjs = require('./chunk-VWZCWYRH.js');
 
 
 
 
-var _chunk5HAVK64Qjs = require('./chunk-5HAVK64Q.js');
+var _chunkB5K6DU6Gjs = require('./chunk-B5K6DU6G.js');
 
 
 
 
 var _chunkCKIZDPIJjs = require('./chunk-CKIZDPIJ.js');
-require('./chunk-36XAYVMC.js');
+require('./chunk-WAAQLJ67.js');
 require('./chunk-AZHZ4NB4.js');
 
 
@@ -46,13 +46,13 @@ var TracesError = class extends Error {
 };
 
 // src/client-sdk/services/traces/tracing/tracer.ts
-var tracer = _chunkVMZUN4EFjs.getLangWatchTracer.call(void 0, `${_chunk5HAVK64Qjs.LANGWATCH_SDK_NAME_CLIENT}.traces`, _chunk5HAVK64Qjs.LANGWATCH_SDK_VERSION);
+var tracer = _chunkBP2WGNIVjs.getLangWatchTracer.call(void 0, `${_chunkB5K6DU6Gjs.LANGWATCH_SDK_NAME_CLIENT}.traces`, _chunkB5K6DU6Gjs.LANGWATCH_SDK_VERSION);
 
 // src/client-sdk/services/traces/service.ts
 var TracesService = class {
   constructor(config) {
     this.config = config;
-    return _chunkD7UAKYVIjs.createTracingProxy.call(void 0, 
+    return _chunkXHNJY5BPjs.createTracingProxy.call(void 0, 
       this,
       tracer
     );
@@ -115,15 +115,15 @@ var LangWatch = class {
     _chunkOHM7JUMRjs.__privateAdd.call(void 0, this, _LangWatch_instances);
     var _a, _b, _c, _d;
     const apiKey = (_b = (_a = options.apiKey) != null ? _a : process.env.LANGWATCH_API_KEY) != null ? _b : "";
-    const endpoint = (_d = (_c = options.endpoint) != null ? _c : process.env.LANGWATCH_ENDPOINT) != null ? _d : _chunk5HAVK64Qjs.DEFAULT_ENDPOINT;
+    const endpoint = (_d = (_c = options.endpoint) != null ? _c : process.env.LANGWATCH_ENDPOINT) != null ? _d : _chunkB5K6DU6Gjs.DEFAULT_ENDPOINT;
     this.config = _chunkOHM7JUMRjs.__privateMethod.call(void 0, this, _LangWatch_instances, createInternalConfig_fn).call(this, {
       apiKey,
       endpoint,
       options: options.options
     });
-    this.prompts = new (0, _chunkD7UAKYVIjs.PromptsFacade)(_chunkOHM7JUMRjs.__spreadValues.call(void 0, {
-      promptsApiService: new (0, _chunkD7UAKYVIjs.PromptsApiService)(this.config),
-      localPromptsService: new (0, _chunkD7UAKYVIjs.LocalPromptsService)()
+    this.prompts = new (0, _chunkXHNJY5BPjs.PromptsFacade)(_chunkOHM7JUMRjs.__spreadValues.call(void 0, {
+      promptsApiService: new (0, _chunkXHNJY5BPjs.PromptsApiService)(this.config),
+      localPromptsService: new (0, _chunkXHNJY5BPjs.LocalPromptsService)()
     }, this.config));
     this.traces = new TracesFacade(this.config);
   }
@@ -140,7 +140,7 @@ createInternalConfig_fn = function({
   var _a;
   return {
     logger: (_a = options == null ? void 0 : options.logger) != null ? _a : new (0, _chunkCKIZDPIJjs.NoOpLogger)(),
-    langwatchApiClient: _chunkD7UAKYVIjs.createLangWatchApiClient.call(void 0, apiKey, endpoint)
+    langwatchApiClient: _chunkXHNJY5BPjs.createLangWatchApiClient.call(void 0, apiKey, endpoint)
   };
 };
 
@@ -157,5 +157,5 @@ var logger = {
 
 
 
-exports.FilterableBatchSpanProcessor = _chunkSNDTNU3Tjs.FilterableBatchSpanProcessor; exports.LangWatch = LangWatch; exports.LangWatchExporter = _chunkJ55AV2YWjs.LangWatchTraceExporter; exports.attributes = _chunkCKIZDPIJjs.attributes_exports; exports.getLangWatchLogger = _chunkJ55AV2YWjs.getLangWatchLogger; exports.getLangWatchTracer = _chunkVMZUN4EFjs.getLangWatchTracer; exports.logger = logger;
+exports.FilterableBatchSpanProcessor = _chunkSNDTNU3Tjs.FilterableBatchSpanProcessor; exports.LangWatch = LangWatch; exports.LangWatchExporter = _chunkVWZCWYRHjs.LangWatchTraceExporter; exports.attributes = _chunkCKIZDPIJjs.attributes_exports; exports.getLangWatchLogger = _chunkVWZCWYRHjs.getLangWatchLogger; exports.getLangWatchTracer = _chunkBP2WGNIVjs.getLangWatchTracer; exports.logger = logger;
 //# sourceMappingURL=index.js.map