Package

  • npm name: @premier/sdk
  • Path in monorepo: sdk/js
  • Shell helper: sdk/shell/premier-emit.sh

API surface

import {
  emit,
  premier,
  isPremierActive,
  premierEnv,
  PremierNotActiveError,
} from "@premier/sdk";
Export Behavior
isPremierActive() True when collector URL + token env vars exist
emit(event, opts?) POST to collector; no-op → null if inactive
premier.spawn / model / tool / approval Kind helpers
premierEnv() Throws PremierNotActiveError if inactive

Design rules

  • No global config files — env from premier record is the contract
  • Never invent usage or role tokens
  • Safe when Premier is absent (unless required: true)

Tests

npm run build --workspace @premier/sdk
npm run test --workspace @premier/sdk