langwatch 0.3.2 → 0.4.1

package/dist/chunk-IZ2U3ABC.mjs

@@ -0,0 +1,636 @@
+import {
+  getLangWatchTracer
+} from "./chunk-EJWJXTPU.mjs";
+import {
+  LANGWATCH_SDK_NAME_CLIENT,
+  LANGWATCH_SDK_VERSION
+} from "./chunk-FQSWUK5N.mjs";
+import {
+  shouldCaptureInput,
+  shouldCaptureOutput
+} from "./chunk-YNQ44U6D.mjs";
+import {
+  PromptConverter
+} from "./chunk-SYMZPWZE.mjs";
+import {
+  __spreadProps,
+  __spreadValues
+} from "./chunk-CU3443HD.mjs";
+
+// src/client-sdk/services/prompts/prompt.ts
+import { Liquid } from "liquidjs";
+
+// src/client-sdk/services/prompts/tracing/prompt-tracing.decorator.ts
+var PromptTracingDecorator = class {
+  constructor(target) {
+    this.target = target;
+  }
+  traceCompilation(span, variables, compileFn) {
+    var _a;
+    span.setType("prompt");
+    if (shouldCaptureInput()) {
+      span.setInput(this.target.raw);
+      if (variables) {
+        span.setAttribute(
+          "langwatch.prompt.variables",
+          JSON.stringify({
+            type: "json",
+            value: variables
+          })
+        );
+      }
+    }
+    const result = compileFn();
+    span.setAttributes({
+      "langwatch.prompt.id": result.id,
+      "langwatch.prompt.handle": (_a = result.handle) != null ? _a : "",
+      "langwatch.prompt.version.id": result.versionId,
+      "langwatch.prompt.version.number": result.version
+    });
+    if (shouldCaptureOutput()) {
+      span.setOutput(result.raw);
+    }
+    return result;
+  }
+  compile(span, variables = {}) {
+    return this.traceCompilation(
+      span,
+      variables,
+      () => this.target.compile(variables)
+    );
+  }
+  compileStrict(span, variables) {
+    return this.traceCompilation(
+      span,
+      variables,
+      () => this.target.compileStrict(variables)
+    );
+  }
+};
+
+// src/client-sdk/services/prompts/tracing/prompt-service-tracing.decorator.ts
+var PromptServiceTracingDecorator = class {
+  constructor(target) {
+    this.target = target;
+  }
+  async get(span, id, options) {
+    var _a;
+    span.setType("prompt");
+    span.setAttribute("langwatch.prompt.id", id);
+    const result = await this.target.get(id, options);
+    if (result) {
+      span.setAttributes({
+        "langwatch.prompt.id": result.id,
+        "langwatch.prompt.handle": (_a = result.handle) != null ? _a : "",
+        "langwatch.prompt.version.id": result.versionId,
+        "langwatch.prompt.version.number": result.version
+      });
+    }
+    if (result && shouldCaptureOutput()) {
+      span.setOutput("json", result.raw);
+    }
+    return result;
+  }
+  async create(span, params) {
+    var _a;
+    span.setType("prompt");
+    if (shouldCaptureInput()) {
+      span.setInput(params);
+    }
+    const result = await this.target.create(params);
+    span.setAttribute("langwatch.prompt.id", result.id);
+    span.setAttribute("langwatch.prompt.handle", (_a = result.handle) != null ? _a : "");
+    span.setAttribute("langwatch.prompt.scope", result.scope);
+    span.setAttribute("langwatch.prompt.version.id", result.versionId);
+    span.setAttribute("langwatch.prompt.version.number", result.version);
+    return result;
+  }
+  async update(span, id, params) {
+    var _a;
+    if (shouldCaptureInput()) {
+      span.setInput(params);
+    }
+    const result = await this.target.update(id, params);
+    span.setType("prompt");
+    span.setAttribute("langwatch.prompt.id", id);
+    span.setAttribute("langwatch.prompt.handle", (_a = result.handle) != null ? _a : "");
+    span.setAttribute("langwatch.prompt.scope", result.scope);
+    span.setAttribute("langwatch.prompt.version.id", result.versionId);
+    span.setAttribute("langwatch.prompt.version.number", result.version);
+    return result;
+  }
+  async delete(span, id) {
+    const result = await this.target.delete(id);
+    span.setType("prompt");
+    span.setAttribute("langwatch.prompt.id", id);
+    span.setAttribute("langwatch.prompt.deleted", "true");
+    return result;
+  }
+  async upsert(span, handle, config) {
+    if (shouldCaptureInput()) {
+      span.setInput(config);
+    }
+    const result = await this.target.upsert(handle, config);
+    span.setType("prompt");
+    span.setAttribute("langwatch.prompt.handle", handle);
+    span.setAttribute("langwatch.prompt.created", result.created.toString());
+    span.setAttribute("langwatch.prompt.id", result.prompt.id);
+    span.setAttribute("langwatch.prompt.version.id", result.prompt.versionId);
+    span.setAttribute("langwatch.prompt.version.number", result.prompt.version);
+    return result;
+  }
+  async sync(span, params) {
+    if (shouldCaptureInput()) {
+      span.setInput(params);
+    }
+    const result = await this.target.sync(params);
+    span.setType("prompt");
+    span.setAttribute("langwatch.prompt.name", params.name);
+    span.setAttribute("langwatch.prompt.sync.action", result.action);
+    if (result.conflictInfo) {
+      span.setAttribute("langwatch.prompt.sync.has_conflict", "true");
+      span.setAttribute("langwatch.prompt.sync.local_version", result.conflictInfo.localVersion.toString());
+      span.setAttribute("langwatch.prompt.sync.remote_version", result.conflictInfo.remoteVersion.toString());
+    }
+    return result;
+  }
+};
+
+// src/client-sdk/services/prompts/tracing/tracer.ts
+var tracer = getLangWatchTracer(`${LANGWATCH_SDK_NAME_CLIENT}.prompts`, LANGWATCH_SDK_VERSION);
+
+// src/client-sdk/tracing/create-tracing-proxy.ts
+import { SpanKind } from "@opentelemetry/api";
+function createTracingProxy(target, tracer2, DecoratorClass) {
+  const decorator = DecoratorClass ? new DecoratorClass(target) : null;
+  return new Proxy(target, {
+    get(target2, prop, receiver) {
+      const value = Reflect.get(target2, prop, receiver);
+      if (typeof value !== "function") {
+        return value;
+      }
+      if (typeof prop === "string" && !prop.startsWith("_") && // Skip private methods
+      !isGetterOrSetter(target2, prop) && // Skip actual getters/setters
+      !isBuiltInMethod(prop)) {
+        return (...args) => {
+          const spanName = `${target2.constructor.name}.${prop}`;
+          return tracer2.withActiveSpan(spanName, {
+            kind: SpanKind.CLIENT,
+            attributes: {
+              "code.function": prop,
+              "code.namespace": target2.constructor.name
+            }
+          }, (span) => {
+            if (decorator && prop in decorator) {
+              const decoratorMethod = decorator[prop];
+              if (typeof decoratorMethod === "function") {
+                return decoratorMethod.apply(decorator, [span, ...args]);
+              }
+            }
+            return value.apply(target2, args);
+          });
+        };
+      }
+      return typeof value === "function" ? value.bind(target2) : value;
+    }
+  });
+}
+var isGetterOrSetter = (target, prop) => {
+  var _a;
+  let descriptor = Object.getOwnPropertyDescriptor(target, prop);
+  if (!descriptor) {
+    const prototype = Object.getPrototypeOf(target);
+    if (prototype) {
+      descriptor = Object.getOwnPropertyDescriptor(prototype, prop);
+    }
+  }
+  return !!((_a = descriptor == null ? void 0 : descriptor.get) != null ? _a : descriptor == null ? void 0 : descriptor.set);
+};
+var isBuiltInMethod = (prop) => {
+  if (typeof prop !== "string") {
+    return false;
+  }
+  const builtInMethods = [
+    "toString",
+    "valueOf",
+    "toJSON",
+    "toLocaleString",
+    "hasOwnProperty",
+    "isPrototypeOf",
+    "propertyIsEnumerable",
+    "constructor"
+  ];
+  return builtInMethods.includes(prop);
+};
+
+// src/client-sdk/services/prompts/prompt.ts
+var PromptCompilationError = class extends Error {
+  constructor(message, template, originalError) {
+    super(message);
+    this.template = template;
+    this.originalError = originalError;
+    this.name = "PromptCompilationError";
+  }
+};
+var liquid = new Liquid({
+  strictFilters: true
+});
+var Prompt = class {
+  constructor(promptData) {
+    this.promptData = promptData;
+    this.id = promptData.id;
+    this.handle = promptData.handle;
+    this.scope = promptData.scope;
+    this.name = promptData.name;
+    this.updatedAt = promptData.updatedAt;
+    this.version = promptData.version;
+    this.versionId = promptData.versionId;
+    this.versionCreatedAt = promptData.versionCreatedAt;
+    this.model = promptData.model;
+    this.prompt = promptData.prompt;
+    this.messages = promptData.messages;
+    this.response_format = promptData.response_format;
+    return createTracingProxy(this, tracer, PromptTracingDecorator);
+  }
+  /**
+   * Get the raw prompt data from the API
+   */
+  get raw() {
+    return this.promptData;
+  }
+  /**
+   * Compile the prompt template with provided variables (lenient - missing variables become empty)
+   * @param variables - Object containing variable values for template compilation
+   * @returns CompiledPrompt instance with compiled content
+   */
+  _compile(variables, strict) {
+    try {
+      const compiledPrompt = this.prompt ? liquid.parseAndRenderSync(this.prompt, variables, {
+        strictVariables: strict
+      }) : "";
+      const compiledMessages = (this.messages || []).map((message) => __spreadProps(__spreadValues({}, message), {
+        content: message.content ? liquid.parseAndRenderSync(message.content, variables, {
+          strictVariables: strict
+        }) : message.content
+      }));
+      const compiledData = __spreadProps(__spreadValues({}, this), {
+        prompt: compiledPrompt,
+        messages: compiledMessages
+      });
+      return new CompiledPrompt(compiledData, this);
+    } catch (error) {
+      const templateStr = this.prompt || JSON.stringify(this.messages);
+      throw new PromptCompilationError(
+        `Failed to compile prompt template: ${error instanceof Error ? error.message : "Unknown error"}`,
+        templateStr,
+        error
+      );
+    }
+  }
+  compile(variables = {}) {
+    return this._compile(variables, false);
+  }
+  /**
+   * Compile with validation - throws error if required variables are missing
+   * @param variables - Template variables
+   * @returns CompiledPrompt instance with compiled content
+   */
+  compileStrict(variables) {
+    return this._compile(variables, true);
+  }
+};
+var CompiledPrompt = class extends Prompt {
+  constructor(compiledData, original) {
+    super(compiledData);
+    this.original = original;
+  }
+};
+
+// src/client-sdk/services/prompts/service.ts
+var PromptsError = class extends Error {
+  constructor(message, operation, originalError) {
+    super(message);
+    this.operation = operation;
+    this.originalError = originalError;
+    this.name = "PromptsError";
+  }
+};
+var PromptsService = class {
+  constructor(config) {
+    this.config = config;
+    return createTracingProxy(
+      this,
+      tracer,
+      PromptServiceTracingDecorator
+    );
+  }
+  /**
+   * Handles API errors by throwing a PromptsError with operation context.
+   * @param operation Description of the operation being performed.
+   * @param error The error object returned from the API client.
+   * @throws {PromptsError}
+   */
+  handleApiError(operation, error) {
+    var _a, _b;
+    const errorMessage = typeof error === "string" ? error : (_b = (_a = error == null ? void 0 : error.error) != null ? _a : error == null ? void 0 : error.message) != null ? _b : "Unknown error occurred";
+    throw new PromptsError(
+      `Failed to ${operation}: ${errorMessage}`,
+      operation,
+      error
+    );
+  }
+  /**
+   * Fetches all prompts from the API.
+   * @returns Array of Prompt instances.
+   * @throws {PromptsError} If the API call fails.
+   */
+  async getAll() {
+    const { data, error } = await this.config.langwatchApiClient.GET("/api/prompts");
+    if (error) this.handleApiError("fetch all prompts", error);
+    return data.map((promptData) => new Prompt(promptData));
+  }
+  /**
+   * Fetches a single prompt by its ID.
+   * @param id The prompt's unique identifier.
+   * @returns The Prompt instance.
+   * @throws {PromptsError} If the API call fails.
+   */
+  async get(id, options) {
+    const { data, error } = await this.config.langwatchApiClient.GET("/api/prompts/{id}", {
+      params: { path: { id } },
+      query: {
+        version: options == null ? void 0 : options.version
+      }
+    });
+    if (error) {
+      this.handleApiError(`fetch prompt with ID "${id}"`, error);
+    }
+    return new Prompt(data);
+  }
+  /**
+   * Validates if a prompt exists.
+   * @param id The prompt's unique identifier.
+   * @returns True if prompt exists, false otherwise.
+   * @throws {PromptsError} If the API call fails (not 404).
+   */
+  async exists(id) {
+    var _a;
+    try {
+      await this.get(id);
+      return true;
+    } catch (error) {
+      if (error instanceof PromptsError && ((_a = error.originalError) == null ? void 0 : _a.statusCode) === 404) {
+        return false;
+      }
+      throw error;
+    }
+  }
+  /**
+   * Creates a new prompt.
+   * @param params The prompt creation payload, matching the OpenAPI schema.
+   * @returns The created Prompt instance.
+   * @throws {PromptsError} If the API call fails.
+   */
+  async create(params) {
+    const { data, error } = await this.config.langwatchApiClient.POST("/api/prompts", {
+      body: params
+    });
+    if (error) this.handleApiError("create prompt", error);
+    return new Prompt(data);
+  }
+  /**
+   * Updates an existing prompt.
+   * @param id The prompt's unique identifier.
+   * @param params The update payload, matching the OpenAPI schema.
+   * @returns The updated Prompt instance.
+   * @throws {PromptsError} If the API call fails.
+   * @remarks
+   *   The API does not return the updated prompt directly, so this method fetches it after updating.
+   */
+  async update(id, params) {
+    const { error } = await this.config.langwatchApiClient.PUT("/api/prompts/{id}", {
+      params: { path: { id } },
+      body: params
+    });
+    if (error) this.handleApiError(`update prompt with ID "${id}"`, error);
+    const updatedPrompt = await this.get(id);
+    if (!updatedPrompt) {
+      throw new PromptsError(
+        "Prompt not found after update",
+        "update prompt",
+        null
+      );
+    }
+    return updatedPrompt;
+  }
+  /**
+   * Deletes a prompt by its ID.
+   * @param id The prompt's unique identifier.
+   * @throws {PromptsError} If the API call fails.
+   */
+  async delete(id) {
+    const { data, error } = await this.config.langwatchApiClient.DELETE("/api/prompts/{id}", {
+      params: { path: { id } }
+    });
+    if (error) this.handleApiError(`delete prompt with ID "${id}"`, error);
+    return data;
+  }
+  /**
+   * Fetches all versions for a given prompt.
+   * @param id The prompt's unique identifier.
+   * @throws {PromptsError} If the API call fails.
+   */
+  async getVersions(id) {
+    var _a;
+    const { data, error } = await this.config.langwatchApiClient.GET(
+      "/api/prompts/{id}/versions",
+      {
+        params: { path: { id } }
+      }
+    );
+    if (error)
+      this.handleApiError(`fetch versions for prompt with ID "${id}"`, error);
+    const prompts = {};
+    const dataTypeCorrected = data;
+    for (const version of dataTypeCorrected) {
+      prompts[version.id] = new Prompt({
+        id: version.configId,
+        handle: version.handle,
+        scope: version.scope,
+        messages: version.configData.messages,
+        model: version.configData.model,
+        prompt: version.configData.prompt,
+        response_format: null,
+        name: `Prompt ${version.configId}@${version.id}`,
+        updatedAt: version.createdAt,
+        version: (_a = version.configData.version) != null ? _a : 0,
+        versionCreatedAt: version.createdAt,
+        versionId: version.id
+      });
+    }
+    return prompts;
+  }
+  /**
+   * Creates a new version for a given prompt.
+   * @param id The prompt's unique identifier.
+   * @param params The version creation payload, matching the OpenAPI schema.
+   * @returns The updated Prompt instance.
+   * @throws {PromptsError} If the API call fails.
+   * @remarks
+   *   The API does not return the updated prompt directly, so this method fetches it after creation.
+   */
+  async createVersion(id, params) {
+    const { error } = await this.config.langwatchApiClient.POST("/api/prompts/{id}/versions", {
+      params: { path: { id } },
+      body: params
+    });
+    if (error)
+      this.handleApiError(`create version for prompt with ID "${id}"`, error);
+    const updatedPrompt = await this.get(id);
+    if (!updatedPrompt) {
+      throw new PromptsError(
+        "Prompt not found after version creation",
+        "create version",
+        null
+      );
+    }
+    return updatedPrompt;
+  }
+  /**
+   * Upserts a prompt with local configuration - creates if doesn't exist, updates version if exists.
+   * @param handle The prompt's handle/identifier.
+   * @param config Local prompt configuration.
+   * @returns Object with created flag and the prompt instance.
+   * @throws {PromptsError} If the API call fails.
+   */
+  async upsert(handle, config) {
+    var _a, _b;
+    let prompt = await this.get(handle);
+    let created = false;
+    if (!prompt) {
+      prompt = await this.create({ handle });
+      created = true;
+    }
+    const versionData = {
+      configData: {
+        version: 1,
+        model: config.model,
+        prompt: PromptConverter.extractSystemPrompt(config.messages),
+        messages: PromptConverter.filterNonSystemMessages(config.messages),
+        temperature: (_a = config.modelParameters) == null ? void 0 : _a.temperature,
+        max_tokens: (_b = config.modelParameters) == null ? void 0 : _b.max_tokens,
+        inputs: [{ identifier: "input", type: "str" }],
+        outputs: [{ identifier: "output", type: "str" }]
+      },
+      commitMessage: `Updated via CLI sync`,
+      projectId: "placeholder",
+      // Will be overridden by the API
+      configId: prompt.id,
+      schemaVersion: "1.0",
+      version: 1
+      // Will be auto-incremented by the API
+    };
+    const updatedPrompt = await this.createVersion(prompt.id, versionData);
+    return {
+      created,
+      prompt: updatedPrompt
+    };
+  }
+  /**
+   * Sync a prompt with local content, handling conflicts and version management
+   */
+  async sync(params) {
+    var _a, _b;
+    try {
+      const response = await this.config.langwatchApiClient.POST("/api/prompts/{id}/sync", {
+        params: { path: { id: params.name } },
+        body: {
+          configData: params.configData,
+          localVersion: params.localVersion,
+          commitMessage: params.commitMessage
+        }
+      });
+      if (response.error) {
+        const errorMessage = (_b = (_a = response.error) == null ? void 0 : _a.error) != null ? _b : JSON.stringify(response.error);
+        throw new Error(`Failed to sync prompt: ${errorMessage}`);
+      }
+      return {
+        action: response.data.action,
+        prompt: response.data.prompt,
+        conflictInfo: response.data.conflictInfo
+      };
+    } catch (error) {
+      const message = error instanceof Error ? error.message : "Unknown error occurred";
+      throw new PromptsError(message, "sync", error);
+    }
+  }
+};
+
+// src/client-sdk/services/prompts/facade.ts
+var PromptsFacade = class {
+  constructor(config) {
+    this.config = config;
+    this.service = new PromptsService(config);
+  }
+  /**
+   * Creates a new prompt.
+   * @param data The prompt creation payload.
+   * @returns The created Prompt instance.
+   * @throws {PromptsError} If the API call fails.
+   */
+  async create(data) {
+    return this.service.create(data);
+  }
+  /**
+   * Retrieves a prompt by handle or ID.
+   * @param handleOrId The prompt's handle or unique identifier.
+   * @param options Optional parameters for the request.
+   * @returns The Prompt instance or null if not found.
+   * @throws {PromptsError} If the API call fails.
+   */
+  async get(handleOrId, options) {
+    return this.service.get(handleOrId, options);
+  }
+  /**
+   * Retrieves all prompts.
+   * @returns Array of Prompt instances.
+   * @throws {PromptsError} If the API call fails.
+   */
+  async getAll() {
+    return this.service.getAll();
+  }
+  /**
+   * Updates an existing prompt.
+   * @param handleOrId The prompt's handle or unique identifier.
+   * @param newData The update payload.
+   * @returns The updated Prompt instance.
+   * @throws {PromptsError} If the API call fails.
+   */
+  async update(handleOrId, newData) {
+    return this.service.update(handleOrId, newData);
+  }
+  /**
+   * Deletes a prompt by handle or ID.
+   * @param handleOrId The prompt's handle or unique identifier.
+   * @throws {PromptsError} If the API call fails.
+   */
+  async delete(handleOrId) {
+    return this.service.delete(handleOrId);
+  }
+  /**
+   * Syncs a prompt with the server.
+   * @param params The sync parameters.
+   * @returns The sync result.
+   * @throws {PromptsError} If the API call fails.
+   */
+  async sync(params) {
+    return this.service.sync(params);
+  }
+};
+
+export {
+  createTracingProxy,
+  PromptsError,
+  PromptsFacade
+};
+//# sourceMappingURL=chunk-IZ2U3ABC.mjs.map