TypeScript SDK

npm install @eclips/sdk

import { EClipsClient } from '@eclips/sdk';

const client = new EClipsClient({
  apiKey: process.env.ECLIPS_API_KEY!,
  organizationId: process.env.ECLIPS_ORG_ID!,
});

// Fire and poll — blocks until the agent finishes
const result = await client.runAndWait(
  'procurement_specialist',
  'Get 3 vendor quotes for 500 laptops — Dell, HP, Lenovo',
);

console.log(result.status);  // "completed"
console.log(result.result);  // { vendors: [...], recommended: "Dell" }

import { EClipsClient } from '@eclips/sdk';

// In your webhook route, verify the signature before trusting the body
const ok = EClipsClient.verifyWebhook(
  rawBody,
  request.headers['x-eclips-signature'],
  process.env.WEBHOOK_SECRET!,
);
if (!ok) return new Response('Unauthorized', { status: 401 });

import {
  EClipsClient,
  AuthenticationError,
  RateLimitError,
  TimeoutError,
  NotFoundError,
} from '@eclips/sdk';

try {
  const result = await client.runAndWait('ap_specialist', task);
} catch (err) {
  if (err instanceof AuthenticationError) {
    // Invalid or missing API key
  } else if (err instanceof RateLimitError) {
    await sleep(err.retryAfter ?? 60);   // seconds
  } else if (err instanceof TimeoutError) {
    // err.runId is still valid — poll client.getRun(err.runId)
  } else if (err instanceof NotFoundError) {
    // Run, triage item, or webhook not found
  }
}