@ultrst-armada/kloks 1.4.3 → 1.4.4

package/package.json

@@ -1,12 +1,12 @@
 {
   "name": "@ultrst-armada/kloks",
-  "version": "1.4.3",
+  "version": "1.4.4",
   "private": false,
   "publishConfig": {
     "access": "public",
     "registry": "https://registry.npmjs.org/"
   },
-  "description": "Kloks — Public Backend, State-Graph, Audio/MIDI & Service Package Library built on KrnlTS (@kloks/*)",
+  "description": "Kloks \u2014 Public Backend, State-Graph, Audio/MIDI & Service Package Library built on KrnlTS (@kloks/*)",
   "type": "module",
   "main": "./index.js",
   "module": "./index.js",
@@ -39,11 +39,6 @@
       "import": "./packages/state-graph/dist/state/index.js",
       "default": "./packages/state-graph/dist/state/index.js"
     },
-    "./state-graph/execution": {
-      "types": "./packages/state-graph/dist/execution/index.d.ts",
-      "import": "./packages/state-graph/dist/execution/index.js",
-      "default": "./packages/state-graph/dist/execution/index.js"
-    },
     "./state-graph/domain": {
       "types": "./packages/state-graph/dist/domain/index.d.ts",
       "import": "./packages/state-graph/dist/domain/index.js",
@@ -79,11 +74,6 @@
       "import": "./packages/backend/dist/index.js",
       "default": "./packages/backend/dist/index.js"
     },
-    "./backend/execution": {
-      "types": "./packages/backend/dist/execution/index.d.ts",
-      "import": "./packages/backend/dist/execution/index.js",
-      "default": "./packages/backend/dist/execution/index.js"
-    },
     "./backend/krnl-services": {
       "types": "./packages/backend/dist/krnl-services.d.ts",
       "import": "./packages/backend/dist/krnl-services.js",
@@ -113,11 +103,6 @@
       "types": "./packages/client/dist/index.d.ts",
       "import": "./packages/client/dist/index.js",
       "default": "./packages/client/dist/index.js"
-    },
-    "./backend/worker": {
-      "types": "./packages/backend/dist/execution/WorkerExecutionBoundary.d.ts",
-      "import": "./packages/backend/dist/execution/WorkerExecutionBoundary.js",
-      "default": "./packages/backend/dist/execution/WorkerExecutionBoundary.js"
     }
   },
   "scripts": {
@@ -131,7 +116,6 @@
   "dependencies": {
     "@aws-sdk/client-s3": "^3.600.0",
     "bcryptjs": "^2.4.3",
-    "bullmq": "^6.3.8",
     "ws": "^8.18.0",
     "zod": "^3.24.1",
     "zustand": "^5.0.15"
@@ -165,7 +149,7 @@
     "@types/better-sqlite3": "^7.6.0",
     "@types/node": "^22.0.0",
     "@types/react": "^19.0.0",
-    "@ultrst-armada/krnl": "^1.0.2",
+    "@ultrst-armada/krnl": "^1.0.3",
     "bcryptjs": "^2.4.3",
     "better-sqlite3": "^11.0.0",
     "react": "^19.0.1",
@@ -173,5 +157,9 @@
     "typescript": "^5.7.3",
     "vitest": "^3.1.0"
   },
-  "packageManager": "pnpm@9.15.0"
+  "packageManager": "pnpm@9.15.0",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/dinilmusick/Kloks.git"
+  }
 }

package/packages/audio-midi/dist/index.d.ts

@@ -1,5 +1,5 @@
 import * as _ultrst_armada_krnl from '@ultrst-armada/krnl';
-import { ServiceDefinition, IService } from '@ultrst-armada/krnl';
+import { ServiceDefinition, IService, OrchestrationDefinition } from '@ultrst-armada/krnl';
 import { INodeVisuals, SpaceNode, NodeConnection, MidiNote, SynthPreset, ContainerNode, PlayerNode, SamplePresetType, AudioTrackData, HardwareChannelInfo, NamedAudioBus, AudioDeviceInfo, ConnectionsConfig, MidiInputDevice, StoredPacket, RecorderNode, CurveTrackData, CurvePoint, EffectNode, CompressorEffectConfig, MultibandCompressorEffectConfig } from '@ultrst-armada/kloks/state-graph';
 export { AudioConcepts, BufferConcepts, BufferCycleCalculation } from '@ultrst-armada/kloks/state-graph';
 
@@ -969,21 +969,30 @@ declare const MidiServiceFacade: {
     createInstance: typeof createMidiService;
     execute: <TIn = unknown, TOut = unknown>(op: string, input?: TIn) => Promise<TOut>;
 };
-declare const AudioMidiOrchestratorFacade: {
+
+declare const AudioMidiOrchestratorDefinition: OrchestrationDefinition;
+declare const krnlAudioHardwareServiceDefinition: ServiceDefinition<Record<string, unknown>, Record<string, unknown>>;
+declare const krnlAudioHardwareServiceFacade: {
     id: string;
     name: string;
     version: string;
-    dependencies: string[];
-    execute: (input: {
-        midiCommand: MidiCommandType;
-        note?: number;
-        velocity?: number;
-        channel?: number;
-    }) => Promise<{
-        midiEvent: MidiEventPayload$1;
-        audioState: AudioHardwareState;
-        routedAt: number;
-    }>;
+    runtime: "client";
+    deployment: "local";
+    definition: ServiceDefinition<Record<string, unknown>, Record<string, unknown>>;
+    createInstance: typeof createAudioHardwareService;
+    execute: <TIn = unknown, TOut = unknown>(op: string, input?: TIn) => Promise<TOut>;
+};
+declare const krnlMidiServiceDefinition: ServiceDefinition<Record<string, unknown>, Record<string, unknown>>;
+declare const krnlMidiServiceFacade: {
+    id: string;
+    name: string;
+    version: string;
+    runtime: "client";
+    deployment: "local";
+    definition: ServiceDefinition<Record<string, unknown>, Record<string, unknown>>;
+    createInstance: typeof createMidiService;
+    execute: <TIn = unknown, TOut = unknown>(op: string, input?: TIn) => Promise<TOut>;
 };
+declare const krnlAudioMidiOrchestratorDefinition: OrchestrationDefinition<unknown, unknown>;
 
-export { type ActiveAuditionPlayback, type ActiveTrackPlayback, type AudioBusConfig, AudioClipEngine, AudioContainerGraphNode, AudioContextManager, type AudioDeviceDescriptor, type AudioEffectProcessorInstance, AudioEffects, type AudioEffectsState, type AudioEngineConfig, AudioHardwareServiceDefinition, AudioHardwareServiceFacade, type AudioHardwareState, AudioInputManager$1 as AudioInputManager, AudioMidiOrchestratorFacade, type AudioServiceEvents, type AudioStateListener, BaseAudioGraphNode, BaseProcessorAudioGraphNode, BaseSourceAudioGraphNode, type BufferedAudioPeak, type BufferedCurvePoint, type BufferedMidiEvent, type CrossoverBandNodes, CurveEngine, DEFAULT_AUDIO_CONFIG, DEFAULT_NAMED_BUSSES, DEFAULT_NAMED_INPUTS, DEFAULT_OSC_DEVICES, type DeviceListener, EffectProcessorGraphNode, type MidiEventPayload as EngineMidiEventPayload, type HardwareProfileResult, KNOWN_PATTERNS, type KnownDevicePattern, MasterAudioOutputGraphNode, type MidiCommandType, MidiContainerGraphNode, type MidiEventListener, type MidiEventPayload$1 as MidiEventPayload, MidiInstrumentGraphNode, type MidiListener, MidiManager$1 as MidiManager, type MidiPortDescriptor, MidiServiceDefinition, type MidiServiceEvents, MidiServiceFacade, type MidiStateListener, type MidiStatus, type MidiSubsystemState, MultiChannelOutputRouter, type MultibandCompressorInstance, type OscDevice, type OscDeviceListener, type OscDeviceType, type OscListener, OscManager, type OscMessage, OscServiceDefinition, OscServiceFacade, type OutputChannelInfo, RetrospectiveBufferEngine, type RetrospectiveCycleInfo, STORAGE_KEY_AUDIO_CONFIG, SequencerEngine, SequencerEngineServiceDefinition, SequencerEngineServiceFacade, type SidechainCompressorInstance, SignalRouterGraphNode, type SnapshotListener, type StatusListener, SynthConfigManager, SynthEngine, SynthEngineServiceDefinition, SynthEngineServiceFacade, type SynthEngineState, audioClipEngine, audioEffectsEntity, audioInputManager, buildInputChannelList, buildOutputChannelList, create3BandCrossover, createAudioEffectProcessor, createAudioGraphNode, createAudioHardwareService, createCosmicImpulseBuffer, createMidiService, createMultibandCompressor, createSidechainCompressor, curveEngine, detectHardwareProfile, generatePresetAudioBuffer, generateReverbImpulse, generateSaturationCurve, midiManager, multiChannelOutputRouter, oscManager, playContainerNoteWithEffects, playSyntheticDrumVoice, processActiveContainers, retrospectiveBufferEngine, sequencerEngine, synthEngine };
+export { type ActiveAuditionPlayback, type ActiveTrackPlayback, type AudioBusConfig, AudioClipEngine, AudioContainerGraphNode, AudioContextManager, type AudioDeviceDescriptor, type AudioEffectProcessorInstance, AudioEffects, type AudioEffectsState, type AudioEngineConfig, AudioHardwareServiceDefinition, AudioHardwareServiceFacade, type AudioHardwareState, AudioInputManager$1 as AudioInputManager, AudioMidiOrchestratorDefinition, type AudioServiceEvents, type AudioStateListener, BaseAudioGraphNode, BaseProcessorAudioGraphNode, BaseSourceAudioGraphNode, type BufferedAudioPeak, type BufferedCurvePoint, type BufferedMidiEvent, type CrossoverBandNodes, CurveEngine, DEFAULT_AUDIO_CONFIG, DEFAULT_NAMED_BUSSES, DEFAULT_NAMED_INPUTS, DEFAULT_OSC_DEVICES, type DeviceListener, EffectProcessorGraphNode, type MidiEventPayload as EngineMidiEventPayload, type HardwareProfileResult, KNOWN_PATTERNS, type KnownDevicePattern, MasterAudioOutputGraphNode, type MidiCommandType, MidiContainerGraphNode, type MidiEventListener, type MidiEventPayload$1 as MidiEventPayload, MidiInstrumentGraphNode, type MidiListener, MidiManager$1 as MidiManager, type MidiPortDescriptor, MidiServiceDefinition, type MidiServiceEvents, MidiServiceFacade, type MidiStateListener, type MidiStatus, type MidiSubsystemState, MultiChannelOutputRouter, type MultibandCompressorInstance, type OscDevice, type OscDeviceListener, type OscDeviceType, type OscListener, OscManager, type OscMessage, OscServiceDefinition, OscServiceFacade, type OutputChannelInfo, RetrospectiveBufferEngine, type RetrospectiveCycleInfo, STORAGE_KEY_AUDIO_CONFIG, SequencerEngine, SequencerEngineServiceDefinition, SequencerEngineServiceFacade, type SidechainCompressorInstance, SignalRouterGraphNode, type SnapshotListener, type StatusListener, SynthConfigManager, SynthEngine, SynthEngineServiceDefinition, SynthEngineServiceFacade, type SynthEngineState, audioClipEngine, audioEffectsEntity, audioInputManager, buildInputChannelList, buildOutputChannelList, create3BandCrossover, createAudioEffectProcessor, createAudioGraphNode, createAudioHardwareService, createCosmicImpulseBuffer, createMidiService, createMultibandCompressor, createSidechainCompressor, curveEngine, detectHardwareProfile, generatePresetAudioBuffer, generateReverbImpulse, generateSaturationCurve, krnlAudioHardwareServiceDefinition, krnlAudioHardwareServiceFacade, krnlAudioMidiOrchestratorDefinition, krnlMidiServiceDefinition, krnlMidiServiceFacade, midiManager, multiChannelOutputRouter, oscManager, playContainerNoteWithEffects, playSyntheticDrumVoice, processActiveContainers, retrospectiveBufferEngine, sequencerEngine, synthEngine };

package/packages/audio-midi/dist/index.js

@@ -37,7 +37,7 @@ import {
   synthEngine
 } from "./chunk-3GRGELA4.js";
 
-// ../../node_modules/.pnpm/@ultrst-armada+krnl@1.0.2/node_modules/@ultrst-armada/krnl/packages/core/dist/index.js
+// ../../node_modules/.pnpm/@ultrst-armada+krnl@1.0.3/node_modules/@ultrst-armada/krnl/packages/core/dist/index.js
 var ServiceStateStore = class {
   state;
   listeners = /* @__PURE__ */ new Set();
@@ -91,17 +91,37 @@ var ServiceEventBus = class {
     this.handlers.clear();
   }
 };
+var TRANSITIONS = {
+  uninitialized: ["initializing"],
+  initializing: ["ready", "uninitialized"],
+  ready: ["starting"],
+  starting: ["running", "ready"],
+  running: ["stopping"],
+  stopping: ["stopped", "running"],
+  stopped: ["starting"]
+};
 var LifecycleManager = class {
   status = "uninitialized";
   getStatus() {
     return this.status;
   }
-  setStatus(next) {
+  canTransitionTo(next) {
+    return TRANSITIONS[this.status].includes(next);
+  }
+  transitionTo(next) {
+    if (!this.canTransitionTo(next)) {
+      throw new Error("[Lifecycle] Invalid transition '" + this.status + "' -> '" + next + "'.");
+    }
     this.status = next;
   }
+  setStatus(next) {
+    this.transitionTo(next);
+  }
   assertRunning(serviceName) {
     if (this.status !== "running") {
-      throw new Error(`[Service:${serviceName}] Cannot invoke operation while status is '${this.status}' (expected 'running').`);
+      throw new Error(
+        "[Service:" + serviceName + "] Cannot invoke operation while status is '" + this.status + "' (expected 'running')."
+      );
     }
   }
 };
@@ -113,7 +133,7 @@ var ServiceInstance = class {
     this.version = definition.version;
     this.lifecycle = new LifecycleManager();
     this.eventBus = new ServiceEventBus();
-    if (definition.state?.initial) {
+    if (definition.state) {
       this.stateStore = new ServiceStateStore(definition.state.initial);
     }
   }
@@ -124,46 +144,76 @@ var ServiceInstance = class {
   stateStore;
   eventBus;
   lifecycle;
+  initialized = false;
+  disposed = false;
   getDefinition() {
     return this.definition;
   }
+  getStatus() {
+    return this.lifecycle.getStatus();
+  }
   async start() {
-    this.lifecycle.setStatus("starting");
-    if (this.definition.lifecycle?.onInit) {
-      await this.definition.lifecycle.onInit();
+    if (this.disposed) throw new Error("[Service:" + this.name + "] Cannot start a disposed service.");
+    const current = this.lifecycle.getStatus();
+    if (current === "running") return;
+    if (current === "initializing" || current === "starting" || current === "stopping") {
+      throw new Error("[Service:" + this.name + "] Cannot start while status is '" + current + "'.");
+    }
+    if (!this.initialized) {
+      this.lifecycle.transitionTo("initializing");
+      try {
+        await this.definition.lifecycle?.onInit?.();
+        this.initialized = true;
+        this.lifecycle.transitionTo("ready");
+      } catch (error) {
+        this.lifecycle.transitionTo("uninitialized");
+        throw error;
+      }
     }
-    if (this.definition.lifecycle?.onStart) {
-      await this.definition.lifecycle.onStart();
+    this.lifecycle.transitionTo("starting");
+    try {
+      await this.definition.lifecycle?.onStart?.();
+      this.lifecycle.transitionTo("running");
+    } catch (error) {
+      this.lifecycle.transitionTo("ready");
+      throw error;
     }
-    this.lifecycle.setStatus("running");
   }
   async stop() {
-    this.lifecycle.setStatus("stopping");
-    if (this.definition.lifecycle?.onStop) {
-      await this.definition.lifecycle.onStop();
+    const current = this.lifecycle.getStatus();
+    if (current === "stopped") return;
+    if (current !== "running") {
+      throw new Error("[Service:" + this.name + "] Cannot stop while status is '" + current + "'.");
     }
-    if (this.definition.lifecycle?.onDispose) {
-      await this.definition.lifecycle.onDispose();
+    this.lifecycle.transitionTo("stopping");
+    try {
+      await this.definition.lifecycle?.onStop?.();
+      this.lifecycle.transitionTo("stopped");
+    } catch (error) {
+      this.lifecycle.transitionTo("running");
+      throw error;
     }
-    this.lifecycle.setStatus("stopped");
+  }
+  async dispose() {
+    if (this.disposed) return;
+    if (this.lifecycle.getStatus() === "running") await this.stop();
+    await this.definition.lifecycle?.onDispose?.();
+    this.disposed = true;
   }
   async call(op, input, ctx = {}) {
     this.lifecycle.assertRunning(this.name);
     const operation = this.definition.operations[op];
     if (!operation) {
-      throw new Error(`[Service:${this.name}] Operation '${op}' not found.`);
+      throw new Error("[Service:" + this.name + "] Operation '" + op + "' not found.");
     }
     return await operation.handler(input, ctx);
   }
   getState() {
-    if (!this.stateStore) {
-      return Object.freeze({});
-    }
-    return this.stateStore.getState();
+    return this.stateStore?.getState() ?? Object.freeze({});
   }
   setState(mutation) {
     if (!this.stateStore) {
-      this.stateStore = new ServiceStateStore(mutation);
+      this.stateStore = new ServiceStateStore({ ...mutation });
       return;
     }
     this.stateStore.setState(mutation);
@@ -175,12 +225,66 @@ var ServiceInstance = class {
     this.eventBus.emit(event, payload);
   }
 };
-function createServiceDefinition(definition) {
+function assertRecord(value, field) {
+  if (!value || typeof value !== "object" || Array.isArray(value)) {
+    throw new Error("[KrnlTS] Invalid service definition: '" + field + "' must be an object.");
+  }
+}
+function assertNonEmptyString(value, field) {
+  if (typeof value !== "string" || value.trim().length === 0) {
+    throw new Error("[KrnlTS] Invalid service definition: '" + field + "' must be a non-empty string.");
+  }
+}
+function validateServiceDefinition(definition) {
+  if (!definition || typeof definition !== "object") {
+    throw new Error("[KrnlTS] Invalid service definition: expected an object.");
+  }
+  assertNonEmptyString(definition.id, "id");
+  assertNonEmptyString(definition.name, "name");
+  assertNonEmptyString(definition.version, "version");
+  if (!definition.operations || typeof definition.operations !== "object") {
+    throw new Error("[Service:" + definition.name + "] Invalid operations: expected an object.");
+  }
+  for (const [key, operation] of Object.entries(definition.operations)) {
+    if (!operation || typeof operation !== "object") {
+      throw new Error("[Service:" + definition.name + "] Invalid operation '" + key + "'.");
+    }
+    assertNonEmptyString(operation.id, "operations." + key + ".id");
+    assertNonEmptyString(operation.name, "operations." + key + ".name");
+    if (operation.inputSchema !== void 0) assertRecord(operation.inputSchema, "operations." + key + ".inputSchema");
+    if (operation.outputSchema !== void 0) assertRecord(operation.outputSchema, "operations." + key + ".outputSchema");
+    if (typeof operation.handler !== "function") {
+      throw new Error("[Service:" + definition.name + "] Operation '" + key + "' must define a handler.");
+    }
+  }
+  for (const [key, event] of Object.entries(definition.events ?? {})) {
+    if (!event || typeof event !== "object") {
+      throw new Error("[Service:" + definition.name + "] Invalid event '" + key + "'.");
+    }
+    assertNonEmptyString(event.name, "events." + key + ".name");
+  }
+  for (const [key, schema] of Object.entries(definition.inputs ?? {})) assertRecord(schema, "inputs." + key);
+  for (const [key, schema] of Object.entries(definition.outputs ?? {})) assertRecord(schema, "outputs." + key);
+  if (definition.state?.schema !== void 0) assertRecord(definition.state.schema, "state.schema");
+  for (const capability of definition.capabilities ?? []) {
+    assertNonEmptyString(capability.id, "capability.id");
+    assertNonEmptyString(capability.name, "capability.name");
+    if (!Array.isArray(capability.protocols)) {
+      throw new Error("[Service:" + definition.name + "] Capability '" + capability.name + "' protocols must be an array.");
+    }
+  }
+  for (const dependency of definition.dependencies ?? []) {
+    assertNonEmptyString(dependency.serviceId, "dependency.serviceId");
+  }
   return definition;
 }
+function createServiceDefinition(definition) {
+  return validateServiceDefinition(definition);
+}
 function createService(definition) {
-  return new ServiceInstance(definition);
+  return new ServiceInstance(validateServiceDefinition(definition));
 }
+var asyncHooks = globalThis.process?.getBuiltinModule?.("node:async_hooks");
 
 // src/audioInputManager.ts
 var AudioInputManager = class {
@@ -2362,7 +2466,14 @@ function createAudioHardwareService(manager = new AudioInputManager()) {
       getState: {
         id: "AudioHardwareService.getState",
         name: "getState",
-        handler: async () => manager.getState()
+        handler: async (input) => {
+          const state = manager.getState();
+          return {
+            ...state,
+            ...input && typeof input === "object" ? input : {},
+            audioState: state
+          };
+        }
       },
       dispose: {
         id: "AudioHardwareService.dispose",
@@ -2450,12 +2561,13 @@ function createMidiService(manager = new MidiManager()) {
           const unsub = manager.subscribeEvents((ev) => {
             captured = ev;
           });
-          manager.emitVirtualMidi(payload);
+          const cmd = payload.command || payload.midiCommand || "NOTE_ON";
+          manager.emitVirtualMidi({ ...payload, command: cmd });
           unsub();
           if (captured && svcRef) {
             svcRef.emit("midiEvent", captured);
           }
-          return captured;
+          return { midiEvent: captured, success: true };
         }
       },
       parseRawBytes: {
@@ -2505,28 +2617,36 @@ var MidiServiceFacade = {
     return defaultMidiService.call(op, input);
   }
 };
-var AudioMidiOrchestratorFacade = {
+var AudioMidiOrchestratorDefinition = {
   id: "kloks.orchestrator.audioMidi",
   name: "AudioMidiOrchestrator",
   version: "1.0.0",
+  description: "Pure serializable orchestration definition: Midi -> AudioHardware",
+  scope: "service",
   dependencies: [AudioHardwareServiceFacade.id, MidiServiceFacade.id],
-  execute: async (input) => {
-    const midiEvent = await MidiServiceFacade.execute("emitVirtualMidi", {
-      command: input.midiCommand,
-      note: input.note ?? 60,
-      velocity: input.velocity ?? 100,
-      channel: input.channel ?? 1
-    });
-    const audioState = await AudioHardwareServiceFacade.execute(
-      "getState"
-    );
-    return {
-      midiEvent,
-      audioState,
-      routedAt: Date.now()
-    };
-  }
+  steps: [
+    {
+      id: "step_midi",
+      name: "Emit Virtual MIDI",
+      type: "task",
+      target: MidiServiceFacade.id,
+      operation: "emitVirtualMidi"
+    },
+    {
+      id: "step_audio",
+      name: "Get Audio Hardware State",
+      type: "task",
+      target: AudioHardwareServiceFacade.id,
+      operation: "getState",
+      dependsOn: ["step_midi"]
+    }
+  ]
 };
+var krnlAudioHardwareServiceDefinition = AudioHardwareServiceDefinition;
+var krnlAudioHardwareServiceFacade = AudioHardwareServiceFacade;
+var krnlMidiServiceDefinition = MidiServiceDefinition;
+var krnlMidiServiceFacade = MidiServiceFacade;
+var krnlAudioMidiOrchestratorDefinition = AudioMidiOrchestratorDefinition;
 export {
   AudioClipEngine,
   AudioConcepts,
@@ -2536,7 +2656,7 @@ export {
   AudioHardwareServiceDefinition,
   AudioHardwareServiceFacade,
   AudioInputManager,
-  AudioMidiOrchestratorFacade,
+  AudioMidiOrchestratorDefinition,
   BaseAudioGraphNode,
   BaseProcessorAudioGraphNode,
   BaseSourceAudioGraphNode,
@@ -2586,6 +2706,11 @@ export {
   generatePresetAudioBuffer,
   generateReverbImpulse,
   generateSaturationCurve,
+  krnlAudioHardwareServiceDefinition,
+  krnlAudioHardwareServiceFacade,
+  krnlAudioMidiOrchestratorDefinition,
+  krnlMidiServiceDefinition,
+  krnlMidiServiceFacade,
   midiManager,
   multiChannelOutputRouter,
   oscManager,

package/packages/audio-midi/kloks.manifest.json

@@ -13,12 +13,6 @@
         "export": "AudioHardwareServiceFacade",
         "facade": "AudioHardwareServiceFacade"
       },
-      "ui": {
-        "package": "@floks/ui",
-        "components": [
-          "BaseCard"
-        ]
-      },
       "modes": [
         "backend",
         "fullstack"
@@ -31,7 +25,13 @@
           "App.main-content"
         ]
       },
-      "dependencies": []
+      "dependencies": [],
+      "defaultFrontend": {
+        "component": "BaseCard",
+        "package": "@ultrst-armada/floks/ui",
+        "export": "BaseCard",
+        "relationship": "recommended"
+      }
     },
     {
       "id": "midi",
@@ -60,7 +60,7 @@
       "name": "Audio & MIDI Orchestrator",
       "version": "1.0.0",
       "package": "@kloks/audio-midi",
-      "export": "AudioMidiOrchestratorFacade",
+      "export": "AudioMidiOrchestratorDefinition",
       "targetTypes": [
         "BackendFacade.orchestrations"
       ]

package/packages/audio-midi/package.json

@@ -28,6 +28,6 @@
     "@kloks/state-graph": "workspace:*"
   },
   "devDependencies": {
-    "@ultrst-armada/krnl": "^1.0.2"
+    "@ultrst-armada/krnl": "^1.0.3"
   }
 }

package/packages/backend/dist/{WebSocketTransport-CxUzUfwl.d.ts → WebSocketTransport-CHmkJ0tj.d.ts}

@@ -1,4 +1,111 @@
-import { R as ResolutionStrategy, B as BackendExecutor, C as CallbackHandle, M as Message, J as Job } from './types-BERZJ93O.js';
+/**
+ * @file types.ts
+ * @description Canonical protocol types, messages, jobs, callbacks, and resolution interfaces.
+ */
+type MessageType = 'COMMAND' | 'QUERY' | 'RESULT' | 'EVENT' | 'CALLBACK_REQUEST' | 'CALLBACK_RESULT' | 'JOB_SUBMIT' | 'JOB_PROGRESS' | 'JOB_RESULT' | 'ERROR' | 'ACK';
+interface AuthContext {
+    userId?: string;
+    role?: string;
+    permissions?: string[];
+    token?: string;
+}
+interface CapabilityContext {
+    domain: string;
+    capability: string;
+    scope?: string;
+}
+interface Message<T = unknown> {
+    id: string;
+    type: MessageType;
+    operation: string;
+    payload?: T;
+    sessionId?: string;
+    correlationId?: string;
+    causationId?: string;
+    sequence?: number;
+    timestamp: number;
+    authContext?: AuthContext;
+    capabilityContext?: CapabilityContext;
+    error?: {
+        code: string;
+        message: string;
+        details?: unknown;
+    };
+}
+interface CallbackHandle {
+    id: string;
+    sessionId: string;
+    capability: string;
+    expiration: number;
+}
+interface Delegation<T = unknown> {
+    target: string;
+    operation: string;
+    payload: T;
+    callbackHandle?: CallbackHandle;
+    eventChannel?: string;
+    sessionId?: string;
+    correlationId?: string;
+}
+type JobState = 'PENDING' | 'QUEUED' | 'RUNNING' | 'COMPLETED' | 'FAILED' | 'CANCELLED';
+type JobPriority = 'LOW' | 'NORMAL' | 'HIGH' | 'CRITICAL';
+interface Job<TPayload = unknown, TResult = unknown> {
+    id: string;
+    type: string;
+    payload: TPayload;
+    priority?: JobPriority;
+    sequence?: number;
+    sequenceKey?: string;
+    dependencies?: string[];
+    sessionId?: string;
+    correlationId?: string;
+    state: JobState;
+    progress?: number;
+    result?: TResult;
+    error?: string;
+    createdAt: number;
+    updatedAt: number;
+}
+type ResolutionStrategy = 'LOCAL' | 'REMOTE' | 'REMOTE_FIRST' | 'LOCAL_FIRST';
+interface ResourceVersion {
+    version: number;
+    updatedAt: number;
+    checksum?: string;
+}
+interface DistributedLock {
+    key: string;
+    ownerId: string;
+    leaseId: string;
+    expiration: number;
+}
+interface BackendInstance {
+    id: string;
+    url: string;
+    healthy: boolean;
+    capacity: number;
+    activeJobs: number;
+    activeConnections: number;
+    latencyMs: number;
+    lastHeartbeat: number;
+    weight?: number;
+}
+type RoutingStrategy = 'roundRobin' | 'weighted' | 'leastConnections' | 'latencyAware' | 'capacityAware';
+interface IdempotentRequest<T = unknown> {
+    id: string;
+    idempotencyKey: string;
+    operation: string;
+    payload: T;
+    timestamp: number;
+}
+interface BackendExecutor {
+    execute<T = unknown, R = unknown>(command: Message<T>): Promise<R>;
+    query<T = unknown, R = unknown>(query: Message<T>): Promise<R>;
+    subscribe(channel: string, handler: (event: Message) => void): () => void;
+    emit(event: Message): Promise<void>;
+    registerCallback(callback: (...args: unknown[]) => unknown): CallbackHandle;
+    delegate<T = unknown, R = unknown>(delegation: Delegation<T>): Promise<R>;
+    submitJob<T = unknown, R = unknown>(job: Partial<Job<T, R>>): Promise<Job<T, R>>;
+}
 
 /**
  * @file BackendResolver.ts
@@ -252,4 +359,4 @@ declare class WebSocketTransport implements ITransport {
     getReconnectDelay(): number;
 }
 
-export { BackendClient as B, type CallbackFn as C, type DomainProxy as D, type ErrorHandler as E, FrontendSession as F, type GapHandler as G, HTTPTransport as H, type ITransport as I, type MessageHandler as M, type SequenceCheckResult as S, WebSocketTransport as W, type BackendClientOptions as a, BackendResolver as b, type BackendResolverOptions as c, CallbackRegistry as d, EventBus as e, type EventHandler as f, type FrontendSessionOptions as g, type HTTPTransportOptions as h, SequenceTracker as i, type WebSocketTransportOptions as j, createBackendClient as k };
+export { type AuthContext as A, BackendClient as B, type CallbackFn as C, type Delegation as D, type ErrorHandler as E, FrontendSession as F, type GapHandler as G, HTTPTransport as H, type ITransport as I, type Job as J, type Message as M, type ResolutionStrategy as R, type SequenceCheckResult as S, WebSocketTransport as W, type BackendClientOptions as a, type BackendExecutor as b, type BackendInstance as c, BackendResolver as d, type BackendResolverOptions as e, type CallbackHandle as f, CallbackRegistry as g, type CapabilityContext as h, type DistributedLock as i, type DomainProxy as j, EventBus as k, type EventHandler as l, type FrontendSessionOptions as m, type HTTPTransportOptions as n, type IdempotentRequest as o, type JobPriority as p, type JobState as q, type MessageHandler as r, type MessageType as s, type ResourceVersion as t, type RoutingStrategy as u, SequenceTracker as v, type WebSocketTransportOptions as w, createBackendClient as x };

package/packages/backend/dist/auth/index.js

@@ -2,14 +2,14 @@ import {
   AdminGuard,
   BaseAccountProvider,
   LocalAccountProvider,
-  PasswordHasher,
-  loginSystemUser,
-  resolveUserFromToken
-} from "../chunk-4ZFXEFOE.js";
+  PasswordHasher
+} from "../chunk-MPYASJ5A.js";
 import {
   RateLimiter,
-  SessionManager
-} from "../chunk-25Y7AVTP.js";
+  SessionManager,
+  loginSystemUser,
+  resolveUserFromToken
+} from "../chunk-ZDH4XI7W.js";
 export {
   AdminGuard,
   BaseAccountProvider,