langwatch 0.23.0 → 0.25.0

package/dist/chunk-ITK3APKC.js

@@ -0,0 +1,370 @@
+"use strict";Object.defineProperty(exports, "__esModule", {value: true}); function _interopRequireWildcard(obj) { if (obj && obj.__esModule) { return obj; } else { var newObj = {}; if (obj != null) { for (var key in obj) { if (Object.prototype.hasOwnProperty.call(obj, key)) { newObj[key] = obj[key]; } } } newObj.default = obj; return newObj; } } function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; }
+
+var _chunkAZHZ4NB4js = require('./chunk-AZHZ4NB4.js');
+
+
+var _chunkC5Y772G7js = require('./chunk-C5Y772G7.js');
+
+// src/cli/utils/promptConverter.ts
+var PromptConverter = class {
+  /**
+   * Converts a Prompt instance from the API service to the MaterializedPrompt format
+   * used for saving to the .materialized directory.
+   */
+  static fromApiToMaterialized(prompt) {
+    return {
+      id: prompt.id,
+      name: prompt.name,
+      version: prompt.version,
+      versionId: prompt.versionId,
+      model: prompt.model,
+      messages: prompt.messages,
+      prompt: prompt.prompt,
+      temperature: prompt.temperature,
+      maxTokens: prompt.maxTokens,
+      inputs: prompt.inputs,
+      outputs: prompt.outputs,
+      updatedAt: prompt.updatedAt
+    };
+  }
+  /**
+   * Converts a MaterializedPrompt to the YAML content structure
+   * for saving to .prompt.yaml files.
+   */
+  static fromMaterializedToYaml(prompt) {
+    const result = {
+      model: prompt.model,
+      messages: prompt.messages
+    };
+    if (prompt.temperature !== void 0 || prompt.maxTokens !== void 0) {
+      result.modelParameters = {};
+      if (prompt.temperature !== void 0) {
+        result.modelParameters.temperature = prompt.temperature;
+      }
+      if (prompt.maxTokens !== void 0) {
+        result.modelParameters.maxTokens = prompt.maxTokens;
+      }
+    }
+    return result;
+  }
+  /**
+   * Converts a LocalPromptConfig (loaded from YAML) to the format
+   * expected by the API service for upserting.
+   */
+  static fromLocalToApiFormat(config) {
+    var _a, _b;
+    return {
+      model: config.model,
+      temperature: (_a = config.modelParameters) == null ? void 0 : _a.temperature,
+      maxTokens: (_b = config.modelParameters) == null ? void 0 : _b.max_tokens,
+      messages: config.messages
+    };
+  }
+  /**
+   * Extracts the system prompt from messages array.
+   * Used when converting to API format that separates system prompt from messages.
+   */
+  static extractSystemPrompt(messages) {
+    var _a, _b;
+    return (_b = (_a = messages.find((m) => m.role === "system")) == null ? void 0 : _a.content) != null ? _b : "";
+  }
+  /**
+   * Filters out system messages from the messages array.
+   * Used when converting to API format that handles system prompt separately.
+   */
+  static filterNonSystemMessages(messages) {
+    return messages.filter((m) => m.role !== "system");
+  }
+};
+
+// src/cli/utils/fileManager.ts
+var _fs = require('fs'); var fs = _interopRequireWildcard(_fs);
+var _path = require('path'); var path = _interopRequireWildcard(_path);
+var _jsyaml = require('js-yaml'); var yaml = _interopRequireWildcard(_jsyaml);
+var _chalk = require('chalk'); var _chalk2 = _interopRequireDefault(_chalk);
+
+// src/cli/utils/errors/prompt-not-found.error.ts
+var PromptFileNotFoundError = class extends Error {
+  constructor(filePath) {
+    super(`Local prompt file not found: ${filePath}`);
+    this.name = "PromptFileNotFoundError";
+  }
+};
+
+// src/cli/utils/fileManager.ts
+var _FileManager = class _FileManager {
+  /** Reset the cached project root. Tests use this to exercise different cwds. */
+  static _resetProjectRootCache() {
+    this._projectRoot = void 0;
+  }
+  static hasProjectMarker(dir) {
+    return this.PROJECT_MARKERS.some((m) => fs.existsSync(path.join(dir, m)));
+  }
+  static findProjectRoot() {
+    if (this._projectRoot) {
+      return this._projectRoot;
+    }
+    const cwd = process.cwd();
+    const fsRoot = path.parse(cwd).root;
+    let topProjectDir = null;
+    let scan = cwd;
+    while (scan !== fsRoot) {
+      if (this.hasProjectMarker(scan)) {
+        topProjectDir = scan;
+      }
+      scan = path.dirname(scan);
+    }
+    if (!topProjectDir) {
+      this._projectRoot = cwd;
+      return cwd;
+    }
+    let currentDir = cwd;
+    while (true) {
+      const configPath = path.join(currentDir, this.PROMPTS_CONFIG_FILE);
+      if (fs.existsSync(configPath)) {
+        this._projectRoot = currentDir;
+        return currentDir;
+      }
+      if (currentDir === topProjectDir) break;
+      currentDir = path.dirname(currentDir);
+    }
+    this._projectRoot = cwd;
+    return cwd;
+  }
+  static getPromptsConfigPath() {
+    return path.join(this.findProjectRoot(), this.PROMPTS_CONFIG_FILE);
+  }
+  static getPromptsLockPath() {
+    return path.join(this.findProjectRoot(), this.PROMPTS_LOCK_FILE);
+  }
+  static getPromptsDir() {
+    return path.join(this.findProjectRoot(), 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: ${_chunkC5Y772G7js.formatApiErrorMessage.call(void 0, { 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 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 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 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(this.findProjectRoot(), 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(this.findProjectRoot(), ".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";
+_FileManager.PROJECT_MARKERS = [
+  ".git",
+  "package.json",
+  "pyproject.toml"
+];
+_FileManager.loadPromptsLock = () => {
+  const lockPath = _FileManager.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: ${_chunkC5Y772G7js.formatApiErrorMessage.call(void 0, { error })}`);
+  }
+};
+_FileManager.loadLocalPrompt = (filePath) => {
+  const fullPath = path.resolve(filePath);
+  if (!fs.existsSync(fullPath)) {
+    throw new PromptFileNotFoundError(filePath);
+  }
+  try {
+    const content = fs.readFileSync(fullPath, "utf-8");
+    const rawData = yaml.load(content);
+    const result = _chunkAZHZ4NB4js.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 ${_chalk2.default.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}: ${_chunkC5Y772G7js.formatApiErrorMessage.call(void 0, { error })}`);
+  }
+};
+_FileManager.getLocalPromptFiles = () => {
+  const promptsDir = _FileManager.getPromptsDir();
+  const materializedDir = _FileManager.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;
+};
+var FileManager = _FileManager;
+
+
+
+
+
+exports.PromptConverter = PromptConverter; exports.PromptFileNotFoundError = PromptFileNotFoundError; exports.FileManager = FileManager;
+//# sourceMappingURL=chunk-ITK3APKC.js.map

package/dist/chunk-ITK3APKC.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["/home/runner/work/langwatch/langwatch/typescript-sdk/dist/chunk-ITK3APKC.js","../src/cli/utils/promptConverter.ts","../src/cli/utils/fileManager.ts","../src/cli/utils/errors/prompt-not-found.error.ts"],"names":[],"mappings":"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","file":"/home/runner/work/langwatch/langwatch/typescript-sdk/dist/chunk-ITK3APKC.js","sourcesContent":[null,"import type { LocalPromptConfig, MaterializedPrompt } from \"../types\";\nimport { type PromptResponse, type UpdatePromptBody } from \"@/client-sdk/services/prompts/types\";\n\n/**\n * Converter utility for transforming between YAML prompt format and API service format.\n *\n * The YAML format follows the GitHub .prompt.yaml file format standard,\n * while the API format is our internal prompt service schema tied to the database.\n *\n * This separation allows us to maintain and evolve both formats independently\n * while keeping the conversion logic centralized and well-tested.\n */\nexport class PromptConverter {\n  /**\n   * Converts a Prompt instance from the API service to the MaterializedPrompt format\n   * used for saving to the .materialized directory.\n   */\n  static fromApiToMaterialized(prompt: PromptResponse): MaterializedPrompt {\n    return {\n      id: prompt.id,\n      name: prompt.name,\n      version: prompt.version,\n      versionId: prompt.versionId,\n      model: prompt.model,\n      messages: prompt.messages,\n      prompt: prompt.prompt,\n      temperature: prompt.temperature,\n      maxTokens: prompt.maxTokens,\n      inputs: prompt.inputs,\n      outputs: prompt.outputs,\n      updatedAt: prompt.updatedAt,\n    };\n  }\n\n  /**\n   * Converts a MaterializedPrompt to the YAML content structure\n   * for saving to .prompt.yaml files.\n   */\n  static fromMaterializedToYaml(prompt: MaterializedPrompt): {\n    model: string;\n    modelParameters?: {\n      temperature?: number;\n      maxTokens?: number;\n    };\n    messages: Array<{\n      role: \"system\" | \"user\" | \"assistant\";\n      content: string;\n    }>;\n  } {\n    const result: any = {\n      model: prompt.model,\n      messages: prompt.messages,\n    };\n\n    // Add modelParameters if temperature or maxTokens exist\n    if (prompt.temperature !== undefined || prompt.maxTokens !== undefined) {\n      result.modelParameters = {};\n      if (prompt.temperature !== undefined) {\n        result.modelParameters.temperature = prompt.temperature;\n      }\n      if (prompt.maxTokens !== undefined) {\n        result.modelParameters.maxTokens = prompt.maxTokens;\n      }\n    }\n\n    return result;\n  }\n\n  /**\n   * Converts a LocalPromptConfig (loaded from YAML) to the format\n   * expected by the API service for upserting.\n   */\n  static fromLocalToApiFormat(config: LocalPromptConfig): Omit<UpdatePromptBody, \"commitMessage\">\n  {\n    return {\n      model: config.model,\n      temperature: config.modelParameters?.temperature,\n      maxTokens: config.modelParameters?.max_tokens,\n      messages: config.messages,\n    };\n  }\n\n  /**\n   * Extracts the system prompt from messages array.\n   * Used when converting to API format that separates system prompt from messages.\n   */\n  static extractSystemPrompt(\n    messages: Array<{ role: string; content: string }>,\n  ): string {\n    return messages.find((m) => m.role === \"system\")?.content ?? \"\";\n  }\n\n  /**\n   * Filters out system messages from the messages array.\n   * Used when converting to API format that handles system prompt separately.\n   */\n  static filterNonSystemMessages(\n    messages: Array<{\n      role: \"system\" | \"user\" | \"assistant\";\n      content: string;\n    }>,\n  ): Array<{ role: \"user\" | \"assistant\"; content: string }> {\n    return messages.filter((m) => m.role !== \"system\") as Array<{\n      role: \"user\" | \"assistant\";\n      content: string;\n    }>;\n  }\n}\n","import * as fs from \"fs\";\nimport * as path from \"path\";\nimport * as yaml from \"js-yaml\";\nimport chalk from \"chalk\";\nimport type { PromptsConfig, LocalPromptConfig, MaterializedPrompt, PromptsLock } from \"../types\";\nimport { localPromptConfigSchema } from \"../types\";\nimport { PromptConverter } from \"@/cli/utils/promptConverter\";\nimport { PromptFileNotFoundError } from \"./errors/prompt-not-found.error\";\nimport { formatApiErrorMessage } from \"@/client-sdk/services/_shared/format-api-error\";\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  private static _projectRoot: string | undefined;\n\n  /** Reset the cached project root. Tests use this to exercise different cwds. */\n  static _resetProjectRootCache(): void {\n    this._projectRoot = undefined;\n  }\n\n  private static readonly PROJECT_MARKERS = [\n    \".git\",\n    \"package.json\",\n    \"pyproject.toml\",\n  ];\n\n  private static hasProjectMarker(dir: string): boolean {\n    return this.PROJECT_MARKERS.some((m) => fs.existsSync(path.join(dir, m)));\n  }\n\n  private static findProjectRoot(): string {\n    if (this._projectRoot) {\n      return this._projectRoot;\n    }\n\n    const cwd = process.cwd();\n    const fsRoot = path.parse(cwd).root;\n\n    // Find the highest ancestor that still looks like part of \"this project\"\n    // (has package.json / pyproject.toml / .git). If cwd itself has no marker,\n    // we don't walk up at all — prevents grabbing a stray prompts.json from\n    // /tmp or other shared scratch dirs.\n    let topProjectDir: string | null = null;\n    let scan = cwd;\n    while (scan !== fsRoot) {\n      if (this.hasProjectMarker(scan)) {\n        topProjectDir = scan;\n      }\n      scan = path.dirname(scan);\n    }\n\n    if (!topProjectDir) {\n      this._projectRoot = cwd;\n      return cwd;\n    }\n\n    // Walk up from cwd looking for prompts.json, capped at the project boundary.\n    let currentDir = cwd;\n    while (true) {\n      const configPath = path.join(currentDir, this.PROMPTS_CONFIG_FILE);\n      if (fs.existsSync(configPath)) {\n        this._projectRoot = currentDir;\n        return currentDir;\n      }\n      if (currentDir === topProjectDir) break;\n      currentDir = path.dirname(currentDir);\n    }\n\n    // No prompts.json anywhere within the project — default to cwd so `init`\n    // creates it where the user actually ran the command. This also keeps\n    // concurrent test workdirs isolated: each tempdir gets its own prompts.json\n    // instead of all pointing at a shared repo-root file.\n    this._projectRoot = cwd;\n    return cwd;\n  }\n\n  static getPromptsConfigPath(): string {\n    return path.join(this.findProjectRoot(), this.PROMPTS_CONFIG_FILE);\n  }\n\n  static getPromptsLockPath(): string {\n    return path.join(this.findProjectRoot(), this.PROMPTS_LOCK_FILE);\n  }\n\n  static getPromptsDir(): string {\n    return path.join(this.findProjectRoot(), 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: ${formatApiErrorMessage({ 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: ${formatApiErrorMessage({ 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 PromptFileNotFoundError(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}: ${formatApiErrorMessage({ 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(this.findProjectRoot(), 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(this.findProjectRoot(), \".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}\n","export class PromptFileNotFoundError extends Error {\n  constructor(filePath: string) {\n    super(`Local prompt file not found: ${filePath}`);\n    this.name = 'PromptFileNotFoundError';\n  }\n}\n"]}

package/dist/chunk-J3KM7ZO7.mjs

@@ -0,0 +1,152 @@
+// src/client-sdk/services/_shared/format-api-error.ts
+var GENERIC_MESSAGES = /* @__PURE__ */ new Set([
+  "",
+  "internal server error",
+  "unknown error",
+  "unknown error occurred"
+]);
+function isGeneric(s) {
+  return GENERIC_MESSAGES.has(s.trim().toLowerCase());
+}
+function firstMeaningful(...candidates) {
+  for (const c of candidates) {
+    if (typeof c === "string" && !isGeneric(c)) return c;
+  }
+  return void 0;
+}
+function collectAllOwnPropertyNames(value, seen = /* @__PURE__ */ new Set()) {
+  if (!value || typeof value !== "object" || seen.has(value)) return [];
+  seen.add(value);
+  const names = /* @__PURE__ */ new Set();
+  for (const name of Object.getOwnPropertyNames(value)) {
+    names.add(name);
+    try {
+      const child = value[name];
+      for (const nested of collectAllOwnPropertyNames(child, seen)) {
+        names.add(nested);
+      }
+    } catch (e) {
+    }
+  }
+  return Array.from(names);
+}
+function formatZodIssues(body) {
+  const isZod = body.name === "ZodError" || Array.isArray(body.issues) && body.issues.length > 0;
+  if (!isZod || !Array.isArray(body.issues)) return void 0;
+  const rendered = body.issues.map((issue) => {
+    const pathArr = Array.isArray(issue.path) ? issue.path : [];
+    const path = pathArr.filter((p) => typeof p === "string" || typeof p === "number").join(".");
+    const msg = typeof issue.message === "string" ? issue.message : "";
+    if (path && msg) return `${path} \u2014 ${msg}`;
+    if (msg) return msg;
+    if (path) return path;
+    return void 0;
+  }).filter((s) => typeof s === "string" && s.length > 0);
+  if (rendered.length === 0) return void 0;
+  return `Validation failed: ${rendered.join("; ")}`;
+}
+function stringifyBody(body) {
+  try {
+    if (body && typeof body === "object") {
+      return JSON.stringify(body, collectAllOwnPropertyNames(body));
+    }
+    return JSON.stringify(body);
+  } catch (e) {
+    return String(body);
+  }
+}
+function formatApiErrorMessage({
+  error,
+  options = {}
+}) {
+  if (error == null) {
+    return options.status ? `Request failed with status ${options.status}` : "Unknown error occurred";
+  }
+  if (typeof error === "string") {
+    return isGeneric(error) && options.status ? `${error} (status ${options.status})` : error;
+  }
+  if (error instanceof Error) {
+    const base = error.message || "Unknown error occurred";
+    const cause = error.cause;
+    const causeMsg = cause instanceof Error ? cause.message : cause && typeof cause === "object" && typeof cause.message === "string" ? cause.message : void 0;
+    const causeCode = cause && typeof cause === "object" && typeof cause.code === "string" ? cause.code : void 0;
+    const detail = [causeCode, causeMsg && causeMsg !== base ? causeMsg : void 0].filter((s) => typeof s === "string" && s.length > 0).join(": ");
+    const formatted = detail ? `${base} (${detail})` : base;
+    const combined = `${base} ${causeMsg != null ? causeMsg : ""} ${causeCode != null ? causeCode : ""}`.toLowerCase();
+    if (combined.includes("unknown scheme") || combined.includes("err_invalid_url") || combined.includes("failed to parse url")) {
+      return `${formatted} \u2014 check your LANGWATCH_ENDPOINT (must start with http:// or https://)`;
+    }
+    return formatted;
+  }
+  if (typeof error === "object") {
+    const body = error;
+    const zod = formatZodIssues(body);
+    if (zod) return zod;
+    const fromMessage = typeof body.message === "string" ? body.message : void 0;
+    const fromError = typeof body.error === "string" ? body.error : void 0;
+    const fromDetail = typeof body.detail === "string" ? body.detail : void 0;
+    const fromReason = typeof body.reason === "string" ? body.reason : void 0;
+    const meaningful = firstMeaningful(fromMessage, fromError, fromDetail, fromReason);
+    if (meaningful) {
+      if (fromError && fromMessage && fromMessage !== fromError && !isGeneric(fromError) && !isGeneric(fromMessage)) {
+        return `${fromError}: ${fromMessage}`;
+      }
+      return meaningful;
+    }
+    if (body.error && typeof body.error === "object") {
+      const nested = body.error;
+      if (body.error instanceof Error && body.error.message) {
+        return body.error.message;
+      }
+      const nestedZod = formatZodIssues(nested);
+      if (nestedZod) return nestedZod;
+      const fromNestedMsg = typeof nested.message === "string" ? nested.message : void 0;
+      const fromNestedErr = typeof nested.error === "string" ? nested.error : void 0;
+      const nestedMeaningful = firstMeaningful(fromNestedMsg, fromNestedErr);
+      if (nestedMeaningful) {
+        return nestedMeaningful;
+      }
+      const nestedRaw = stringifyBody(nested);
+      if (nestedRaw && nestedRaw !== "{}") {
+        return nestedRaw;
+      }
+    }
+    const raw = stringifyBody(body);
+    if (!raw || raw === "{}" || raw === '""' || raw === "null") {
+      return options.status ? `Request failed with status ${options.status}` : "Unknown error occurred";
+    }
+    const withStatus = options.status ? `status ${options.status} ${raw}` : raw;
+    return `server returned ${withStatus}`;
+  }
+  try {
+    return String(error);
+  } catch (e) {
+    return "Unknown error occurred";
+  }
+}
+function formatApiErrorForOperation({
+  operation,
+  error,
+  options = {}
+}) {
+  const message = formatApiErrorMessage({ error, options });
+  return `Failed to ${operation}: ${message}`;
+}
+function extractStatusFromResponse(value) {
+  if (!value || typeof value !== "object") return void 0;
+  const obj = value;
+  if (typeof obj.status === "number") return obj.status;
+  if (typeof obj.statusCode === "number") return obj.statusCode;
+  if (obj.response && typeof obj.response === "object") {
+    const resp = obj.response;
+    if (typeof resp.status === "number") return resp.status;
+  }
+  return void 0;
+}
+
+export {
+  formatApiErrorMessage,
+  formatApiErrorForOperation,
+  extractStatusFromResponse
+};
+//# sourceMappingURL=chunk-J3KM7ZO7.mjs.map

package/dist/chunk-J3KM7ZO7.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/client-sdk/services/_shared/format-api-error.ts"],"sourcesContent":["/**\n * Extracts the most informative, user-facing message from an API error body.\n *\n * Errors from the LangWatch API follow the shape `{ error: string, message?: string }`\n * per `errorSchema` in the server. In production the middleware may return a\n * generic `{ error: \"Internal server error\", message: \"Internal server error\" }`\n * which is useless to a user — this helper at least falls back to stringifying\n * the raw body so no diagnostic information is lost.\n *\n * Priority (first non-generic, non-empty wins):\n *   1. `body.message` (descriptive sentence from the server)\n *   2. `body.error`   (error kind — \"NotFoundError\", \"Conflict\", …)\n *   3. Any other string fields on the body object (e.g. `detail`, `reason`)\n *   4. JSON stringification of the entire body\n *   5. `Error#message` if the input is a thrown Error\n *   6. A status-code-derived fallback, if available\n */\nconst GENERIC_MESSAGES = new Set([\n  \"\",\n  \"internal server error\",\n  \"unknown error\",\n  \"unknown error occurred\",\n]);\n\nfunction isGeneric(s: string): boolean {\n  return GENERIC_MESSAGES.has(s.trim().toLowerCase());\n}\n\nfunction firstMeaningful(...candidates: Array<unknown>): string | undefined {\n  for (const c of candidates) {\n    if (typeof c === \"string\" && !isGeneric(c)) return c;\n  }\n  return undefined;\n}\n\nfunction collectAllOwnPropertyNames(value: unknown, seen = new Set<unknown>()): string[] {\n  if (!value || typeof value !== \"object\" || seen.has(value)) return [];\n  seen.add(value);\n  const names = new Set<string>();\n  for (const name of Object.getOwnPropertyNames(value)) {\n    names.add(name);\n    try {\n      const child = (value as Record<string, unknown>)[name];\n      for (const nested of collectAllOwnPropertyNames(child, seen)) {\n        names.add(nested);\n      }\n    } catch {\n      // Ignore getter side effects.\n    }\n  }\n  return Array.from(names);\n}\n\ninterface ZodIssue {\n  path?: unknown;\n  message?: unknown;\n}\n\n/**\n * Renders a Zod validation error body into a user-readable string. Returns\n * undefined if `body` is not a Zod error shape.\n *\n * Examples:\n *   { name: \"ZodError\", issues: [{ path: [\"format\"], message: \"Invalid enum value...\" }] }\n *   → \"Validation failed: format — Invalid enum value...\"\n *   { name: \"ZodError\", issues: [<issue1>, <issue2>] }\n *   → \"Validation failed: a.b — msg1; c — msg2\"\n */\nfunction formatZodIssues(body: Record<string, unknown>): string | undefined {\n  const isZod =\n    body.name === \"ZodError\" ||\n    (Array.isArray(body.issues) && body.issues.length > 0);\n  if (!isZod || !Array.isArray(body.issues)) return undefined;\n\n  const rendered = (body.issues as ZodIssue[])\n    .map((issue) => {\n      const pathArr = Array.isArray(issue.path) ? issue.path : [];\n      const path = pathArr\n        .filter((p) => typeof p === \"string\" || typeof p === \"number\")\n        .join(\".\");\n      const msg = typeof issue.message === \"string\" ? issue.message : \"\";\n      if (path && msg) return `${path} — ${msg}`;\n      if (msg) return msg;\n      if (path) return path;\n      return undefined;\n    })\n    .filter((s): s is string => typeof s === \"string\" && s.length > 0);\n\n  if (rendered.length === 0) return undefined;\n  return `Validation failed: ${rendered.join(\"; \")}`;\n}\n\nfunction stringifyBody(body: unknown): string {\n  try {\n    // Use all own property names (including non-enumerable ones, common on\n    // native Error instances and fetch errors) so we preserve every field the\n    // server sent, at any nesting depth.\n    if (body && typeof body === \"object\") {\n      return JSON.stringify(body, collectAllOwnPropertyNames(body));\n    }\n    return JSON.stringify(body);\n  } catch {\n    return String(body);\n  }\n}\n\nexport interface FormatApiErrorOptions {\n  /**\n   * HTTP status code from the response, when known. Used as part of the\n   * fallback output so that the user has at least some actionable signal.\n   */\n  status?: number;\n}\n\nexport interface FormatApiErrorMessageParams {\n  error: unknown;\n  /** Currently only `status` — kept as an object for forward extension. */\n  options?: FormatApiErrorOptions;\n}\n\nexport function formatApiErrorMessage({\n  error,\n  options = {},\n}: FormatApiErrorMessageParams): string {\n  if (error == null) {\n    return options.status\n      ? `Request failed with status ${options.status}`\n      : \"Unknown error occurred\";\n  }\n\n  if (typeof error === \"string\") {\n    return isGeneric(error) && options.status\n      ? `${error} (status ${options.status})`\n      : error;\n  }\n\n  if (error instanceof Error) {\n    // Node's fetch wraps transport failures as `TypeError: fetch failed` with\n    // the real reason (ECONNREFUSED, ENOTFOUND, timeout, etc.) on `.cause`.\n    // Surface that so the user can tell whether the endpoint is wrong, the\n    // server is down, or DNS can't resolve the host.\n    const base = error.message || \"Unknown error occurred\";\n    const cause = (error as { cause?: unknown }).cause;\n    const causeMsg =\n      cause instanceof Error\n        ? cause.message\n        : cause && typeof cause === \"object\" &&\n            typeof (cause as { message?: unknown }).message === \"string\"\n          ? (cause as { message: string }).message\n          : undefined;\n    const causeCode =\n      cause && typeof cause === \"object\" &&\n      typeof (cause as { code?: unknown }).code === \"string\"\n        ? (cause as { code: string }).code\n        : undefined;\n\n    const detail = [causeCode, causeMsg && causeMsg !== base ? causeMsg : undefined]\n      .filter((s): s is string => typeof s === \"string\" && s.length > 0)\n      .join(\": \");\n    const formatted = detail ? `${base} (${detail})` : base;\n\n    // Node fetch emits \"TypeError: fetch failed\" with `cause.message =\n    // \"unknown scheme\"` when the URL has no/invalid scheme (e.g. the user\n    // set LANGWATCH_ENDPOINT=localhost:5570 instead of http://localhost:5570).\n    // Add a hint — the raw phrase tells the user nothing actionable.\n    const combined = `${base} ${causeMsg ?? \"\"} ${causeCode ?? \"\"}`.toLowerCase();\n    if (\n      combined.includes(\"unknown scheme\") ||\n      combined.includes(\"err_invalid_url\") ||\n      combined.includes(\"failed to parse url\")\n    ) {\n      return `${formatted} — check your LANGWATCH_ENDPOINT (must start with http:// or https://)`;\n    }\n    return formatted;\n  }\n\n  if (typeof error === \"object\") {\n    const body = error as Record<string, unknown>;\n\n    // Zod validation errors: `{ name: \"ZodError\", issues: [{ path, message }] }`.\n    // Without this they render as unreadable raw JSON to the user.\n    const zod = formatZodIssues(body);\n    if (zod) return zod;\n\n    // Most specific fields first.\n    const fromMessage = typeof body.message === \"string\" ? body.message : undefined;\n    const fromError = typeof body.error === \"string\" ? body.error : undefined;\n    const fromDetail = typeof body.detail === \"string\" ? body.detail : undefined;\n    const fromReason = typeof body.reason === \"string\" ? body.reason : undefined;\n\n    // 1. Top-level meaningful fields take priority. If the server gave us a\n    //    descriptive `message`/`error`/`detail`/`reason`, use that — even if\n    //    `body.error` is an object with its own (potentially generic) message.\n    const meaningful = firstMeaningful(fromMessage, fromError, fromDetail, fromReason);\n    if (meaningful) {\n      if (\n        fromError &&\n        fromMessage &&\n        fromMessage !== fromError &&\n        !isGeneric(fromError) &&\n        !isGeneric(fromMessage)\n      ) {\n        return `${fromError}: ${fromMessage}`;\n      }\n      return meaningful;\n    }\n\n    // 2. Nested `body.error` — only used as a fallback when no top-level\n    //    field carried a useful message. Native Error instances and\n    //    tRPC-style envelopes both fit here.\n    if (body.error && typeof body.error === \"object\") {\n      const nested = body.error as Record<string, unknown>;\n\n      if (body.error instanceof Error && body.error.message) {\n        return body.error.message;\n      }\n\n      // Zod validation envelopes: `{ success: false, error: { name: \"ZodError\", issues: [...] } }`\n      const nestedZod = formatZodIssues(nested);\n      if (nestedZod) return nestedZod;\n\n      const fromNestedMsg = typeof nested.message === \"string\" ? nested.message : undefined;\n      const fromNestedErr = typeof nested.error === \"string\" ? nested.error : undefined;\n      const nestedMeaningful = firstMeaningful(fromNestedMsg, fromNestedErr);\n      if (nestedMeaningful) {\n        return nestedMeaningful;\n      }\n\n      // Stringify the nested object so identifiers like `{ code, status }`\n      // still reach the user.\n      const nestedRaw = stringifyBody(nested);\n      if (nestedRaw && nestedRaw !== \"{}\") {\n        return nestedRaw;\n      }\n    }\n\n    // 3. No meaningful top-level or nested fields — dump the raw JSON so\n    //    the user at least sees the server payload. Attach status for\n    //    context.\n    const raw = stringifyBody(body);\n\n    // Collapse empty / near-empty payloads to a friendlier message — there's\n    // nothing for the user to see in `{}` anyway.\n    if (!raw || raw === \"{}\" || raw === '\"\"' || raw === \"null\") {\n      return options.status\n        ? `Request failed with status ${options.status}`\n        : \"Unknown error occurred\";\n    }\n\n    const withStatus = options.status ? `status ${options.status} ${raw}` : raw;\n    return `server returned ${withStatus}`;\n  }\n\n  // Primitive types (number, boolean, bigint, symbol) — coerce safely.\n  // We've already handled string, null/undefined, Error, and object above.\n  try {\n    return String(error as number | boolean | bigint);\n  } catch {\n    return \"Unknown error occurred\";\n  }\n}\n\nexport interface FormatApiErrorForOperationParams {\n  operation: string;\n  error: unknown;\n  options?: FormatApiErrorOptions;\n}\n\n/**\n * Builds a fully-qualified error message for a specific operation, including\n * the operation name and the extracted server-side message.\n */\nexport function formatApiErrorForOperation({\n  operation,\n  error,\n  options = {},\n}: FormatApiErrorForOperationParams): string {\n  const message = formatApiErrorMessage({ error, options });\n  return `Failed to ${operation}: ${message}`;\n}\n\n/**\n * Attempts to read a status code from common response-shaped wrappers without\n * assuming a particular SDK. Returns undefined if none is found.\n */\nexport function extractStatusFromResponse(value: unknown): number | undefined {\n  if (!value || typeof value !== \"object\") return undefined;\n  const obj = value as Record<string, unknown>;\n  if (typeof obj.status === \"number\") return obj.status;\n  if (typeof obj.statusCode === \"number\") return obj.statusCode;\n  if (obj.response && typeof obj.response === \"object\") {\n    const resp = obj.response as Record<string, unknown>;\n    if (typeof resp.status === \"number\") return resp.status;\n  }\n  return undefined;\n}\n"],"mappings":"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","names":[]}