SkyAIApp Documentation

import { SkyAI, isRouterError } from "@skyaiapp/sdk";

// One client, reused across requests. The SDK handles connection pooling,
// retry budgets, and trace propagation under the hood.
const sky = new SkyAI({
  apiKey: process.env.SKYAIAPP_API_KEY!,
  // Optional: pin a routing policy (created in console) instead of inline goal/strategy.
  // policyId: "policy_prod_v3",
});

async function planTrip(query: string) {
  try {
    const res = await sky.route({
      // Goal answers "what do you want?" — cost / quality / stability.
      goal: "quality",
      // Strategy answers "how aggressively?" — balanced / cost-optimized / quality-first.
      strategy: "quality-first",
      messages: [
        { role: "system", content: "You are a senior travel planner." },
        { role: "user", content: query },
      ],
      // Explicit fallback chain — used only if the primary fails or budget is exceeded.
      fallback: {
        models: ["claude-opus-4.7", "gemini-3.1-pro"],
        maxRetries: 2,
      },
      // Per-request budget hint — router will avoid pricier models if possible.
      budget: { maxCostUsd: 0.05 },
      // 30-second hard cap — surfaces as RouterTimeoutError.
      timeoutMs: 30_000,
    });

    return {
      output: res.output,
      // Inspect routing decision — useful for analytics and debugging.
      model: res.routing.selectedModel,        // e.g. "gpt-5.5-pro"
      cost: res.routing.costUsd,               // e.g. 0.00321
      latencyMs: res.routing.latencyMs,        // e.g. 940
      cached: res.routing.cacheHit,            // boolean
      traceId: res.traceId,                    // open in console for full span tree
    };
  } catch (err) {
    if (isRouterError(err)) {
      console.error("Routing failed:", err.code, err.message);
      // err.retryAfterMs is set on rate limits; err.upstreamProvider on provider failures.
    }
    throw err;
  }
}

const result = await planTrip("Plan a 7-day European city-hopping trip in October.");
console.log(result);