@ultrst-armada/kloks 1.4.3 → 1.4.4

package/packages/backend/kloks.manifest.json

@@ -14,13 +14,6 @@
         "export": "AuthServiceFacade",
         "facade": "AuthServiceFacade"
       },
-      "ui": {
-        "package": "@floks/ui",
-        "components": [
-          "LoginModal",
-          "CredentialField"
-        ]
-      },
       "modes": [
         "backend",
         "fullstack"
@@ -33,7 +26,12 @@
           "App.main-content"
         ]
       },
-      "dependencies": []
+      "dependencies": [],
+      "defaultFrontend": {
+        "component": "AuthPage",
+        "package": "@ultrst-armada/floks/ui",
+        "relationship": "recommended"
+      }
     },
     {
       "id": "storage",
@@ -46,12 +44,6 @@
         "export": "StorageServiceFacade",
         "facade": "StorageServiceFacade"
       },
-      "ui": {
-        "package": "@floks/ui",
-        "components": [
-          "BaseCard"
-        ]
-      },
       "modes": [
         "backend",
         "fullstack"
@@ -64,7 +56,14 @@
           "App.main-content"
         ]
       },
-      "dependencies": []
+      "dependencies": [
+        "srkl"
+      ],
+      "defaultFrontend": {
+        "component": "WorkspaceTilesMenu",
+        "package": "@ultrst-armada/floks/ui",
+        "relationship": "recommended"
+      }
     },
     {
       "id": "workspace",
@@ -77,12 +76,6 @@
         "export": "WorkspaceServiceFacade",
         "facade": "WorkspaceServiceFacade"
       },
-      "ui": {
-        "package": "@floks/ui",
-        "components": [
-          "WorkspaceTilesMenu"
-        ]
-      },
       "modes": [
         "backend",
         "fullstack"
@@ -95,7 +88,16 @@
           "App.main-content"
         ]
       },
-      "dependencies": []
+      "dependencies": [
+        "auth",
+        "storage",
+        "srkl"
+      ],
+      "defaultFrontend": {
+        "component": "WorkspaceTilesMenu",
+        "package": "@ultrst-armada/floks/ui",
+        "relationship": "recommended"
+      }
     },
     {
       "id": "control-plane",
@@ -108,12 +110,6 @@
         "export": "ControlPlaneServiceFacade",
         "facade": "ControlPlaneServiceFacade"
       },
-      "ui": {
-        "package": "@floks/ui",
-        "components": [
-          "StatusIndicator"
-        ]
-      },
       "modes": [
         "backend",
         "fullstack"
@@ -126,18 +122,23 @@
           "App.footer"
         ]
       },
-      "dependencies": []
+      "dependencies": [],
+      "defaultFrontend": {
+        "component": "StatusIndicator",
+        "package": "@ultrst-armada/floks/ui",
+        "relationship": "recommended"
+      }
     },
     {
-      "id": "execution",
-      "name": "Execution & Worker Boundary",
+      "id": "database",
+      "name": "Database Service",
       "version": "1.0.0",
-      "description": "Executable backend facade with isolated background worker boundary.",
+      "description": "SQL and transaction execution driver service.",
       "backend": {
         "package": "@kloks/backend",
         "subpath": "krnl-services",
-        "export": "ExecutionServiceFacade",
-        "facade": "ExecutionServiceFacade"
+        "export": "DatabaseServiceFacade",
+        "facade": "DatabaseServiceFacade"
       },
       "modes": [
         "backend"
@@ -150,15 +151,15 @@
       "dependencies": []
     },
     {
-      "id": "database",
-      "name": "Database Service",
+      "id": "gemini",
+      "name": "Google Gemini AI Service",
       "version": "1.0.0",
-      "description": "SQL and transaction execution driver service.",
+      "description": "Gemini text and multimodal generation service.",
       "backend": {
         "package": "@kloks/backend",
         "subpath": "krnl-services",
-        "export": "DatabaseServiceFacade",
-        "facade": "DatabaseServiceFacade"
+        "export": "GeminiServiceFacade",
+        "facade": "GeminiServiceFacade"
       },
       "modes": [
         "backend"
@@ -171,18 +172,19 @@
       "dependencies": []
     },
     {
-      "id": "gemini",
-      "name": "Google Gemini AI Service",
+      "id": "srkl",
+      "name": "SRKL Credential Federation",
       "version": "1.0.0",
-      "description": "Gemini text and multimodal generation service.",
+      "description": "Service-account discovery and Backblaze B2 bucket federation for reusable application modules.",
       "backend": {
         "package": "@kloks/backend",
         "subpath": "krnl-services",
-        "export": "GeminiServiceFacade",
-        "facade": "GeminiServiceFacade"
+        "export": "SrklServiceFacade",
+        "facade": "SrklServiceFacade"
       },
       "modes": [
-        "backend"
+        "backend",
+        "fullstack"
       ],
       "targets": {
         "backend": [

package/packages/backend/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@kloks/backend",
   "version": "1.0.0",
-  "description": "Kloks Backend Services — Auth, Storage, Workspace, Control Plane, API, Connectivity & Execution built on KrnlTS",
+  "description": "Kloks Backend Services \u2014 Auth, Storage, Workspace, Control Plane, API, Connectivity & Execution built on KrnlTS",
   "type": "module",
   "private": false,
   "publishConfig": {
@@ -58,11 +58,6 @@
       "types": "./dist/srkl/index.d.ts",
       "default": "./dist/srkl/index.js"
     },
-    "./execution": {
-      "import": "./dist/execution/index.js",
-      "types": "./dist/execution/index.d.ts",
-      "default": "./dist/execution/index.js"
-    },
     "./services": {
       "import": "./dist/services/index.js",
       "types": "./dist/services/index.d.ts",
@@ -75,7 +70,7 @@
     }
   },
   "scripts": {
-    "build": "tsup src/index.ts src/krnl-services.ts src/services/index.ts src/auth/index.ts src/storage/index.ts src/workspace/index.ts src/control-plane/index.ts src/api/index.ts src/connectivity/index.ts src/client/index.ts src/srkl/index.ts src/execution/index.ts --format esm --dts --clean --external @kloks/functions --external react --external @kloks/state-graph --external @neondatabase/serverless --external @supabase/supabase-js --external @aws-sdk/client-s3 --external @aws-sdk/lib-storage --external bcryptjs --external better-sqlite3 --external zod --external ws",
+    "build": "tsup src/index.ts src/krnl-services.ts src/services/index.ts src/auth/index.ts src/storage/index.ts src/workspace/index.ts src/control-plane/index.ts src/api/index.ts src/connectivity/index.ts src/client/index.ts src/srkl/index.ts --format esm --dts --clean --external @kloks/functions --external react --external @kloks/state-graph --external @neondatabase/serverless --external @supabase/supabase-js --external @aws-sdk/client-s3 --external @aws-sdk/lib-storage --external bcryptjs --external better-sqlite3 --external zod --external ws",
     "typecheck": "tsc --noEmit",
     "clean": "rm -rf dist"
   },
@@ -120,6 +115,6 @@
     }
   },
   "devDependencies": {
-    "@ultrst-armada/krnl": "^1.0.2"
+    "@ultrst-armada/krnl": "^1.0.3"
   }
 }

package/packages/client/package.json

@@ -36,6 +36,6 @@
     }
   },
   "devDependencies": {
-    "@ultrst-armada/krnl": "^1.0.2"
+    "@ultrst-armada/krnl": "^1.0.3"
   }
 }

package/packages/contracts/dist/index.js

@@ -224,24 +224,20 @@ var KLOKS_PUBLIC_SURFACE = [
   { name: "MidiManager", subpath: "audio-midi", category: "audio-midi", hasZodSchema: false },
   { name: "AudioHardwareServiceFacade", subpath: "audio-midi", category: "audio-midi", hasZodSchema: false },
   { name: "MidiServiceFacade", subpath: "audio-midi", category: "audio-midi", hasZodSchema: false },
-  { name: "AudioMidiOrchestratorFacade", subpath: "audio-midi", category: "audio-midi", hasZodSchema: false },
+  { name: "AudioMidiOrchestratorDefinition", subpath: "audio-midi", category: "audio-midi", hasZodSchema: false },
   { name: "AudioBusConfig", subpath: "audio-midi", category: "audio-midi", hasZodSchema: true },
   { name: "AudioHardwareState", subpath: "audio-midi", category: "audio-midi", hasZodSchema: true },
   { name: "MidiCommandType", subpath: "audio-midi", category: "audio-midi", hasZodSchema: true },
   { name: "MidiEventPayload", subpath: "audio-midi", category: "audio-midi", hasZodSchema: true },
   // ── orchestrations ──
-  { name: "OrchestratorAFacade", subpath: "orchestrations", category: "orchestrations", hasZodSchema: false },
-  { name: "OrchestratorBFacade", subpath: "orchestrations", category: "orchestrations", hasZodSchema: false },
-  { name: "WorkspaceBackendFacade", subpath: "orchestrations", category: "orchestrations", hasZodSchema: false },
-  { name: "backendFacade", subpath: "orchestrations", category: "orchestrations", hasZodSchema: false },
-  { name: "workerExecutionBoundary", subpath: "orchestrations", category: "orchestrations", hasZodSchema: false },
+  { name: "OrchestratorADefinition", subpath: "orchestrations", category: "orchestrations", hasZodSchema: false },
+  { name: "OrchestratorBDefinition", subpath: "orchestrations", category: "orchestrations", hasZodSchema: false },
+  { name: "AudioMidiOrchestratorDefinition", subpath: "orchestrations", category: "orchestrations", hasZodSchema: false },
   // ── backend ──
   { name: "AuthServiceFacade", subpath: "backend", category: "backend", hasZodSchema: false },
   { name: "StorageServiceFacade", subpath: "backend", category: "backend", hasZodSchema: false },
   { name: "WorkspaceServiceFacade", subpath: "backend", category: "backend", hasZodSchema: false },
   { name: "ControlPlaneServiceFacade", subpath: "backend", category: "backend", hasZodSchema: false },
-  { name: "ExecutionServiceFacade", subpath: "backend", category: "backend", hasZodSchema: false },
-  { name: "ExecutableBackendFacade", subpath: "backend", category: "backend", hasZodSchema: false },
   // ── services ──
   { name: "ServiceAFacade", subpath: "services", category: "services", hasZodSchema: false },
   { name: "ServiceBFacade", subpath: "services", category: "services", hasZodSchema: false },
@@ -276,10 +272,9 @@ var QWNSR_REQUIRED_SURFACE = [
   "createNodeInstance",
   "StateLifecycleServiceFacade",
   "NodeGraphEngineServiceFacade",
-  "WorkspaceBackendFacade",
   "AudioHardwareServiceFacade",
   "MidiServiceFacade",
-  "AudioMidiOrchestratorFacade"
+  "AudioMidiOrchestratorDefinition"
 ];
 function validateConsumerSurfaceCompatibility(requiredSymbols = QWNSR_REQUIRED_SURFACE, publicSurface = KLOKS_PUBLIC_SURFACE) {
   const publicNames = new Set(publicSurface.map((s) => s.name));

package/packages/contracts/package.json

@@ -28,6 +28,6 @@
     "zod": "^3.24.1"
   },
   "devDependencies": {
-    "@ultrst-armada/krnl": "^1.0.2"
+    "@ultrst-armada/krnl": "^1.0.3"
   }
 }

package/packages/functions/dist/index.d.ts

@@ -384,5 +384,16 @@ declare const FunctionsServiceFacade: {
     createInstance: () => _ultrst_armada_krnl.ServiceInstance<Record<string, unknown>, Record<string, unknown>>;
     execute: <TIn = unknown, TOut = unknown>(op: string, input?: TIn) => Promise<TOut>;
 };
+declare const krnlFunctionsServiceDefinition: ServiceDefinition<Record<string, unknown>, Record<string, unknown>>;
+declare const krnlFunctionsServiceFacade: {
+    id: string;
+    name: string;
+    version: string;
+    runtime: "server";
+    deployment: "local";
+    definition: ServiceDefinition<Record<string, unknown>, Record<string, unknown>>;
+    createInstance: () => _ultrst_armada_krnl.ServiceInstance<Record<string, unknown>, Record<string, unknown>>;
+    execute: <TIn = unknown, TOut = unknown>(op: string, input?: TIn) => Promise<TOut>;
+};
 
-export { type Disposable, type EventListener, FileCache, FileLock, FunctionsServiceDefinition, FunctionsServiceFacade, LRUCache, type Logger, type Provider, type RealtimeWorkspaceEvent, type ReleaseFn, type Result, SkipoBase, type SkipoConfig, type SkipoHTTPOptions, type SkipoHTTPResult, type SpawnHandle, TTLCache, appendFile, copyDir, createClient, createTempDir, createTempFile, debounce, deepClone, deepEqual, deepMerge, del, deleteDir, deleteFile, dirExists, ensureDir, execCmd, fileExists, firstExisting, get, getEnv, getFileStat, getPath, getRecentEvents, interpolate, isPlaceholderConnection, listDir, loadEnv, memoize, objectDiff, once, pLimit, platform, post, prefixedId, publishRealtimeEvent, put, readFile, readJSON, request, requestRaw, requireEnv, retry, sanitizeDatabaseUrl, setPath, shortId, sleep, spawnCmd, streamResponse, subscribeRealtimeEvents, swr, throttle, toCamelCase, toKebabCase, toPascalCase, toScreamingSnake, toSlug, toSnakeCase, updateJSON, uuid, validateEnvSchema, walkDir, watchDir, watchFile, which, withTempDir, withTimeout, writeFile, writeFileAtomic, writeJSON };
+export { type Disposable, type EventListener, FileCache, FileLock, FunctionsServiceDefinition, FunctionsServiceFacade, LRUCache, type Logger, type Provider, type RealtimeWorkspaceEvent, type ReleaseFn, type Result, SkipoBase, type SkipoConfig, type SkipoHTTPOptions, type SkipoHTTPResult, type SpawnHandle, TTLCache, appendFile, copyDir, createClient, createTempDir, createTempFile, debounce, deepClone, deepEqual, deepMerge, del, deleteDir, deleteFile, dirExists, ensureDir, execCmd, fileExists, firstExisting, get, getEnv, getFileStat, getPath, getRecentEvents, interpolate, isPlaceholderConnection, krnlFunctionsServiceDefinition, krnlFunctionsServiceFacade, listDir, loadEnv, memoize, objectDiff, once, pLimit, platform, post, prefixedId, publishRealtimeEvent, put, readFile, readJSON, request, requestRaw, requireEnv, retry, sanitizeDatabaseUrl, setPath, shortId, sleep, spawnCmd, streamResponse, subscribeRealtimeEvents, swr, throttle, toCamelCase, toKebabCase, toPascalCase, toScreamingSnake, toSlug, toSnakeCase, updateJSON, uuid, validateEnvSchema, walkDir, watchDir, watchFile, which, withTempDir, withTimeout, writeFile, writeFileAtomic, writeJSON };

package/packages/functions/dist/index.js

@@ -1,4 +1,4 @@
-// ../../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();
@@ -52,17 +52,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')."
+      );
     }
   }
 };
@@ -74,7 +94,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);
     }
   }
@@ -85,46 +105,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.definition.lifecycle?.onStart) {
-      await this.definition.lifecycle.onStart();
+    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;
+      }
+    }
+    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);
@@ -136,12 +186,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/string.ts
 function toCamelCase(str) {
@@ -1121,6 +1225,8 @@ var FunctionsServiceFacade = {
     return defaultFunctionsService.call(op, input);
   }
 };
+var krnlFunctionsServiceDefinition = FunctionsServiceDefinition;
+var krnlFunctionsServiceFacade = FunctionsServiceFacade;
 export {
   FileCache,
   FileLock,
@@ -1153,6 +1259,8 @@ export {
   getRecentEvents,
   interpolate,
   isPlaceholderConnection,
+  krnlFunctionsServiceDefinition,
+  krnlFunctionsServiceFacade,
   listDir,
   loadEnv,
   memoize,

package/packages/functions/package.json

@@ -28,6 +28,6 @@
     "zod": "^3.24.1"
   },
   "devDependencies": {
-    "@ultrst-armada/krnl": "^1.0.2"
+    "@ultrst-armada/krnl": "^1.0.3"
   }
 }

package/packages/orchestrations/dist/index.d.ts

@@ -1,31 +1,13 @@
-import { CounterState, TelemetryEvents } from '@ultrst-armada/kloks/services';
-import { ExecutableBackendFacade, WorkerExecutionBoundary } from '@ultrst-armada/kloks/backend/execution';
-
-/**
- * @file backendExecutionFacade.ts
- * @description Registers backend services on ExecutableBackendFacade and connects BullMQ workers.
- * Enforces SKIPO::STATE_EXECUTION_ARCHITECTURE (Worker-only access to Backend Facade).
- */
-
-declare class WorkspaceBackendFacade extends ExecutableBackendFacade {
-}
-declare const backendFacade: WorkspaceBackendFacade;
-declare const workerExecutionBoundary: WorkerExecutionBoundary;
+import { OrchestrationDefinition } from '@ultrst-armada/krnl';
 
 /**
  * @file index.ts
- * @description @ultrst-armada/kloks/orchestrations — Canonical Orchestrators A & B built on KrnlTS & @ultrst-armada/kloks/services.
- * Orchestrator A: Service A (Pure) -> Service B (Stateful)
- * Orchestrator B: Service B (Stateful) -> Service C (Event-Emitting)
+ * @description @ultrst-armada/kloks/orchestrations — Canonical pure Orchestration Definitions A & B.
+ * STRICT INVARIANT: Kloks is a pure distribution catalog and NEVER owns execution,
+ * queues, workers, schedulers, or dispatchers. Kloks exports pure serializable definitions
+ * conforming to OrchestrationDefinition<TInput, TOutput>.
  */
 
-interface OrchestratorFacade<TInput = unknown, TOutput = unknown> {
-    readonly id: string;
-    readonly name: string;
-    readonly version: string;
-    readonly dependencies: string[];
-    execute(input: TInput): Promise<TOutput>;
-}
 interface OrchestratorAInput {
     a: number;
     b: number;
@@ -33,23 +15,43 @@ interface OrchestratorAInput {
 }
 interface OrchestratorAOutput {
     computed: number;
-    state: CounterState;
+    state: {
+        count: number;
+    };
 }
 /**
- * Orchestrator A: Sequences Service A (Pure Math) -> Service B (Stateful Counter)
+ * Pure serializable definition for Orchestrator A.
+ * Sequences Service A (Pure Math) -> Service B (Stateful Counter).
+ * Free from execution machinery. To be instantiated and executed by Skipo/runtime.
  */
-declare const OrchestratorAFacade: OrchestratorFacade<OrchestratorAInput, OrchestratorAOutput>;
+declare const OrchestratorADefinition: OrchestrationDefinition<OrchestratorAInput, OrchestratorAOutput>;
 interface OrchestratorBInput {
     delta?: number;
     metricName?: string;
 }
 interface OrchestratorBOutput {
-    state: CounterState;
-    emitted: TelemetryEvents['reading'];
+    state: {
+        count: number;
+    };
+    emitted: {
+        metric: string;
+        value: number;
+        timestamp: number;
+    };
 }
 /**
- * Orchestrator B: Sequences Service B (Stateful Counter) -> Service C (Event-Emitting Telemetry)
+ * Pure serializable definition for Orchestrator B.
+ * Sequences Service B (Stateful Counter) -> Service C (Event-Emitting Telemetry).
+ * Free from execution machinery. To be instantiated and executed by Skipo/runtime.
+ */
+declare const OrchestratorBDefinition: OrchestrationDefinition<OrchestratorBInput, OrchestratorBOutput>;
+/**
+ * Pure serializable definition for Audio-Midi Orchestrator.
+ * Sequences MidiService -> AudioHardwareService.
  */
-declare const OrchestratorBFacade: OrchestratorFacade<OrchestratorBInput, OrchestratorBOutput>;
+declare const AudioMidiOrchestratorDefinition: OrchestrationDefinition;
+declare const krnlOrchestratorADefinition: OrchestrationDefinition<OrchestratorAInput, OrchestratorAOutput>;
+declare const krnlOrchestratorBDefinition: OrchestrationDefinition<OrchestratorBInput, OrchestratorBOutput>;
+declare const krnlAudioMidiOrchestratorDefinition: OrchestrationDefinition<unknown, unknown>;
 
-export { OrchestratorAFacade, type OrchestratorAInput, type OrchestratorAOutput, OrchestratorBFacade, type OrchestratorBInput, type OrchestratorBOutput, type OrchestratorFacade, WorkspaceBackendFacade, backendFacade, workerExecutionBoundary };
+export { AudioMidiOrchestratorDefinition, OrchestratorADefinition, type OrchestratorAInput, type OrchestratorAOutput, OrchestratorBDefinition, type OrchestratorBInput, type OrchestratorBOutput, krnlAudioMidiOrchestratorDefinition, krnlOrchestratorADefinition, krnlOrchestratorBDefinition };