Olympus SDK

The Olympus TypeScript SDK (@olympus/cli) provides a robust, type-safe programmatic interface for NebusAI employees to build custom automation, management dashboards, and background agents.

Usage

The SDK is exposed as a module within the @olympus/cli package.

import { OlympusSDK } from '@olympus/cli';

// Initialize the SDK with environment configuration
const sdk = await OlympusSDK.init();

// 1. Query the AI Router (using high-tier model for reasoning)
const response = await sdk.queryAI("Audit the current Spanner schema for multi-tenancy gaps.", "t5");

// 2. Interact with the Guardian Protocol
const state = await sdk.guardian.getIssueState(1083);
if (state.status === 'in-progress') {
  console.log("Current verified progress:", state.acItems.filter(i => i.status === 'verified').length);
}

// 3. Infrastructure & SRE Operations
const plan = await sdk.infraPlan("staging");
console.log("Terraform Plan Output:", plan);

// 4. Identity Management
const tenantId = await sdk.setSecret("auth-service", "STRIPE_KEY", "sk_test_...", "dev");

Key Modules

GuardianClient

The core logic for the A/C state machine and empirical proof verification. Use this to automate the "Definition of Done" for any task.

GCPClient

A thin wrapper around gcloud and Cloud SDKs for service discovery, Cloud Build lifecycle management, and Secret Manager orchestration.

AI & Agent Integration

Direct bindings to the ACP AI Router and the Roman God Agent Pantheon. Supports session persistence and multi-turn agent orchestration.

SDK Development

If you are adding new features to the SDK, ensure you rebuild the package:

cd tools/olympus-cli
npm run build

The SDK logic is shared with the CLI and the MCP Server to ensure absolute consistency across all interfaces.