langwatch 0.3.0 → 0.3.1

package/dist/chunk-3GKPQB4R.mjs

@@ -0,0 +1,242 @@
+import {
+  localPromptConfigSchema
+} from "./chunk-4NRLVT2U.mjs";
+import {
+  PromptConverter
+} from "./chunk-W5ZEP3CI.mjs";
+
+// src/cli/utils/fileManager.ts
+import * as fs from "fs";
+import * as path from "path";
+import * as yaml from "js-yaml";
+import chalk from "chalk";
+var FileManager = class {
+  static getPromptsConfigPath() {
+    return path.join(process.cwd(), this.PROMPTS_CONFIG_FILE);
+  }
+  static getPromptsLockPath() {
+    return path.join(process.cwd(), this.PROMPTS_LOCK_FILE);
+  }
+  static getPromptsDir() {
+    return path.join(process.cwd(), this.PROMPTS_DIR);
+  }
+  static getMaterializedDir() {
+    return path.join(this.getPromptsDir(), this.MATERIALIZED_DIR);
+  }
+  static ensureDirectories() {
+    const promptsDir = this.getPromptsDir();
+    const materializedDir = this.getMaterializedDir();
+    if (!fs.existsSync(promptsDir)) {
+      fs.mkdirSync(promptsDir, { recursive: true });
+    }
+    if (!fs.existsSync(materializedDir)) {
+      fs.mkdirSync(materializedDir, { recursive: true });
+    }
+  }
+  static loadPromptsConfig() {
+    const configPath = this.getPromptsConfigPath();
+    if (!fs.existsSync(configPath)) {
+      return { prompts: {} };
+    }
+    try {
+      const content = fs.readFileSync(configPath, "utf-8");
+      return JSON.parse(content);
+    } catch (error) {
+      throw new Error(`Failed to parse prompts.json: ${error instanceof Error ? error.message : "Unknown error"}`);
+    }
+  }
+  static savePromptsConfig(config) {
+    const configPath = this.getPromptsConfigPath();
+    fs.writeFileSync(configPath, JSON.stringify(config, null, 2) + "\n");
+  }
+  static initializePromptsConfig() {
+    const configPath = this.getPromptsConfigPath();
+    const existed = fs.existsSync(configPath);
+    if (!existed) {
+      const emptyConfig = { prompts: {} };
+      this.savePromptsConfig(emptyConfig);
+      return { created: true, path: configPath };
+    }
+    return { created: false, path: configPath };
+  }
+  static loadPromptsLock() {
+    const lockPath = this.getPromptsLockPath();
+    if (!fs.existsSync(lockPath)) {
+      return {
+        lockfileVersion: 1,
+        prompts: {}
+      };
+    }
+    try {
+      const content = fs.readFileSync(lockPath, "utf-8");
+      return JSON.parse(content);
+    } catch (error) {
+      throw new Error(`Failed to parse prompts-lock.json: ${error instanceof Error ? error.message : "Unknown error"}`);
+    }
+  }
+  static savePromptsLock(lock) {
+    const lockPath = this.getPromptsLockPath();
+    fs.writeFileSync(lockPath, JSON.stringify(lock, null, 2) + "\n");
+  }
+  static initializePromptsLock() {
+    const lockPath = this.getPromptsLockPath();
+    const existed = fs.existsSync(lockPath);
+    if (!existed) {
+      const emptyLock = {
+        lockfileVersion: 1,
+        prompts: {}
+      };
+      this.savePromptsLock(emptyLock);
+      return { created: true, path: lockPath };
+    }
+    return { created: false, path: lockPath };
+  }
+  static loadLocalPrompt(filePath) {
+    const fullPath = path.resolve(filePath);
+    if (!fs.existsSync(fullPath)) {
+      throw new Error(`Local prompt file not found: ${filePath}`);
+    }
+    try {
+      const content = fs.readFileSync(fullPath, "utf-8");
+      const rawData = yaml.load(content);
+      const result = localPromptConfigSchema.safeParse(rawData);
+      if (!result.success) {
+        const prettyError = result.error.issues.map((issue) => `\u2716 ${issue.message}${issue.path.length > 0 ? `
+  \u2192 at ${issue.path.join(".")}` : ""}`).join("\n");
+        throw new Error(
+          `Invalid prompt configuration in ${chalk.yellow(filePath)}:
+${prettyError}`
+        );
+      }
+      return result.data;
+    } catch (error) {
+      if (error instanceof Error && error.message.includes("Invalid prompt configuration")) {
+        throw error;
+      }
+      throw new Error(`Failed to parse local prompt file ${filePath}: ${error instanceof Error ? error.message : "Unknown error"}`);
+    }
+  }
+  static saveMaterializedPrompt(name, prompt) {
+    const materializedDir = this.getMaterializedDir();
+    const parts = name.split("/");
+    const fileName = `${parts[parts.length - 1]}.prompt.yaml`;
+    if (parts.length > 1) {
+      const subDir = path.join(materializedDir, ...parts.slice(0, -1));
+      if (!fs.existsSync(subDir)) {
+        fs.mkdirSync(subDir, { recursive: true });
+      }
+    }
+    const filePath = path.join(materializedDir, ...parts.slice(0, -1), fileName);
+    const yamlContent = PromptConverter.fromMaterializedToYaml(prompt);
+    const yamlString = yaml.dump(yamlContent, {
+      lineWidth: -1,
+      noRefs: true,
+      sortKeys: false
+    });
+    fs.writeFileSync(filePath, yamlString);
+    return filePath;
+  }
+  static getLocalPromptFiles() {
+    const promptsDir = this.getPromptsDir();
+    const materializedDir = this.getMaterializedDir();
+    if (!fs.existsSync(promptsDir)) {
+      return [];
+    }
+    const files = [];
+    const walkDir = (dir, relativePath = "") => {
+      const entries = fs.readdirSync(dir, { withFileTypes: true });
+      for (const entry of entries) {
+        const fullPath = path.join(dir, entry.name);
+        const relativeFilePath = path.join(relativePath, entry.name);
+        if (entry.isDirectory()) {
+          if (fullPath === materializedDir) {
+            continue;
+          }
+          walkDir(fullPath, relativeFilePath);
+        } else if (entry.isFile() && entry.name.endsWith(".prompt.yaml")) {
+          files.push(path.join(promptsDir, relativeFilePath));
+        }
+      }
+    };
+    walkDir(promptsDir);
+    return files;
+  }
+  static promptNameFromPath(filePath) {
+    const promptsDir = this.getPromptsDir();
+    const relativePath = path.relative(promptsDir, filePath);
+    return relativePath.replace(/\.prompt\.yaml$/, "");
+  }
+  static cleanupOrphanedMaterializedFiles(currentDependencies) {
+    const materializedDir = this.getMaterializedDir();
+    if (!fs.existsSync(materializedDir)) {
+      return [];
+    }
+    const cleaned = [];
+    const cleanupDir = (dir, relativePath = "") => {
+      const entries = fs.readdirSync(dir, { withFileTypes: true });
+      for (const entry of entries) {
+        const fullPath = path.join(dir, entry.name);
+        const relativeFilePath = path.join(relativePath, entry.name);
+        if (entry.isDirectory()) {
+          cleanupDir(fullPath, relativeFilePath);
+          try {
+            const dirEntries = fs.readdirSync(fullPath);
+            if (dirEntries.length === 0) {
+              fs.rmdirSync(fullPath);
+            }
+          } catch (e) {
+          }
+        } else if (entry.isFile() && entry.name.endsWith(".prompt.yaml")) {
+          const promptName = relativeFilePath.replace(/\.prompt\.yaml$/, "");
+          if (!currentDependencies.has(promptName)) {
+            fs.unlinkSync(fullPath);
+            cleaned.push(promptName);
+          }
+        }
+      }
+    };
+    cleanupDir(materializedDir);
+    return cleaned;
+  }
+  static updateLockEntry(lock, name, prompt, materializedPath) {
+    const relativePath = path.relative(process.cwd(), materializedPath);
+    lock.prompts[name] = {
+      version: prompt.version,
+      versionId: prompt.versionId,
+      materialized: relativePath
+    };
+  }
+  static removeFromLock(lock, names) {
+    for (const name of names) {
+      delete lock.prompts[name];
+    }
+  }
+  static addToGitignore(entry) {
+    const gitignorePath = path.join(process.cwd(), ".gitignore");
+    if (!fs.existsSync(gitignorePath)) {
+      fs.writeFileSync(gitignorePath, `${entry}
+`);
+      return { added: true, existed: false };
+    }
+    const content = fs.readFileSync(gitignorePath, "utf-8");
+    const lines = content.split("\n").map((line) => line.trim());
+    if (lines.includes(entry)) {
+      return { added: false, existed: true };
+    }
+    const newContent = content.endsWith("\n") ? `${content}${entry}
+` : `${content}
+${entry}
+`;
+    fs.writeFileSync(gitignorePath, newContent);
+    return { added: true, existed: false };
+  }
+};
+FileManager.PROMPTS_CONFIG_FILE = "prompts.json";
+FileManager.PROMPTS_LOCK_FILE = "prompts-lock.json";
+FileManager.PROMPTS_DIR = "prompts";
+FileManager.MATERIALIZED_DIR = ".materialized";
+
+export {
+  FileManager
+};
+//# sourceMappingURL=chunk-3GKPQB4R.mjs.map

package/dist/chunk-3GKPQB4R.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/cli/utils/fileManager.ts"],"sourcesContent":["import * as fs from \"fs\";\nimport * as path from \"path\";\nimport * as yaml from \"js-yaml\";\nimport chalk from \"chalk\";\nimport { z } from \"zod\";\nimport type { PromptsConfig, LocalPromptConfig, MaterializedPrompt, PromptsLock, PromptsLockEntry } from \"../types\";\nimport { localPromptConfigSchema } from \"../types\";\nimport { PromptConverter } from \"../../prompt/converter\";\n\nexport class FileManager {\n  private static readonly PROMPTS_CONFIG_FILE = \"prompts.json\";\n  private static readonly PROMPTS_LOCK_FILE = \"prompts-lock.json\";\n  private static readonly PROMPTS_DIR = \"prompts\";\n  private static readonly MATERIALIZED_DIR = \".materialized\";\n\n  static getPromptsConfigPath(): string {\n    return path.join(process.cwd(), this.PROMPTS_CONFIG_FILE);\n  }\n\n  static getPromptsLockPath(): string {\n    return path.join(process.cwd(), this.PROMPTS_LOCK_FILE);\n  }\n\n  static getPromptsDir(): string {\n    return path.join(process.cwd(), this.PROMPTS_DIR);\n  }\n\n  static getMaterializedDir(): string {\n    return path.join(this.getPromptsDir(), this.MATERIALIZED_DIR);\n  }\n\n  static ensureDirectories(): void {\n    const promptsDir = this.getPromptsDir();\n    const materializedDir = this.getMaterializedDir();\n\n    if (!fs.existsSync(promptsDir)) {\n      fs.mkdirSync(promptsDir, { recursive: true });\n    }\n\n    if (!fs.existsSync(materializedDir)) {\n      fs.mkdirSync(materializedDir, { recursive: true });\n    }\n  }\n\n  static loadPromptsConfig(): PromptsConfig {\n    const configPath = this.getPromptsConfigPath();\n\n    if (!fs.existsSync(configPath)) {\n      return { prompts: {} };\n    }\n\n    try {\n      const content = fs.readFileSync(configPath, \"utf-8\");\n      return JSON.parse(content) as PromptsConfig;\n    } catch (error) {\n      throw new Error(`Failed to parse prompts.json: ${error instanceof Error ? error.message : \"Unknown error\"}`);\n    }\n  }\n\n  static savePromptsConfig(config: PromptsConfig): void {\n    const configPath = this.getPromptsConfigPath();\n    fs.writeFileSync(configPath, JSON.stringify(config, null, 2) + \"\\n\");\n  }\n\n  static initializePromptsConfig(): { created: boolean; path: string } {\n    const configPath = this.getPromptsConfigPath();\n    const existed = fs.existsSync(configPath);\n\n    if (!existed) {\n      const emptyConfig: PromptsConfig = { prompts: {} };\n      this.savePromptsConfig(emptyConfig);\n      return { created: true, path: configPath };\n    }\n\n    return { created: false, path: configPath };\n  }\n\n  static loadPromptsLock(): PromptsLock {\n    const lockPath = this.getPromptsLockPath();\n\n    if (!fs.existsSync(lockPath)) {\n      return {\n        lockfileVersion: 1,\n        prompts: {}\n      };\n    }\n\n    try {\n      const content = fs.readFileSync(lockPath, \"utf-8\");\n      return JSON.parse(content) as PromptsLock;\n    } catch (error) {\n      throw new Error(`Failed to parse prompts-lock.json: ${error instanceof Error ? error.message : \"Unknown error\"}`);\n    }\n  }\n\n  static savePromptsLock(lock: PromptsLock): void {\n    const lockPath = this.getPromptsLockPath();\n    fs.writeFileSync(lockPath, JSON.stringify(lock, null, 2) + \"\\n\");\n  }\n\n  static initializePromptsLock(): { created: boolean; path: string } {\n    const lockPath = this.getPromptsLockPath();\n    const existed = fs.existsSync(lockPath);\n\n    if (!existed) {\n      const emptyLock: PromptsLock = {\n        lockfileVersion: 1,\n        prompts: {}\n      };\n      this.savePromptsLock(emptyLock);\n      return { created: true, path: lockPath };\n    }\n\n    return { created: false, path: lockPath };\n  }\n\n  static loadLocalPrompt(filePath: string): LocalPromptConfig {\n    const fullPath = path.resolve(filePath);\n\n    if (!fs.existsSync(fullPath)) {\n      throw new Error(`Local prompt file not found: ${filePath}`);\n    }\n\n    try {\n      const content = fs.readFileSync(fullPath, \"utf-8\");\n      const rawData = yaml.load(content);\n\n      // Validate with zod and provide nice error messages\n      const result = localPromptConfigSchema.safeParse(rawData);\n\n            if (!result.success) {\n        // Format zod errors nicely (manually since z.prettifyError might not be available)\n        const prettyError = result.error.issues\n          .map(issue => `✖ ${issue.message}${issue.path.length > 0 ? `\\n  → at ${issue.path.join('.')}` : ''}`)\n          .join('\\n');\n\n        throw new Error(\n          `Invalid prompt configuration in ${chalk.yellow(filePath)}:\\n${prettyError}`\n        );\n      }\n\n      return result.data;\n    } catch (error) {\n      if (error instanceof Error && error.message.includes(\"Invalid prompt configuration\")) {\n        throw error; // Re-throw zod validation errors as-is\n      }\n      throw new Error(`Failed to parse local prompt file ${filePath}: ${error instanceof Error ? error.message : \"Unknown error\"}`);\n    }\n  }\n\n    static saveMaterializedPrompt(name: string, prompt: MaterializedPrompt): string {\n    const materializedDir = this.getMaterializedDir();\n    const parts = name.split(\"/\");\n    const fileName = `${parts[parts.length - 1]}.prompt.yaml`;\n\n    // Create nested directories if needed\n    if (parts.length > 1) {\n      const subDir = path.join(materializedDir, ...parts.slice(0, -1));\n      if (!fs.existsSync(subDir)) {\n        fs.mkdirSync(subDir, { recursive: true });\n      }\n    }\n\n    const filePath = path.join(materializedDir, ...parts.slice(0, -1), fileName);\n\n    // Convert to YAML format using the converter\n    const yamlContent = PromptConverter.fromMaterializedToYaml(prompt);\n\n    const yamlString = yaml.dump(yamlContent, {\n      lineWidth: -1,\n      noRefs: true,\n      sortKeys: false\n    });\n\n    fs.writeFileSync(filePath, yamlString);\n    return filePath;\n  }\n\n  static getLocalPromptFiles(): string[] {\n    const promptsDir = this.getPromptsDir();\n    const materializedDir = this.getMaterializedDir();\n\n    if (!fs.existsSync(promptsDir)) {\n      return [];\n    }\n\n    const files: string[] = [];\n\n    const walkDir = (dir: string, relativePath = \"\"): void => {\n      const entries = fs.readdirSync(dir, { withFileTypes: true });\n\n      for (const entry of entries) {\n        const fullPath = path.join(dir, entry.name);\n        const relativeFilePath = path.join(relativePath, entry.name);\n\n        if (entry.isDirectory()) {\n          // Skip the .materialized directory\n          if (fullPath === materializedDir) {\n            continue;\n          }\n          walkDir(fullPath, relativeFilePath);\n        } else if (entry.isFile() && entry.name.endsWith(\".prompt.yaml\")) {\n          files.push(path.join(promptsDir, relativeFilePath));\n        }\n      }\n    };\n\n    walkDir(promptsDir);\n    return files;\n  }\n\n  static promptNameFromPath(filePath: string): string {\n    const promptsDir = this.getPromptsDir();\n    const relativePath = path.relative(promptsDir, filePath);\n    return relativePath.replace(/\\.prompt\\.yaml$/, \"\");\n  }\n\n  static cleanupOrphanedMaterializedFiles(currentDependencies: Set<string>): string[] {\n    const materializedDir = this.getMaterializedDir();\n\n    if (!fs.existsSync(materializedDir)) {\n      return [];\n    }\n\n    const cleaned: string[] = [];\n\n    const cleanupDir = (dir: string, relativePath = \"\"): void => {\n      const entries = fs.readdirSync(dir, { withFileTypes: true });\n\n      for (const entry of entries) {\n        const fullPath = path.join(dir, entry.name);\n        const relativeFilePath = path.join(relativePath, entry.name);\n\n        if (entry.isDirectory()) {\n          cleanupDir(fullPath, relativeFilePath);\n\n          // Remove empty directories\n          try {\n            const dirEntries = fs.readdirSync(fullPath);\n            if (dirEntries.length === 0) {\n              fs.rmdirSync(fullPath);\n            }\n          } catch {\n            // Directory not empty or other error, ignore\n          }\n        } else if (entry.isFile() && entry.name.endsWith(\".prompt.yaml\")) {\n          // Extract prompt name from materialized file path\n          const promptName = relativeFilePath.replace(/\\.prompt\\.yaml$/, \"\");\n\n          if (!currentDependencies.has(promptName)) {\n            fs.unlinkSync(fullPath);\n            cleaned.push(promptName);\n          }\n        }\n      }\n    };\n\n    cleanupDir(materializedDir);\n    return cleaned;\n  }\n\n  static updateLockEntry(lock: PromptsLock, name: string, prompt: MaterializedPrompt, materializedPath: string): void {\n    const relativePath = path.relative(process.cwd(), materializedPath);\n\n    lock.prompts[name] = {\n      version: prompt.version,\n      versionId: prompt.versionId,\n      materialized: relativePath,\n    };\n  }\n\n  static removeFromLock(lock: PromptsLock, names: string[]): void {\n    for (const name of names) {\n      delete lock.prompts[name];\n    }\n  }\n\n  static addToGitignore(entry: string): { added: boolean; existed: boolean } {\n    const gitignorePath = path.join(process.cwd(), \".gitignore\");\n\n    // Check if .gitignore exists\n    if (!fs.existsSync(gitignorePath)) {\n      // Create new .gitignore with the entry\n      fs.writeFileSync(gitignorePath, `${entry}\\n`);\n      return { added: true, existed: false };\n    }\n\n    // Read existing .gitignore\n    const content = fs.readFileSync(gitignorePath, \"utf-8\");\n    const lines = content.split(\"\\n\").map(line => line.trim());\n\n    // Check if entry already exists\n    if (lines.includes(entry)) {\n      return { added: false, existed: true };\n    }\n\n    // Add entry to .gitignore\n    const newContent = content.endsWith(\"\\n\") ? `${content}${entry}\\n` : `${content}\\n${entry}\\n`;\n    fs.writeFileSync(gitignorePath, newContent);\n\n    return { added: true, existed: false };\n  }\n}"],"mappings":"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","names":[]}

package/dist/chunk-4NRLVT2U.mjs

@@ -0,0 +1,35 @@
+// src/cli/types.ts
+import { z } from "zod";
+var localPromptConfigSchema = z.object({
+  model: z.string().min(1, "Model is required"),
+  modelParameters: z.object({
+    temperature: z.number().optional(),
+    max_tokens: z.number().optional()
+  }).loose().optional(),
+  messages: z.array(
+    z.object({
+      role: z.enum(["system", "user", "assistant"]),
+      content: z.string().min(1, "Message content cannot be empty")
+    }).loose()
+  ).min(1, "At least one message is required")
+}).loose();
+var parsePromptSpec = (spec) => {
+  const atIndex = spec.lastIndexOf("@");
+  if (atIndex === -1) {
+    return { name: spec, version: "latest" };
+  }
+  const name = spec.slice(0, atIndex);
+  const version = spec.slice(atIndex + 1);
+  if (!name || !version) {
+    throw new Error(
+      `Invalid prompt specification: ${spec}. Use format 'name@version' or just 'name'`
+    );
+  }
+  return { name, version };
+};
+
+export {
+  localPromptConfigSchema,
+  parsePromptSpec
+};
+//# sourceMappingURL=chunk-4NRLVT2U.mjs.map

package/dist/chunk-4NRLVT2U.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/cli/types.ts"],"sourcesContent":["import { z } from \"zod\";\n\nexport type PromptDependency =\n  | string\n  | {\n      version?: string;\n      file?: string;\n    };\n\nexport type PromptsConfig = {\n  prompts: Record<string, PromptDependency>;\n};\n\n// Zod schema for local prompt config with permissive validation\nexport const localPromptConfigSchema = z\n  .object({\n    model: z.string().min(1, \"Model is required\"),\n    modelParameters: z\n      .object({\n        temperature: z.number().optional(),\n        max_tokens: z.number().optional(),\n      })\n      .loose()\n      .optional(),\n    messages: z\n      .array(\n        z\n          .object({\n            role: z.enum([\"system\", \"user\", \"assistant\"]),\n            content: z.string().min(1, \"Message content cannot be empty\"),\n          })\n          .loose(),\n      )\n      .min(1, \"At least one message is required\"),\n  })\n  .loose();\n\nexport type LocalPromptConfig = z.infer<typeof localPromptConfigSchema>;\n\nexport type MaterializedPrompt = {\n  id: string;\n  name: string;\n  version: number;\n  versionId: string;\n  model: string;\n  messages: Array<{\n    role: \"system\" | \"user\" | \"assistant\";\n    content: string;\n  }>;\n  prompt: string;\n  updatedAt: string;\n  versionCreatedAt: string;\n};\n\nexport type SyncResult = {\n  fetched: Array<{ name: string; version: number; versionSpec: string }>;\n  pushed: Array<{ name: string; version: number }>;\n  unchanged: string[];\n  cleaned: string[];\n  errors: Array<{ name: string; error: string }>;\n};\n\nexport type PromptsLockEntry = {\n  version: number;\n  versionId: string;\n  materialized: string;\n};\n\nexport type PromptsLock = {\n  lockfileVersion: number;\n  prompts: Record<string, PromptsLockEntry>;\n};\n\n// Parse npm-style version specifications like \"foo@latest\" or \"bar@5\"\nexport const parsePromptSpec = (\n  spec: string,\n): { name: string; version: string } => {\n  const atIndex = spec.lastIndexOf(\"@\");\n  if (atIndex === -1) {\n    return { name: spec, version: \"latest\" };\n  }\n\n  const name = spec.slice(0, atIndex);\n  const version = spec.slice(atIndex + 1);\n\n  if (!name || !version) {\n    throw new Error(\n      `Invalid prompt specification: ${spec}. Use format 'name@version' or just 'name'`,\n    );\n  }\n\n  return { name, version };\n};\n"],"mappings":";AAAA,SAAS,SAAS;AAcX,IAAM,0BAA0B,EACpC,OAAO;AAAA,EACN,OAAO,EAAE,OAAO,EAAE,IAAI,GAAG,mBAAmB;AAAA,EAC5C,iBAAiB,EACd,OAAO;AAAA,IACN,aAAa,EAAE,OAAO,EAAE,SAAS;AAAA,IACjC,YAAY,EAAE,OAAO,EAAE,SAAS;AAAA,EAClC,CAAC,EACA,MAAM,EACN,SAAS;AAAA,EACZ,UAAU,EACP;AAAA,IACC,EACG,OAAO;AAAA,MACN,MAAM,EAAE,KAAK,CAAC,UAAU,QAAQ,WAAW,CAAC;AAAA,MAC5C,SAAS,EAAE,OAAO,EAAE,IAAI,GAAG,iCAAiC;AAAA,IAC9D,CAAC,EACA,MAAM;AAAA,EACX,EACC,IAAI,GAAG,kCAAkC;AAC9C,CAAC,EACA,MAAM;AAuCF,IAAM,kBAAkB,CAC7B,SACsC;AACtC,QAAM,UAAU,KAAK,YAAY,GAAG;AACpC,MAAI,YAAY,IAAI;AAClB,WAAO,EAAE,MAAM,MAAM,SAAS,SAAS;AAAA,EACzC;AAEA,QAAM,OAAO,KAAK,MAAM,GAAG,OAAO;AAClC,QAAM,UAAU,KAAK,MAAM,UAAU,CAAC;AAEtC,MAAI,CAAC,QAAQ,CAAC,SAAS;AACrB,UAAM,IAAI;AAAA,MACR,iCAAiC,IAAI;AAAA,IACvC;AAAA,EACF;AAEA,SAAO,EAAE,MAAM,QAAQ;AACzB;","names":[]}

package/dist/{chunk-SVJ7SCGB.js → chunk-52GXX3MA.js}

@@ -16,9 +16,11 @@
 
 
 
+var _chunkDTEKFQ4Ujs = require('./chunk-DTEKFQ4U.js');
 
 
-var _chunkVJSOCNPAjs = require('./chunk-VJSOCNPA.js');
+
+var _chunkFJLK5CFLjs = require('./chunk-FJLK5CFL.js');
 
 // src/observability/trace.ts
 
@@ -68,7 +70,7 @@ function recordEvaluation(details, attributes) {
     var _a2;
     try {
       span.setType(details.isGuardrail ? "guardrail" : "evaluation");
-      span.addEvent(_chunkVJSOCNPAjs.ATTR_LANGWATCH_EVALUATION_CUSTOM, {
+      span.addEvent(_chunkDTEKFQ4Ujs.ATTR_LANGWATCH_EVALUATION_CUSTOM, {
         json_encoded_event: JSON.stringify({
           evaluation_id: (_a2 = details.evaluationId) != null ? _a2 : `eval_${_xksuid.generate.call(void 0, )}`,
           name: details.name,
@@ -180,10 +182,10 @@ var LangWatchSpanImpl = class {
     if (body.role === void 0) {
       body.role = "system";
     }
-    this.span.addEvent(_chunkVJSOCNPAjs.LOG_EVNT_GEN_AI_SYSTEM_MESSAGE, _chunkVJSOCNPAjs.__spreadProps.call(void 0, _chunkVJSOCNPAjs.__spreadValues.call(void 0, {}, attributes), {
+    this.span.addEvent(_chunkDTEKFQ4Ujs.LOG_EVNT_GEN_AI_SYSTEM_MESSAGE, _chunkFJLK5CFLjs.__spreadProps.call(void 0, _chunkFJLK5CFLjs.__spreadValues.call(void 0, {}, attributes), {
       [_incubating2.default.ATTR_GEN_AI_SYSTEM]: system,
-      [_chunkVJSOCNPAjs.ATTR_LANGWATCH_GEN_AI_LOG_EVENT_BODY]: JSON.stringify(body),
-      [_chunkVJSOCNPAjs.ATTR_LANGWATCH_GEN_AI_LOG_EVENT_IMPOSTER]: true
+      [_chunkDTEKFQ4Ujs.ATTR_LANGWATCH_GEN_AI_LOG_EVENT_BODY]: JSON.stringify(body),
+      [_chunkDTEKFQ4Ujs.ATTR_LANGWATCH_GEN_AI_LOG_EVENT_IMPOSTER]: true
     }));
     return this;
   }
@@ -191,10 +193,10 @@ var LangWatchSpanImpl = class {
     if (body.role === void 0) {
       body.role = "user";
     }
-    this.span.addEvent(_chunkVJSOCNPAjs.LOG_EVNT_GEN_AI_USER_MESSAGE, _chunkVJSOCNPAjs.__spreadProps.call(void 0, _chunkVJSOCNPAjs.__spreadValues.call(void 0, {}, attributes), {
+    this.span.addEvent(_chunkDTEKFQ4Ujs.LOG_EVNT_GEN_AI_USER_MESSAGE, _chunkFJLK5CFLjs.__spreadProps.call(void 0, _chunkFJLK5CFLjs.__spreadValues.call(void 0, {}, attributes), {
       [_incubating2.default.ATTR_GEN_AI_SYSTEM]: system,
-      [_chunkVJSOCNPAjs.ATTR_LANGWATCH_GEN_AI_LOG_EVENT_BODY]: JSON.stringify(body),
-      [_chunkVJSOCNPAjs.ATTR_LANGWATCH_GEN_AI_LOG_EVENT_IMPOSTER]: true
+      [_chunkDTEKFQ4Ujs.ATTR_LANGWATCH_GEN_AI_LOG_EVENT_BODY]: JSON.stringify(body),
+      [_chunkDTEKFQ4Ujs.ATTR_LANGWATCH_GEN_AI_LOG_EVENT_IMPOSTER]: true
     }));
     return this;
   }
@@ -202,10 +204,10 @@ var LangWatchSpanImpl = class {
     if (body.role === void 0) {
       body.role = "assistant";
     }
-    this.span.addEvent(_chunkVJSOCNPAjs.LOG_EVNT_GEN_AI_ASSISTANT_MESSAGE, _chunkVJSOCNPAjs.__spreadProps.call(void 0, _chunkVJSOCNPAjs.__spreadValues.call(void 0, {}, attributes), {
+    this.span.addEvent(_chunkDTEKFQ4Ujs.LOG_EVNT_GEN_AI_ASSISTANT_MESSAGE, _chunkFJLK5CFLjs.__spreadProps.call(void 0, _chunkFJLK5CFLjs.__spreadValues.call(void 0, {}, attributes), {
       [_incubating2.default.ATTR_GEN_AI_SYSTEM]: system,
-      [_chunkVJSOCNPAjs.ATTR_LANGWATCH_GEN_AI_LOG_EVENT_BODY]: JSON.stringify(body),
-      [_chunkVJSOCNPAjs.ATTR_LANGWATCH_GEN_AI_LOG_EVENT_IMPOSTER]: true
+      [_chunkDTEKFQ4Ujs.ATTR_LANGWATCH_GEN_AI_LOG_EVENT_BODY]: JSON.stringify(body),
+      [_chunkDTEKFQ4Ujs.ATTR_LANGWATCH_GEN_AI_LOG_EVENT_IMPOSTER]: true
     }));
     return this;
   }
@@ -213,10 +215,10 @@ var LangWatchSpanImpl = class {
     if (body.role === void 0) {
       body.role = "tool";
     }
-    this.span.addEvent(_chunkVJSOCNPAjs.LOG_EVNT_GEN_AI_TOOL_MESSAGE, _chunkVJSOCNPAjs.__spreadProps.call(void 0, _chunkVJSOCNPAjs.__spreadValues.call(void 0, {}, attributes), {
+    this.span.addEvent(_chunkDTEKFQ4Ujs.LOG_EVNT_GEN_AI_TOOL_MESSAGE, _chunkFJLK5CFLjs.__spreadProps.call(void 0, _chunkFJLK5CFLjs.__spreadValues.call(void 0, {}, attributes), {
       [_incubating2.default.ATTR_GEN_AI_SYSTEM]: system,
-      [_chunkVJSOCNPAjs.ATTR_LANGWATCH_GEN_AI_LOG_EVENT_BODY]: JSON.stringify(body),
-      [_chunkVJSOCNPAjs.ATTR_LANGWATCH_GEN_AI_LOG_EVENT_IMPOSTER]: true
+      [_chunkDTEKFQ4Ujs.ATTR_LANGWATCH_GEN_AI_LOG_EVENT_BODY]: JSON.stringify(body),
+      [_chunkDTEKFQ4Ujs.ATTR_LANGWATCH_GEN_AI_LOG_EVENT_IMPOSTER]: true
     }));
     return this;
   }
@@ -224,15 +226,15 @@ var LangWatchSpanImpl = class {
     if (body.message && body.message.role === void 0) {
       body.message.role = "assistant";
     }
-    this.span.addEvent(_chunkVJSOCNPAjs.LOG_EVNT_GEN_AI_CHOICE, _chunkVJSOCNPAjs.__spreadProps.call(void 0, _chunkVJSOCNPAjs.__spreadValues.call(void 0, {}, attributes), {
+    this.span.addEvent(_chunkDTEKFQ4Ujs.LOG_EVNT_GEN_AI_CHOICE, _chunkFJLK5CFLjs.__spreadProps.call(void 0, _chunkFJLK5CFLjs.__spreadValues.call(void 0, {}, attributes), {
       [_incubating2.default.ATTR_GEN_AI_SYSTEM]: system,
-      [_chunkVJSOCNPAjs.ATTR_LANGWATCH_GEN_AI_LOG_EVENT_BODY]: JSON.stringify(body),
-      [_chunkVJSOCNPAjs.ATTR_LANGWATCH_GEN_AI_LOG_EVENT_IMPOSTER]: true
+      [_chunkDTEKFQ4Ujs.ATTR_LANGWATCH_GEN_AI_LOG_EVENT_BODY]: JSON.stringify(body),
+      [_chunkDTEKFQ4Ujs.ATTR_LANGWATCH_GEN_AI_LOG_EVENT_IMPOSTER]: true
     }));
     return this;
   }
   setType(type) {
-    this.span.setAttribute(_chunkVJSOCNPAjs.ATTR_LANGWATCH_SPAN_TYPE, type);
+    this.span.setAttribute(_chunkDTEKFQ4Ujs.ATTR_LANGWATCH_SPAN_TYPE, type);
     return this;
   }
   setRequestModel(model) {
@@ -245,7 +247,7 @@ var LangWatchSpanImpl = class {
   }
   setRAGContexts(ragContexts) {
     this.span.setAttribute(
-      _chunkVJSOCNPAjs.ATTR_LANGWATCH_RAG_CONTEXTS,
+      _chunkDTEKFQ4Ujs.ATTR_LANGWATCH_RAG_CONTEXTS,
       JSON.stringify({
         type: "json",
         value: ragContexts
@@ -255,7 +257,7 @@ var LangWatchSpanImpl = class {
   }
   setRAGContext(ragContext) {
     this.span.setAttribute(
-      _chunkVJSOCNPAjs.ATTR_LANGWATCH_RAG_CONTEXTS,
+      _chunkDTEKFQ4Ujs.ATTR_LANGWATCH_RAG_CONTEXTS,
       JSON.stringify({
         type: "json",
         value: [ragContext]
@@ -265,7 +267,7 @@ var LangWatchSpanImpl = class {
   }
   setMetrics(metrics) {
     this.span.setAttribute(
-      _chunkVJSOCNPAjs.ATTR_LANGWATCH_METRICS,
+      _chunkDTEKFQ4Ujs.ATTR_LANGWATCH_METRICS,
       JSON.stringify({
         type: "json",
         value: metrics
@@ -275,16 +277,16 @@ var LangWatchSpanImpl = class {
   }
   setSelectedPrompt(prompt) {
     this.span.setAttributes({
-      [_chunkVJSOCNPAjs.ATTR_LANGWATCH_PROMPT_SELECTED_ID]: prompt.id,
-      [_chunkVJSOCNPAjs.ATTR_LANGWATCH_PROMPT_ID]: prompt.id,
-      [_chunkVJSOCNPAjs.ATTR_LANGWATCH_PROMPT_VERSION_ID]: prompt.versionId,
-      [_chunkVJSOCNPAjs.ATTR_LANGWATCH_PROMPT_VERSION_NUMBER]: prompt.version
+      [_chunkDTEKFQ4Ujs.ATTR_LANGWATCH_PROMPT_SELECTED_ID]: prompt.id,
+      [_chunkDTEKFQ4Ujs.ATTR_LANGWATCH_PROMPT_ID]: prompt.id,
+      [_chunkDTEKFQ4Ujs.ATTR_LANGWATCH_PROMPT_VERSION_ID]: prompt.versionId,
+      [_chunkDTEKFQ4Ujs.ATTR_LANGWATCH_PROMPT_VERSION_NUMBER]: prompt.version
     });
     return this;
   }
   setInput(input) {
     this.span.setAttribute(
-      _chunkVJSOCNPAjs.ATTR_LANGWATCH_INPUT,
+      _chunkDTEKFQ4Ujs.ATTR_LANGWATCH_INPUT,
       JSON.stringify({
         type: "json",
         value: input
@@ -294,7 +296,7 @@ var LangWatchSpanImpl = class {
   }
   setInputString(input) {
     this.span.setAttribute(
-      _chunkVJSOCNPAjs.ATTR_LANGWATCH_INPUT,
+      _chunkDTEKFQ4Ujs.ATTR_LANGWATCH_INPUT,
       JSON.stringify({
         type: "text",
         value: input
@@ -304,7 +306,7 @@ var LangWatchSpanImpl = class {
   }
   setOutput(output) {
     this.span.setAttribute(
-      _chunkVJSOCNPAjs.ATTR_LANGWATCH_OUTPUT,
+      _chunkDTEKFQ4Ujs.ATTR_LANGWATCH_OUTPUT,
       JSON.stringify({
         type: "json",
         value: output
@@ -314,7 +316,7 @@ var LangWatchSpanImpl = class {
   }
   setOutputString(output) {
     this.span.setAttribute(
-      _chunkVJSOCNPAjs.ATTR_LANGWATCH_OUTPUT,
+      _chunkDTEKFQ4Ujs.ATTR_LANGWATCH_OUTPUT,
       JSON.stringify({
         type: "text",
         value: output
@@ -324,7 +326,7 @@ var LangWatchSpanImpl = class {
   }
   setOutputEvaluation(guardrail, output) {
     this.span.setAttribute(
-      _chunkVJSOCNPAjs.ATTR_LANGWATCH_OUTPUT,
+      _chunkDTEKFQ4Ujs.ATTR_LANGWATCH_OUTPUT,
       JSON.stringify({
         type: guardrail ? "guardrail_result" : "evaluation_result",
         value: output
@@ -421,4 +423,4 @@ function getLangWatchTracer(name, version) {
 
 
 exports.getLangWatchTracer = getLangWatchTracer; exports.tracer = tracer; exports.recordEvaluation = recordEvaluation; exports.spanTypes = spanTypes; exports.createLangWatchSpan = createLangWatchSpan;
-//# sourceMappingURL=chunk-SVJ7SCGB.js.map
+//# sourceMappingURL=chunk-52GXX3MA.js.map

package/dist/chunk-52GXX3MA.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["/home/runner/work/langwatch/langwatch/typescript-sdk/dist/chunk-52GXX3MA.js","../src/observability/trace.ts","../src/observability/span.ts","../src/evaluation/record-evaluation.ts","../src/evaluation/tracer.ts"],"names":["_a"],"mappings":"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","file":"/home/runner/work/langwatch/langwatch/typescript-sdk/dist/chunk-52GXX3MA.js","sourcesContent":[null,"import {\n  trace as otelTrace,\n  Tracer,\n  Span,\n  SpanOptions,\n  Context,\n  SpanStatusCode,\n} from \"@opentelemetry/api\";\nimport { LangWatchSpan, createLangWatchSpan } from \"./span\";\n\n/**\n * LangWatch OpenTelemetry Tracing Extensions\n *\n * This module provides wrappers and helpers for OpenTelemetry Tracer and Span objects,\n * adding ergonomic methods for LLM/GenAI observability and structured tracing.\n *\n * @module trace\n */\nexport interface LangWatchTracer extends Tracer {\n  /**\n   * Starts a new {@link LangWatchSpan}. Start the span without setting it on context.\n   *\n   * This method does NOT modify the current Context.\n   *\n   * @param name The name of the span\n   * @param [options] SpanOptions used for span creation\n   * @param [context] Context to use to extract parent\n   * @returns LangWatchSpan The newly created span\n   *\n   * @example\n   *     const span = tracer.startSpan('op');\n   *     span.setAttribute('key', 'value');\n   *     span.end();\n   */\n  startSpan(\n    name: string,\n    options?: SpanOptions,\n    context?: Context,\n  ): LangWatchSpan;\n\n  /**\n   * Starts a new {@link LangWatchSpan} and calls the given function passing it the\n   * created span as first argument.\n   * Additionally the new span gets set in context and this context is activated\n   * for the duration of the function call.\n   *\n   * @param name The name of the span\n   * @param [options] SpanOptions used for span creation\n   * @param [context] Context to use to extract parent\n   * @param fn function called in the context of the span and receives the newly created span as an argument\n   * @returns return value of fn\n   *\n   * @example\n   *     const result = tracer.startActiveSpan('op', span => {\n   *       try {\n   *         // do some work\n   *         span.setStatus({code: SpanStatusCode.OK});\n   *         return something;\n   *       } catch (err) {\n   *         span.setStatus({\n   *           code: SpanStatusCode.ERROR,\n   *           message: err.message,\n   *         });\n   *         throw err;\n   *       } finally {\n   *         span.end();\n   *       }\n   *     });\n   *\n   * @example\n   *     const span = tracer.startActiveSpan('op', span => {\n   *       try {\n   *         do some work\n   *         return span;\n   *       } catch (err) {\n   *         span.setStatus({\n   *           code: SpanStatusCode.ERROR,\n   *           message: err.message,\n   *         });\n   *         throw err;\n   *       }\n   *     });\n   *     do some more work\n   *     span.end();\n   */\n  startActiveSpan<F extends (span: LangWatchSpan) => unknown>(\n    name: string,\n    fn: F,\n  ): ReturnType<F>;\n  startActiveSpan<F extends (span: LangWatchSpan) => unknown>(\n    name: string,\n    options: SpanOptions,\n    fn: F,\n  ): ReturnType<F>;\n  startActiveSpan<F extends (span: LangWatchSpan) => unknown>(\n    name: string,\n    options: SpanOptions,\n    context: Context,\n    fn: F,\n  ): ReturnType<F>;\n\n  /**\n   * Starts a new {@link LangWatchSpan}, runs the provided async function, and automatically handles\n   * error recording, status setting, and span ending. This is a safer and more ergonomic alternative\n   * to manually using try/catch/finally blocks with startActiveSpan.\n   *\n   * Overloads:\n   * - withActiveSpan(name, fn)\n   * - withActiveSpan(name, options, fn)\n   * - withActiveSpan(name, options, context, fn)\n   *\n   * @param name The name of the span\n   * @param options Optional SpanOptions for span creation\n   * @param context Optional Context to use to extract parent\n   * @param fn   The async function to execute within the span context. Receives the span as its first argument.\n   * @returns The return value of the provided function\n   *\n   * @example\n   *   await tracer.withActiveSpan('my-operation', async (span) => {\n   *     // ... your code ...\n   *   });\n   *\n   *   await tracer.withActiveSpan('my-operation', { attributes: { foo: 'bar' } }, async (span) => {\n   *     // ... your code ...\n   *   });\n   *\n   *   await tracer.withActiveSpan('my-operation', { attributes: { foo: 'bar' } }, myContext, async (span) => {\n   *     // ... your code ...\n   *   });\n   */\n  withActiveSpan<T>(\n    name: string,\n    fn: (span: LangWatchSpan) => Promise<T> | T\n  ): Promise<T>;\n  withActiveSpan<T>(\n    name: string,\n    options: SpanOptions,\n    fn: (span: LangWatchSpan) => Promise<T> | T\n  ): Promise<T>;\n  withActiveSpan<T>(\n    name: string,\n    options: SpanOptions,\n    context: Context,\n    fn: (span: LangWatchSpan) => Promise<T> | T\n  ): Promise<T>;\n}\n\n/**\n * Extension of OpenTelemetry's Tracer with LangWatch-specific helpers.\n *\n * This interface provides methods for starting spans and active spans that return LangWatchSpan objects,\n * which include ergonomic helpers for LLM/GenAI tracing.\n *\n * @example\n * import { getLangWatchTracer } from 'langwatch';\n * const tracer = getLangWatchTracer('my-service');\n * const span = tracer.startSpan('llm-call');\n * span.setType('llm').setInput('Prompt').setOutput('Completion');\n * span.end();\n *\n * tracer.startActiveSpan('llm-call', (span) => {\n *   span.setType('llm');\n *   // ...\n *   span.end();\n * });\n */\nexport function getLangWatchTracer(name: string, version?: string): LangWatchTracer {\n  const tracer = otelTrace.getTracer(name, version);\n\n  // Create a proxy for the tracer that intercepts the calls to startActiveSpan and\n  // startSpan, and wraps the span object with our custom LangWatchSpan.\n  const handler: ProxyHandler<LangWatchTracer> = {\n    get(target, prop, _receiver) {\n      switch (prop) {\n        case \"startActiveSpan\": {\n          const startActiveSpan: StartActiveSpanOverloads = (\n            ...args: [\n              string,\n              SpanOptions?,\n              Context?,\n              ((span: Span) => unknown)?,\n            ]\n          ) => {\n            // Find the span callback function (usually the last argument!)\n            const fnIndex = args.findIndex((arg) => typeof arg === \"function\");\n            if (fnIndex === -1) {\n              throw new Error(\n                \"startActiveSpan requires a function as the last argument\",\n              );\n            }\n\n            // A type assertion is safe here due to the check above, but still sad 😥\n            const userFn = args[fnIndex] as (\n              span: Span,\n              ...rest: unknown[]\n            ) => unknown;\n\n            // Replace the function with one that wraps the span first\n            const spanWrapFunc = (...fnArgs: unknown[]) => {\n              const [span, ...rest] = fnArgs;\n              return userFn(createLangWatchSpan(span as Span), ...rest);\n            };\n\n            const newArgs = [...args];\n            newArgs[fnIndex] = spanWrapFunc;\n\n            // TypeScript can't infer the overload, but this is safe\n            return (\n              target.startActiveSpan as unknown as (\n                ...args: unknown[]\n              ) => unknown\n            )(...newArgs);\n          };\n          return startActiveSpan;\n        }\n\n        case \"startSpan\": {\n          return function (\n            ...args: Parameters<Tracer[\"startSpan\"]>\n          ): ReturnType<Tracer[\"startSpan\"]> {\n            const span = target.startSpan(...args);\n            return createLangWatchSpan(span);\n          };\n        }\n\n        case \"withActiveSpan\": {\n          /**\n           * Implementation of withActiveSpan: supports all overloads like startActiveSpan.\n           * Uses startActiveSpan to ensure context propagation for nested spans.\n           */\n          return async function withActiveSpan(...args: any[]): Promise<any> {\n            // Find the function argument (should be the last argument)\n            const fnIndex = args.findIndex((arg) => typeof arg === \"function\");\n            if (fnIndex === -1) {\n              throw new Error(\"withActiveSpan requires a function as the last argument\");\n            }\n            const userFn = args[fnIndex] as (span: LangWatchSpan) => Promise<any> | any;\n            // The preceding arguments are: name, options?, context?\n            const name = args[0];\n            const options = args.length > 2 ? args[1] : undefined;\n            const context = args.length > 3 ? args[2] : undefined;\n\n            return await new Promise((resolve, reject) => {\n              // Use startActiveSpan to ensure context propagation\n              const cb = async (span: Span) => {\n                const wrappedSpan = createLangWatchSpan(span);\n                try {\n                  resolve(await userFn(wrappedSpan));\n                } catch (err: any) {\n                  wrappedSpan.setStatus({\n                    code: SpanStatusCode.ERROR,\n                    message: err && err.message ? err.message : String(err),\n                  });\n                  wrappedSpan.recordException(err);\n                  reject(err);\n                } finally {\n                  wrappedSpan.end();\n                }\n              };\n              // Call the correct overload of startActiveSpan\n              if (context !== undefined) {\n                target.startActiveSpan(name, options, context, cb);\n              } else if (options !== undefined) {\n                target.startActiveSpan(name, options, cb);\n              } else {\n                target.startActiveSpan(name, cb);\n              }\n            });\n          };\n        }\n\n        default: {\n          const value = target[prop as keyof Tracer];\n          return typeof value === \"function\" ? value.bind(target) : value;\n        }\n      }\n    },\n  };\n\n  return new Proxy(tracer, handler) as LangWatchTracer;\n}\n\n/**\n * Helper type for the function overloads of startActiveSpan.\n *\n * This matches OpenTelemetry's Tracer interface and is used internally for type safety.\n */\ntype StartActiveSpanOverloads = {\n  <F extends (span: Span) => unknown>(name: string, fn: F): ReturnType<F>;\n  <F extends (span: Span) => unknown>(\n    name: string,\n    options: SpanOptions,\n    fn: F,\n  ): ReturnType<F>;\n  <F extends (span: Span) => unknown>(\n    name: string,\n    options: SpanOptions,\n    context: Context,\n    fn: F,\n  ): ReturnType<F>;\n};\n","import {\n  Attributes,\n  AttributeValue,\n  Span,\n  SpanContext,\n  SpanStatus,\n  Link,\n  Exception\n} from \"@opentelemetry/api\";\nimport semconv from \"@opentelemetry/semantic-conventions/incubating\";\nimport * as intSemconv from \"./semconv\";\nimport {\n  RecordedEvaluationDetails,\n  recordEvaluation,\n} from \"../evaluation/record-evaluation\";\nimport { EvaluationResultModel } from \"../evaluation/types\";\nimport { Prompt } from \"../prompt/prompt\";\n\n/**\n * Supported types of spans for LangWatch observability. These types categorize the nature of the span for downstream analysis and visualization.\n *\n * @example\n * import { spanTypes, SpanType } from './span';\n * const myType: SpanType = 'llm';\n */\nexport const spanTypes = [\n  \"span\",\n  \"llm\",\n  \"chain\",\n  \"tool\",\n  \"agent\",\n  \"guardrail\",\n  \"evaluation\",\n  \"rag\",\n  \"prompt\",\n  \"workflow\",\n  \"component\",\n  \"module\",\n  \"server\",\n  \"client\",\n  \"producer\",\n  \"consumer\",\n  \"task\",\n  \"unknown\",\n] as const;\n\nexport type SpanType = (typeof spanTypes)[number];\n\n/**\n * Context for a RAG (Retrieval-Augmented Generation) span.\n *\n * This structure is used to record which document and chunk were retrieved and used as context for a generation.\n *\n * @property document_id - Unique identifier for the source document.\n * @property chunk_id - Unique identifier for the chunk within the document.\n * @property content - The actual content of the chunk provided to the model.\n *\n * @example\n * const ragContext: LangWatchSpanRAGContext = {\n *   document_id: 'doc-123',\n *   chunk_id: 'chunk-456',\n *   content: 'Relevant passage from the document.'\n * };\n */\nexport interface LangWatchSpanRAGContext {\n  document_id: string;\n  chunk_id: string;\n  content: string;\n}\n\n/**\n * Metrics for a LangWatch span.\n *\n * @property promptTokens - The number of prompt tokens used.\n * @property completionTokens - The number of completion tokens used.\n * @property cost - The cost of the span.\n */\nexport interface LangWatchSpanMetrics {\n  /** The number of prompt tokens used */\n  promptTokens?: number;\n  /** The number of completion tokens used */\n  completionTokens?: number;\n  /** The cost of the span */\n  cost?: number;\n}\n\n/**\n * Body for a system message event in a GenAI span.\n *\n * Used to log system/instruction messages sent to the model.\n *\n * @property content - The message content.\n * @property role - The role of the message, typically 'system' or 'instruction'.\n *\n * @example\n * span.addGenAISystemMessageEvent({ content: 'You are a helpful assistant.' });\n */\nexport interface LangWatchSpanGenAISystemMessageEventBody {\n  /** Content of the system message */\n  content?: string;\n  /** Role of the message (system or instruction) */\n  role?: \"system\" | \"instruction\";\n}\n\n/**\n * Body for a user message event in a GenAI span.\n *\n * Used to log user/customer messages sent to the model.\n *\n * @property content - The message content.\n * @property role - The role of the message, typically 'user' or 'customer'.\n *\n * @example\n * span.addGenAIUserMessageEvent({ content: 'What is the weather today?' });\n */\nexport interface LangWatchSpanGenAIUserMessageEventBody {\n  /** Content of the user message */\n  content?: string;\n  /** Role of the message (user or customer) */\n  role?: \"user\" | \"customer\";\n}\n\n/**\n * Body for an assistant message event in a GenAI span.\n *\n * Used to log assistant/bot responses, including tool calls.\n *\n * @property content - The message content.\n * @property role - The role of the message, typically 'assistant' or 'bot'.\n * @property tool_calls - Array of tool call objects, if the assistant invoked tools/functions.\n *\n * @example\n * span.addGenAIAssistantMessageEvent({ content: 'The weather is sunny.', role: 'assistant' });\n */\nexport interface LangWatchSpanGenAIAssistantMessageEventBody {\n  /** Content of the assistant message */\n  content?: string;\n  /** Role of the message (assistant or bot) */\n  role?: \"assistant\" | \"bot\";\n  /** Tool calls made by the assistant */\n  tool_calls?: {\n    function: {\n      /** Name of the function called */\n      name: string;\n      /** Arguments passed to the function */\n      arguments?: string;\n    };\n    /** Tool call identifier */\n    id: string;\n    /** Type of tool call */\n    type: \"function\";\n  }[];\n}\n\n/**\n * Body for a tool message event in a GenAI span.\n *\n * Used to log messages from tools/functions invoked by the assistant.\n *\n * @property content - The message content.\n * @property id - Unique identifier for the tool call.\n * @property role - The role, typically 'tool' or 'function'.\n *\n * @example\n * span.addGenAIToolMessageEvent({ content: 'Result from tool', id: 'tool-1', role: 'tool' });\n */\nexport interface LangWatchSpanGenAIToolMessageEventBody {\n  /** Content of the tool message */\n  content?: string;\n  /** Tool call identifier */\n  id: string;\n  /** Role of the message (tool or function) */\n  role?: \"tool\" | \"function\";\n}\n\n/**\n * Body for a choice event in a GenAI span.\n *\n * Used to log the model's output choices, including finish reason and message content.\n *\n * @property finish_reason - Why the generation finished (e.g., 'stop', 'length').\n * @property index - Index of the choice (for multi-choice outputs).\n * @property message - The message content and tool calls for this choice.\n *\n * @example\n * span.addGenAIChoiceEvent({ finish_reason: 'stop', index: 0, message: { content: 'Hello!' } });\n */\nexport interface LangWatchSpanGenAIChoiceEventBody {\n  /** Reason the generation finished */\n  finish_reason: intSemconv.VAL_GEN_AI_FINISH_REASONS | (string & {});\n  /** Index of the choice */\n  index: number;\n  /** Message content for the choice */\n  message?: {\n    /** Content of the message */\n    content?: string;\n    /** Role of the message (assistant or bot) */\n    role?: \"assistant\" | \"bot\";\n    /** Tool calls made by the assistant */\n    tool_calls?: {\n      function: {\n        /** Name of the function called */\n        name: string;\n        /** Arguments passed to the function */\n        arguments?: string;\n      };\n      /** Tool call identifier */\n      id: string;\n      /** Type of tool call */\n      type: \"function\";\n    }[];\n  };\n}\n\n/**\n * Extension of OpenTelemetry's Span with LangWatch-specific helpers for LLM, RAG, and GenAI tracing.\n *\n * This interface provides ergonomic methods for recording structured LLM/GenAI data, such as inputs, outputs, RAG contexts, and message events.\n *\n * All methods return `this` for chaining.\n *\n * @example\n * const span = createLangWatchSpan(otelSpan);\n * span\n *   .setType('llm')\n *   .setInput({ prompt: 'Hello' })\n *   .setOutput('Hi!')\n *   .addGenAIUserMessageEvent({ content: 'Hello' })\n *   .addGenAIAssistantMessageEvent({ content: 'Hi!' });\n */\nexport interface LangWatchSpan extends Span {\n  /**\n   * Record the evaluation result for the span.\n   *\n   * @param details - The evaluation details\n   * @param attributes - Additional attributes to add to the evaluation span.\n   * @returns this\n   */\n  recordEvaluation(\n    details: RecordedEvaluationDetails,\n    attributes?: Attributes,\n  ): this;\n\n  /**\n   * Add a GenAI system message event to the span.\n   *\n   * This logs a system/instruction message sent to the model.\n   *\n   * @param body - The event body (content and role)\n   * @param system - The GenAI system (optional, e.g., 'openai', 'anthropic')\n   * @param attributes - Additional OpenTelemetry attributes (optional)\n   * @returns this\n   */\n  addGenAISystemMessageEvent(\n    body: LangWatchSpanGenAISystemMessageEventBody,\n    system?: intSemconv.VAL_GEN_AI_SYSTEMS | (string & {}),\n    attributes?: Record<string, AttributeValue>,\n  ): this;\n  /**\n   * Add a GenAI user message event to the span.\n   *\n   * This logs a user/customer message sent to the model.\n   *\n   * @param body - The event body (content and role)\n   * @param system - The GenAI system (optional)\n   * @param attributes - Additional OpenTelemetry attributes (optional)\n   * @returns this\n   */\n  addGenAIUserMessageEvent(\n    body: LangWatchSpanGenAIUserMessageEventBody,\n    system?: intSemconv.VAL_GEN_AI_SYSTEMS | (string & {}),\n    attributes?: Record<string, AttributeValue>,\n  ): this;\n  /**\n   * Add a GenAI assistant message event to the span.\n   *\n   * This logs an assistant/bot response, including tool calls if present.\n   *\n   * @param body - The event body (content, role, tool_calls)\n   * @param system - The GenAI system (optional)\n   * @param attributes - Additional OpenTelemetry attributes (optional)\n   * @returns this\n   */\n  addGenAIAssistantMessageEvent(\n    body: LangWatchSpanGenAIAssistantMessageEventBody,\n    system?: intSemconv.VAL_GEN_AI_SYSTEMS | (string & {}),\n    attributes?: Record<string, AttributeValue>,\n  ): this;\n  /**\n   * Add a GenAI tool message event to the span.\n   *\n   * This logs a message from a tool/function invoked by the assistant.\n   *\n   * @param body - The event body (content, id, role)\n   * @param system - The GenAI system (optional)\n   * @param attributes - Additional OpenTelemetry attributes (optional)\n   * @returns this\n   */\n  addGenAIToolMessageEvent(\n    body: LangWatchSpanGenAIToolMessageEventBody,\n    system?: intSemconv.VAL_GEN_AI_SYSTEMS | (string & {}),\n    attributes?: Record<string, AttributeValue>,\n  ): this;\n  /**\n   * Add a GenAI choice event to the span.\n   *\n   * This logs a model output choice, including finish reason and message content.\n   *\n   * @param body - The event body (finish_reason, index, message)\n   * @param system - The GenAI system (optional)\n   * @param attributes - Additional OpenTelemetry attributes (optional)\n   * @returns this\n   */\n  addGenAIChoiceEvent(\n    body: LangWatchSpanGenAIChoiceEventBody,\n    system?: intSemconv.VAL_GEN_AI_SYSTEMS | (string & {}),\n    attributes?: Record<string, AttributeValue>,\n  ): this;\n\n  /**\n   * Set the type of the span (e.g., 'llm', 'rag', 'tool', etc).\n   *\n   * This is used for downstream filtering and analytics.\n   *\n   * @param type - The span type (see SpanType)\n   * @returns this\n   */\n  setType(type: SpanType): this;\n\n  /**\n   * Set the request model name for the span.\n   *\n   * This is typically the model name sent in the API request (e.g., 'gpt-4', 'claude-3').\n   *\n   * @param model - The request model name\n   * @returns this\n   */\n  setRequestModel(model: string): this;\n  /**\n   * Set the response model name for the span.\n   *\n   * This is the model name returned in the API response, if different from the request.\n   *\n   * @param model - The response model name\n   * @returns this\n   */\n  setResponseModel(model: string): this;\n\n  /**\n   * Set multiple RAG contexts for the span.\n   *\n   * Use this to record all retrieved documents/chunks used as context for a generation.\n   *\n   * @param ragContexts - Array of RAG context objects\n   * @returns this\n   */\n  setRAGContexts(ragContexts: LangWatchSpanRAGContext[]): this;\n  /**\n   * Set a single RAG context for the span.\n   *\n   * Use this if only one context was retrieved.\n   *\n   * @param ragContext - The RAG context object\n   * @returns this\n   */\n  setRAGContext(ragContext: LangWatchSpanRAGContext): this;\n\n  /**\n   * Set the metrics for the span.\n   *\n   * @param metrics - The metrics object\n   * @returns this\n   */\n  setMetrics(metrics: LangWatchSpanMetrics): this;\n\n  /**\n   * Set the selected prompt for the span. This will attach this prompt to the trace. If\n   * this is set on multiple spans, the last one will be used.\n   *\n   * @param prompt - The prompt object\n   * @returns this\n   */\n  setSelectedPrompt(prompt: Prompt): this;\n\n  /**\n   * Record the input to the span as a JSON-serializable value.\n   *\n   * The input is stringified and stored as a span attribute for later analysis.\n   *\n   * @param input - The input value (any type, will be JSON.stringified)\n   * @returns this\n   */\n  setInput(input: unknown): this;\n  /**\n   * Record the input to the span as a plain string.\n   *\n   * Use this for raw text prompts or queries.\n   *\n   * @param input - The input string\n   * @returns this\n   */\n  setInputString(input: string): this;\n  /**\n   * Record the output from the span as a JSON-serializable value.\n   *\n   * The output is stringified and stored as a span attribute for later analysis.\n   *\n   * @param output - The output value (any type, will be JSON.stringified)\n   * @returns this\n   */\n  setOutput(output: unknown): this;\n  /**\n   * Record the output from the span as a plain string.\n   *\n   * Use this for raw text completions or responses.\n   *\n   * @param output - The output string\n   * @returns this\n   */\n  setOutputString(output: string): this;\n\n  /**\n   * Set the evaluation output for the span.\n   *\n   * @param guardrail - Whether the evaluation is a guardrail\n   * @param output - The evaluation result\n   * @returns this\n   */\n  setOutputEvaluation(guardrail: boolean, output: EvaluationResultModel): this;\n}\n\n/**\n * LangWatchSpan class that wraps an OpenTelemetry Span with LangWatch-specific helpers.\n *\n * This class provides a clean, type-safe wrapper around OpenTelemetry spans with\n * additional methods for LLM, RAG, and GenAI tracing. All methods support fluent API chaining.\n *\n * @example\n * import { createLangWatchSpan } from './span';\n * const otelSpan = tracer.startSpan('llm-call');\n * const span = createLangWatchSpan(otelSpan);\n * span.setType('llm').setInput('Prompt').setOutput('Completion');\n */\nclass LangWatchSpanImpl implements LangWatchSpan {\n  constructor(private span: Span) {}\n\n  // OpenTelemetry Span methods with fluent API support\n  setAttribute(key: string, value: AttributeValue): this {\n    this.span.setAttribute(key, value);\n    return this;\n  }\n\n  setAttributes(attributes: Attributes): this {\n    this.span.setAttributes(attributes);\n    return this;\n  }\n\n  addEvent(name: string, attributes?: Attributes): this {\n    this.span.addEvent(name, attributes);\n    return this;\n  }\n\n  recordException(exception: Exception): this {\n    this.span.recordException(exception);\n    return this;\n  }\n\n  setStatus(status: SpanStatus): this {\n    this.span.setStatus(status);\n    return this;\n  }\n\n  updateName(name: string): this {\n    this.span.updateName(name);\n    return this;\n  }\n\n  // Pass through other Span methods without chaining\n  end(endTime?: number): void {\n    this.span.end(endTime);\n  }\n\n  isRecording(): boolean {\n    return this.span.isRecording();\n  }\n\n  spanContext(): SpanContext {\n    return this.span.spanContext();\n  }\n\n  addLink(link: Link): this {\n    this.span.addLink(link);\n    return this;\n  }\n\n  addLinks(links: Link[]): this {\n    this.span.addLinks(links);\n    return this;\n  }\n\n  // LangWatch-specific methods\n  recordEvaluation(\n    details: RecordedEvaluationDetails,\n    attributes?: Attributes,\n  ): this {\n    recordEvaluation(details, attributes);\n    return this;\n  }\n\n  addGenAISystemMessageEvent(\n    body: LangWatchSpanGenAISystemMessageEventBody,\n    system?: intSemconv.VAL_GEN_AI_SYSTEMS | (string & {}),\n    attributes?: Record<string, AttributeValue>,\n  ): this {\n    if (body.role === void 0) {\n      body.role = \"system\";\n    }\n\n    this.span.addEvent(intSemconv.LOG_EVNT_GEN_AI_SYSTEM_MESSAGE, {\n      ...attributes,\n      [semconv.ATTR_GEN_AI_SYSTEM]: system,\n      [intSemconv.ATTR_LANGWATCH_GEN_AI_LOG_EVENT_BODY]: JSON.stringify(body),\n      [intSemconv.ATTR_LANGWATCH_GEN_AI_LOG_EVENT_IMPOSTER]: true,\n    });\n    return this;\n  }\n\n  addGenAIUserMessageEvent(\n    body: LangWatchSpanGenAIUserMessageEventBody,\n    system?: intSemconv.VAL_GEN_AI_SYSTEMS | (string & {}),\n    attributes?: Record<string, AttributeValue>,\n  ): this {\n    if (body.role === void 0) {\n      body.role = \"user\";\n    }\n\n    this.span.addEvent(intSemconv.LOG_EVNT_GEN_AI_USER_MESSAGE, {\n      ...attributes,\n      [semconv.ATTR_GEN_AI_SYSTEM]: system,\n      [intSemconv.ATTR_LANGWATCH_GEN_AI_LOG_EVENT_BODY]: JSON.stringify(body),\n      [intSemconv.ATTR_LANGWATCH_GEN_AI_LOG_EVENT_IMPOSTER]: true,\n    });\n    return this;\n  }\n\n  addGenAIAssistantMessageEvent(\n    body: LangWatchSpanGenAIAssistantMessageEventBody,\n    system?: intSemconv.VAL_GEN_AI_SYSTEMS | (string & {}),\n    attributes?: Record<string, AttributeValue>,\n  ): this {\n    if (body.role === void 0) {\n      body.role = \"assistant\";\n    }\n\n    this.span.addEvent(intSemconv.LOG_EVNT_GEN_AI_ASSISTANT_MESSAGE, {\n      ...attributes,\n      [semconv.ATTR_GEN_AI_SYSTEM]: system,\n      [intSemconv.ATTR_LANGWATCH_GEN_AI_LOG_EVENT_BODY]: JSON.stringify(body),\n      [intSemconv.ATTR_LANGWATCH_GEN_AI_LOG_EVENT_IMPOSTER]: true,\n    });\n    return this;\n  }\n\n  addGenAIToolMessageEvent(\n    body: LangWatchSpanGenAIToolMessageEventBody,\n    system?: intSemconv.VAL_GEN_AI_SYSTEMS | (string & {}),\n    attributes?: Record<string, AttributeValue>,\n  ): this {\n    if (body.role === void 0) {\n      body.role = \"tool\";\n    }\n\n    this.span.addEvent(intSemconv.LOG_EVNT_GEN_AI_TOOL_MESSAGE, {\n      ...attributes,\n      [semconv.ATTR_GEN_AI_SYSTEM]: system,\n      [intSemconv.ATTR_LANGWATCH_GEN_AI_LOG_EVENT_BODY]: JSON.stringify(body),\n      [intSemconv.ATTR_LANGWATCH_GEN_AI_LOG_EVENT_IMPOSTER]: true,\n    });\n    return this;\n  }\n\n  addGenAIChoiceEvent(\n    body: LangWatchSpanGenAIChoiceEventBody,\n    system?: intSemconv.VAL_GEN_AI_SYSTEMS | (string & {}),\n    attributes?: Record<string, AttributeValue>,\n  ): this {\n    if (body.message && body.message.role === void 0) {\n      body.message.role = \"assistant\";\n    }\n\n    this.span.addEvent(intSemconv.LOG_EVNT_GEN_AI_CHOICE, {\n      ...attributes,\n      [semconv.ATTR_GEN_AI_SYSTEM]: system,\n      [intSemconv.ATTR_LANGWATCH_GEN_AI_LOG_EVENT_BODY]: JSON.stringify(body),\n      [intSemconv.ATTR_LANGWATCH_GEN_AI_LOG_EVENT_IMPOSTER]: true,\n    });\n    return this;\n  }\n\n  setType(type: SpanType): this {\n    this.span.setAttribute(intSemconv.ATTR_LANGWATCH_SPAN_TYPE, type);\n    return this;\n  }\n\n  setRequestModel(model: string): this {\n    this.span.setAttribute(semconv.ATTR_GEN_AI_REQUEST_MODEL, model);\n    return this;\n  }\n\n  setResponseModel(model: string): this {\n    this.span.setAttribute(semconv.ATTR_GEN_AI_RESPONSE_MODEL, model);\n    return this;\n  }\n\n  setRAGContexts(ragContexts: LangWatchSpanRAGContext[]): this {\n    this.span.setAttribute(\n      intSemconv.ATTR_LANGWATCH_RAG_CONTEXTS,\n      JSON.stringify({\n        type: \"json\",\n        value: ragContexts,\n      }),\n    );\n    return this;\n  }\n\n  setRAGContext(ragContext: LangWatchSpanRAGContext): this {\n    this.span.setAttribute(\n      intSemconv.ATTR_LANGWATCH_RAG_CONTEXTS,\n      JSON.stringify({\n        type: \"json\",\n        value: [ragContext],\n      }),\n    );\n    return this;\n  }\n\n  setMetrics(metrics: LangWatchSpanMetrics): this {\n    this.span.setAttribute(\n      intSemconv.ATTR_LANGWATCH_METRICS,\n      JSON.stringify({\n        type: \"json\",\n        value: metrics,\n      }),\n    );\n    return this;\n  }\n\n  setSelectedPrompt(prompt: Prompt): this {\n    this.span.setAttributes({\n      [intSemconv.ATTR_LANGWATCH_PROMPT_SELECTED_ID]: prompt.id,\n      [intSemconv.ATTR_LANGWATCH_PROMPT_ID]: prompt.id,\n      [intSemconv.ATTR_LANGWATCH_PROMPT_VERSION_ID]: prompt.versionId,\n      [intSemconv.ATTR_LANGWATCH_PROMPT_VERSION_NUMBER]: prompt.version,\n    });\n    return this;\n  }\n\n  setInput(input: unknown): this {\n    this.span.setAttribute(\n      intSemconv.ATTR_LANGWATCH_INPUT,\n      JSON.stringify({\n        type: \"json\",\n        value: input,\n      }),\n    );\n    return this;\n  }\n\n  setInputString(input: string): this {\n    this.span.setAttribute(\n      intSemconv.ATTR_LANGWATCH_INPUT,\n      JSON.stringify({\n        type: \"text\",\n        value: input,\n      }),\n    );\n    return this;\n  }\n\n  setOutput(output: unknown): this {\n    this.span.setAttribute(\n      intSemconv.ATTR_LANGWATCH_OUTPUT,\n      JSON.stringify({\n        type: \"json\",\n        value: output,\n      }),\n    );\n    return this;\n  }\n\n  setOutputString(output: string): this {\n    this.span.setAttribute(\n      intSemconv.ATTR_LANGWATCH_OUTPUT,\n      JSON.stringify({\n        type: \"text\",\n        value: output,\n      }),\n    );\n    return this;\n  }\n\n  setOutputEvaluation(guardrail: boolean, output: EvaluationResultModel): this {\n    this.span.setAttribute(\n      intSemconv.ATTR_LANGWATCH_OUTPUT,\n      JSON.stringify({\n        type: guardrail ? \"guardrail_result\" : \"evaluation_result\",\n        value: output,\n      }),\n    );\n    return this;\n  }\n}\n\n/**\n * Creates a LangWatchSpan wrapper around an OpenTelemetry Span.\n *\n * @param span - The OpenTelemetry Span to wrap\n * @returns A LangWatchSpan with additional methods for LLM/GenAI observability\n *\n * @example\n * import { createLangWatchSpan } from './span';\n * const otelSpan = tracer.startSpan('llm-call');\n * const span = createLangWatchSpan(otelSpan);\n * span.setType('llm').setInput('Prompt').setOutput('Completion');\n */\nexport function createLangWatchSpan(span: Span): LangWatchSpan {\n  return new LangWatchSpanImpl(span);\n}\n","import { EvaluationRESTResult } from \"../internal/generated/types/evaluations\";\nimport * as intSemconv from \"../observability/semconv\";\nimport { Attributes, SpanStatusCode } from \"@opentelemetry/api\";\nimport { generate } from \"xksuid\";\nimport { tracer } from \"./tracer\";\n\nexport interface RecordedEvaluationDetails {\n  evaluationId?: string;\n  name: string;\n  type?: string;\n  isGuardrail?: boolean;\n  status?: \"processed\" | \"skipped\" | \"error\";\n  passed?: boolean;\n  score?: number;\n  label?: string;\n  details?: string;\n  cost?: number | { currency: string; amount: number };\n  error?: Error;\n  timestamps?: {\n    startedAtUnixMs: number;\n    finishedAtUnixMs: number;\n  };\n}\n\nexport function recordEvaluation(\n  details: RecordedEvaluationDetails,\n  attributes?: Attributes,\n) {\n  let result: EvaluationRESTResult;\n  const status = details.status || \"processed\";\n\n  if (status === \"skipped\") {\n    result = {\n      status: \"skipped\",\n      details: details.details,\n    };\n  } else if (status === \"error\") {\n    result = {\n      status: \"error\",\n      error_type: details.error?.name || \"Unknown\",\n      details: details.details || details.error?.message || \"Unknown error\",\n    };\n  } else {\n    result = {\n      status: \"processed\",\n      passed: details.passed,\n      score: details.score,\n      label: details.label,\n      details: details.details,\n    };\n    if (details.cost) {\n      (result as any).cost =\n        typeof details.cost === \"number\"\n          ? { currency: \"USD\", amount: details.cost }\n          : details.cost;\n    }\n  }\n\n  tracer.startActiveSpan(\"record evaluation\", (span) => {\n    try {\n      span.setType(details.isGuardrail ? \"guardrail\" : \"evaluation\");\n      span.addEvent(intSemconv.ATTR_LANGWATCH_EVALUATION_CUSTOM, {\n        json_encoded_event: JSON.stringify({\n          evaluation_id: details.evaluationId ?? `eval_${generate()}`,\n          name: details.name,\n          type: details.type,\n          is_guardrail: details.isGuardrail,\n          status: result.status,\n          passed: details.passed,\n          score: details.score,\n          label: details.label,\n          details: details.details,\n          cost: details.cost,\n          error: details.error,\n          timestamps: details.timestamps,\n        }),\n      });\n\n      span.setOutput(result);\n\n      if (attributes) {\n        span.setAttributes(attributes);\n      }\n      if (details.cost) {\n        span.setMetrics({\n          cost:\n            typeof details.cost === \"number\"\n              ? details.cost\n              : details.cost.amount,\n        });\n      }\n    } catch (error) {\n      span.recordException(error as Error);\n      span.setStatus({ code: SpanStatusCode.ERROR, message: (error as Error)?.message });\n    } finally {\n      span.end();\n    }\n\n    return;\n  });\n}\n","import { getLangWatchTracer } from \"../observability/trace\";\n\nexport const tracer = getLangWatchTracer(\"langwatch.evaluation\");\n"]}