langwatch 0.31.0 → 0.33.0

package/dist/chunk-3E6W6KZ7.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["/home/runner/work/langwatch/langwatch/typescript-sdk/dist/chunk-3E6W6KZ7.js","../src/cli/utils/governance/login-flow.ts","../src/cli/utils/governance/login-ceremony.ts"],"names":[],"mappings":"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","file":"/home/runner/work/langwatch/langwatch/typescript-sdk/dist/chunk-3E6W6KZ7.js","sourcesContent":[null,"/**\n * Shared device-code login implementations. Two entry points:\n *\n *   1. `runUnifiedLoginFlow({ kind })` — the canonical flow used by\n *      `langwatch login` (interactive routes here for both modes). The\n *      same browser-approval ceremony works for either credential type;\n *      only the persist target differs:\n *        kind: 'device_session' → ~/.langwatch/config.json\n *        kind: 'project_api_key' → $CWD/.env (LANGWATCH_API_KEY)\n *      No copy-paste of the credential ever — the server ships it\n *      back to the CLI over the same RFC 8628 poll endpoint.\n *\n *   2. `runDeviceFlowLogin(...)` — back-compat wrapper that calls\n *      `runUnifiedLoginFlow({ kind: 'device_session' })`. Preserved so\n *      `commands/login.ts --device` and `utils/governance/wrapper.ts`\n *      auto-login keep working without churn.\n *\n * Spec: specs/ai-governance/cli-onboarding/login-unified.feature\n */\n\nimport * as fs from \"node:fs\";\nimport * as path from \"node:path\";\nimport chalk from \"chalk\";\nimport ora from \"ora\";\nimport {\n  startDeviceCode,\n  pollUntilDone,\n  DeviceFlowError,\n  type CredentialType,\n  type ExchangeApiKeyResult,\n  type ExchangeDeviceSessionResult,\n} from \"./device-flow\";\nimport { loadConfig, saveConfig, type GovernanceConfig } from \"./config\";\nimport { formatLoginCeremony } from \"./login-ceremony\";\nimport { getCliBootstrap, type CliBootstrapResponse } from \"./cli-api\";\n\nexport interface RunUnifiedLoginOptions {\n  /** Credential type to mint. Defaults to 'device_session' for back-compat. */\n  kind?: CredentialType;\n  /** Optional browser override (LANGWATCH_BROWSER also honoured). */\n  browser?: string;\n  /** Pre-loaded config to mutate; defaults to `loadConfig()`. */\n  cfg?: GovernanceConfig;\n}\n\nexport type RunDeviceFlowLoginOptions = Omit<RunUnifiedLoginOptions, \"kind\">;\n\n/**\n * Run the canonical device-code login flow end-to-end. Selects what to\n * mint via `kind` (defaults to device_session); the same browser\n * approval ceremony covers both modes. On success, persists to the\n * right store + returns the latest GovernanceConfig.\n */\nexport async function runUnifiedLoginFlow(\n  opts: RunUnifiedLoginOptions = {},\n): Promise<GovernanceConfig> {\n  const kind: CredentialType = opts.kind ?? \"device_session\";\n  const cfg = opts.cfg ?? loadConfig();\n  const baseUrl = cfg.control_plane_url;\n\n  console.log(chalk.blue(\"🔐 LangWatch login\"));\n  console.log(chalk.gray(`Control plane: ${baseUrl}`));\n  console.log(\n    chalk.gray(\n      kind === \"project_api_key\"\n        ? \"Mode: project SDK API key (will write .env)\"\n        : \"Mode: device session (will write ~/.langwatch/config.json)\",\n    ),\n  );\n\n  const dc = await startDeviceCode({ baseUrl }, { credentialType: kind });\n  const verifyURL =\n    dc.verification_uri_complete ??\n    `${dc.verification_uri.replace(/\\/+$/, \"\")}?user_code=${encodeURIComponent(dc.user_code)}`;\n\n  console.log();\n  console.log(chalk.cyan(`Opening: ${verifyURL}`));\n  console.log(\n    chalk.gray(\n      `If your browser doesn't open, paste the URL above and enter code: ${chalk.bold(dc.user_code)}`,\n    ),\n  );\n  console.log();\n\n  await openInBrowser(verifyURL, opts.browser);\n\n  // discardStdin:false is load-bearing. ora's default (true) flips stdin to\n  // raw mode while the spinner runs, so Ctrl+C arrives as a raw 0x03 byte that\n  // ora swallows instead of a SIGINT — the wait becomes unkillable. Keeping\n  // stdin cooked lets the terminal deliver SIGINT; the handler stops the\n  // spinner and exits cleanly so the user can always abort the login wait.\n  const spinner = ora({\n    text: \"Waiting for you to approve in the browser\",\n    discardStdin: false,\n  }).start();\n  const onSigint = () => {\n    spinner.stop();\n    console.log(chalk.gray(\"\\nLogin cancelled.\"));\n    process.exit(130);\n  };\n  process.once(\"SIGINT\", onSigint);\n  try {\n    const result = await pollUntilDone({ baseUrl }, dc);\n    if (result.kind === \"device_session\") {\n      spinner.succeed(`Logged in as ${result.user.email}`);\n      persistDeviceSession(cfg, result);\n      saveConfig(cfg);\n\n      const bootstrap = await fetchBootstrapSafely(cfg);\n\n      // Pick up the server's authoritative gateway URL. Without this,\n      // self-hosted CLI users would see the SaaS default\n      // (https://gateway.langwatch.ai) on whoami / login output even\n      // though the actual gateway is on localhost:5563. The server's\n      // `gatewayUrl` reflects `LW_GATEWAY_BASE_URL` or the IS_SAAS-\n      // aware fallback. Backwards-compatible: older servers (without\n      // this field) leave the local default in place.\n      if (bootstrap?.gatewayUrl) {\n        cfg.gateway_url = bootstrap.gatewayUrl;\n        saveConfig(cfg);\n      }\n\n      // Cache the org's per-tool path policy so the `langwatch <tool>`\n      // wrapper gates path selection on the admin's choices offline.\n      // Older servers omit the field; the wrapper then falls back to\n      // the hardcoded defaults.\n      if (bootstrap?.toolPolicies) {\n        cfg.tool_policies = bootstrap.toolPolicies;\n        saveConfig(cfg);\n      }\n\n      console.log();\n      const ceremonyLines = formatLoginCeremony({\n        email: cfg.user?.email ?? result.user.email,\n        organizationName: cfg.organization?.name,\n        tools: bootstrap?.tools,\n        providers: bootstrap?.providers,\n        budget:\n          bootstrap?.budget?.monthlyLimitUsd != null\n            ? {\n                period: bootstrap.budget.period,\n                limitUsd: bootstrap.budget.monthlyLimitUsd,\n                usedUsd: bootstrap.budget.monthlyUsedUsd,\n              }\n            : undefined,\n      });\n      for (const line of ceremonyLines) {\n        console.log(line);\n      }\n      console.log();\n      console.log(chalk.gray(`  Dashboard: ${cfg.control_plane_url}`));\n\n      return cfg;\n    }\n\n    // kind === 'api_key' — write to project-local .env (NO copy-paste)\n    spinner.succeed(\n      `API key generated for project ${chalk.bold(result.project.name)}`,\n    );\n    const envResult = writeApiKeyToEnv(result.api_key);\n    console.log();\n    console.log(chalk.green(\"✓ API key saved to .env\"));\n    if (envResult.created) {\n      console.log(chalk.gray(`  • Created .env file at ${envResult.path}`));\n    } else if (envResult.updated) {\n      console.log(chalk.gray(`  • Updated existing API key in ${envResult.path}`));\n    } else {\n      console.log(chalk.gray(`  • Added API key to ${envResult.path}`));\n    }\n    console.log();\n    console.log(\n      chalk.gray(\n        `  Project: ${result.project.name} (${result.project.slug})`,\n      ),\n    );\n    console.log(chalk.gray(`  Dashboard: ${cfg.control_plane_url}`));\n    return cfg;\n  } catch (err) {\n    spinner.fail();\n    if (err instanceof DeviceFlowError) {\n      switch (err.kind) {\n        case \"denied\":\n          throw new Error(\n            \"authorization denied — you can retry `langwatch login`\",\n          );\n        case \"expired\":\n          throw new Error(\n            \"authorization request expired — run `langwatch login` again\",\n          );\n        default:\n          throw err;\n      }\n    }\n    throw err;\n  } finally {\n    process.removeListener(\"SIGINT\", onSigint);\n  }\n}\n\n/**\n * Back-compat wrapper. New callers should use `runUnifiedLoginFlow`\n * directly with an explicit `kind`.\n */\nexport async function runDeviceFlowLogin(\n  opts: RunDeviceFlowLoginOptions = {},\n): Promise<GovernanceConfig> {\n  return runUnifiedLoginFlow({ ...opts, kind: \"device_session\" });\n}\n\nfunction persistDeviceSession(\n  cfg: GovernanceConfig,\n  result: ExchangeDeviceSessionResult,\n): void {\n  cfg.access_token = result.access_token;\n  cfg.refresh_token = result.refresh_token;\n  cfg.expires_at = Math.floor(Date.now() / 1000) + result.expires_in;\n  cfg.user = {\n    id: result.user.id,\n    email: result.user.email,\n    name: result.user.name,\n  };\n  cfg.organization = {\n    id: result.organization.id,\n    slug: result.organization.slug,\n    name: result.organization.name,\n  };\n  if (result.default_personal_vk) {\n    cfg.default_personal_vk = {\n      id: result.default_personal_vk.id,\n      secret: result.default_personal_vk.secret,\n      prefix: result.default_personal_vk.prefix,\n    };\n  }\n  if (result.endpoint) {\n    cfg.control_plane_url = result.endpoint.replace(/\\/+$/, \"\");\n  }\n}\n\ninterface EnvWriteResult {\n  created: boolean;\n  updated: boolean;\n  path: string;\n}\n\nfunction writeApiKeyToEnv(apiKey: string): EnvWriteResult {\n  const envPath = path.join(process.cwd(), \".env\");\n  if (!fs.existsSync(envPath)) {\n    fs.writeFileSync(envPath, `LANGWATCH_API_KEY=${apiKey}\\n`);\n    return { created: true, updated: false, path: envPath };\n  }\n  const content = fs.readFileSync(envPath, \"utf-8\");\n  const lines = content.split(\"\\n\");\n  let found = false;\n  const updatedLines = lines.map((line) => {\n    if (line.startsWith(\"LANGWATCH_API_KEY=\")) {\n      found = true;\n      return `LANGWATCH_API_KEY=${apiKey}`;\n    }\n    return line;\n  });\n  if (!found) {\n    if (content.endsWith(\"\\n\") || content === \"\") {\n      updatedLines.push(`LANGWATCH_API_KEY=${apiKey}`);\n    } else {\n      updatedLines.push(\"\", `LANGWATCH_API_KEY=${apiKey}`);\n    }\n  }\n  fs.writeFileSync(envPath, updatedLines.join(\"\\n\"));\n  return { created: false, updated: found, path: envPath };\n}\n\nasync function fetchBootstrapSafely(\n  cfg: GovernanceConfig,\n): Promise<CliBootstrapResponse | null> {\n  try {\n    return await getCliBootstrap(cfg);\n  } catch {\n    return null;\n  }\n}\n\nasync function openInBrowser(url: string, override?: string): Promise<void> {\n  const choice =\n    override ?? process.env.LANGWATCH_BROWSER ?? process.env.BROWSER ?? \"\";\n  if (choice === \"none\") return;\n  const open = (await import(\"open\")).default;\n  try {\n    if (!choice || choice === \"default\") {\n      await open(url);\n      return;\n    }\n    await open(url, { app: { name: choice } });\n  } catch {\n    // browser failure shouldn't break login — user can paste manually\n  }\n}\n\n// The post-login shell-rc persist offer was removed when `langwatch\n// login` became auth-only: the device session in config.json is\n// already authoritative, so login never edits the shell rc. The\n// persist offer now lives in the `langwatch <tool>` wrapper and fires\n// only in ingestion mode (maybeOfferIngestionShellRcPersist in\n// shell-rc.ts), framed as installing telemetry.\n\n// Type-only re-exports so callers can import the shapes from this\n// module without reaching into device-flow.ts.\nexport type { ExchangeApiKeyResult, ExchangeDeviceSessionResult };\n","/**\n * Render the \"You're in!\" ceremony emitted by `langwatch login` after a\n * successful device-flow exchange.\n *\n * Two clearly-separated lists, sourced from the org's AI Tools catalog:\n *\n *   ✓ Logged in as jane@acme.com @ Acme\n *\n *   Your AI tools (run any of these):\n *     $ langwatch claude   # Claude Code\n *     $ langwatch codex    # Codex\n *\n *   Model providers you can issue a virtual key for:\n *     • anthropic   Claude\n *     • openai      (not configured yet)\n *\n *   Monthly budget: $500   |   Used: $0.00\n *\n *   Or open the app in your browser:\n *     $ langwatch open\n *\n * The two sections answer two different questions: which coding assistants\n * can I run right now (`tools`), and which model providers can I mint my own\n * virtual key for (`providers`). They are NOT the same thing — conflating\n * them was the bug this rewrite fixes.\n *\n * Pure function: takes the data, returns an array of lines. Caller applies\n * any chalk colouring + writes to stdout. Lets unit tests assert on the\n * literal output without colour/escape noise.\n */\n\nexport interface LoginCeremonyTool {\n  /** CLI slug the wrapper runs (e.g. \"claude\", \"codex\"). */\n  slug: string;\n  /** Human-readable assistant name (e.g. \"Claude Code\"). */\n  displayName: string;\n}\n\nexport interface LoginCeremonyProvider {\n  /** Provider key (lowercase, e.g. \"anthropic\", \"openai\", \"gemini\"). */\n  name: string;\n  /** Optional human-readable provider label (e.g. \"Anthropic\"). */\n  displayName?: string;\n  /**\n   * Whether the org has a live credential for this provider. When false the\n   * ceremony annotates the row so the user knows the tile still needs setup\n   * before a minted key will work.\n   */\n  configured?: boolean;\n}\n\nexport interface LoginCeremonyBudget {\n  /** Period label (e.g. \"Monthly\"). Capitalised in output. */\n  period: string;\n  /** Spend ceiling in USD (rendered as `$N`). */\n  limitUsd: number;\n  /** Used so far in USD (rendered with two decimals). */\n  usedUsd: number;\n}\n\nexport interface LoginCeremonyInput {\n  email: string;\n  organizationName?: string;\n  /**\n   * Coding assistants the user can run via `langwatch <slug>`, sourced from\n   * the org's catalog. When empty / omitted the ceremony falls back to the\n   * built-in default wrappers so a fresh org still gets a next-step.\n   */\n  tools?: LoginCeremonyTool[];\n  /** Model providers the user can mint their own virtual key for. */\n  providers?: LoginCeremonyProvider[];\n  budget?: LoginCeremonyBudget;\n  /** Whether the `langwatch open` browser-launch command is available. */\n  openCommand?: boolean;\n}\n\n/** Fallback wrappers when the org has not published any coding-assistant tile. */\nconst DEFAULT_TOOLS: LoginCeremonyTool[] = [\n  { slug: \"claude\", displayName: \"Claude Code\" },\n  { slug: \"codex\", displayName: \"Codex\" },\n  { slug: \"cursor\", displayName: \"Cursor\" },\n];\n\nfunction padRight(s: string, width: number): string {\n  if (s.length >= width) return s;\n  return s + \" \".repeat(width - s.length);\n}\n\nfunction formatUsd(n: number): string {\n  // $500 (whole) → \"$500\"; $42.18 → \"$42.18\".\n  if (Number.isInteger(n)) return `$${n}`;\n  return `$${n.toFixed(2)}`;\n}\n\nfunction formatUsedUsd(n: number): string {\n  return `$${n.toFixed(2)}`;\n}\n\nexport function formatLoginCeremony(input: LoginCeremonyInput): string[] {\n  const lines: string[] = [];\n\n  const orgSuffix = input.organizationName ? ` @ ${input.organizationName}` : \"\";\n  lines.push(`✓ Logged in as ${input.email}${orgSuffix}`);\n\n  // AI tools (coding assistants). Fall back to the built-in wrappers when the\n  // org published none, so the user always gets a runnable next-step.\n  const tools =\n    input.tools && input.tools.length > 0 ? input.tools : DEFAULT_TOOLS;\n  lines.push(\"\");\n  lines.push(\"Your AI tools (run any of these):\");\n  const cmdWidth = Math.max(\n    ...tools.map((t) => `langwatch ${t.slug}`.length),\n  );\n  for (const tool of tools) {\n    const cmd = `langwatch ${tool.slug}`;\n    const labelSuffix = tool.displayName ? `  # ${tool.displayName}` : \"\";\n    lines.push(`  $ ${padRight(cmd, cmdWidth)}${labelSuffix}`);\n  }\n\n  // Model providers the user can mint a virtual key for — a different concept\n  // from the tools above. Only shown when the org published provider tiles.\n  if (input.providers && input.providers.length > 0) {\n    lines.push(\"\");\n    lines.push(\"Model providers you can issue a virtual key for:\");\n    const nameWidth = Math.max(...input.providers.map((p) => p.name.length));\n    for (const p of input.providers) {\n      const padded = padRight(p.name, nameWidth);\n      const annotations: string[] = [];\n      if (p.displayName && p.displayName !== p.name) {\n        annotations.push(p.displayName);\n      }\n      if (p.configured === false) annotations.push(\"(not configured yet)\");\n      const suffix = annotations.length > 0 ? `  ${annotations.join(\"  \")}` : \"\";\n      lines.push(`  • ${padded}${suffix}`);\n    }\n  }\n\n  if (input.budget) {\n    lines.push(\"\");\n    const period =\n      input.budget.period.charAt(0).toUpperCase() +\n      input.budget.period.slice(1).toLowerCase();\n    lines.push(\n      `${period} budget: ${formatUsd(input.budget.limitUsd)}   |   Used: ${formatUsedUsd(input.budget.usedUsd)}`,\n    );\n  }\n\n  if (input.openCommand !== false) {\n    lines.push(\"\");\n    lines.push(\"Or open the app in your browser:\");\n    lines.push(\"  $ langwatch open\");\n  }\n\n  return lines;\n}\n"]}

package/dist/chunk-56HLVZTH.mjs

@@ -0,0 +1,101 @@
+import {
+  createLangWatchApiClient
+} from "./chunk-VRGHREA7.mjs";
+import {
+  extractStatusFromResponse,
+  formatApiErrorForOperation
+} from "./chunk-J3KM7ZO7.mjs";
+
+// src/client-sdk/services/evaluators/errors.ts
+var EvaluatorsApiError = class extends Error {
+  constructor(message, operation, originalError) {
+    super(message);
+    this.operation = operation;
+    this.originalError = originalError;
+    this.name = "EvaluatorsApiError";
+  }
+};
+
+// src/client-sdk/services/evaluators/evaluators-api.service.ts
+var EvaluatorsApiService = class {
+  constructor(config) {
+    var _a;
+    this.apiClient = (_a = config == null ? void 0 : config.langwatchApiClient) != null ? _a : createLangWatchApiClient();
+  }
+  handleApiError(operation, error) {
+    const message = formatApiErrorForOperation({ operation, error, options: {
+      status: extractStatusFromResponse(error)
+    } });
+    throw new EvaluatorsApiError(message, operation, error);
+  }
+  /**
+   * Fetches all evaluators for the project.
+   */
+  async getAll() {
+    const { data, error } = await this.apiClient.GET("/api/evaluators");
+    if (error) this.handleApiError("fetch all evaluators", error);
+    return data;
+  }
+  /**
+   * Fetches a single evaluator by its ID or slug.
+   */
+  async get(idOrSlug) {
+    const { data, error } = await this.apiClient.GET(
+      "/api/evaluators/{idOrSlug}",
+      {
+        params: { path: { idOrSlug } }
+      }
+    );
+    if (error)
+      this.handleApiError(
+        `fetch evaluator with ID or slug "${idOrSlug}"`,
+        error
+      );
+    return data;
+  }
+  /**
+   * Creates a new evaluator.
+   */
+  async create(params) {
+    const { data, error } = await this.apiClient.POST("/api/evaluators", {
+      body: params
+    });
+    if (error) this.handleApiError("create evaluator", error);
+    return data;
+  }
+  /**
+   * Updates an evaluator by its ID.
+   */
+  async update(id, params) {
+    const { data, error } = await this.apiClient.PUT(
+      "/api/evaluators/{id}",
+      {
+        params: { path: { id } },
+        body: params
+      }
+    );
+    if (error)
+      this.handleApiError(`update evaluator with ID "${id}"`, error);
+    return data;
+  }
+  /**
+   * Deletes (archives) an evaluator by its ID.
+   */
+  async delete(id) {
+    const { data, error } = await this.apiClient.DELETE(
+      "/api/evaluators/{id}",
+      {
+        params: { path: { id } }
+      }
+    );
+    if (error)
+      this.handleApiError(`delete evaluator with ID "${id}"`, error);
+    return data;
+  }
+};
+
+export {
+  EvaluatorsApiError,
+  EvaluatorsApiService
+};
+//# sourceMappingURL=chunk-56HLVZTH.mjs.map

package/dist/chunk-5YPBJ2RX.js

@@ -0,0 +1,300 @@
+"use strict";Object.defineProperty(exports, "__esModule", {value: true});
+
+var _chunkWZTRPR6Ajs = require('./chunk-WZTRPR6A.js');
+
+
+
+
+
+
+
+
+var _chunkTJ6BZNZNjs = require('./chunk-TJ6BZNZN.js');
+
+
+var _chunkIXYZL7U2js = require('./chunk-IXYZL7U2.js');
+
+
+
+var _chunkBRPEG3YQjs = require('./chunk-BRPEG3YQ.js');
+
+// src/observability-sdk/exporters/langwatch-trace-exporter.ts
+var _exportertraceotlphttp = require('@opentelemetry/exporter-trace-otlp-http');
+
+// src/observability-sdk/exporters/trace-filters.ts
+function applyFilters(filters, spans) {
+  if (!filters || filters.length === 0) return spans;
+  return filters.reduce((current, rule) => applyFilterRule(rule, current), spans);
+}
+function applyFilterRule(rule, spans) {
+  if ("preset" in rule && rule.preset) {
+    return applyPreset(
+      rule.preset,
+      spans
+    );
+  }
+  if ("include" in rule && rule.include) {
+    const criteria = rule.include;
+    return spans.filter((s) => matchesCriteria(s, criteria));
+  }
+  if ("exclude" in rule && rule.exclude) {
+    const criteria = rule.exclude;
+    return spans.filter((s) => !matchesCriteria(s, criteria));
+  }
+  return spans;
+}
+function applyPreset(preset, spans) {
+  if (preset === "vercelAIOnly") return spans.filter((s) => isVercelAiSpan(s));
+  if (preset === "excludeHttpRequests") return spans.filter((s) => !isHttpRequestSpan(s));
+  return spans;
+}
+function matchesCriteria(span, criteria) {
+  var _a, _b;
+  if (criteria.instrumentationScopeName !== void 0) {
+    const scopeName = (_b = (_a = span.instrumentationScope) == null ? void 0 : _a.name) != null ? _b : "";
+    const ok = criteria.instrumentationScopeName.some((m) => valueMatches(scopeName, m));
+    if (!ok) return false;
+  }
+  if (criteria.name !== void 0) {
+    const ok = criteria.name.some((m) => {
+      var _a2;
+      return valueMatches((_a2 = span.name) != null ? _a2 : "", m);
+    });
+    if (!ok) return false;
+  }
+  return true;
+}
+function valueMatches(value, rule) {
+  var _a;
+  const raw = value != null ? value : "";
+  const ignoreCase = (_a = rule.ignoreCase) != null ? _a : false;
+  if (rule.equals !== void 0) {
+    return ignoreCase ? raw.localeCompare(rule.equals, void 0, { sensitivity: "base" }) === 0 : raw === rule.equals;
+  }
+  if (rule.startsWith !== void 0) {
+    return ignoreCase ? raw.toLowerCase().startsWith(rule.startsWith.toLowerCase()) : raw.startsWith(rule.startsWith);
+  }
+  if (rule.matches instanceof RegExp) {
+    const re = ignoreCase && !rule.matches.flags.includes("i") ? new RegExp(rule.matches.source, (rule.matches.flags || "") + "i") : rule.matches;
+    return re.test(raw);
+  }
+  return false;
+}
+function isVercelAiSpan(span) {
+  var _a, _b, _c, _d;
+  const scope = (_d = (_c = (_b = (_a = span.instrumentationScope) == null ? void 0 : _a.name) == null ? void 0 : _b.toLowerCase) == null ? void 0 : _c.call(_b)) != null ? _d : "";
+  return scope === "ai";
+}
+function isHttpRequestSpan(span) {
+  var _a;
+  const name = (_a = span.name) != null ? _a : "";
+  const verbMatch = /^(GET|POST|PUT|DELETE|PATCH|OPTIONS|HEAD)\b/i.test(name);
+  return verbMatch;
+}
+
+// src/observability-sdk/exporters/langwatch-trace-exporter.ts
+var LangWatchTraceExporter = class extends _exportertraceotlphttp.OTLPTraceExporter {
+  /**
+   * 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'
+   * });
+   *
+   * // With custom endpoint and no filtering
+   * const exporter = new LangWatchTraceExporter({
+   *   endpoint: 'https://custom.langwatch.ai',
+   *   filters: null
+   * });
+   * ```
+   */
+  constructor(opts) {
+    var _a, _b, _c, _d, _e;
+    const apiKey = (_b = (_a = opts == null ? void 0 : opts.apiKey) != null ? _a : process.env.LANGWATCH_API_KEY) != null ? _b : "";
+    const projectId = (_c = opts == null ? void 0 : opts.projectId) != null ? _c : process.env.LANGWATCH_PROJECT_ID;
+    const endpoint = (_e = (_d = opts == null ? void 0 : opts.endpoint) != null ? _d : process.env.LANGWATCH_ENDPOINT) != null ? _e : _chunkTJ6BZNZNjs.DEFAULT_ENDPOINT;
+    const url = new URL(_chunkTJ6BZNZNjs.TRACES_PATH, endpoint);
+    const otelEndpoint = url.toString();
+    super({
+      headers: _chunkBRPEG3YQjs.__spreadValues.call(void 0, {
+        "x-langwatch-sdk-name": _chunkTJ6BZNZNjs.LANGWATCH_SDK_NAME_OBSERVABILITY,
+        "x-langwatch-sdk-language": _chunkTJ6BZNZNjs.LANGWATCH_SDK_LANGUAGE,
+        "x-langwatch-sdk-version": _chunkTJ6BZNZNjs.LANGWATCH_SDK_VERSION,
+        "x-langwatch-sdk-runtime": _chunkTJ6BZNZNjs.LANGWATCH_SDK_RUNTIME.call(void 0, )
+      }, _chunkWZTRPR6Ajs.buildAuthHeaders.call(void 0, { apiKey, projectId })),
+      url: otelEndpoint.toString()
+    });
+    if ((opts == null ? void 0 : opts.filters) === null || Array.isArray(opts == null ? void 0 : opts.filters) && opts.filters.length === 0) {
+      this.filters = [];
+    } else if (Array.isArray(opts == null ? void 0 : opts.filters)) {
+      this.filters = opts.filters;
+    } else {
+      this.filters = [{ preset: "excludeHttpRequests" }];
+    }
+  }
+  export(spans, resultCallback) {
+    const filtered = applyFilters(this.filters, spans);
+    super.export(filtered, resultCallback);
+  }
+};
+
+// src/observability-sdk/exporters/langwatch-logs-exporter.ts
+var _exporterlogsotlphttp = require('@opentelemetry/exporter-logs-otlp-http');
+var LangWatchLogsExporter = class extends _exporterlogsotlphttp.OTLPLogExporter {
+  /**
+   * Creates a new LangWatchLogsExporter instance.
+   *
+   * @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.
+   */
+  constructor(opts) {
+    var _a, _b, _c, _d;
+    const apiKey = (_b = (_a = opts == null ? void 0 : opts.apiKey) != null ? _a : process.env.LANGWATCH_API_KEY) != null ? _b : "";
+    const endpoint = (_d = (_c = opts == null ? void 0 : opts.endpoint) != null ? _c : process.env.LANGWATCH_ENDPOINT) != null ? _d : _chunkTJ6BZNZNjs.DEFAULT_ENDPOINT;
+    const url = new URL(_chunkTJ6BZNZNjs.LOGS_PATH, endpoint);
+    const otelEndpoint = url.toString();
+    super({
+      headers: _chunkBRPEG3YQjs.__spreadValues.call(void 0, {
+        "x-langwatch-sdk-name": _chunkTJ6BZNZNjs.LANGWATCH_SDK_NAME_OBSERVABILITY,
+        "x-langwatch-sdk-language": _chunkTJ6BZNZNjs.LANGWATCH_SDK_LANGUAGE,
+        "x-langwatch-sdk-version": _chunkTJ6BZNZNjs.LANGWATCH_SDK_VERSION,
+        "x-langwatch-sdk-runtime": _chunkTJ6BZNZNjs.LANGWATCH_SDK_RUNTIME.call(void 0, )
+      }, apiKey ? { authorization: `Bearer ${apiKey}` } : {}),
+      url: otelEndpoint.toString()
+    });
+  }
+};
+
+// src/observability-sdk/semconv/events.ts
+var LOG_EVNT_GEN_AI_SYSTEM_MESSAGE = "gen.ai.system_message";
+var LOG_EVNT_GEN_AI_USER_MESSAGE = "gen.ai.user_message";
+var LOG_EVNT_GEN_AI_ASSISTANT_MESSAGE = "gen.ai.assistant_message";
+var LOG_EVNT_GEN_AI_TOOL_MESSAGE = "gen.ai.tool_message";
+var LOG_EVNT_GEN_AI_CHOICE = "gen.ai.choice";
+
+// src/observability-sdk/logger/index.ts
+
+
+var _apilogs = require('@opentelemetry/api-logs');
+
+// src/observability-sdk/logger/implementation.ts
+var _api = require('@opentelemetry/api');
+var LangWatchLoggerInternal = class {
+  constructor(logger) {
+    this.logger = logger;
+  }
+  emit(logRecord, options) {
+    if (!_chunkIXYZL7U2js.shouldCaptureOutput.call(void 0, )) {
+      logRecord.body = void 0;
+    }
+    if (!logRecord.context && !(options == null ? void 0 : options.excludeContext)) {
+      logRecord.context = _api.context.active();
+    }
+    this.logger.emit(logRecord);
+  }
+  emitGenAISystemMessageEvent(body, system, attributes) {
+    var _a;
+    this.emitGenAIEvent(
+      LOG_EVNT_GEN_AI_SYSTEM_MESSAGE,
+      _chunkBRPEG3YQjs.__spreadProps.call(void 0, _chunkBRPEG3YQjs.__spreadValues.call(void 0, {}, body), { role: (_a = body.role) != null ? _a : "system" }),
+      _chunkBRPEG3YQjs.__spreadProps.call(void 0, _chunkBRPEG3YQjs.__spreadValues.call(void 0, {}, attributes), {
+        "gen_ai.system": system
+      })
+    );
+  }
+  emitGenAIUserMessageEvent(body, system, attributes) {
+    var _a;
+    this.emitGenAIEvent(
+      LOG_EVNT_GEN_AI_USER_MESSAGE,
+      _chunkBRPEG3YQjs.__spreadProps.call(void 0, _chunkBRPEG3YQjs.__spreadValues.call(void 0, {}, body), { role: (_a = body.role) != null ? _a : "user" }),
+      _chunkBRPEG3YQjs.__spreadProps.call(void 0, _chunkBRPEG3YQjs.__spreadValues.call(void 0, {}, attributes), {
+        "gen_ai.system": system
+      })
+    );
+  }
+  emitGenAIAssistantMessageEvent(body, system, attributes) {
+    var _a;
+    this.emitGenAIEvent(
+      LOG_EVNT_GEN_AI_ASSISTANT_MESSAGE,
+      _chunkBRPEG3YQjs.__spreadProps.call(void 0, _chunkBRPEG3YQjs.__spreadValues.call(void 0, {}, body), { role: (_a = body.role) != null ? _a : "assistant" }),
+      _chunkBRPEG3YQjs.__spreadProps.call(void 0, _chunkBRPEG3YQjs.__spreadValues.call(void 0, {}, attributes), {
+        "gen_ai.system": system
+      })
+    );
+  }
+  emitGenAIToolMessageEvent(body, system, attributes) {
+    if (body.role === void 0) {
+      body.role = "tool";
+    }
+    this.emitGenAIEvent(
+      LOG_EVNT_GEN_AI_TOOL_MESSAGE,
+      _chunkBRPEG3YQjs.__spreadValues.call(void 0, {}, body),
+      _chunkBRPEG3YQjs.__spreadProps.call(void 0, _chunkBRPEG3YQjs.__spreadValues.call(void 0, {}, attributes), {
+        "gen_ai.system": system
+      })
+    );
+  }
+  emitGenAIChoiceEvent(body, system, attributes) {
+    var _a, _b;
+    if (body.message && body.message.role === void 0) {
+      body.message.role = "assistant";
+    }
+    this.emitGenAIEvent(
+      LOG_EVNT_GEN_AI_CHOICE,
+      _chunkBRPEG3YQjs.__spreadProps.call(void 0, _chunkBRPEG3YQjs.__spreadValues.call(void 0, {}, body), {
+        message: _chunkBRPEG3YQjs.__spreadProps.call(void 0, _chunkBRPEG3YQjs.__spreadValues.call(void 0, {}, body.message), { role: (_b = (_a = body.message) == null ? void 0 : _a.role) != null ? _b : "assistant" })
+      }),
+      _chunkBRPEG3YQjs.__spreadProps.call(void 0, _chunkBRPEG3YQjs.__spreadValues.call(void 0, {}, attributes), {
+        "gen_ai.system": system
+      })
+    );
+  }
+  emitGenAIEvent(eventName, body, attributes) {
+    this.emit({
+      eventName,
+      context: _api.context.active(),
+      attributes: _chunkBRPEG3YQjs.__spreadValues.call(void 0, {}, attributes),
+      body: _chunkIXYZL7U2js.shouldCaptureOutput.call(void 0, ) ? body : void 0,
+      observedTimestamp: (/* @__PURE__ */ new Date()).getTime()
+    });
+  }
+};
+
+// src/observability-sdk/logger/index.ts
+var currentLoggerProvider = new (0, _apilogs.NoopLoggerProvider)();
+function setLangWatchLoggerProvider(loggerProvider) {
+  currentLoggerProvider = loggerProvider;
+}
+function getLangWatchLogger(name, version) {
+  return getLangWatchLoggerFromProvider(currentLoggerProvider, name, version);
+}
+function getLangWatchLoggerFromProvider(loggerProvider, name, version) {
+  return createLangWatchLogger(loggerProvider.getLogger(name, version));
+}
+function createLangWatchLogger(logger) {
+  return new LangWatchLoggerInternal(logger);
+}
+
+
+
+
+
+
+
+exports.LangWatchTraceExporter = LangWatchTraceExporter; exports.LangWatchLogsExporter = LangWatchLogsExporter; exports.setLangWatchLoggerProvider = setLangWatchLoggerProvider; exports.getLangWatchLogger = getLangWatchLogger; exports.getLangWatchLoggerFromProvider = getLangWatchLoggerFromProvider;
+//# sourceMappingURL=chunk-5YPBJ2RX.js.map

package/dist/chunk-5YPBJ2RX.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["/home/runner/work/langwatch/langwatch/typescript-sdk/dist/chunk-5YPBJ2RX.js","../src/observability-sdk/exporters/langwatch-trace-exporter.ts","../src/observability-sdk/exporters/trace-filters.ts","../src/observability-sdk/exporters/langwatch-logs-exporter.ts","../src/observability-sdk/semconv/events.ts","../src/observability-sdk/logger/index.ts","../src/observability-sdk/logger/implementation.ts"],"names":["_a"],"mappings":"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","file":"/home/runner/work/langwatch/langwatch/typescript-sdk/dist/chunk-5YPBJ2RX.js","sourcesContent":[null,"import { OTLPTraceExporter } from \"@opentelemetry/exporter-trace-otlp-http\";\nimport { type ReadableSpan } from \"@opentelemetry/sdk-trace-base\";\nimport { type ExportResult } from '@opentelemetry/core';\nimport {\n  DEFAULT_ENDPOINT,\n  LANGWATCH_SDK_LANGUAGE,\n  LANGWATCH_SDK_NAME_OBSERVABILITY,\n  LANGWATCH_SDK_RUNTIME,\n  LANGWATCH_SDK_VERSION,\n  TRACES_PATH,\n} from \"../../internal/constants\";\nimport { buildAuthHeaders } from \"../../internal/api/auth\";\nimport {\n  type TraceFilter,\n  type Criteria,\n  type Match,\n  applyFilters,\n} from \"./trace-filters\";\n\n/**\n * Configuration options for the LangWatchTraceExporter.\n *\n * @property endpoint - Custom LangWatch endpoint URL. Falls back to LANGWATCH_ENDPOINT env var or default.\n * @property apiKey - API key for authentication. Falls back to LANGWATCH_API_KEY env var.\n * @property filters - Array of filters applied sequentially to spans before export.\n *                     Default: `[{ preset: \"excludeHttpRequests\" }]` to reduce framework noise.\n *                     Pass `null` or `[]` to disable all filtering.\n */\nexport interface LangWatchTraceExporterOptions {\n  endpoint?: string;\n  apiKey?: string;\n  /**\n   * Project identifier. Required when `apiKey` is a Personal Access Token\n   * (`pat-lw-*`); ignored for legacy `sk-lw-*` keys. Falls back to\n   * `LANGWATCH_PROJECT_ID`.\n   */\n  projectId?: string;\n  filters?: TraceFilter[] | null;\n}\n\nexport type { TraceFilter, Criteria, Match };\n\n/**\n * LangWatchTraceExporter extends the OpenTelemetry OTLP HTTP trace exporter\n * to send trace data to LangWatch with proper authentication and metadata headers.\n *\n * ## Features\n * - Automatic authorization header configuration via API key\n * - SDK version and runtime identification headers\n * - Proper endpoint URL construction for LangWatch ingestion\n * - Intent-based span filtering with presets and custom criteria\n *\n * ## Filtering Behavior\n * - **Default**: HTTP request spans are excluded to reduce framework noise\n * - **Pipeline**: Filters are applied sequentially with AND semantics\n * - **Matching**: All string comparisons are case-sensitive by default\n * - **Array Syntax**: All criteria require arrays of Match objects for explicit filtering\n *\n * ## Filter Types\n * - **Presets**: Pre-configured common filters (`vercelAIOnly`, `excludeHttpRequests`)\n * - **Include**: Keep only spans matching criteria (OR within field, AND across fields)\n * - **Exclude**: Remove spans matching criteria (OR within field, AND across fields)\n *\n * @example Basic usage with default filtering\n * ```typescript\n * import { LangWatchTraceExporter } from '@langwatch/observability';\n *\n * // Default: excludes HTTP request spans\n * const exporter = new LangWatchTraceExporter();\n * ```\n *\n * @example Using presets\n * ```typescript\n * // Keep only Vercel AI SDK spans\n * const exporterAI = new LangWatchTraceExporter({\n *   filters: [{ preset: 'vercelAIOnly' }],\n * });\n *\n * // Explicitly exclude HTTP requests (same as default)\n * const exporterNoHttp = new LangWatchTraceExporter({\n *   filters: [{ preset: 'excludeHttpRequests' }],\n * });\n *\n * // No filtering at all (send all spans)\n * const exporterAll = new LangWatchTraceExporter({\n *   filters: null, // or filters: []\n * });\n * ```\n *\n * @example Custom filtering with criteria\n * ```typescript\n * // Include only spans with specific scope\n * const exporter1 = new LangWatchTraceExporter({\n *   filters: [\n *     { include: { instrumentationScopeName: [{ equals: 'ai' }] } }\n *   ],\n * });\n *\n * // Exclude spans by name pattern\n * const exporter2 = new LangWatchTraceExporter({\n *   filters: [\n *     { exclude: { name: [{ startsWith: 'internal.' }] } }\n *   ],\n * });\n *\n * // Case-insensitive matching\n * const exporter3 = new LangWatchTraceExporter({\n *   filters: [\n *     { include: { name: [{ equals: 'chat.completion', ignoreCase: true }] } }\n *   ],\n * });\n * ```\n *\n * @example Filter pipelines (AND semantics)\n * ```typescript\n * // Keep AI spans, then remove HTTP requests\n * const exporter = new LangWatchTraceExporter({\n *   filters: [\n *     { include: { instrumentationScopeName: [{ equals: 'ai' }] } },\n *     { preset: 'excludeHttpRequests' },\n *   ],\n * });\n * ```\n *\n * @example OR semantics within a field\n * ```typescript\n * // Include spans with name starting with 'chat.' OR 'llm.'\n * const exporter = new LangWatchTraceExporter({\n *   filters: [\n *     {\n *       include: {\n *         name: [\n *           { startsWith: 'chat.' },\n *           { startsWith: 'llm.' }\n *         ]\n *       }\n *     }\n *   ],\n * });\n * ```\n *\n * @example Using regex patterns\n * ```typescript\n * const exporter = new LangWatchTraceExporter({\n *   filters: [\n *     {\n *       include: {\n *         name: [{ matches: /^(chat|llm)\\./i }]\n *       }\n *     }\n *   ],\n * });\n * ```\n */\nexport class LangWatchTraceExporter extends OTLPTraceExporter {\n  private readonly filters: TraceFilter[];\n  /**\n   * Creates a new LangWatchTraceExporter instance.\n   *\n   * @param opts - Configuration options for the exporter\n   * @param opts.apiKey - API key for LangWatch authentication.\n   *                     Falls back to `LANGWATCH_API_KEY` environment variable, then empty string.\n   * @param opts.endpoint - Custom endpoint URL for LangWatch ingestion.\n   *                       Falls back to `LANGWATCH_ENDPOINT` environment variable, then default endpoint.\n   * @param opts.filters - Array of filters applied sequentially to spans before export (AND semantics).\n   *                      When omitted, defaults to `[{ preset: \"excludeHttpRequests\" }]`.\n   *                      Pass `null` or `[]` to disable all filtering and send all spans.\n   *\n   * @example\n   * ```typescript\n   * // With API key and default filtering\n   * const exporter = new LangWatchTraceExporter({\n   *   apiKey: 'your-api-key'\n   * });\n   *\n   * // With custom endpoint and no filtering\n   * const exporter = new LangWatchTraceExporter({\n   *   endpoint: 'https://custom.langwatch.ai',\n   *   filters: null\n   * });\n   * ```\n   */\n  constructor(opts?: LangWatchTraceExporterOptions) {\n    const apiKey = opts?.apiKey ?? process.env.LANGWATCH_API_KEY ?? \"\";\n    const projectId = opts?.projectId ?? process.env.LANGWATCH_PROJECT_ID;\n    const endpoint =\n      opts?.endpoint ??\n      process.env.LANGWATCH_ENDPOINT ??\n      DEFAULT_ENDPOINT;\n\n    const url = new URL(TRACES_PATH, endpoint);\n    const otelEndpoint = url.toString();\n\n    super({\n      headers: {\n        \"x-langwatch-sdk-name\": LANGWATCH_SDK_NAME_OBSERVABILITY,\n        \"x-langwatch-sdk-language\": LANGWATCH_SDK_LANGUAGE,\n        \"x-langwatch-sdk-version\": LANGWATCH_SDK_VERSION,\n        \"x-langwatch-sdk-runtime\": LANGWATCH_SDK_RUNTIME(),\n        ...buildAuthHeaders({ apiKey, projectId }),\n      },\n      url: otelEndpoint.toString(),\n    });\n\n    // Handle filters: null or [] = no filtering, undefined = default, array = use provided\n    if (opts?.filters === null || (Array.isArray(opts?.filters) && opts.filters.length === 0)) {\n      this.filters = [];\n    } else if (Array.isArray(opts?.filters)) {\n      this.filters = opts.filters;\n    } else {\n      this.filters = [{ preset: \"excludeHttpRequests\" }];\n    }\n  }\n\n  export(spans: ReadableSpan[], resultCallback: (result: ExportResult) => void): void {\n    const filtered = applyFilters(this.filters, spans);\n    super.export(filtered, resultCallback);\n  }\n}\n","import { type ReadableSpan } from \"@opentelemetry/sdk-trace-base\";\n\nexport interface Criteria {\n  instrumentationScopeName?: Match[];\n  name?: Match[];\n}\n\nexport interface Match {\n  equals?: string;\n  startsWith?: string;\n  matches?: RegExp;\n  ignoreCase?: boolean;\n}\n\nexport type TraceFilter =\n  | { preset: \"vercelAIOnly\" | \"excludeHttpRequests\" }\n  | { include: Criteria }\n  | { exclude: Criteria };\n\n/**\n * Applies a sequence of filters to an array of spans using AND semantics.\n * Each filter in the sequence is applied to the result of the previous filter,\n * progressively narrowing down the set of spans.\n *\n * @param filters - Array of filter rules to apply sequentially\n * @param spans - Array of spans to filter\n * @returns Filtered array of spans that match all filter criteria\n *\n * @example\n * ```typescript\n * const filters: TraceFilter[] = [\n *   { include: { instrumentationScopeName: [{ equals: 'ai' }] } },\n *   { preset: 'excludeHttpRequests' }\n * ];\n * const filtered = applyFilters(filters, spans);\n * // Returns only AI spans that are not HTTP requests\n * ```\n */\nexport function applyFilters(\n  filters: TraceFilter[] | undefined,\n  spans: ReadableSpan[]\n): ReadableSpan[] {\n  if (!filters || filters.length === 0) return spans;\n  return filters.reduce((current, rule) => applyFilterRule(rule, current), spans);\n}\n\n/**\n * Applies a single filter rule to an array of spans.\n * Handles three types of filters: presets, include rules, and exclude rules.\n *\n * @param rule - Single filter rule (preset, include, or exclude)\n * @param spans - Array of spans to filter\n * @returns Filtered array of spans based on the rule\n *\n * @example\n * ```typescript\n * // Using preset\n * const filtered1 = applyFilterRule({ preset: 'vercelAIOnly' }, spans);\n *\n * // Using include\n * const filtered2 = applyFilterRule(\n *   { include: { name: [{ startsWith: 'llm.' }] } },\n *   spans\n * );\n *\n * // Using exclude\n * const filtered3 = applyFilterRule(\n *   { exclude: { instrumentationScopeName: [{ equals: 'http' }] } },\n *   spans\n * );\n * ```\n */\nexport function applyFilterRule(rule: TraceFilter, spans: ReadableSpan[]): ReadableSpan[] {\n  if (\"preset\" in rule && rule.preset) {\n    return applyPreset(\n      (rule as { preset: TraceFilter extends { preset: infer P } ? P : never }).preset as any,\n      spans\n    );\n  }\n\n  if (\"include\" in rule && rule.include) {\n    const criteria = (rule as { include: Criteria }).include;\n    return spans.filter((s) => matchesCriteria(s, criteria));\n  }\n\n  if (\"exclude\" in rule && rule.exclude) {\n    const criteria = (rule as { exclude: Criteria }).exclude;\n    return spans.filter((s) => !matchesCriteria(s, criteria));\n  }\n\n  return spans;\n}\n\n/**\n * Applies a preset filter to an array of spans.\n * Presets are predefined common filtering patterns.\n *\n * Available presets:\n * - `vercelAIOnly`: Keeps only spans from the Vercel AI SDK (instrumentationScope.name === 'ai')\n * - `excludeHttpRequests`: Removes spans that appear to be HTTP requests (span name starts with HTTP verb)\n *\n * @param preset - Name of the preset filter to apply\n * @param spans - Array of spans to filter\n * @returns Filtered array of spans based on the preset\n *\n * @example\n * ```typescript\n * // Keep only Vercel AI spans\n * const aiSpans = applyPreset('vercelAIOnly', spans);\n *\n * // Remove HTTP request spans\n * const noHttpSpans = applyPreset('excludeHttpRequests', spans);\n * ```\n */\nexport function applyPreset(\n  preset: \"vercelAIOnly\" | \"excludeHttpRequests\",\n  spans: ReadableSpan[]\n): ReadableSpan[] {\n  if (preset === \"vercelAIOnly\") return spans.filter((s) => isVercelAiSpan(s));\n  if (preset === \"excludeHttpRequests\") return spans.filter((s) => !isHttpRequestSpan(s));\n\n  return spans;\n}\n\n/**\n * Checks if a span matches the given criteria.\n * All specified criteria fields must match (AND semantics within a criteria object).\n * Within each field, matchers are evaluated with OR semantics (any matcher can match).\n *\n * @param span - Span to evaluate\n * @param criteria - Criteria to match against (instrumentationScopeName and/or name)\n * @returns True if the span matches all specified criteria, false otherwise\n *\n * @example\n * ```typescript\n * const criteria: Criteria = {\n *   instrumentationScopeName: [{ equals: 'ai' }],\n *   name: [{ startsWith: 'llm.' }, { startsWith: 'chat.' }]\n * };\n * const matches = matchesCriteria(span, criteria);\n * // Returns true if scope is 'ai' AND name starts with 'llm.' OR 'chat.'\n * ```\n */\nexport function matchesCriteria(span: ReadableSpan, criteria: Criteria): boolean {\n  if (criteria.instrumentationScopeName !== void 0) {\n    const scopeName = span.instrumentationScope?.name ?? \"\";\n    const ok = criteria.instrumentationScopeName.some((m) => valueMatches(scopeName, m));\n    if (!ok) return false;\n  }\n\n  if (criteria.name !== void 0) {\n    const ok = criteria.name.some((m) => valueMatches(span.name ?? \"\", m));\n    if (!ok) return false;\n  }\n\n  return true;\n}\n\n/**\n * Evaluates if a string value matches a given match rule.\n * Supports three types of matching: exact equality, prefix matching, and regex matching.\n * All matching is case-sensitive by default unless `ignoreCase` is explicitly set to true.\n *\n * @param value - String value to evaluate\n * @param rule - Match rule specifying the matching criteria\n * @returns True if the value matches the rule, false otherwise\n *\n * @example\n * ```typescript\n * // Exact match (case-sensitive by default)\n * valueMatches('GET /api/users', { equals: 'GET /api/users' }); // true\n * valueMatches('get /api/users', { equals: 'GET /api/users' }); // false\n *\n * // Case-insensitive exact match\n * valueMatches('get /api/users', { equals: 'GET /api/users', ignoreCase: true }); // true\n *\n * // Prefix match\n * valueMatches('GET /api/users', { startsWith: 'GET' }); // true\n * valueMatches('POST /api/users', { startsWith: 'GET' }); // false\n *\n * // Regex match\n * valueMatches('GET /api/users', { matches: /^(GET|POST)\\b/ }); // true\n *\n * // Case-insensitive regex\n * valueMatches('get /api/users', { matches: /^GET\\b/, ignoreCase: true }); // true\n * ```\n */\nexport function valueMatches(value: string, rule: Match): boolean {\n  const raw = value ?? \"\";\n  const ignoreCase = rule.ignoreCase ?? false;\n\n  if (rule.equals !== void 0) {\n    return ignoreCase\n      ? raw.localeCompare(rule.equals, void 0, { sensitivity: \"base\" }) === 0\n      : raw === rule.equals;\n  }\n\n  if (rule.startsWith !== void 0) {\n    return ignoreCase\n      ? raw.toLowerCase().startsWith(rule.startsWith.toLowerCase())\n      : raw.startsWith(rule.startsWith);\n  }\n\n  if (rule.matches instanceof RegExp) {\n    const re =\n      ignoreCase && !rule.matches.flags.includes(\"i\")\n        ? new RegExp(rule.matches.source, (rule.matches.flags || \"\") + \"i\")\n        : rule.matches;\n    return re.test(raw);\n  }\n\n  return false;\n}\n\n/**\n * Checks if a span is from the Vercel AI SDK.\n * A span is considered a Vercel AI span if its instrumentation scope name is 'ai' (case-insensitive).\n *\n * @param span - Span to check\n * @returns True if the span is from the Vercel AI SDK, false otherwise\n *\n * @example\n * ```typescript\n * if (isVercelAiSpan(span)) {\n *   console.log('This is a Vercel AI operation');\n * }\n * ```\n */\nexport function isVercelAiSpan(span: ReadableSpan): boolean {\n  const scope = span.instrumentationScope?.name?.toLowerCase?.() ?? \"\";\n  return scope === \"ai\";\n}\n\n/**\n * Checks if a span appears to be an HTTP request based on its name.\n * A span is considered an HTTP request if its name starts with a common HTTP verb\n * (GET, POST, PUT, DELETE, PATCH, OPTIONS, HEAD) followed by a word boundary.\n *\n * @param span - Span to check\n * @returns True if the span appears to be an HTTP request, false otherwise\n *\n * @example\n * ```typescript\n * // These would return true:\n * // span.name = \"GET /api/users\"\n * // span.name = \"POST /api/data\"\n * // span.name = \"DELETE /resource/123\"\n *\n * if (isHttpRequestSpan(span)) {\n *   console.log('This is an HTTP request span');\n * }\n * ```\n */\nexport function isHttpRequestSpan(span: ReadableSpan): boolean {\n  const name = span.name ?? \"\";\n  const verbMatch = /^(GET|POST|PUT|DELETE|PATCH|OPTIONS|HEAD)\\b/i.test(name);\n  return verbMatch;\n}\n","import { OTLPLogExporter } from \"@opentelemetry/exporter-logs-otlp-http\";\nimport {\n  DEFAULT_ENDPOINT,\n  LANGWATCH_SDK_LANGUAGE,\n  LANGWATCH_SDK_NAME_OBSERVABILITY,\n  LANGWATCH_SDK_RUNTIME,\n  LANGWATCH_SDK_VERSION,\n  LOGS_PATH,\n} from \"../../internal/constants\";\n\nexport interface LangWatchLogsExporterOptions {\n  endpoint?: string;\n  apiKey?: string;\n}\n\n/**\n * LangWatchLogsExporter extends the OpenTelemetry OTLP HTTP logs exporter\n * to send logs to LangWatch with proper authentication and metadata headers.\n *\n * This exporter automatically configures:\n * - Authorization headers using the provided API key or environment variables/fallback\n * - SDK version and language identification headers\n * - Proper endpoint configuration for LangWatch ingestion using provided URL or environment variables/fallback\n *\n * @example\n * ```typescript\n * import { LangWatchLogsExporter } from '@langwatch/observability';\n *\n * // Using environment variables/fallback configuration\n * const exporter = new LangWatchLogsExporter();\n *\n * // Using custom options\n * const exporter = new LangWatchLogsExporter({\n *   apiKey: 'your-api-key',\n *   endpoint: 'https://custom.langwatch.com'\n * });\n * ```\n */\nexport class LangWatchLogsExporter extends OTLPLogExporter {\n  /**\n   * Creates a new LangWatchLogsExporter instance.\n   *\n   * @param opts - Optional configuration options for the exporter.\n   * @param opts.apiKey - Optional API key for LangWatch authentication. If not provided,\n   *                     will use environment variables or fallback configuration.\n   * @param opts.endpoint - Optional custom endpoint URL for LangWatch ingestion.\n   *                       If not provided, will use environment variables or fallback configuration.\n   */\n  constructor(opts?: LangWatchLogsExporterOptions) {\n    const apiKey = opts?.apiKey ?? process.env.LANGWATCH_API_KEY ?? \"\";\n    const endpoint =\n      opts?.endpoint ??\n      process.env.LANGWATCH_ENDPOINT ??\n      DEFAULT_ENDPOINT;\n\n    const url = new URL(LOGS_PATH, endpoint);\n    const otelEndpoint = url.toString();\n\n    super({\n      headers: {\n        \"x-langwatch-sdk-name\": LANGWATCH_SDK_NAME_OBSERVABILITY,\n        \"x-langwatch-sdk-language\": LANGWATCH_SDK_LANGUAGE,\n        \"x-langwatch-sdk-version\": LANGWATCH_SDK_VERSION,\n        \"x-langwatch-sdk-runtime\": LANGWATCH_SDK_RUNTIME(),\n        ...(apiKey ? { authorization: `Bearer ${apiKey}` } : {}),\n      },\n      url: otelEndpoint.toString(),\n    });\n  }\n}\n","/*\n  This file contains the values for the OpenTelemetry semantic conventions for GenAI log\n  record event names.\n\n  👉 https://opentelemetry.io/docs/specs/semconv/gen-ai/gen-ai-events/\n*/\n\n/**\n * GenAI system message event name\n * Used for log records representing system messages in AI conversations\n */\nexport const LOG_EVNT_GEN_AI_SYSTEM_MESSAGE = \"gen.ai.system_message\";\n\n/**\n * GenAI user message event name\n * Used for log records representing user messages in AI conversations\n */\nexport const LOG_EVNT_GEN_AI_USER_MESSAGE = \"gen.ai.user_message\";\n\n/**\n * GenAI assistant message event name\n * Used for log records representing assistant responses in AI conversations\n */\nexport const LOG_EVNT_GEN_AI_ASSISTANT_MESSAGE = \"gen.ai.assistant_message\";\n\n/**\n * GenAI tool message event name\n * Used for log records representing tool calls or responses in AI conversations\n */\nexport const LOG_EVNT_GEN_AI_TOOL_MESSAGE = \"gen.ai.tool_message\";\n\n/**\n * GenAI choice event name\n * Used for log records representing choices made by AI models\n */\nexport const LOG_EVNT_GEN_AI_CHOICE = \"gen.ai.choice\";\n\n/**\n * LangWatch LangChain callback event name\n * Used for log records representing LangChain callback events\n */\nexport const EVNT_LANGWATCH_LANGCHAIN_CALLBACK = \"langwatch.langchain.callback\";\n","import {\n  type Logger,\n  type LoggerProvider,\n  NoopLoggerProvider,\n} from \"@opentelemetry/api-logs\";\nimport {\n  type LangWatchLogger,\n} from \"./types\";\nimport { LangWatchLoggerInternal } from \"./implementation\";\n\n/**\n * The LangWatch-specific global logger provider. It may not be the same as the current\n * OpenTelemetry global logger provider, but it's the last one the `setupObservability`\n * knows about.\n * @internal\n */\nlet currentLoggerProvider: LoggerProvider = new NoopLoggerProvider();\n\n/**\n * @module observability/logger\n * @description\n * Provides LangWatch logger integration with OpenTelemetry, including logger provider\n * management and logger creation utilities.\n *\n * @remarks\n * This module allows you to set a global logger provider, retrieve LangWatch loggers,\n * and wrap OpenTelemetry loggers with LangWatch-specific functionality.\n *\n * @see {@link setLangWatchLoggerProvider}\n * @see {@link getLangWatchLogger}\n * @see {@link getLangWatchLoggerFromProvider}\n * @see {@link createLangWatchLogger}\n */\nexport function setLangWatchLoggerProvider(\n  loggerProvider: LoggerProvider,\n): void {\n  currentLoggerProvider = loggerProvider;\n}\n\n/**\n * Retrieves a LangWatch logger with the specified name and optional version.\n *\n * @param name - The name of the logger (typically your service or module name).\n * @param version - (Optional) The version of the logger.\n * @returns A {@link LangWatchLogger} instance.\n *\n * @remarks\n * Uses the logger provider set during observability setup. If no provider is set, returns\n * a NoOp logger.\n *\n * @example\n * ```ts\n * const logger = getLangWatchLogger(\"my-service\");\n * logger.info(\"Service started\");\n * ```\n *\n * @see {@link setLangWatchLoggerProvider}\n */\nexport function getLangWatchLogger(\n  name: string,\n  version?: string,\n): LangWatchLogger {\n  return getLangWatchLoggerFromProvider(currentLoggerProvider, name, version);\n}\n\n/**\n * Retrieves a LangWatch logger from a specific OpenTelemetry logger provider.\n *\n * @param loggerProvider - The OpenTelemetry logger provider to use.\n * @param name - The name of the logger.\n * @param version - (Optional) The version of the logger.\n * @returns A {@link LangWatchLogger} instance.\n *\n * @remarks\n * Use this function if you want to use a custom logger provider instead of the global one.\n *\n * @example\n * ```ts\n * const customProvider = new LoggerProvider();\n * const logger = getLangWatchLoggerFromProvider(customProvider, \"custom-service\");\n * ```\n */\nexport function getLangWatchLoggerFromProvider(\n  loggerProvider: LoggerProvider,\n  name: string,\n  version?: string,\n): LangWatchLogger {\n  return createLangWatchLogger(loggerProvider.getLogger(name, version));\n}\n\n/**\n * Wraps an OpenTelemetry logger as a LangWatch logger.\n *\n * @param logger - The OpenTelemetry logger to wrap.\n * @returns A {@link LangWatchLogger} instance.\n *\n * @example\n * ```ts\n * import { Logger } from \"@opentelemetry/api-logs\";\n * const otelLogger = new Logger();\n * const lwLogger = createLangWatchLogger(otelLogger);\n * lwLogger.info(\"Wrapped logger\");\n * ```\n */\nexport function createLangWatchLogger(logger: Logger): LangWatchLogger {\n  return new LangWatchLoggerInternal(logger);\n}\n\n// Export types and implementation\nexport * from \"./types\";\nexport * from \"./implementation\";\n","import {\n  type AnyValue,\n  type Logger,\n} from \"@opentelemetry/api-logs\";\nimport {\n  type EmitOptions,\n  type LangWatchLogger,\n  type LangWatchLogRecord,\n  type LangWatchSpanGenAIAssistantMessageEventBody,\n  type LangWatchSpanGenAIChoiceEventBody,\n  type LangWatchSpanGenAISystemMessageEventBody,\n  type LangWatchSpanGenAIToolMessageEventBody,\n  type LangWatchSpanGenAIUserMessageEventBody,\n} from \"./types\";\nimport { shouldCaptureOutput } from \"../config\";\nimport * as intSemconv from \"../semconv\";\nimport { type SemConvLogRecordAttributes } from \"../semconv\";\nimport { context } from \"@opentelemetry/api\";\n\n/**\n * Internal implementation of {@link LangWatchLogger}.\n *\n * @remarks\n * This class wraps an OpenTelemetry logger and adds LangWatch-specific functionality for\n * structured logging and event emission.\n * Not intended for direct use; use {@link getLangWatchLogger} or\n * {@link createLangWatchLogger} instead.\n */\nexport class LangWatchLoggerInternal implements LangWatchLogger {\n  constructor(private logger: Logger) {}\n\n  emit(logRecord: LangWatchLogRecord, options?: EmitOptions): void {\n    // Handle output capture configuration\n    if (!shouldCaptureOutput()) {\n      logRecord.body = void 0;\n    }\n\n    // Set context if not provided and not explicitly excluded\n    if (!logRecord.context && !options?.excludeContext) {\n      logRecord.context = context.active();\n    }\n\n    // Emit the log record through the underlying OpenTelemetry logger\n    this.logger.emit(logRecord);\n  }\n\n  emitGenAISystemMessageEvent(\n    body: LangWatchSpanGenAISystemMessageEventBody,\n    system?: intSemconv.VAL_GEN_AI_SYSTEMS | (string & {}),\n    attributes?: SemConvLogRecordAttributes,\n  ): void {\n    this.emitGenAIEvent(\n      intSemconv.LOG_EVNT_GEN_AI_SYSTEM_MESSAGE,\n      { ...body, role: body.role ?? \"system\" } satisfies LangWatchSpanGenAISystemMessageEventBody,\n      {\n        ...attributes,\n        \"gen_ai.system\": system,\n      },\n    );\n  }\n\n  emitGenAIUserMessageEvent(\n    body: LangWatchSpanGenAIUserMessageEventBody,\n    system?: intSemconv.VAL_GEN_AI_SYSTEMS | (string & {}),\n    attributes?: SemConvLogRecordAttributes,\n  ) {\n    this.emitGenAIEvent(\n      intSemconv.LOG_EVNT_GEN_AI_USER_MESSAGE,\n      { ...body, role: body.role ?? \"user\" } satisfies LangWatchSpanGenAIUserMessageEventBody,\n      {\n        ...attributes,\n        \"gen_ai.system\": system,\n      },\n    );\n  }\n\n  emitGenAIAssistantMessageEvent(\n    body: LangWatchSpanGenAIAssistantMessageEventBody,\n    system?: intSemconv.VAL_GEN_AI_SYSTEMS | (string & {}),\n    attributes?: SemConvLogRecordAttributes,\n  ) {\n    this.emitGenAIEvent(\n      intSemconv.LOG_EVNT_GEN_AI_ASSISTANT_MESSAGE,\n      { ...body, role: body.role ?? \"assistant\" } satisfies LangWatchSpanGenAIAssistantMessageEventBody,\n      {\n        ...attributes,\n        \"gen_ai.system\": system,\n      },\n    );\n  }\n\n  emitGenAIToolMessageEvent(\n    body: LangWatchSpanGenAIToolMessageEventBody,\n    system?: intSemconv.VAL_GEN_AI_SYSTEMS | (string & {}),\n    attributes?: SemConvLogRecordAttributes,\n  ) {\n    if (body.role === void 0) {\n      body.role = \"tool\";\n    }\n\n    this.emitGenAIEvent(\n      intSemconv.LOG_EVNT_GEN_AI_TOOL_MESSAGE,\n      { ...body },\n      {\n        ...attributes,\n        \"gen_ai.system\": system,\n      },\n    );\n  }\n\n  emitGenAIChoiceEvent(\n    body: LangWatchSpanGenAIChoiceEventBody,\n    system?: intSemconv.VAL_GEN_AI_SYSTEMS | (string & {}),\n    attributes?: SemConvLogRecordAttributes,\n  ) {\n    if (body.message && body.message.role === void 0) {\n      body.message.role = \"assistant\";\n    }\n\n    this.emitGenAIEvent(\n      intSemconv.LOG_EVNT_GEN_AI_CHOICE,\n      {\n        ...body,\n        message: { ...body.message, role: body.message?.role ?? \"assistant\" },\n      } satisfies LangWatchSpanGenAIChoiceEventBody,\n      {\n        ...attributes,\n        \"gen_ai.system\": system,\n      },\n    );\n  }\n\n  private emitGenAIEvent(\n    eventName: string,\n    body: AnyValue,\n    attributes?: SemConvLogRecordAttributes,\n  ): void {\n    this.emit({\n      eventName,\n      context: context.active(),\n      attributes: { ...attributes },\n      body: shouldCaptureOutput() ? body : void 0,\n      observedTimestamp: new Date().getTime(),\n    });\n  }\n}\n"]}