@meteor.ia/sdk

SDK oficial de TypeScript para la API de Meteor — infraestructura agéntica como servicio.

Server-side only: tu API key (met_...) es secreta. Nunca la uses en el browser.

Instalación

npm install @meteor.ia/sdk

Quickstart

import Met from '@meteor.ia/sdk';

const met = new Met(process.env.MET_API_KEY!, { workspaceId: 7 });

// Ejecutar un Met y esperar el resultado
const run = await met.runs.create({ met: 'ventas', input: 'Resume los leads de hoy' });
console.log(run.output);

// …o en streaming, evento por evento
for await (const ev of met.runs.stream({ input: 'Hola' })) {
  console.log(ev.type, ev.data); // run.started, run.step, run.output, run.completed
}

Recursos

• met.runs — ejecutar Mets (create, stream, retrieve, list, iterate).
• met.agents — gestionar Mets (list, retrieve, create, update, linkSkill, unlinkSkill).
• met.integrations — conectores MCP (list, tools, activate, deactivate, execute).
• met.contacts — CRM (list, iterate, retrieve, create, update, delete, messages, sendMessage, sendTemplate, notes, tags…).
• met.webhooks — webhooks entrantes (list, create, update, delete, rotateSecret, events, sample).
• met.billing — plan y consumo, solo lectura (subscription, access, consumption, executions, invoices, transactions).
• met.tasks — tareas agénticas (list, create, retrieve, update, setStatus, execute, executions).
• met.collections — colecciones de datos (list, retrieve, create, update, delete).
• met.items — registros de una colección (list, iterate, retrieve, search, create, patchField, setStatus).
• met.partner.* — solo keys de partner, read-only: clients.list, commissions.list, payouts.list/summary. Lo sirve el backend de partners; el SDK enruta a partnerBaseUrl (default prod de partners) de forma transparente.

Características del cliente

• Autenticación con la key met_* en cada request.
• Reintentos automáticos ante 429/5xx con backoff exponencial (respeta Retry-After).
• Idempotencia automática en POSTs con efectos (evita duplicar en retries de red).
• Des-envuelto del wire: recibes el recurso directo, nunca { success, data }.
• Errores tipados: MetAuthError, MetRateLimitError (con retryAfter), MetInvalidRequestError, MetAgentError, MetApiError.
• Paginación transparente: for await (const run of met.runs.iterate()).
• Cero dependencias de runtime (usa el fetch global, Node ≥20).

Manejo de errores

import { MetRateLimitError, MetAuthError } from '@meteor.ia/sdk';

try {
  await met.runs.create({ input: 'x' });
} catch (err) {
  if (err instanceof MetRateLimitError) console.log(`Reintentar en ${err.retryAfter}s`);
  else if (err instanceof MetAuthError) console.log('Key inválida');
  else throw err;
}

v0.2.0 — agrega los namespaces partner (clients/commissions/payouts, solo lectura) y tools (verificación HMAC de tool-calls entrantes), y exige https:// en baseUrl para que la API key nunca viaje en claro (se permite http solo a loopback). Los tipos de los recursos se generarán del spec OpenAPI en una próxima versión; la superficie de métodos es estable.

v0.1.0 — primera versión pública.