@uluops/core 0.5.0

package/dist/types/workflow.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"workflow.js","sourceRoot":"","sources":["../../src/types/workflow.ts"],"names":[],"mappings":""}

package/dist/utils/formatError.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Extract a human-readable message from an unknown error value.
+ * Safely handles Error instances, strings, and arbitrary objects.
+ */
+export declare function formatErrorMessage(error: unknown): string;
+//# sourceMappingURL=formatError.d.ts.map

package/dist/utils/formatError.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"formatError.d.ts","sourceRoot":"","sources":["../../src/utils/formatError.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAGzD"}

package/dist/utils/formatError.js

@@ -0,0 +1,10 @@
+/**
+ * Extract a human-readable message from an unknown error value.
+ * Safely handles Error instances, strings, and arbitrary objects.
+ */
+export function formatErrorMessage(error) {
+    if (error instanceof Error)
+        return error.message;
+    return String(error);
+}
+//# sourceMappingURL=formatError.js.map

package/dist/utils/formatError.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"formatError.js","sourceRoot":"","sources":["../../src/utils/formatError.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,UAAU,kBAAkB,CAAC,KAAc;IAC/C,IAAI,KAAK,YAAY,KAAK;QAAE,OAAO,KAAK,CAAC,OAAO,CAAC;IACjD,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC;AACvB,CAAC"}

package/dist/utils/parseRef.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Parse a definition reference string into name and optional version.
+ *
+ * Handles `name`, `name@version`, and edge cases like multiple `@` symbols
+ * (only splits on the first `@`).
+ *
+ * @example parseRef('code-validator') → ['code-validator', undefined]
+ * @example parseRef('code-validator@1.0.0') → ['code-validator', '1.0.0']
+ */
+export declare function parseRef(ref: string): [name: string, version: string | undefined];
+//# sourceMappingURL=parseRef.d.ts.map

package/dist/utils/parseRef.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parseRef.d.ts","sourceRoot":"","sources":["../../src/utils/parseRef.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,wBAAgB,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,SAAS,CAAC,CAIjF"}

package/dist/utils/parseRef.js

@@ -0,0 +1,16 @@
+/**
+ * Parse a definition reference string into name and optional version.
+ *
+ * Handles `name`, `name@version`, and edge cases like multiple `@` symbols
+ * (only splits on the first `@`).
+ *
+ * @example parseRef('code-validator') → ['code-validator', undefined]
+ * @example parseRef('code-validator@1.0.0') → ['code-validator', '1.0.0']
+ */
+export function parseRef(ref) {
+    const atIndex = ref.indexOf('@');
+    if (atIndex === -1)
+        return [ref, undefined];
+    return [ref.slice(0, atIndex), ref.slice(atIndex + 1) || undefined];
+}
+//# sourceMappingURL=parseRef.js.map

package/dist/utils/parseRef.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"parseRef.js","sourceRoot":"","sources":["../../src/utils/parseRef.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,MAAM,UAAU,QAAQ,CAAC,GAAW;IAClC,MAAM,OAAO,GAAG,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IACjC,IAAI,OAAO,KAAK,CAAC,CAAC;QAAE,OAAO,CAAC,GAAG,EAAE,SAAS,CAAC,CAAC;IAC5C,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,OAAO,CAAC,EAAE,GAAG,CAAC,KAAK,CAAC,OAAO,GAAG,CAAC,CAAC,IAAI,SAAS,CAAC,CAAC;AACtE,CAAC"}

package/dist/utils/sumTokenMetrics.d.ts

@@ -0,0 +1,9 @@
+import type { ExecutionMetrics } from '../types/execution.js';
+type TokenFields = Pick<ExecutionMetrics, 'inputTokens' | 'outputTokens' | 'cacheCreationTokens' | 'cacheReadTokens' | 'totalEffectiveTokens'>;
+/**
+ * Sum token-related fields across an array of execution metrics.
+ * Returns only token totals — caller adds durationMs, model, etc.
+ */
+export declare function sumTokenMetrics(items: ReadonlyArray<TokenFields>): Required<TokenFields>;
+export {};
+//# sourceMappingURL=sumTokenMetrics.d.ts.map

package/dist/utils/sumTokenMetrics.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sumTokenMetrics.d.ts","sourceRoot":"","sources":["../../src/utils/sumTokenMetrics.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAE9D,KAAK,WAAW,GAAG,IAAI,CAAC,gBAAgB,EAAE,aAAa,GAAG,cAAc,GAAG,qBAAqB,GAAG,iBAAiB,GAAG,sBAAsB,CAAC,CAAC;AAE/I;;;GAGG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,aAAa,CAAC,WAAW,CAAC,GAAG,QAAQ,CAAC,WAAW,CAAC,CAgBxF"}

package/dist/utils/sumTokenMetrics.js

@@ -0,0 +1,20 @@
+/**
+ * Sum token-related fields across an array of execution metrics.
+ * Returns only token totals — caller adds durationMs, model, etc.
+ */
+export function sumTokenMetrics(items) {
+    let inputTokens = 0;
+    let outputTokens = 0;
+    let cacheCreationTokens = 0;
+    let cacheReadTokens = 0;
+    let totalEffectiveTokens = 0;
+    for (const m of items) {
+        inputTokens += m.inputTokens;
+        outputTokens += m.outputTokens;
+        cacheCreationTokens += m.cacheCreationTokens ?? 0;
+        cacheReadTokens += m.cacheReadTokens ?? 0;
+        totalEffectiveTokens += m.totalEffectiveTokens;
+    }
+    return { inputTokens, outputTokens, cacheCreationTokens, cacheReadTokens, totalEffectiveTokens };
+}
+//# sourceMappingURL=sumTokenMetrics.js.map

package/dist/utils/sumTokenMetrics.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sumTokenMetrics.js","sourceRoot":"","sources":["../../src/utils/sumTokenMetrics.ts"],"names":[],"mappings":"AAIA;;;GAGG;AACH,MAAM,UAAU,eAAe,CAAC,KAAiC;IAC/D,IAAI,WAAW,GAAG,CAAC,CAAC;IACpB,IAAI,YAAY,GAAG,CAAC,CAAC;IACrB,IAAI,mBAAmB,GAAG,CAAC,CAAC;IAC5B,IAAI,eAAe,GAAG,CAAC,CAAC;IACxB,IAAI,oBAAoB,GAAG,CAAC,CAAC;IAE7B,KAAK,MAAM,CAAC,IAAI,KAAK,EAAE,CAAC;QACtB,WAAW,IAAI,CAAC,CAAC,WAAW,CAAC;QAC7B,YAAY,IAAI,CAAC,CAAC,YAAY,CAAC;QAC/B,mBAAmB,IAAI,CAAC,CAAC,mBAAmB,IAAI,CAAC,CAAC;QAClD,eAAe,IAAI,CAAC,CAAC,eAAe,IAAI,CAAC,CAAC;QAC1C,oBAAoB,IAAI,CAAC,CAAC,oBAAoB,CAAC;IACjD,CAAC;IAED,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,mBAAmB,EAAE,eAAe,EAAE,oBAAoB,EAAE,CAAC;AACnG,CAAC"}

package/dist/utils/topoSort.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Topological sort for workflow phase DAG execution.
+ *
+ * Groups phases into execution levels where all phases in a level
+ * have their dependencies satisfied by phases in earlier levels.
+ * Phases within the same level are independent and can run in parallel.
+ */
+interface HasDependencies {
+    id: string;
+    depends_on?: string[];
+}
+/**
+ * Group phases into topological execution levels.
+ *
+ * Level 0 contains phases with no dependencies (root set).
+ * Level N contains phases whose dependencies are all in levels 0..N-1.
+ * Phases within the same level are independent by construction.
+ *
+ * @throws Error if the dependency graph contains a cycle
+ * @throws Error if a dependency references a non-existent phase
+ */
+export declare function topoGroupLevels<T extends HasDependencies>(phases: T[]): T[][];
+export {};
+//# sourceMappingURL=topoSort.d.ts.map

package/dist/utils/topoSort.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"topoSort.d.ts","sourceRoot":"","sources":["../../src/utils/topoSort.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,UAAU,eAAe;IACvB,EAAE,EAAE,MAAM,CAAC;IACX,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;CACvB;AAED;;;;;;;;;GASG;AACH,wBAAgB,eAAe,CAAC,CAAC,SAAS,eAAe,EAAE,MAAM,EAAE,CAAC,EAAE,GAAG,CAAC,EAAE,EAAE,CAqD7E"}

package/dist/utils/topoSort.js

@@ -0,0 +1,60 @@
+/**
+ * Topological sort for workflow phase DAG execution.
+ *
+ * Groups phases into execution levels where all phases in a level
+ * have their dependencies satisfied by phases in earlier levels.
+ * Phases within the same level are independent and can run in parallel.
+ */
+/**
+ * Group phases into topological execution levels.
+ *
+ * Level 0 contains phases with no dependencies (root set).
+ * Level N contains phases whose dependencies are all in levels 0..N-1.
+ * Phases within the same level are independent by construction.
+ *
+ * @throws Error if the dependency graph contains a cycle
+ * @throws Error if a dependency references a non-existent phase
+ */
+export function topoGroupLevels(phases) {
+    if (phases.length === 0)
+        return [];
+    const phaseMap = new Map();
+    for (const phase of phases) {
+        phaseMap.set(phase.id, phase);
+    }
+    // Validate all dependencies reference existing phases
+    for (const phase of phases) {
+        for (const dep of phase.depends_on ?? []) {
+            if (!phaseMap.has(dep)) {
+                throw new Error(`Phase "${phase.id}" depends on "${dep}" which does not exist`);
+            }
+        }
+    }
+    const levels = [];
+    const placed = new Set();
+    while (placed.size < phases.length) {
+        const level = [];
+        for (const phase of phases) {
+            if (placed.has(phase.id))
+                continue;
+            const deps = phase.depends_on ?? [];
+            const allDepsSatisfied = deps.every(dep => placed.has(dep));
+            if (allDepsSatisfied) {
+                level.push(phase);
+            }
+        }
+        if (level.length === 0) {
+            // No progress possible — cycle detected
+            const remaining = phases
+                .filter(p => !placed.has(p.id))
+                .map(p => p.id);
+            throw new Error(`Cycle detected in phase dependencies: ${remaining.join(', ')}`);
+        }
+        for (const phase of level) {
+            placed.add(phase.id);
+        }
+        levels.push(level);
+    }
+    return levels;
+}
+//# sourceMappingURL=topoSort.js.map

package/dist/utils/topoSort.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"topoSort.js","sourceRoot":"","sources":["../../src/utils/topoSort.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAOH;;;;;;;;;GASG;AACH,MAAM,UAAU,eAAe,CAA4B,MAAW;IACpE,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,CAAC;IAEnC,MAAM,QAAQ,GAAG,IAAI,GAAG,EAAa,CAAC;IACtC,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QAC3B,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,EAAE,KAAK,CAAC,CAAC;IAChC,CAAC;IAED,sDAAsD;IACtD,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QAC3B,KAAK,MAAM,GAAG,IAAI,KAAK,CAAC,UAAU,IAAI,EAAE,EAAE,CAAC;YACzC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;gBACvB,MAAM,IAAI,KAAK,CACb,UAAU,KAAK,CAAC,EAAE,iBAAiB,GAAG,wBAAwB,CAC/D,CAAC;YACJ,CAAC;QACH,CAAC;IACH,CAAC;IAED,MAAM,MAAM,GAAU,EAAE,CAAC;IACzB,MAAM,MAAM,GAAG,IAAI,GAAG,EAAU,CAAC;IAEjC,OAAO,MAAM,CAAC,IAAI,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC;QACnC,MAAM,KAAK,GAAQ,EAAE,CAAC;QAEtB,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;YAC3B,IAAI,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC;gBAAE,SAAS;YAEnC,MAAM,IAAI,GAAG,KAAK,CAAC,UAAU,IAAI,EAAE,CAAC;YACpC,MAAM,gBAAgB,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC;YAE5D,IAAI,gBAAgB,EAAE,CAAC;gBACrB,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YACpB,CAAC;QACH,CAAC;QAED,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACvB,wCAAwC;YACxC,MAAM,SAAS,GAAG,MAAM;iBACrB,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;iBAC9B,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;YAClB,MAAM,IAAI,KAAK,CACb,yCAAyC,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAChE,CAAC;QACJ,CAAC;QAED,KAAK,MAAM,KAAK,IAAI,KAAK,EAAE,CAAC;YAC1B,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;QACvB,CAAC;QACD,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACrB,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/validation/ValidationClient.d.ts

@@ -0,0 +1,51 @@
+import type { ResolvedConfig } from '../types/config.js';
+import type { ExecutionResult } from '../types/execution.js';
+import type { AgentResult } from '../types/agent.js';
+import type { RunSubmission, RunSubmissionResponse, RunHistoryEntry, ValidationQueryOptions } from '../types/validation.js';
+/**
+ * Thin wrapper around @uluops/ops-sdk for execution result submission.
+ *
+ * Delegates all API operations to OpsClient (which handles retry,
+ * rate limiting, error mapping, auth). This class transforms
+ * SDK ExecutionResult objects into the format expected by OpsClient.
+ *
+ * For full issue management, analytics, and taxonomy operations,
+ * use `@uluops/ops-sdk` directly.
+ */
+export declare class ValidationClient {
+    private config;
+    private ops;
+    constructor(config: ResolvedConfig);
+    /**
+     * Submit execution results to validation service
+     */
+    submit(submission: RunSubmission): Promise<RunSubmissionResponse>;
+    /**
+     * Preview what a submission would do without saving (dry run).
+     *
+     * Accepts individual parameters matching the public UluOpsClient API.
+     */
+    validateRun(project: string, workflowType: string, result: ExecutionResult | AgentResult): Promise<{
+        wouldCreate: boolean;
+        wouldUpdate: boolean;
+        wouldRegress: boolean;
+        validationErrors: string[];
+    }>;
+    /**
+     * Get run history for a project
+     */
+    getHistory(project: string, options?: Omit<ValidationQueryOptions, 'project'>): Promise<RunHistoryEntry[]>;
+    /**
+     * Get details for a specific run by ID
+     */
+    getRun(runId: string): Promise<RunSubmissionResponse>;
+    /**
+     * Transform SDK RunSubmission to OpsClient SaveFeaturesListInput format
+     */
+    private transformToOpsInput;
+    /**
+     * Create a local-only response when tracking is disabled
+     */
+    private createLocalResponse;
+}
+//# sourceMappingURL=ValidationClient.d.ts.map

package/dist/validation/ValidationClient.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ValidationClient.d.ts","sourceRoot":"","sources":["../../src/validation/ValidationClient.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACzD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAC7D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AACrD,OAAO,KAAK,EAAE,aAAa,EAAE,qBAAqB,EAAE,eAAe,EAAE,sBAAsB,EAAE,MAAM,wBAAwB,CAAC;AAE5H;;;;;;;;;GASG;AACH,qBAAa,gBAAgB;IAGf,OAAO,CAAC,MAAM;IAF1B,OAAO,CAAC,GAAG,CAAY;gBAEH,MAAM,EAAE,cAAc;IAQ1C;;OAEG;IACG,MAAM,CAAC,UAAU,EAAE,aAAa,GAAG,OAAO,CAAC,qBAAqB,CAAC;IAwBvE;;;;OAIG;IACG,WAAW,CACf,OAAO,EAAE,MAAM,EACf,YAAY,EAAE,MAAM,EACpB,MAAM,EAAE,eAAe,GAAG,WAAW,GACpC,OAAO,CAAC;QACT,WAAW,EAAE,OAAO,CAAC;QACrB,WAAW,EAAE,OAAO,CAAC;QACrB,YAAY,EAAE,OAAO,CAAC;QACtB,gBAAgB,EAAE,MAAM,EAAE,CAAC;KAC5B,CAAC;IAYF;;OAEG;IACG,UAAU,CACd,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE,IAAI,CAAC,sBAAsB,EAAE,SAAS,CAAC,GAChD,OAAO,CAAC,eAAe,EAAE,CAAC;IAuB7B;;OAEG;IACG,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,qBAAqB,CAAC;IAkB3D;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAqD3B;;OAEG;IACH,OAAO,CAAC,mBAAmB;CAgB5B"}

package/dist/validation/ValidationClient.js

@@ -0,0 +1,179 @@
+import { OpsClient } from '@uluops/ops-sdk';
+/**
+ * Thin wrapper around @uluops/ops-sdk for execution result submission.
+ *
+ * Delegates all API operations to OpsClient (which handles retry,
+ * rate limiting, error mapping, auth). This class transforms
+ * SDK ExecutionResult objects into the format expected by OpsClient.
+ *
+ * For full issue management, analytics, and taxonomy operations,
+ * use `@uluops/ops-sdk` directly.
+ */
+export class ValidationClient {
+    config;
+    ops;
+    constructor(config) {
+        this.config = config;
+        this.ops = new OpsClient({
+            apiKey: config.apiKey,
+            baseUrl: config.validationUrl,
+            timeout: config.timeout,
+        });
+    }
+    /**
+     * Submit execution results to validation service
+     */
+    async submit(submission) {
+        if (!this.config.trackingEnabled) {
+            return this.createLocalResponse(submission);
+        }
+        const input = this.transformToOpsInput(submission);
+        const response = await this.ops.runs.save(input);
+        return {
+            runId: response.run.id,
+            runNumber: response.run.runNumber,
+            projectId: response.run.projectId,
+            dashboardUrl: `${this.config.dashboardUrl}/runs/${response.run.id}`,
+            allGatesPassed: response.run.allGatesPassed,
+            averageScore: response.run.averageScore ?? 0,
+            correlation: {
+                newIssues: response.correlation?.newIssues ?? 0,
+                recurringIssues: response.correlation?.recurringIssues ?? 0,
+                regressions: response.correlation?.regressions ?? 0,
+            },
+            deduplicated: response.deduplicated,
+        };
+    }
+    /**
+     * Preview what a submission would do without saving (dry run).
+     *
+     * Accepts individual parameters matching the public UluOpsClient API.
+     */
+    async validateRun(project, workflowType, result) {
+        const input = this.transformToOpsInput({ project, workflowType, result });
+        const response = await this.ops.runs.validate(input);
+        return {
+            wouldCreate: Boolean(response.wouldCreate),
+            wouldUpdate: Boolean(response.wouldUpdate),
+            wouldRegress: Boolean(response.wouldRegress),
+            validationErrors: response.validationErrors,
+        };
+    }
+    /**
+     * Get run history for a project
+     */
+    async getHistory(project, options) {
+        const runs = await this.ops.runs.listByProject(project, {
+            workflowType: options?.workflowType,
+            limit: options?.limit,
+        });
+        return runs.map(r => ({
+            id: r.id,
+            projectId: r.projectId,
+            runNumber: r.runNumber,
+            workflowType: r.workflowType,
+            timestamp: r.timestamp,
+            allGatesPassed: r.allGatesPassed,
+            averageScore: r.averageScore ?? 0,
+            rawMarkdown: r.rawMarkdown ?? undefined,
+            archivedAt: r.archivedAt ?? undefined,
+            archiveReason: r.archiveReason ?? undefined,
+            idempotencyKey: r.idempotencyKey,
+            createdAt: r.createdAt,
+            updatedAt: r.updatedAt ?? r.createdAt,
+        }));
+    }
+    /**
+     * Get details for a specific run by ID
+     */
+    async getRun(runId) {
+        const run = await this.ops.runs.get(runId);
+        return {
+            runId: run.id,
+            runNumber: run.runNumber,
+            projectId: run.projectId,
+            dashboardUrl: `${this.config.dashboardUrl}/runs/${run.id}`,
+            allGatesPassed: run.allGatesPassed,
+            averageScore: run.averageScore ?? 0,
+            correlation: { newIssues: 0, recurringIssues: 0, regressions: 0 },
+            deduplicated: false,
+        };
+    }
+    // ─────────────────────────────────────────────────────────────────────────────
+    // Private Methods
+    // ─────────────────────────────────────────────────────────────────────────────
+    /**
+     * Transform SDK RunSubmission to OpsClient SaveFeaturesListInput format
+     */
+    transformToOpsInput(submission) {
+        const { result } = submission;
+        return {
+            project: submission.project,
+            workflowType: submission.workflowType,
+            idempotencyKey: submission.idempotencyKey,
+            agents: [{
+                    name: result.name,
+                    score: result.score ?? 0,
+                    maxScore: 100,
+                    decision: result.decision,
+                    model: result.metrics.model,
+                    tokens: {
+                        inputTokens: result.metrics.inputTokens,
+                        outputTokens: result.metrics.outputTokens,
+                        cacheCreationTokens: result.metrics.cacheCreationTokens,
+                        cacheReadTokens: result.metrics.cacheReadTokens,
+                        totalEffectiveTokens: result.metrics.totalEffectiveTokens,
+                    },
+                    durationMs: result.metrics.durationMs,
+                }],
+            recommendations: result.recommendations.map(r => ({
+                agent: r.validator ?? 'unknown',
+                validator: r.validator ?? 'unknown',
+                title: r.title,
+                priority: r.priority,
+                severity: r.severity,
+                failureCode: r.failureCode,
+                failureDomain: r.failureDomain,
+                failureMode: r.failureMode,
+                category: r.category,
+                filePath: r.filePath,
+                lineNumber: r.lineNumber,
+                description: r.description,
+                classificationConfidence: r.classificationConfidence,
+                classifiedBy: r.classifiedBy,
+                secondaryFailureCodes: r.secondaryFailureCodes,
+                taxonomyVersion: r.taxonomyVersion,
+            })),
+            timestamp: new Date().toISOString(),
+            rawMarkdown: submission.rawMarkdown,
+            summary: {
+                allGatesPassed: result.decision === 'PASS' || result.decision === 'SHIP',
+                averageScore: result.score ?? 0,
+            },
+            definitionType: result.type,
+            definitionName: result.name,
+            definitionVersion: result.version !== 'unknown' ? result.version : undefined,
+            definitionHash: result.definitionHash?.replace(/^sha256:/, ''),
+        };
+    }
+    /**
+     * Create a local-only response when tracking is disabled
+     */
+    createLocalResponse(submission) {
+        return {
+            runId: 'local',
+            runNumber: 0,
+            projectId: 'local',
+            dashboardUrl: '',
+            allGatesPassed: submission.result.decision === 'PASS' || submission.result.decision === 'SHIP',
+            averageScore: submission.result.score ?? 0,
+            correlation: {
+                newIssues: submission.result.recommendations.length,
+                recurringIssues: 0,
+                regressions: 0,
+            },
+            deduplicated: false,
+        };
+    }
+}
+//# sourceMappingURL=ValidationClient.js.map

package/dist/validation/ValidationClient.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ValidationClient.js","sourceRoot":"","sources":["../../src/validation/ValidationClient.ts"],"names":[],"mappings":"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"}

package/dist/validation/index.d.ts

@@ -0,0 +1,2 @@
+export { ValidationClient } from './ValidationClient.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/validation/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/validation/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC"}

package/dist/validation/index.js

@@ -0,0 +1,2 @@
+export { ValidationClient } from './ValidationClient.js';
+//# sourceMappingURL=index.js.map

package/dist/validation/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/validation/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC"}

package/package.json

@@ -0,0 +1,76 @@
+{
+  "name": "@uluops/core",
+  "version": "0.5.0",
+  "description": "The foundational execution engine for UluOps. Orchestrates AI-powered code analysis through a 4-layer execution hierarchy (Agent > Command > Workflow > Pipeline), manages LLM tool loops via Vercel AI SDK, and integrates with UluOps Registry and Validation services.",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    },
+    "./types": {
+      "import": "./dist/types/index.js",
+      "types": "./dist/types/index.d.ts"
+    },
+    "./errors": {
+      "import": "./dist/errors/index.js",
+      "types": "./dist/errors/index.d.ts"
+    }
+  },
+  "files": [
+    "dist",
+    "definitions"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run",
+    "test:watch": "vitest watch",
+    "test:coverage": "vitest run --coverage",
+    "lint": "eslint src/",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": [
+    "uluops",
+    "validation",
+    "agent",
+    "workflow",
+    "pipeline",
+    "sdk",
+    "llm",
+    "ai"
+  ],
+  "author": "Uluops <engineering@uluops.com>",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Uluops/uluops-core.git"
+  },
+  "dependencies": {
+    "@ai-sdk/anthropic": "^3.0.0",
+    "@ai-sdk/google": "^3.0.31",
+    "@ai-sdk/openai": "^3.0.33",
+    "@uluops/ops-sdk": "^1.1.0",
+    "@uluops/registry-sdk": "^0.3.0",
+    "@uluops/sdk-core": "^0.5.0",
+    "ai": "^6.0.0",
+    "glob": "^11.0.0",
+    "yaml": "^2.7.0",
+    "zod": "^3.24.1"
+  },
+  "devDependencies": {
+    "@types/node": "^22.12.0",
+    "@typescript-eslint/eslint-plugin": "^8.54.0",
+    "@typescript-eslint/parser": "^8.54.0",
+    "eslint": "^9.39.2",
+    "nock": "^14.0.1",
+    "typescript": "^5.7.3",
+    "typescript-eslint": "^8.54.0",
+    "vitest": "^3.0.4"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  }
+}