Cortex SDK for JavaScript and Node.js

Install

npm install @cortex-suite/sdk

Quick start

Browser

import { CortexClient } from "@cortex-suite/sdk";

const client = new CortexClient({
  apiKey: "your-api-key",
  // authUrl: "https://cortexsuite.app", // optional override
  onMessage: (msg) => console.log(msg.type, msg.payload),
});

await client.connect();
await client.sendMessage({ content: "Hello" });

Node.js

import { CortexClient } from "@cortex-suite/sdk";

async function main() {
  const client = new CortexClient({
    apiKey: "your-api-key",
    // authUrl: "https://cortexsuite.app", // optional override
    onMessage: (msg) => console.log(msg.type, msg.payload),
  });

  await client.connect();
  await client.sendMessage({ content: "Hello" });
}

main().catch(console.error);

API

See the full API reference. authUrl is optional; if omitted, the SDK uses its default auth base URL.

Error handling

import { CortexClient } from "@cortex-suite/sdk";

const client = new CortexClient({
  apiKey: "your-api-key",
  onMessage: (msg) => {
    if (msg.type === "system::error") {
      console.error("Runtime error:", msg.payload.code, msg.payload.message);
      if (msg.payload.fatal) {
        // handle unrecoverable session
      }
    }
  },
});

try {
  await client.connect();
} catch (err) {
  if (err.code === "auth_invalid" || err.code === "auth_refresh_failed") {
    // prompt user to re-authenticate
  }
}