@metisos/operator-sdk

Call your MetisOS Digital Operator from any application.

npm install @metisos/operator-sdk

Quick start

import { MetisOperator } from '@metisos/operator-sdk';

const op = new MetisOperator({
  operatorId: process.env.METIS_OPERATOR_ID!,
  apiKey: process.env.METIS_API_KEY!,
});

const { response } = await op.chat('What is on my calendar today?');
console.log(response);

Get your operatorId and generate API keys at metisos.co/developer.

API

new MetisOperator(options)

| Option | Type | Required | Default | |---|---|---|---| | operatorId | string | yes | — | | apiKey | string | yes | — | | baseUrl | string | no | https://metisos.co | | fetch | typeof fetch | no | globalThis.fetch |

Works in Node 18+, Deno, Bun, browsers, Cloudflare Workers — anywhere fetch exists.

op.chat(message, options?)

Send a message to your operator. Returns { response, metadata }.

const { response } = await op.chat('Summarize this article', {
  context: { url: 'https://example.com/article' },
});

op.manifest()

Fetch the operator's ADP v2.0 manifest — capability discovery. Public, no key needed.

op.health()

Quick health check. Public, no key needed.

op.queryMemory(query) (Pro/Max only)

Query the operator's long-term memory. Shared-runtime operators return 503.

Error handling

Failures throw MetisOperatorError with status and body fields:

import { MetisOperator, MetisOperatorError } from '@metisos/operator-sdk';

try {
  await op.chat('hello');
} catch (err) {
  if (err instanceof MetisOperatorError) {
    if (err.status === 429) console.log('Rate limited — retry after a minute');
    else if (err.status === 401) console.log('Bad API key');
  }
}

Rate limits

60 requests per minute per API key. Responses include X-RateLimit-* headers.

Reference

• Full API documentation: https://github.com/metisos/agentpattern/blob/main/docs/api/operator-api.md
• Developer console: https://metisos.co/developer
• Agent Discovery Protocol: https://adp.metisos.co

License

MIT