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