straleio

TypeScript SDK for the Strale API — let AI agents buy and execute capabilities at runtime.

Install

npm install straleio

Quick start

import { Strale } from "straleio";

const strale = new Strale({ apiKey: "sk_live_..." });

const result = await strale.do({
  task: "validate VAT number SE556703748501",
});

console.log(result.output);
// { valid: true, country_code: "SE", company_name: "Spotify AB" }

Execute by slug

const result = await strale.do({
  capabilitySlug: "vat-validate",
  inputs: { vat_number: "SE556703748501" },
  maxPriceCents: 10,
});

Solutions (bundled workflows)

// Quick company verification (KYB Essentials — 20 countries)
const result = await strale.do({
  solution: "kyb-essentials-se",
  input: { org_number: "5591674668" },
});

// Full compliance check with risk narrative (KYB Complete)
const fullCheck = await strale.do({
  solution: "kyb-complete-se",
  input: { org_number: "5591674668", domain: "example.com" },
});
// fullCheck.narrative — plain-language risk assessment
// fullCheck.checks — structured results for programmatic use

// Invoice fraud detection (Invoice Verify)
const invoiceCheck = await strale.do({
  solution: "invoice-verify-se",
  input: {
    org_number: "5591674668",
    vat_number: "SE559167466801",
    iban: "SE3550000000058398257466",
  },
});

Dry run (preview cost without executing)

const preview = await strale.dryRun({
  task: "look up Swedish company Klarna",
});

console.log(preview.matched_capability); // "swedish-company-data"
console.log(preview.price_cents);        // 80

Check balance

const balance = await strale.getBalance();
console.log(balance.balance_eur); // "1.84"

List capabilities

const capabilities = await strale.listCapabilities();
// 256 capabilities with slug, name, price, category

Free-tier (no API key)

5 capabilities work without authentication:

const strale = new Strale({ apiKey: "" });

const result = await strale.do({
  capabilitySlug: "email-validate",
  inputs: { email: "[email protected]" },
});

Options

const strale = new Strale({
  apiKey: "sk_live_...",
  baseUrl: "https://api.strale.io",   // default
  timeout: 60_000,                     // ms, default 60s
  defaultMaxPriceCents: 200,           // cap per call, default €2.00
});

Error handling

import { Strale, StraleError } from "straleio";

try {
  const result = await strale.do({ task: "..." });
} catch (err) {
  if (err instanceof StraleError) {
    console.error(err.code);    // "insufficient_balance" | "no_matching_capability" | ...
    console.error(err.message);
  }
}

Try for Free

5 capabilities work without an API key or signup:

• email-validate — verify email deliverability
• dns-lookup — DNS record lookup
• json-repair — fix malformed JSON
• url-to-markdown — convert any URL to markdown
• iban-validate — validate international bank account numbers

For all 256 capabilities, sign up for €2 in free trial credits.

Resources

• 📖 Documentation
• 💡 Examples — copy-paste examples for every integration
• 💰 Pricing
• 🔍 Quality methodology
• 🔒 Security

License

MIT — see LICENSE