Item class

A versioned asset in the Kumiho system.

Items represent assets that can have multiple revisions, such as 3D models, textures, workflows, or any other type of creative content. They are the main entry-point for client tools: each API in this class returns a high-level model object rather than the protobuf response so dartdoc can generate user-facing documentation without exposing transport details.

final item = await kumiho.getItem('kref://my-project/models/hero.model');

// Create a new revision
final v1 = await item.createRevision(metadata: {'artist': 'john'});

// Add artifacts to the revision
await v1.createArtifact('mesh', '/assets/hero_v1.fbx');

// Tag the revision
await v1.tag('approved');

// Get all revisions
for (final revision in await item.getRevisions()) {
  print('v${revision.number}: ${revision.tags}');
}