@uluops/ops-sdk

TypeScript SDK for the UluOps Validation Tracker — projects, runs, issues, and analytics.

v5.0.0ESM only

Installation

npm install @uluops/ops-sdk

Quick Start

TypeScript

import { OpsClient } from '@uluops/ops-sdk';

const client = new OpsClient({
  apiKey: 'ulr_your-api-key',
});

Constructor Parameters

apiKeyoptionalstring

API key for authentication. Must start with ulr_ prefix.

emailoptionalstring

Email for session-based authentication.

passwordoptionalstring

Password for session-based authentication.

sessionTokenoptionalstring

Existing session token.

baseUrloptionalstring

API base URL. Defaults to the UluOps production API.

Default: https://api.uluops.ai/api/v1

timeoutoptionalnumber

Request timeout in milliseconds.

Default: 30000

retriesoptionalnumber

Number of retries for transient errors.

Default: 3

debugoptionalboolean

Enable debug logging.

Default: false

onTokenRefreshoptional(token: string) => void

Callback invoked when the session token is refreshed.

orgSlugoptionalstring

Organization slug for multi-tenancy. Sets the X-Org-Slug header on all requests.

Subpath Exports

@uluops/ops-sdkOpsClient, OpsHttpClient, auth strategies
@uluops/ops-sdk/typesTypeScript types and Zod schemas
@uluops/ops-sdk/errorsError classes and type guards
@uluops/ops-sdk/types/enumsEnum types (Status, Priority, Severity, ClassifiedBy)
@uluops/ops-sdk/types/authAuthentication types (AuthUser, PublicUser, etc.)
@uluops/ops-sdk/types/projectsProject types (Project, PublicProject, etc.)
@uluops/ops-sdk/types/runsRun types (Run, RunSummary, AgentSnapshot, etc.)
@uluops/ops-sdk/types/issuesIssue types (Issue, Occurrence, IssueNote, etc.)
@uluops/ops-sdk/types/analyticsAnalytics types (BurndownResult, VelocityResult, etc.)
@uluops/ops-sdk/types/responsesResponse envelope types
@uluops/ops-sdk/types/schemasZod schemas for runtime validation
@uluops/ops-sdk/configConfiguration loading utilities

Namespaces

Authenticationclient.auth

User registration, login, password management, API keys, and session management. Public endpoints (register, login, forgotPassword, resetPassword) do not require authentication.

16 methods

Projectsclient.projects

Create, list, update, and delete projects. Projects are the top-level organizational unit for validation runs and issues.

14 methods

Runsclient.runs

Save, validate, compare, and manage validation pipeline runs. Each run captures agent scores, recommendations, and correlates issues via fingerprinting.

14 methods

Issuesclient.issues

Create, search, update, and manage validation issues. Issues are correlated across runs using SHA-256 fingerprinting of title + agent + filePath + category.

13 methods

Analyticsclient.analytics

Agent performance, burndown charts, velocity tracking, discovery timeline, file hotspots, and failure taxonomy distribution.

12 methods

Taxonomyclient.taxonomy

Failure taxonomy reference data — domains, modes, severity codes, and the failure code pattern.

1 method