Analytics

Definition effectiveness metrics, health grades, ecosystem overview, lineage graphs, evolution trends, and cross-version comparisons.

8 methods

client.analytics.getEffectiveness()

Get effectiveness metrics for a definition — pass rate, score distribution, issue detection rate.

Requires authentication

Parameters

typerequiredstring

Definition type.

agentcommandworkflowpipeline

namerequiredstring

Definition name.

versionoptionalstring

Definition version. If omitted, uses latest published.

getEffectiveness(type: DefinitionType, name: string, version?: string): Promise<DefinitionEffectiveness>

typescript

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

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

const result = await client.analytics.getEffectiveness('agent', 'my-project');

Response Type

Promise<DefinitionEffectiveness>

client.analytics.getHealth()

Get a health grade for a definition based on its issue profile, execution frequency, and effectiveness trends.

Requires authentication

Parameters

typerequiredstring

Definition type.

agentcommandworkflowpipeline

namerequiredstring

Definition name.

versionoptionalstring

Definition version.

getHealth(type: DefinitionType, name: string, version?: string): Promise<DefinitionHealth>

typescript

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

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

const result = await client.analytics.getHealth('agent', 'my-project');

Response Type

Promise<DefinitionHealth>

client.analytics.getEcosystemOverview()

Get cross-project ecosystem statistics — total definitions, executions, health distribution, and top performers.

Requires authentication

getEcosystemOverview(): Promise<EcosystemOverview>

typescript

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

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

const result = await client.analytics.getEcosystemOverview();

Response Type

Promise<EcosystemOverview>

client.analytics.getLineage()

Get the version/fork lineage graph for a definition. Shows how versions and forks relate over time.

Requires authentication

Parameters

typerequiredstring

Definition type.

agentcommandworkflowpipeline

namerequiredstring

Definition name.

getLineage(type: DefinitionType, name: string): Promise<LineageResult>

typescript

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

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

const result = await client.analytics.getLineage('agent', 'my-project');

Response Type

Promise<LineageResult>

client.analytics.getEvolution()

Get version-over-version evolution trends — how scores, pass rates, and issue counts change across versions.

Requires authentication

Parameters

typerequiredstring

Definition type.

agentcommandworkflowpipeline

namerequiredstring

Definition name.

getEvolution(type: DefinitionType, name: string): Promise<EvolutionResult>

typescript

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

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

const result = await client.analytics.getEvolution('agent', 'my-project');

Response Type

Promise<EvolutionResult>

client.analytics.getTranslation()

Get translator version impact analytics — how definition effectiveness changes across translator engine versions.

Requires authentication

Parameters

typerequiredstring

Definition type.

agentcommandworkflowpipeline

namerequiredstring

Definition name.

getTranslation(type: DefinitionType, name: string): Promise<TranslationAnalyticsResult>

typescript

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

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

const result = await client.analytics.getTranslation('agent', 'my-project');

Response Type

Promise<TranslationAnalyticsResult>

client.analytics.compare()

Compare effectiveness metrics across multiple versions of a definition.

Requires authentication

Parameters

typerequiredstring

Definition type.

agentcommandworkflowpipeline

namerequiredstring

Definition name.

versionsrequiredstring[]

Array of version strings to compare (2-5 versions).

compare(type: DefinitionType, name: string, versions: string[]): Promise<CompareResult>

typescript

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

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

const result = await client.analytics.compare('agent', 'my-project', 'example-value');

Response Type

Promise<CompareResult>

client.analytics.getDiffImpact()

Get the structural diff between two versions combined with metric deltas — shows what changed and how it affected effectiveness.

Requires authentication

Parameters

typerequiredstring

Definition type.

agentcommandworkflowpipeline

namerequiredstring

Definition name.

fromVersionrequiredstring

Source version.

toVersionrequiredstring

Target version.

getDiffImpact(type: DefinitionType, name: string, fromVersion: string, toVersion: string): Promise<DiffImpactResult>

typescript

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

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

const result = await client.analytics.getDiffImpact('agent', 'my-project', 'example-value', 'example-value');

Response Type

Promise<DiffImpactResult>