# @oshun/generation-control-isis

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,
});
```