Eve library

@oshun/generation-control-isis

Other

Revision 1

On this page

Canonical Isis generation control adapter contracts for OSHUN.

This package defines the product-facing Isis interface that OSHUN uses when it needs:

  • approved workflow template and workflow-version selection
  • model-registry eligibility and release-state checks
  • provider-routing and RunPod/ComfyUI control-plane summaries
  • controlled generation planning and dispatch contracts
  • provenance, lineage, retention, and release-readiness inspection

It deliberately normalizes multiple Isis surfaces into one stable control-plane contract:

  • generation API for job dispatch, queue health, and provider routing
  • workflow registry for versioned templates and validation
  • model registry for approved model metadata and versions
  • output registry for provenance, lineage, and retention

The adapter contract exposes one canonical generation-control model for OSHUN shell, admin, and cross-domain orchestration work.

Scope#

  • canonical workflow-catalog, model-catalog, routing, provenance, retention, release-readiness, plan, and execution DTOs
  • low-level adapter interface for Isis generation, workflow-registry, model-registry, output-registry, and provider-routing primitives
  • canonical adapter factory (createCanonicalIsisGenerationControlAdapter) that wraps an injected low-level Isis adapter
  • normalization helpers that align raw Isis workflow, model, output, and routing payloads with OSHUN control-plane contracts

Usage#

ts
import { createCanonicalIsisGenerationControlAdapter } from '@oshun/generation-control-isis';

const isis = createCanonicalIsisGenerationControlAdapter({ apiAdapter });

const plan = await isis.planGeneration({
  consumer: 'assistant',
  workflowId: 'workflow-1',
  generationType: 'text-to-image',
  prompt: 'Radiant sunrise over a calm lake',
  userFacing: true,
});