SDK

1
import {
2
  AgentRouterClient,
3
  DEFAULT_AGENTIC_API_BASE_URL,
4
} from "@agentrouter/agentrouter";
5
6
const client = new AgentRouterClient({
7
  apiKey: process.env.AGENTIC_API_KEY,
8
  baseUrl:
9
    process.env.AGENTIC_API_BASE_URL ?? DEFAULT_AGENTIC_API_BASE_URL,
10
  timeoutMs: 20_000,
11
});

1
const domains = await client.catalog.domains.list();
2
const capabilities = await client.catalog.capabilities.list("email");
3
const sendContract = await client.catalog.capabilities.contract("email", "send");
4
const sendRoutes = await client.catalog.capabilities.routes("email", "send");

1
const recommendation = await client.capabilities.recommend({
2
  domain: "email",
3
  capability: "send",
4
  input: {
5
    optimizationPreferences: ["cost", "quality"],
6
    sender: {
7
      mode: "platform_managed",
8
      replyTo: "ops@example.com",
9
    },
10
  },
11
});
12
13
const result = await client.capabilities.execute({
14
  domain: "email",
15
  capability: "send",
16
  input: {
17
    to: "maya@example.com",
18
    subject: "Hello from AgentRouter",
19
    html: "<p>Hello</p>",
20
  },
21
  provider: recommendation.recommendedProvider,
22
  allowFallback: true,
23
});

1
const quote = await client.capabilities.execute({
2
  domain: "broadcast",
3
  capability: "message-quote",
4
  routeKey: "broadcast.message.quote.billboard.mpp",
5
  input: {},
6
  allowFallback: false,
7
});
8
9
const sendRecommendation = await client.capabilities.recommend({
10
  domain: "broadcast",
11
  capability: "message-send",
12
  input: {
13
    text: "Launch update goes here.",
14
    optimizationPreferences: ["quality"],
15
  },
16
});

1
const routeContext = await client.catalog.routes.context(
2
  "translation.text.rephrase.deepl.mpp",
3
);
4
5
const rewrite = await client.capabilities.execute({
6
  domain: "translation",
7
  capability: "text-rephrase",
8
  routeKey: "translation.text.rephrase.deepl.mpp",
9
  input: {
10
    text: "Please make this product update friendlier.",
11
    targetLanguage: "EN-US",
12
    tone: "prefer_friendly",
13
  },
14
  allowFallback: false,
15
});
16
17
console.log(rewrite.rewrittenText);

1
const routeContext = await client.catalog.routes.context(
2
  "geo.time.convert.abstract-timezone.mpp",
3
);
4
5
const converted = await client.capabilities.execute({
6
  domain: "geo",
7
  capability: "time-convert",
8
  routeKey: "geo.time.convert.abstract-timezone.mpp",
9
  input: {
10
    fromLocation: "Los Angeles, CA",
11
    toLocation: "Tokyo, Japan",
12
    datetime: "2026-05-08 09:30:00",
13
  },
14
  allowFallback: false,
15
});
16
17
console.log(converted.convertedTime);

1
const routeContext = await client.catalog.routes.context(
2
  "models.chat.complete.deepseek.mpp",
3
);
4
5
const modelChat = await client.capabilities.execute({
6
  domain: "models",
7
  capability: "chat-complete",
8
  routeKey: "models.chat.complete.deepseek.mpp",
9
  input: {
10
    model: "deepseek-v4-flash",
11
    messages: [
12
      {
13
        role: "user",
14
        content: "Say AgentRouter DeepSeek smoke OK.",
15
      },
16
    ],
17
  },
18
  allowFallback: false,
19
});
20
21
console.log(modelChat.completionText);

1
const textRecommendation = await client.capabilities.recommend({
2
  domain: "text",
3
  capability: "analyze",
4
  input: {
5
    provider: "diffbot-nl",
6
    content: "AgentRouter routes text analysis through Diffbot NL.",
7
    fields: "entities,sentiment,language",
8
    optimizationPreferences: ["quality"],
9
  },
10
});
11
12
const textContext = await client.catalog.routes.context(
13
  "text.analyze.diffbot-nl.mpp",
14
);
15
16
console.log(textRecommendation.recommendedRouteKey);
17
console.log(textRecommendation.canExecuteNow);
18
console.log(textContext.routeKey);

1
const imageContext = await client.catalog.routes.context(
2
  "media.image.generate.fal.mpp",
3
);
4
5
const heroImage = await client.capabilities.execute({
6
  domain: "media",
7
  capability: "image-generate",
8
  routeKey: "media.image.generate.fal.mpp",
9
  input: {
10
    prompt: "Create a clean launch hero image for an AI developer tool",
11
    aspectRatio: "16:9",
12
  },
13
  provider: "fal",
14
  allowFallback: false,
15
});
16
17
console.log(imageContext.routeKey);
18
console.log(heroImage.primaryImageUrl);

1
const extractContext = await client.catalog.routes.context(
2
  "web.extract.diffbot.mpp",
3
);
4
const personContext = await client.catalog.routes.context(
5
  "enrichment.people.enrich.diffbot.mpp",
6
);
7
const companyContext = await client.catalog.routes.context(
8
  "enrichment.company.enrich.diffbot.mpp",
9
);
10
11
const article = await client.capabilities.execute({
12
  domain: "web",
13
  capability: "extract",
14
  routeKey: "web.extract.diffbot.mpp",
15
  input: {
16
    url: "https://www.example.com/article",
17
  },
18
  allowFallback: false,
19
});
20
21
const person = await client.capabilities.execute({
22
  domain: "enrichment",
23
  capability: "people-enrich",
24
  routeKey: "enrichment.people.enrich.diffbot.mpp",
25
  input: {
26
    fullName: "Sam Altman",
27
    companyName: "OpenAI",
28
  },
29
  allowFallback: false,
30
});
31
32
const company = await client.capabilities.execute({
33
  domain: "enrichment",
34
  capability: "company-enrich",
35
  routeKey: "enrichment.company.enrich.diffbot.mpp",
36
  input: {
37
    companyName: "OpenAI",
38
    domain: "openai.com",
39
  },
40
  allowFallback: false,
41
});
42
43
console.log(article.routeKey);
44
console.log(person.person);
45
console.log(company.company);

1
const routeContext = await client.catalog.routes.context(
2
  "travel.airport.operations.flightapi.mpp",
3
);
4
5
const airportOperations = await client.capabilities.execute({
6
  domain: "travel",
7
  capability: "airport-operations",
8
  routeKey: "travel.airport.operations.flightapi.mpp",
9
  input: {
10
    iataCode: "JFK",
11
    mode: "departures",
12
    limit: 1,
13
  },
14
  provider: "flightapi",
15
  allowFallback: false,
16
});

1
client.email;
2
client.enrichment;
3
client.social;
4
client.post;
5
client.broadcast;

1
const recommendation = await client.capabilities.recommend({
2
  domain: "email",
3
  capability: "send",
4
  input: {
5
    optimizationPreferences: ["cost", "quality"],
6
  },
7
});
8
9
console.log(recommendation.recommendedProvider);
10
console.log(recommendation.domainKey);
11
console.log(recommendation.capabilityId);
12
console.log(recommendation.raw);

1
const wallet = await client.raw.request<{
2
  userId: string;
3
  balanceCredits: number;
4
}>({
5
  path: "/wallet",
6
  authMode: "apiKey",
7
});

1
const wallet = await client.wallet.get();
2
const usage = await client.usage.list({ limit: 20 });