TypeScript SDK

pnpm add @pylva/sdk   # or: npm install @pylva/sdk

import { init } from "@pylva/sdk";

init({
  apiKey: process.env.PYLVA_API_KEY!,
});

import { track } from "@pylva/sdk";

await track(
  "acme-corp",
  { step: "draft_reply" },
  async () => {
    return openai.chat.completions.create({
      model: "gpt-4o-mini",
      messages,
    });
  },
);

pnpm add @pylva/sdk @langchain/core @langchain/langgraph

import { PylvaCallbackHandler } from "@pylva/sdk/langgraph";

const handler = new PylvaCallbackHandler({
  apiKey: process.env.PYLVA_API_KEY!,
});

await graph.invoke(input, {
  callbacks: [handler],
  metadata: { pylva_customer_id: "cust_acme" },
});

const handler = new PylvaCallbackHandler({
  apiKey: process.env.PYLVA_API_KEY!,
  trackToolCalls: true,
});

import { reportUsage } from "@pylva/sdk";

reportUsage({
  customer_id: "acme-corp",
  step: "speak_answer",
  metric: "characters",
  value: 4200,
});

import { init, PylvaBudgetExceeded } from "@pylva/sdk";

init({ apiKey: process.env.PYLVA_API_KEY! });

try {
  await openai.chat.completions.create({ model, messages });
} catch (err) {
  if (err instanceof PylvaBudgetExceeded) {
    return cachedOrSmallerResponse();
  }
  throw err;
}

import { verifyWebhook } from "@pylva/sdk";

const ok = verifyWebhook(
  rawBody,
  signatureHeader,
  process.env.PYLVA_WEBHOOK_SECRET!,
  timestampHeader,
);