@uluops/registry-sdk
Client SDK for the UluOps Registry API — manage definitions, models, versions, forks, and execution tracking.
Installation
npm install @uluops/registry-sdkQuick Start
import { RegistryClient } from '@uluops/registry-sdk';
const client = new RegistryClient({
apiKey: 'ulr_your-api-key',
});Constructor Parameters
apiKeyoptionalstringAPI key for authentication (preferred over email/password).
emailoptionalstringEmail for session-based authentication (requires password).
passwordoptionalstringPassword for session-based authentication (requires email).
sessionTokenoptionalstringPre-existing session token from the ops API.
baseUrloptionalstringBase URL for the registry API. Defaults based on NODE_ENV.
authBaseUrloptionalstringBase URL for the ops API (login/refresh). Defaults to localhost:3100 in dev.
timeoutoptionalnumberRequest timeout in milliseconds.
Default:30000retriesoptionalnumberNumber of retries for transient errors.
Default:3debugoptionalbooleanEnable debug logging.
onTokenRefreshoptional(token: string) => voidCallback invoked when session token is refreshed.
orgSlugoptionalstringOrganization slug for multi-tenancy. Sets the X-Org-Slug header on all requests.
Subpath Exports
@uluops/registry-sdk/typesAll type definitions@uluops/registry-sdk/errorsError classes@uluops/registry-sdk/configConfiguration utilities
Namespaces
Session management and authentication state. Login, logout, and credential inspection.
4 methods
CRUD operations for agent, command, workflow, and pipeline definitions. Create drafts, publish, deprecate, and search.
8 methods
Version listing and comparison. View version history and diff changes between versions.
2 methods
YAML validation without storage. Validate definition content against schemas before creating.
1 method
Dependency graph operations. Inspect what a definition depends on and what depends on it.
2 methods
Definition forking with lineage tracking. Fork published definitions and trace ancestry chains.
4 methods
Execution statistics recording and retrieval. Track how often definitions are used.
2 methods
Definition translation and upgrade operations. Retranslate with latest engine or upgrade legacy definitions.
3 methods
AI model catalog. List available models, resolve aliases, and sync from upstream providers.
5 methods
Star and unstar definitions. Track favorites across the registry.
3 methods
Public user information. Look up user profiles by ID (read-only, no sensitive data).
2 methods
Markdown rendering operations. Get rendered agent prompts or preview YAML without storing.
2 methods
Definition effectiveness metrics, health grades, ecosystem overview, lineage graphs, evolution trends, and cross-version comparisons.
8 methods
Definition language schemas. Access the four core languages (ADL, CDL, WDL, PDL) and their current JSON Schema documents.
2 methods