langwatch 0.33.1 → 0.34.0

package/dist/chunk-DCTJDRBW.js

@@ -0,0 +1,40 @@
+"use strict";Object.defineProperty(exports, "__esModule", {value: true});
+
+var _chunkSNKGSX5Ijs = require('./chunk-SNKGSX5I.js');
+
+// src/cli/commands/virtual-keys/_shared.ts
+function virtualKeyDetailUrl(vkId) {
+  const uiOverride = process.env.LANGWATCH_UI_ENDPOINT;
+  const base = (uiOverride != null ? uiOverride : _chunkSNKGSX5Ijs.resolveControlPlaneUrl.call(void 0, )).replace(/\/+$/, "");
+  if (!base) return "";
+  return `${base}/settings/gateway/virtual-keys/${encodeURIComponent(vkId)}`;
+}
+var SCOPE_TYPES = ["ORGANIZATION", "TEAM", "PROJECT"];
+function parseScopeArg(raw) {
+  const trimmed = raw.trim();
+  const colon = trimmed.indexOf(":");
+  if (colon < 1 || colon === trimmed.length - 1) {
+    throw new Error(`--scope value "${raw}" must be in the form TYPE:id (e.g. ORG:acme, TEAM:platform, PROJECT:demo)`);
+  }
+  const typeRaw = trimmed.slice(0, colon).toUpperCase();
+  const scopeId = trimmed.slice(colon + 1).trim();
+  const scopeType = typeRaw === "ORG" ? "ORGANIZATION" : SCOPE_TYPES.includes(typeRaw) ? typeRaw : null;
+  if (!scopeType) {
+    throw new Error(`--scope type "${typeRaw}" must be one of ORG | ORGANIZATION | TEAM | PROJECT`);
+  }
+  if (!scopeId) {
+    throw new Error(`--scope value "${raw}" is missing the id after the colon`);
+  }
+  return { scope_type: scopeType, scope_id: scopeId };
+}
+function formatScope(scope) {
+  const prefix = scope.scope_type === "ORGANIZATION" ? "ORG" : scope.scope_type;
+  return `${prefix}:${scope.scope_id}`;
+}
+
+
+
+
+
+exports.virtualKeyDetailUrl = virtualKeyDetailUrl; exports.parseScopeArg = parseScopeArg; exports.formatScope = formatScope;
+//# sourceMappingURL=chunk-DCTJDRBW.js.map

package/dist/chunk-DCTJDRBW.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["/home/runner/work/langwatch/langwatch/typescript-sdk/dist/chunk-DCTJDRBW.js","../src/cli/commands/virtual-keys/_shared.ts"],"names":[],"mappings":"AAAA;AACE;AACF,sDAA4B;AAC5B;AACA;ACMO,SAAS,mBAAA,CAAoB,IAAA,EAAsB;AACxD,EAAA,MAAM,WAAA,EAAa,OAAA,CAAQ,GAAA,CAAI,qBAAA;AAC/B,EAAA,MAAM,KAAA,EAAA,CAAQ,WAAA,GAAA,KAAA,EAAA,WAAA,EAAc,qDAAA,CAAuB,CAAA,CAAG,OAAA,CAAQ,MAAA,EAAQ,EAAE,CAAA;AACxE,EAAA,GAAA,CAAI,CAAC,IAAA,EAAM,OAAO,EAAA;AAClB,EAAA,OAAO,CAAA,EAAA;AACT;AAEM;AASU;AACR,EAAA;AACA,EAAA;AACF,EAAA;AACI,IAAA;AACR,EAAA;AACM,EAAA;AACA,EAAA;AACA,EAAA;AAID,EAAA;AACG,IAAA;AACR,EAAA;AACK,EAAA;AACG,IAAA;AACR,EAAA;AACO,EAAA;AACT;AAMgB;AACR,EAAA;AACC,EAAA;AACT;ADrBU;AACA;AACA;AACA;AACA;AACA","file":"/home/runner/work/langwatch/langwatch/typescript-sdk/dist/chunk-DCTJDRBW.js","sourcesContent":[null,"import type { VirtualKeyScope, VirtualKeyScopeType } from \"@/client-sdk/services/virtual-keys/virtual-keys-api.service\";\nimport { resolveControlPlaneUrl } from \"@/cli/utils/governance/resolveEndpoint\";\n\n/**\n * Build the public-facing LangWatch UI URL for a VK detail page. After the\n * multi-scope refactor (PR #3524), VKs live at the org-scoped settings\n * surface (/settings/gateway/virtual-keys/:id) regardless of their scope\n * rows; the per-project gateway pages are gone. Honours\n * `LANGWATCH_UI_ENDPOINT` for split UI/API hosts.\n */\nexport function virtualKeyDetailUrl(vkId: string): string {\n  const uiOverride = process.env.LANGWATCH_UI_ENDPOINT;\n  const base = (uiOverride ?? resolveControlPlaneUrl()).replace(/\\/+$/, \"\");\n  if (!base) return \"\";\n  return `${base}/settings/gateway/virtual-keys/${encodeURIComponent(vkId)}`;\n}\n\nconst SCOPE_TYPES: VirtualKeyScopeType[] = [\"ORGANIZATION\", \"TEAM\", \"PROJECT\"];\n\n/**\n * Parse a single `--scope <TYPE>:<id>` CLI value into a `VirtualKeyScope`.\n * Accepts the canonical ORGANIZATION/TEAM/PROJECT spellings (case-insensitive)\n * plus the friendly ORG alias for `ORGANIZATION`. Throws an Error with a\n * single-sentence message the CLI can print directly so users see what they\n * mistyped without a stack trace.\n */\nexport function parseScopeArg(raw: string): VirtualKeyScope {\n  const trimmed = raw.trim();\n  const colon = trimmed.indexOf(\":\");\n  if (colon < 1 || colon === trimmed.length - 1) {\n    throw new Error(`--scope value \"${raw}\" must be in the form TYPE:id (e.g. ORG:acme, TEAM:platform, PROJECT:demo)`);\n  }\n  const typeRaw = trimmed.slice(0, colon).toUpperCase();\n  const scopeId = trimmed.slice(colon + 1).trim();\n  const scopeType: VirtualKeyScopeType | null =\n    typeRaw === \"ORG\" ? \"ORGANIZATION\" :\n    (SCOPE_TYPES as readonly string[]).includes(typeRaw) ? (typeRaw as VirtualKeyScopeType) :\n    null;\n  if (!scopeType) {\n    throw new Error(`--scope type \"${typeRaw}\" must be one of ORG | ORGANIZATION | TEAM | PROJECT`);\n  }\n  if (!scopeId) {\n    throw new Error(`--scope value \"${raw}\" is missing the id after the colon`);\n  }\n  return { scope_type: scopeType, scope_id: scopeId };\n}\n\n/**\n * Format a scope for display in CLI tables / get output: `ORG:acme`,\n * `TEAM:platform`, etc. Uses the short `ORG` form for brevity.\n */\nexport function formatScope(scope: VirtualKeyScope): string {\n  const prefix = scope.scope_type === \"ORGANIZATION\" ? \"ORG\" : scope.scope_type;\n  return `${prefix}:${scope.scope_id}`;\n}\n"]}

package/dist/chunk-DIILEB4J.js

@@ -0,0 +1,196 @@
+"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 _chunkTIAQGDR2js = require('./chunk-TIAQGDR2.js');
+
+
+
+var _chunk4Q4HSAKZjs = require('./chunk-4Q4HSAKZ.js');
+
+
+var _chunkB5TBCV6Njs = require('./chunk-B5TBCV6N.js');
+
+
+
+var _chunkZFFJYYDNjs = require('./chunk-ZFFJYYDN.js');
+
+
+var _chunkC5Y772G7js = require('./chunk-C5Y772G7.js');
+
+// src/cli/commands/pull.ts
+var _fs = require('fs'); var fs = _interopRequireWildcard(_fs);
+var _path = require('path'); var path = _interopRequireWildcard(_path);
+var _chalk = require('chalk'); var _chalk2 = _interopRequireDefault(_chalk);
+var _ora = require('ora'); var _ora2 = _interopRequireDefault(_ora);
+var pullPrompts = async ({
+  config,
+  lock,
+  promptsApiService,
+  result,
+  tag
+}) => {
+  var _a;
+  const remoteDeps = Object.entries(config.prompts).filter(
+    ([, dependency]) => {
+      if (typeof dependency === "object" && dependency.file) {
+        return false;
+      }
+      if (typeof dependency === "string" && dependency.startsWith("file:")) {
+        return false;
+      }
+      return true;
+    }
+  );
+  if (remoteDeps.length > 0) {
+    const fetchSpinner = _ora2.default.call(void 0, 
+      `Checking ${remoteDeps.length} remote prompts...`
+    ).start();
+    for (const [name, dependency] of remoteDeps) {
+      try {
+        const versionSpec = typeof dependency === "string" ? dependency : (_a = dependency.version) != null ? _a : "latest";
+        const displaySpec = tag != null ? tag : versionSpec;
+        const lockEntry = lock.prompts[name];
+        const prompt = tag ? await promptsApiService.get(name, { tag }) : await promptsApiService.get(name, { version: versionSpec });
+        if (prompt) {
+          const needsUpdate = (lockEntry == null ? void 0 : lockEntry.version) !== prompt.version || !lockEntry.materialized || !fs.existsSync(path.resolve(lockEntry.materialized));
+          if (needsUpdate) {
+            const materializedPrompt = _chunkZFFJYYDNjs.PromptConverter.fromApiToMaterialized(prompt);
+            const savedPath = _chunkZFFJYYDNjs.FileManager.saveMaterializedPrompt(
+              name,
+              materializedPrompt
+            );
+            const relativePath = path.relative(process.cwd(), savedPath);
+            result.fetched.push({
+              name,
+              version: prompt.version,
+              versionSpec: displaySpec
+            });
+            _chunkZFFJYYDNjs.FileManager.updateLockEntry(
+              lock,
+              name,
+              materializedPrompt,
+              savedPath
+            );
+            fetchSpinner.text = `Fetched ${_chalk2.default.cyan(
+              `${name}@${displaySpec}`
+            )} ${_chalk2.default.gray(`(version ${prompt.version})`)} \u2192 ${_chalk2.default.gray(
+              relativePath
+            )}`;
+          } else {
+            result.unchanged.push(name);
+          }
+        } else {
+          result.errors.push({ name, error: "Prompt not found" });
+        }
+      } catch (error) {
+        const errorMessage = _chunkC5Y772G7js.formatApiErrorMessage.call(void 0, { error });
+        result.errors.push({ name, error: errorMessage });
+      }
+    }
+    fetchSpinner.stop();
+  }
+  const currentDependencies = new Set(
+    Object.keys(config.prompts).filter((name) => {
+      const dependency = config.prompts[name];
+      if (typeof dependency === "object" && dependency.file) {
+        return false;
+      }
+      if (typeof dependency === "string" && dependency.startsWith("file:")) {
+        return false;
+      }
+      return true;
+    })
+  );
+  const cleanedFiles = _chunkZFFJYYDNjs.FileManager.cleanupOrphanedMaterializedFiles(currentDependencies);
+  if (cleanedFiles.length > 0) {
+    result.cleaned = cleanedFiles;
+    _chunkZFFJYYDNjs.FileManager.removeFromLock(lock, cleanedFiles);
+  }
+};
+var printPullResults = ({
+  result,
+  lock,
+  duration
+}) => {
+  if (result.fetched.length > 0) {
+    for (const { name, version, versionSpec } of result.fetched) {
+      const lockEntry = lock.prompts[name];
+      const displayPath = (lockEntry == null ? void 0 : lockEntry.materialized) ? `./${lockEntry.materialized}` : `./prompts/.materialized/${name}.prompt.yaml`;
+      console.log(
+        _chalk2.default.green(
+          `\u2713 Pulled ${_chalk2.default.cyan(`${name}@${versionSpec}`)} ${_chalk2.default.gray(
+            `(version ${version})`
+          )} \u2192 ${_chalk2.default.gray(displayPath)}`
+        )
+      );
+    }
+  }
+  if (result.cleaned.length > 0) {
+    for (const name of result.cleaned) {
+      console.log(
+        _chalk2.default.yellow(
+          `\u2713 Cleaned ${_chalk2.default.cyan(name)} (no longer in dependencies)`
+        )
+      );
+    }
+  }
+  if (result.errors.length > 0) {
+    for (const { name, error } of result.errors) {
+      console.error(_chalk2.default.red(`\u2717 Failed ${_chalk2.default.cyan(name)}: ${error}`));
+    }
+  }
+  const totalActions = result.fetched.length + result.cleaned.length;
+  if (totalActions === 0 && result.errors.length === 0) {
+    console.log(_chalk2.default.gray(`Pulled in ${duration}s, no changes`));
+  } else {
+    const summary = [];
+    if (result.fetched.length > 0)
+      summary.push(`${result.fetched.length} fetched`);
+    if (result.cleaned.length > 0)
+      summary.push(`${result.cleaned.length} cleaned`);
+    if (result.errors.length > 0)
+      summary.push(`${result.errors.length} errors`);
+    console.log(_chalk2.default.gray(`Pulled ${summary.join(", ")} in ${duration}s`));
+  }
+};
+var pullCommand = async (options) => {
+  console.log("\u2B07\uFE0F  Pulling remote prompts...");
+  const startTime = Date.now();
+  try {
+    _chunkTIAQGDR2js.checkApiKey.call(void 0, );
+    const promptsApiService = new (0, _chunk4Q4HSAKZjs.PromptsApiService)();
+    await _chunkB5TBCV6Njs.ensureProjectInitialized.call(void 0, false);
+    const config = _chunkZFFJYYDNjs.FileManager.loadPromptsConfig();
+    const lock = _chunkZFFJYYDNjs.FileManager.loadPromptsLock();
+    const result = {
+      fetched: [],
+      pushed: [],
+      unchanged: [],
+      cleaned: [],
+      errors: []
+    };
+    await pullPrompts({ config, lock, promptsApiService, result, tag: options == null ? void 0 : options.tag });
+    _chunkZFFJYYDNjs.FileManager.savePromptsLock(lock);
+    const duration = ((Date.now() - startTime) / 1e3).toFixed(1);
+    printPullResults({ result, lock, duration });
+    if (result.errors.length > 0) {
+      process.exit(1);
+    }
+  } catch (error) {
+    if (error instanceof _chunk4Q4HSAKZjs.PromptsError) {
+      console.error(_chalk2.default.red(`Error: ${error.message}`));
+    } else {
+      console.error(
+        _chalk2.default.red(
+          `Unexpected error: ${_chunkC5Y772G7js.formatApiErrorMessage.call(void 0, { error })}`
+        )
+      );
+    }
+    process.exit(1);
+  }
+};
+
+
+
+
+exports.pullPrompts = pullPrompts; exports.pullCommand = pullCommand;
+//# sourceMappingURL=chunk-DIILEB4J.js.map

package/dist/chunk-DIILEB4J.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["/home/runner/work/langwatch/langwatch/typescript-sdk/dist/chunk-DIILEB4J.js","../src/cli/commands/pull.ts"],"names":[],"mappings":"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","file":"/home/runner/work/langwatch/langwatch/typescript-sdk/dist/chunk-DIILEB4J.js","sourcesContent":[null,"import * as fs from \"fs\";\nimport * as path from \"path\";\nimport chalk from \"chalk\";\nimport ora from \"ora\";\nimport { PromptConverter } from \"@/cli/utils/promptConverter\";\nimport {\n  PromptsApiService,\n  PromptsError,\n} from \"@/client-sdk/services/prompts\";\nimport type { PromptsConfig, PromptsLock, SyncResult } from \"../types\";\nimport { FileManager } from \"../utils/fileManager\";\nimport { ensureProjectInitialized } from \"../utils/init\";\nimport { checkApiKey } from \"../utils/apiKey\";\nimport { formatApiErrorMessage } from \"@/client-sdk/services/_shared/format-api-error\";\n\n/**\n * Core pull logic: fetches remote prompts and materializes them locally.\n * Returns the result and mutates the lock object in place.\n */\nexport const pullPrompts = async ({\n  config,\n  lock,\n  promptsApiService,\n  result,\n  tag,\n}: {\n  config: PromptsConfig;\n  lock: PromptsLock;\n  promptsApiService: PromptsApiService;\n  result: SyncResult;\n  tag?: string;\n}): Promise<void> => {\n  const remoteDeps = Object.entries(config.prompts).filter(\n    ([, dependency]) => {\n      if (typeof dependency === \"object\" && dependency.file) {\n        return false;\n      }\n      if (typeof dependency === \"string\" && dependency.startsWith(\"file:\")) {\n        return false;\n      }\n      return true;\n    }\n  );\n\n  if (remoteDeps.length > 0) {\n    const fetchSpinner = ora(\n      `Checking ${remoteDeps.length} remote prompts...`\n    ).start();\n\n    for (const [name, dependency] of remoteDeps) {\n      try {\n        const versionSpec =\n          typeof dependency === \"string\"\n            ? dependency\n            : dependency.version ?? \"latest\";\n\n        const displaySpec = tag ?? versionSpec;\n\n        const lockEntry = lock.prompts[name];\n\n        const prompt = tag\n          ? await promptsApiService.get(name, { tag })\n          : await promptsApiService.get(name, { version: versionSpec });\n\n        if (prompt) {\n          const needsUpdate =\n            lockEntry?.version !== prompt.version ||\n            !lockEntry.materialized ||\n            !fs.existsSync(path.resolve(lockEntry.materialized));\n\n          if (needsUpdate) {\n            const materializedPrompt =\n              PromptConverter.fromApiToMaterialized(prompt);\n\n            const savedPath = FileManager.saveMaterializedPrompt(\n              name,\n              materializedPrompt\n            );\n            const relativePath = path.relative(process.cwd(), savedPath);\n            result.fetched.push({\n              name,\n              version: prompt.version,\n              versionSpec: displaySpec,\n            });\n\n            FileManager.updateLockEntry(\n              lock,\n              name,\n              materializedPrompt,\n              savedPath\n            );\n\n            fetchSpinner.text = `Fetched ${chalk.cyan(\n              `${name}@${displaySpec}`\n            )} ${chalk.gray(`(version ${prompt.version})`)} → ${chalk.gray(\n              relativePath\n            )}`;\n          } else {\n            result.unchanged.push(name);\n          }\n        } else {\n          result.errors.push({ name, error: \"Prompt not found\" });\n        }\n      } catch (error) {\n        const errorMessage =\n          formatApiErrorMessage({ error });\n        result.errors.push({ name, error: errorMessage });\n      }\n    }\n\n    fetchSpinner.stop();\n  }\n\n  // Cleanup orphaned materialized files\n  const currentDependencies = new Set(\n    Object.keys(config.prompts).filter((name) => {\n      const dependency = config.prompts[name];\n      if (typeof dependency === \"object\" && dependency.file) {\n        return false;\n      }\n      if (typeof dependency === \"string\" && dependency.startsWith(\"file:\")) {\n        return false;\n      }\n      return true;\n    })\n  );\n\n  const cleanedFiles =\n    FileManager.cleanupOrphanedMaterializedFiles(currentDependencies);\n  if (cleanedFiles.length > 0) {\n    result.cleaned = cleanedFiles;\n    FileManager.removeFromLock(lock, cleanedFiles);\n  }\n};\n\nconst printPullResults = ({\n  result,\n  lock,\n  duration,\n}: {\n  result: SyncResult;\n  lock: PromptsLock;\n  duration: string;\n}): void => {\n  if (result.fetched.length > 0) {\n    for (const { name, version, versionSpec } of result.fetched) {\n      const lockEntry = lock.prompts[name];\n      const displayPath = lockEntry?.materialized\n        ? `./${lockEntry.materialized}`\n        : `./prompts/.materialized/${name}.prompt.yaml`;\n\n      console.log(\n        chalk.green(\n          `✓ Pulled ${chalk.cyan(`${name}@${versionSpec}`)} ${chalk.gray(\n            `(version ${version})`\n          )} → ${chalk.gray(displayPath)}`\n        )\n      );\n    }\n  }\n\n  if (result.cleaned.length > 0) {\n    for (const name of result.cleaned) {\n      console.log(\n        chalk.yellow(\n          `✓ Cleaned ${chalk.cyan(name)} (no longer in dependencies)`\n        )\n      );\n    }\n  }\n\n  if (result.errors.length > 0) {\n    for (const { name, error } of result.errors) {\n      console.error(chalk.red(`✗ Failed ${chalk.cyan(name)}: ${error}`));\n    }\n  }\n\n  const totalActions = result.fetched.length + result.cleaned.length;\n\n  if (totalActions === 0 && result.errors.length === 0) {\n    console.log(chalk.gray(`Pulled in ${duration}s, no changes`));\n  } else {\n    const summary = [];\n    if (result.fetched.length > 0)\n      summary.push(`${result.fetched.length} fetched`);\n    if (result.cleaned.length > 0)\n      summary.push(`${result.cleaned.length} cleaned`);\n    if (result.errors.length > 0)\n      summary.push(`${result.errors.length} errors`);\n\n    console.log(chalk.gray(`Pulled ${summary.join(\", \")} in ${duration}s`));\n  }\n};\n\nexport const pullCommand = async (options?: { tag?: string }): Promise<void> => {\n  console.log(\"⬇️  Pulling remote prompts...\");\n\n  const startTime = Date.now();\n\n  try {\n    checkApiKey();\n\n    const promptsApiService = new PromptsApiService();\n\n    await ensureProjectInitialized(false);\n\n    const config = FileManager.loadPromptsConfig();\n    const lock = FileManager.loadPromptsLock();\n\n    const result: SyncResult = {\n      fetched: [],\n      pushed: [],\n      unchanged: [],\n      cleaned: [],\n      errors: [],\n    };\n\n    await pullPrompts({ config, lock, promptsApiService, result, tag: options?.tag });\n\n    FileManager.savePromptsLock(lock);\n\n    const duration = ((Date.now() - startTime) / 1000).toFixed(1);\n    printPullResults({ result, lock, duration });\n\n    if (result.errors.length > 0) {\n      process.exit(1);\n    }\n  } catch (error) {\n    if (error instanceof PromptsError) {\n      console.error(chalk.red(`Error: ${error.message}`));\n    } else {\n      console.error(\n        chalk.red(\n          `Unexpected error: ${\n            formatApiErrorMessage({ error })\n          }`\n        )\n      );\n    }\n    process.exit(1);\n  }\n};\n"]}