Versions

Version listing and comparison. View version history and diff changes between versions.

2 methods

client.versions.list()

List all versions of a definition with hash, timestamps, and change metadata.

Parameters

typerequiredstring

Definition type.

agentcommandworkflowpipeline

namerequiredstring

Definition name.

limitoptionalnumber

Results per page.

offsetoptionalnumber

Pagination offset.

Return Fields

versionsrequiredVersionListItem[]

Array of version snapshots.

totalrequirednumber

Total version count.

limitrequirednumber

Page size used.

offsetrequirednumber

Pagination offset used.

list(type: DefinitionType, name: string, options?: { limit?: number; offset?: number }): Promise<VersionsListResponse>

typescript

import { RegistryClient } from '@uluops/registry-sdk';

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

const result = await client.versions.list('agent', 'my-project');

console.log(result.versions);

Response Type

// Promise<VersionsListResponse>
{
  versions: VersionListItem[];
  total: number;
  limit: number;
  offset: number;
}

client.versions.diff()

Compare two versions of a definition. Returns a section-level summary by default. Use format to select output: 'sections' (default), 'fields' (per-field changes), or 'unified' (git-style unified diff).

Parameters

typerequiredstring

Definition type.

agentcommandworkflowpipeline

namerequiredstring

Definition name.

fromrequiredstring

Source version (semver).

torequiredstring

Target version (semver).

fulloptionalboolean

If true, returns full YAML content for both versions.

formatoptionalstring

Output format.

sectionsfieldsunified

Default: sections

Return Fields

fromVersionrequiredstring

Source version.

toVersionrequiredstring

Target version.

fromHashrequiredstring

SHA-256 hash of source version.

toHashrequiredstring

SHA-256 hash of target version.

hasChangesrequiredboolean

Whether any changes exist between versions.

hasPromptChangesrequiredboolean

Whether rendered prompt content changed.

sectionsAddedrequiredstring[]

Names of YAML sections added.

sectionsRemovedrequiredstring[]

Names of YAML sections removed.

sectionsModifiedrequiredstring[]

Names of YAML sections modified.

sectionsUnchangedrequiredstring[]

Names of unchanged YAML sections.

diff(type: DefinitionType, name: string, fromVersion: string, toVersion: string, options?: { full?: boolean; format?: 'sections' | 'fields' | 'unified' }): Promise<VersionDiffSummary | VersionFieldDiff | VersionUnifiedDiff>

typescript

import { RegistryClient } from '@uluops/registry-sdk';

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

const result = await client.versions.diff('agent', 'my-project', '1.0.0', '1.0.0');

console.log(result.fromVersion);

Response Type

// Promise<VersionDiffSummary | VersionFieldDiff | VersionUnifiedDiff>
{
  fromVersion: string;
  toVersion: string;
  fromHash: string;
  toHash: string;
  hasChanges: boolean;
  hasPromptChanges: boolean;
  sectionsAdded: string[];
  sectionsRemoved: string[];
  sectionsModified: string[];
  sectionsUnchanged: string[];
}