@paid-ai/paid-node 0.5.0-alpha2 → 0.5.0

package/dist/cjs/tracing/wrappers/vercelAIWrapper.js

@@ -16,28 +16,29 @@ exports.streamObject = streamObject;
 exports.embed = embed;
 exports.embedMany = embedMany;
 const api_1 = require("@opentelemetry/api");
-const tracing_js_1 = require("../tracing.js");
 const ai_1 = require("ai");
+const tracing_js_1 = require("tracing/tracing.js");
+const tracingContext_js_1 = require("tracing/tracingContext.js");
 function getModelInfo(model) {
     if (model === null || model === void 0 ? void 0 : model.modelId) {
         const modelId = model.modelId;
-        if (modelId.startsWith('gpt-') || modelId.startsWith('text-embedding-') || modelId.startsWith('dall-e-')) {
-            return { system: 'openai', modelName: modelId };
+        if (modelId.startsWith("gpt-") || modelId.startsWith("text-embedding-") || modelId.startsWith("dall-e-")) {
+            return { system: "openai", modelName: modelId };
         }
-        if (modelId.startsWith('claude-')) {
-            return { system: 'anthropic', modelName: modelId };
+        if (modelId.startsWith("claude-")) {
+            return { system: "anthropic", modelName: modelId };
         }
-        if (modelId.startsWith('mistral-') || modelId.startsWith('codestral-')) {
-            return { system: 'mistral', modelName: modelId };
+        if (modelId.startsWith("mistral-") || modelId.startsWith("codestral-")) {
+            return { system: "mistral", modelName: modelId };
         }
-        if (modelId.includes('gemini')) {
-            return { system: 'google', modelName: modelId };
+        if (modelId.includes("gemini")) {
+            return { system: "google", modelName: modelId };
         }
     }
     if (model === null || model === void 0 ? void 0 : model.provider) {
         return { system: model.provider, modelName: model.modelId };
     }
-    return { system: 'unknown' };
+    return { system: "unknown" };
 }
 function extractUsageMetrics(usage) {
     const usageAttrs = {};
@@ -59,14 +60,14 @@ function extractUsageMetrics(usage) {
     return usageAttrs;
 }
 function validateContext() {
-    const externalCustomerId = (0, tracing_js_1.getCustomerIdStorage)();
-    const token = (0, tracing_js_1.getTokenStorage)();
+    const token = (0, tracing_js_1.getToken)();
+    const { externalCustomerId, externalProductId } = (0, tracingContext_js_1.getTracingContext)();
     if (!token || !externalCustomerId) {
         throw new Error("No token or externalCustomerId: This wrapper should be used inside a callback to paid.trace().");
     }
     return {
         externalCustomerId,
-        externalAgentId: (0, tracing_js_1.getAgentIdStorage)(),
+        externalProductId,
         token,
     };
 }
@@ -74,16 +75,20 @@ function generateText(params) {
     return __awaiter(this, void 0, void 0, function* () {
         const context = validateContext();
         const { system: aiSystem, modelName } = getModelInfo(params.model);
-        return tracing_js_1.paidTracer.startActiveSpan("trace.ai-sdk.generateText", (span) => __awaiter(this, void 0, void 0, function* () {
+        const tracer = (0, tracing_js_1.getPaidTracer)();
+        if (!tracer) {
+            throw new Error("Paid tracer is not initialized, Make sure to call 'initializeTracing()' first");
+        }
+        return tracer.startActiveSpan("trace.ai-sdk.generateText", (span) => __awaiter(this, void 0, void 0, function* () {
             var _a;
             const attributes = {
                 "gen_ai.system": aiSystem,
                 "gen_ai.operation.name": "chat",
-                "external_customer_id": context.externalCustomerId,
-                "token": context.token,
+                external_customer_id: context.externalCustomerId,
+                token: context.token,
             };
-            if (context.externalAgentId) {
-                attributes["external_agent_id"] = context.externalAgentId;
+            if (context.externalProductId) {
+                attributes["external_agent_id"] = context.externalProductId;
             }
             if (modelName) {
                 attributes["gen_ai.request.model"] = modelName;
@@ -116,15 +121,19 @@ function streamText(params) {
     return __awaiter(this, void 0, void 0, function* () {
         const context = validateContext();
         const { system: aiSystem, modelName } = getModelInfo(params.model);
-        return tracing_js_1.paidTracer.startActiveSpan("trace.ai-sdk.streamText", (span) => __awaiter(this, void 0, void 0, function* () {
+        const tracer = (0, tracing_js_1.getPaidTracer)();
+        if (!tracer) {
+            throw new Error("Paid tracer is not initialized, Make sure to call 'initializeTracing()' first");
+        }
+        return tracer.startActiveSpan("trace.ai-sdk.streamText", (span) => __awaiter(this, void 0, void 0, function* () {
             const attributes = {
                 "gen_ai.system": aiSystem,
                 "gen_ai.operation.name": "chat",
-                "external_customer_id": context.externalCustomerId,
-                "token": context.token,
+                external_customer_id: context.externalCustomerId,
+                token: context.token,
             };
-            if (context.externalAgentId) {
-                attributes["external_agent_id"] = context.externalAgentId;
+            if (context.externalProductId) {
+                attributes["external_agent_id"] = context.externalProductId;
             }
             if (modelName) {
                 attributes["gen_ai.request.model"] = modelName;
@@ -161,16 +170,20 @@ function generateObject(params) {
     return __awaiter(this, void 0, void 0, function* () {
         const context = validateContext();
         const { system: aiSystem, modelName } = getModelInfo(params.model);
-        return tracing_js_1.paidTracer.startActiveSpan("trace.ai-sdk.generateObject", (span) => __awaiter(this, void 0, void 0, function* () {
+        const tracer = (0, tracing_js_1.getPaidTracer)();
+        if (!tracer) {
+            throw new Error("Paid tracer is not initialized, Make sure to call 'initializeTracing()' first");
+        }
+        return tracer.startActiveSpan("trace.ai-sdk.generateObject", (span) => __awaiter(this, void 0, void 0, function* () {
             var _a;
             const attributes = {
                 "gen_ai.system": aiSystem,
                 "gen_ai.operation.name": "chat",
-                "external_customer_id": context.externalCustomerId,
-                "token": context.token,
+                external_customer_id: context.externalCustomerId,
+                token: context.token,
             };
-            if (context.externalAgentId) {
-                attributes["external_agent_id"] = context.externalAgentId;
+            if (context.externalProductId) {
+                attributes["external_agent_id"] = context.externalProductId;
             }
             if (modelName) {
                 attributes["gen_ai.request.model"] = modelName;
@@ -203,15 +216,19 @@ function streamObject(params) {
     return __awaiter(this, void 0, void 0, function* () {
         const context = validateContext();
         const { system: aiSystem, modelName } = getModelInfo(params.model);
-        return tracing_js_1.paidTracer.startActiveSpan("trace.ai-sdk.streamObject", (span) => __awaiter(this, void 0, void 0, function* () {
+        const tracer = (0, tracing_js_1.getPaidTracer)();
+        if (!tracer) {
+            throw new Error("Paid tracer is not initialized, Make sure to call 'initializeTracing()' first");
+        }
+        return tracer.startActiveSpan("trace.ai-sdk.streamObject", (span) => __awaiter(this, void 0, void 0, function* () {
             const attributes = {
                 "gen_ai.system": aiSystem,
                 "gen_ai.operation.name": "chat",
-                "external_customer_id": context.externalCustomerId,
-                "token": context.token,
+                external_customer_id: context.externalCustomerId,
+                token: context.token,
             };
-            if (context.externalAgentId) {
-                attributes["external_agent_id"] = context.externalAgentId;
+            if (context.externalProductId) {
+                attributes["external_agent_id"] = context.externalProductId;
             }
             if (modelName) {
                 attributes["gen_ai.request.model"] = modelName;
@@ -245,15 +262,19 @@ function embed(params) {
     return __awaiter(this, void 0, void 0, function* () {
         const context = validateContext();
         const { system: aiSystem, modelName } = getModelInfo(params.model);
-        return tracing_js_1.paidTracer.startActiveSpan("trace.ai-sdk.embed", (span) => __awaiter(this, void 0, void 0, function* () {
+        const tracer = (0, tracing_js_1.getPaidTracer)();
+        if (!tracer) {
+            throw new Error("Paid tracer is not initialized, Make sure to call 'initializeTracing()' first");
+        }
+        return tracer.startActiveSpan("trace.ai-sdk.embed", (span) => __awaiter(this, void 0, void 0, function* () {
             const attributes = {
                 "gen_ai.system": aiSystem,
                 "gen_ai.operation.name": "embeddings",
-                "external_customer_id": context.externalCustomerId,
-                "token": context.token,
+                external_customer_id: context.externalCustomerId,
+                token: context.token,
             };
-            if (context.externalAgentId) {
-                attributes["external_agent_id"] = context.externalAgentId;
+            if (context.externalProductId) {
+                attributes["external_agent_id"] = context.externalProductId;
             }
             if (modelName) {
                 attributes["gen_ai.request.model"] = modelName;
@@ -283,15 +304,19 @@ function embedMany(params) {
     return __awaiter(this, void 0, void 0, function* () {
         const context = validateContext();
         const { system: aiSystem, modelName } = getModelInfo(params.model);
-        return tracing_js_1.paidTracer.startActiveSpan("trace.ai-sdk.embedMany", (span) => __awaiter(this, void 0, void 0, function* () {
+        const tracer = (0, tracing_js_1.getPaidTracer)();
+        if (!tracer) {
+            throw new Error("Paid tracer is not initialized, Make sure to call 'initializeTracing()' first");
+        }
+        return tracer.startActiveSpan("trace.ai-sdk.embedMany", (span) => __awaiter(this, void 0, void 0, function* () {
             const attributes = {
                 "gen_ai.system": aiSystem,
                 "gen_ai.operation.name": "embeddings",
-                "external_customer_id": context.externalCustomerId,
-                "token": context.token,
+                external_customer_id: context.externalCustomerId,
+                token: context.token,
             };
-            if (context.externalAgentId) {
-                attributes["external_agent_id"] = context.externalAgentId;
+            if (context.externalProductId) {
+                attributes["external_agent_id"] = context.externalProductId;
             }
             if (modelName) {
                 attributes["gen_ai.request.model"] = modelName;

package/dist/cjs/version.d.ts

@@ -1 +1 @@
-export declare const SDK_VERSION = "0.5.0-alpha2";
+export declare const SDK_VERSION = "0.9.0";

package/dist/cjs/version.js

@@ -1,4 +1,4 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.SDK_VERSION = void 0;
-exports.SDK_VERSION = "0.5.0-alpha2";
+exports.SDK_VERSION = "0.9.0";

package/dist/esm/Client.d.mts

@@ -5,15 +5,19 @@ import * as environments from "./environments.mjs";
 import * as core from "./core/index.mjs";
 import { Customers } from "./api/resources/customers/client/Client.mjs";
 import { Agents } from "./api/resources/agents/client/Client.mjs";
+import { Products } from "./api/resources/products/client/Client.mjs";
 import { Contacts } from "./api/resources/contacts/client/Client.mjs";
 import { Orders } from "./api/resources/orders/client/Client.mjs";
+import { Plans } from "./api/resources/plans/client/Client.mjs";
 import { Usage } from "./wrapper/BatchUsage.mjs";
+import { Traces } from "./api/resources/traces/client/Client.mjs";
+import { NodeTracerProvider } from "@opentelemetry/sdk-trace-node";
 export declare namespace PaidClient {
     interface Options {
         environment?: core.Supplier<environments.PaidEnvironment | string>;
         /** Specify a custom URL to connect the client to. */
         baseUrl?: core.Supplier<string>;
-        token: core.Supplier<core.BearerToken>;
+        token?: core.Supplier<core.BearerToken | undefined>;
         /** Additional headers to include in requests. */
         headers?: Record<string, string | core.Supplier<string | undefined> | undefined>;
     }
@@ -32,18 +36,41 @@ export declare class PaidClient {
     protected readonly _options: PaidClient.Options;
     protected _customers: Customers | undefined;
     protected _agents: Agents | undefined;
+    protected _products: Products | undefined;
     protected _contacts: Contacts | undefined;
     protected _orders: Orders | undefined;
+    protected _plans: Plans | undefined;
     protected _usage: Usage | undefined;
-    constructor(_options: PaidClient.Options);
+    protected _traces: Traces | undefined;
+    constructor(_options?: PaidClient.Options);
     get customers(): Customers;
     get agents(): Agents;
+    get products(): Products;
     get contacts(): Contacts;
     get orders(): Orders;
+    get plans(): Plans;
     get usage(): Usage;
+    get traces(): Traces;
+    /**
+     * @deprecated use the standalone 'initializeTracing' instead
+     */
     initializeTracing(collectorEndpoint?: string): Promise<void>;
-    trace<T extends (...args: any[]) => any>(externalCustomerId: string, fn: T, externalAgentId?: string, ...args: Parameters<T>): Promise<ReturnType<T>>;
     /**
+     * @deprecated use the standalone 'trace()' instead
+     * Use this method to track actions like LLM costs and sending signals.
+     * The callback to this function is the work that you want to trace.
+     *
+     * @param externalCustomerId - The external customer ID
+     * @param fn - The callback function containing the work to be traced
+     * @param externalAgentId - @deprecated Use externalProductId instead
+     * @param externalProductId - The external product ID
+     * @param storePrompt - Whether to store the prompt (defaults to false)
+     * @param args - Arguments to pass to the callback function
+     * @returns The return value of the callback function
+     */
+    trace<T extends (...args: any[]) => any>(externalCustomerId: string, fn: T, externalAgentId?: string, externalProductId?: string, storePrompt?: boolean, ...args: Parameters<T>): Promise<ReturnType<T>>;
+    /**
+     * @deprecated use the standalone 'signal()' instead
      * Sends Paid signal. Needs to be called as part of callback to Paid.trace().
      * When enableCostTracing flag is on, signal is associated
      * with cost traces from the same Paid.trace() context.
@@ -63,4 +90,9 @@ export declare class PaidClient {
     signal(eventName: string): void;
     signal(eventName: string, data: Record<string, any>): void;
     signal(eventName: string, enableCostTracing: boolean, data?: Record<string, any>): void;
+    /**
+     * @deprecated use the standalone 'getPaidTracerProvider()' instead
+     * Export the tracer provider which user can use for his own tracing.
+     */
+    get tracerProvider(): NodeTracerProvider | undefined;
 }

package/dist/esm/Client.mjs

@@ -14,18 +14,20 @@ import * as core from "./core/index.mjs";
 import { mergeHeaders } from "./core/headers.mjs";
 import { Customers } from "./api/resources/customers/client/Client.mjs";
 import { Agents } from "./api/resources/agents/client/Client.mjs";
+import { Products } from "./api/resources/products/client/Client.mjs";
 import { Contacts } from "./api/resources/contacts/client/Client.mjs";
 import { Orders } from "./api/resources/orders/client/Client.mjs";
+import { Plans } from "./api/resources/plans/client/Client.mjs";
 import { Usage } from "./wrapper/BatchUsage.mjs";
-import { _trace, _initializeTracing } from "./tracing/tracing.mjs";
-import { _signal } from "./tracing/signal.mjs";
+import { Traces } from "./api/resources/traces/client/Client.mjs";
+import { signal } from "./tracing/signal.mjs";
+import { getPaidTracerProvider, initializeTracing, trace } from "./tracing/tracing.mjs";
 export class PaidClient {
-    constructor(_options) {
+    constructor(_options = {}) {
         this._options = Object.assign(Object.assign({}, _options), { headers: mergeHeaders({
                 "X-Fern-Language": "JavaScript",
-                "X-Fern-SDK-Name": "@paid-ai/paid-node",
-                "X-Fern-SDK-Version": "0.5.0-alpha2",
-                "User-Agent": "@paid-ai/paid-node/0.5.0-alpha2",
+                "X-Fern-SDK-Name": "",
+                "X-Fern-SDK-Version": "0.8.0",
                 "X-Fern-Runtime": core.RUNTIME.type,
                 "X-Fern-Runtime-Version": core.RUNTIME.version,
             }, _options === null || _options === void 0 ? void 0 : _options.headers) });
@@ -38,6 +40,10 @@ export class PaidClient {
         var _a;
         return ((_a = this._agents) !== null && _a !== void 0 ? _a : (this._agents = new Agents(this._options)));
     }
+    get products() {
+        var _a;
+        return ((_a = this._products) !== null && _a !== void 0 ? _a : (this._products = new Products(this._options)));
+    }
     get contacts() {
         var _a;
         return ((_a = this._contacts) !== null && _a !== void 0 ? _a : (this._contacts = new Contacts(this._options)));
@@ -46,40 +52,72 @@ export class PaidClient {
         var _a;
         return ((_a = this._orders) !== null && _a !== void 0 ? _a : (this._orders = new Orders(this._options)));
     }
+    get plans() {
+        var _a;
+        return ((_a = this._plans) !== null && _a !== void 0 ? _a : (this._plans = new Plans(this._options)));
+    }
     get usage() {
         var _a;
         return ((_a = this._usage) !== null && _a !== void 0 ? _a : (this._usage = new Usage(this._options)));
     }
-    // Need to call this method before using tracing or creating wrappers.
+    get traces() {
+        var _a;
+        return ((_a = this._traces) !== null && _a !== void 0 ? _a : (this._traces = new Traces(this._options)));
+    }
+    /**
+     * @deprecated use the standalone 'initializeTracing' instead
+     */
     initializeTracing(collectorEndpoint) {
         return __awaiter(this, void 0, void 0, function* () {
             const tokenSupplier = this._options.token;
             const token = typeof tokenSupplier === "function" ? yield tokenSupplier() : tokenSupplier;
             const resolvedToken = yield Promise.resolve(token);
-            _initializeTracing(resolvedToken, collectorEndpoint);
+            initializeTracing(resolvedToken, collectorEndpoint);
         });
     }
-    // Use this method to track actions like LLM costs and sending signals.
-    // The callback to this function is the work that you want to trace.
-    trace(externalCustomerId, fn, externalAgentId, ...args) {
-        return __awaiter(this, void 0, void 0, function* () {
-            return yield _trace(externalCustomerId, fn, externalAgentId, ...args);
+    /**
+     * @deprecated use the standalone 'trace()' instead
+     * Use this method to track actions like LLM costs and sending signals.
+     * The callback to this function is the work that you want to trace.
+     *
+     * @param externalCustomerId - The external customer ID
+     * @param fn - The callback function containing the work to be traced
+     * @param externalAgentId - @deprecated Use externalProductId instead
+     * @param externalProductId - The external product ID
+     * @param storePrompt - Whether to store the prompt (defaults to false)
+     * @param args - Arguments to pass to the callback function
+     * @returns The return value of the callback function
+     */
+    trace(externalCustomerId_1, fn_1, externalAgentId_1, externalProductId_1) {
+        return __awaiter(this, arguments, void 0, function* (externalCustomerId, fn, externalAgentId, externalProductId, storePrompt = false, ...args) {
+            // TODO: remove this after deprecation and replace externalAgentId with externalProductId everywhere
+            if (externalProductId) {
+                externalAgentId = externalProductId;
+            }
+            return yield trace({ externalCustomerId, externalProductId: externalAgentId, storePrompt }, fn, ...args);
         });
     }
     signal(eventName, enableCostTracingOrData, data) {
         let enableCostTracing = false;
         let finalData;
-        if (typeof enableCostTracingOrData === 'boolean') {
+        if (typeof enableCostTracingOrData === "boolean") {
             // Case: signal(eventName, boolean, data?)
             enableCostTracing = enableCostTracingOrData;
             finalData = data;
         }
-        else if (typeof enableCostTracingOrData === 'object') {
+        else if (typeof enableCostTracingOrData === "object") {
             // Case: signal(eventName, data)
             enableCostTracing = false;
             finalData = enableCostTracingOrData;
         }
         // Case: signal(eventName) - both remain default/undefined
-        return _signal(eventName, enableCostTracing, finalData);
+        return signal(eventName, enableCostTracing, finalData);
+    }
+    /**
+     * @deprecated use the standalone 'getPaidTracerProvider()' instead
+     * Export the tracer provider which user can use for his own tracing.
+     */
+    get tracerProvider() {
+        return getPaidTracerProvider();
     }
 }

package/dist/esm/api/errors/InternalServerError.d.mts

@@ -0,0 +1,9 @@
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+import * as errors from "../../errors/index.mjs";
+import * as Paid from "../index.mjs";
+import * as core from "../../core/index.mjs";
+export declare class InternalServerError extends errors.PaidError {
+    constructor(body: Paid.Error_, rawResponse?: core.RawResponse);
+}

package/dist/esm/api/errors/InternalServerError.mjs

@@ -0,0 +1,15 @@
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+import * as errors from "../../errors/index.mjs";
+export class InternalServerError extends errors.PaidError {
+    constructor(body, rawResponse) {
+        super({
+            message: "InternalServerError",
+            statusCode: 500,
+            body: body,
+            rawResponse: rawResponse,
+        });
+        Object.setPrototypeOf(this, InternalServerError.prototype);
+    }
+}

package/dist/esm/api/errors/index.d.mts

@@ -1,3 +1,4 @@
 export * from "./ForbiddenError.mjs";
 export * from "./BadRequestError.mjs";
 export * from "./NotFoundError.mjs";
+export * from "./InternalServerError.mjs";

package/dist/esm/api/errors/index.mjs

@@ -1,3 +1,4 @@
 export * from "./ForbiddenError.mjs";
 export * from "./BadRequestError.mjs";
 export * from "./NotFoundError.mjs";
+export * from "./InternalServerError.mjs";

package/dist/esm/api/index.d.mts

@@ -1,3 +1,3 @@
+export * from "./resources/index.mjs";
 export * from "./types/index.mjs";
 export * from "./errors/index.mjs";
-export * from "./resources/index.mjs";

package/dist/esm/api/index.mjs

@@ -1,3 +1,3 @@
+export * from "./resources/index.mjs";
 export * from "./types/index.mjs";
 export * from "./errors/index.mjs";
-export * from "./resources/index.mjs";

package/dist/esm/api/resources/agents/client/Client.d.mts

@@ -28,6 +28,8 @@ export declare class Agents {
     protected readonly _options: Agents.Options;
     constructor(_options?: Agents.Options);
     /**
+     * DEPRECATED: Use /products instead. Agents are now products with type='agent'.
+     *
      * @param {Agents.RequestOptions} requestOptions - Request-specific configuration.
      *
      * @example
@@ -36,6 +38,8 @@ export declare class Agents {
     list(requestOptions?: Agents.RequestOptions): core.HttpResponsePromise<Paid.Agent[]>;
     private __list;
     /**
+     * DEPRECATED: Use POST /products instead.
+     *
      * @param {Paid.AgentCreate} request
      * @param {Agents.RequestOptions} requestOptions - Request-specific configuration.
      *
@@ -49,6 +53,8 @@ export declare class Agents {
     create(request: Paid.AgentCreate, requestOptions?: Agents.RequestOptions): core.HttpResponsePromise<Paid.Agent>;
     private __create;
     /**
+     * DEPRECATED: Use GET /products/{productId} instead.
+     *
      * @param {string} agentId
      * @param {Agents.RequestOptions} requestOptions - Request-specific configuration.
      *
@@ -58,6 +64,8 @@ export declare class Agents {
     get(agentId: string, requestOptions?: Agents.RequestOptions): core.HttpResponsePromise<Paid.Agent>;
     private __get;
     /**
+     * DEPRECATED: Use PUT /products/{productId} instead.
+     *
      * @param {string} agentId
      * @param {Paid.AgentUpdate} request
      * @param {Agents.RequestOptions} requestOptions - Request-specific configuration.
@@ -97,6 +105,8 @@ export declare class Agents {
     update(agentId: string, request: Paid.AgentUpdate, requestOptions?: Agents.RequestOptions): core.HttpResponsePromise<Paid.Agent>;
     private __update;
     /**
+     * DEPRECATED: Use DELETE /products/{productId} instead.
+     *
      * @param {string} agentId
      * @param {Agents.RequestOptions} requestOptions - Request-specific configuration.
      *
@@ -106,6 +116,8 @@ export declare class Agents {
     delete(agentId: string, requestOptions?: Agents.RequestOptions): core.HttpResponsePromise<void>;
     private __delete;
     /**
+     * DEPRECATED: Use GET /products/external/{externalId} instead.
+     *
      * @param {string} externalId
      * @param {Agents.RequestOptions} requestOptions - Request-specific configuration.
      *
@@ -115,6 +127,8 @@ export declare class Agents {
     getByExternalId(externalId: string, requestOptions?: Agents.RequestOptions): core.HttpResponsePromise<Paid.Agent>;
     private __getByExternalId;
     /**
+     * DEPRECATED: Use PUT /products/external/{externalId} instead.
+     *
      * @param {string} externalId
      * @param {Paid.AgentUpdate} request
      * @param {Agents.RequestOptions} requestOptions - Request-specific configuration.
@@ -143,6 +157,8 @@ export declare class Agents {
     updateByExternalId(externalId: string, request: Paid.AgentUpdate, requestOptions?: Agents.RequestOptions): core.HttpResponsePromise<Paid.Agent>;
     private __updateByExternalId;
     /**
+     * DEPRECATED: Use DELETE /products/external/{externalId} instead.
+     *
      * @param {string} externalId
      * @param {Agents.RequestOptions} requestOptions - Request-specific configuration.
      *

package/dist/esm/api/resources/agents/client/Client.mjs

@@ -20,6 +20,8 @@ export class Agents {
         this._options = _options;
     }
     /**
+     * DEPRECATED: Use /products instead. Agents are now products with type='agent'.
+     *
      * @param {Agents.RequestOptions} requestOptions - Request-specific configuration.
      *
      * @example
@@ -67,6 +69,8 @@ export class Agents {
         });
     }
     /**
+     * DEPRECATED: Use POST /products instead.
+     *
      * @param {Paid.AgentCreate} request
      * @param {Agents.RequestOptions} requestOptions - Request-specific configuration.
      *
@@ -122,6 +126,8 @@ export class Agents {
         });
     }
     /**
+     * DEPRECATED: Use GET /products/{productId} instead.
+     *
      * @param {string} agentId
      * @param {Agents.RequestOptions} requestOptions - Request-specific configuration.
      *
@@ -170,6 +176,8 @@ export class Agents {
         });
     }
     /**
+     * DEPRECATED: Use PUT /products/{productId} instead.
+     *
      * @param {string} agentId
      * @param {Paid.AgentUpdate} request
      * @param {Agents.RequestOptions} requestOptions - Request-specific configuration.
@@ -251,6 +259,8 @@ export class Agents {
         });
     }
     /**
+     * DEPRECATED: Use DELETE /products/{productId} instead.
+     *
      * @param {string} agentId
      * @param {Agents.RequestOptions} requestOptions - Request-specific configuration.
      *
@@ -299,6 +309,8 @@ export class Agents {
         });
     }
     /**
+     * DEPRECATED: Use GET /products/external/{externalId} instead.
+     *
      * @param {string} externalId
      * @param {Agents.RequestOptions} requestOptions - Request-specific configuration.
      *
@@ -347,6 +359,8 @@ export class Agents {
         });
     }
     /**
+     * DEPRECATED: Use PUT /products/external/{externalId} instead.
+     *
      * @param {string} externalId
      * @param {Paid.AgentUpdate} request
      * @param {Agents.RequestOptions} requestOptions - Request-specific configuration.
@@ -417,6 +431,8 @@ export class Agents {
         });
     }
     /**
+     * DEPRECATED: Use DELETE /products/external/{externalId} instead.
+     *
      * @param {string} externalId
      * @param {Agents.RequestOptions} requestOptions - Request-specific configuration.
      *

package/dist/esm/api/resources/customers/client/Client.d.mts

@@ -119,5 +119,43 @@ export declare class Customers {
      */
     deleteByExternalId(externalId: string, requestOptions?: Customers.RequestOptions): core.HttpResponsePromise<void>;
     private __deleteByExternalId;
+    /**
+     * @param {string} externalId - The external ID of the customer
+     * @param {Paid.CustomersGetCostsByExternalIdRequest} request
+     * @param {Customers.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link Paid.BadRequestError}
+     * @throws {@link Paid.ForbiddenError}
+     * @throws {@link Paid.NotFoundError}
+     *
+     * @example
+     *     await client.customers.getCostsByExternalId("externalId", {
+     *         limit: 1,
+     *         offset: 1,
+     *         startTime: "2024-01-15T09:30:00Z",
+     *         endTime: "2024-01-15T09:30:00Z"
+     *     })
+     */
+    getCostsByExternalId(externalId: string, request?: Paid.CustomersGetCostsByExternalIdRequest, requestOptions?: Customers.RequestOptions): core.HttpResponsePromise<Paid.CostTracesResponse>;
+    private __getCostsByExternalId;
+    /**
+     * @param {string} externalId - The external ID of the customer
+     * @param {Paid.CustomersGetUsageByExternalIdRequest} request
+     * @param {Customers.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link Paid.BadRequestError}
+     * @throws {@link Paid.ForbiddenError}
+     * @throws {@link Paid.NotFoundError}
+     *
+     * @example
+     *     await client.customers.getUsageByExternalId("externalId", {
+     *         limit: 1,
+     *         offset: 1,
+     *         startTime: "2024-01-15T09:30:00Z",
+     *         endTime: "2024-01-15T09:30:00Z"
+     *     })
+     */
+    getUsageByExternalId(externalId: string, request?: Paid.CustomersGetUsageByExternalIdRequest, requestOptions?: Customers.RequestOptions): core.HttpResponsePromise<Paid.UsageSummariesResponse>;
+    private __getUsageByExternalId;
     protected _getAuthorizationHeader(): Promise<string | undefined>;
 }