@opengeni/runtime 0.6.1 → 0.7.0

package/src/metrics.ts

@@ -1,5 +1,31 @@
 export type RuntimeMetricsHooks = {
-  onModelCall?: (input: { provider: string; outcome: "completed" | "failed"; durationSeconds: number }) => void;
-  onSandboxCreate?: (input: { backend: string; outcome: "completed" | "failed"; durationSeconds: number }) => void;
+  onModelCall?: (input: {
+    provider: string;
+    outcome: "completed" | "failed";
+    durationSeconds: number;
+  }) => void;
+  onSandboxCreate?: (input: {
+    backend: string;
+    outcome: "completed" | "failed";
+    durationSeconds: number;
+  }) => void;
   onSandboxWarmingTimeout?: (input: { backend: string }) => void;
+  /**
+   * One completed Connected Machine (selfhosted) control op — the out-of-band
+   * telemetry twin of the in-band fault rendering. `code` is the typed wire-code
+   * NAME on a failure (bounded label cardinality); `healed` marks a success that
+   * only landed after ≥1 retry (the leading indicator of the next unhealed fault);
+   * `replyBytes` is set only on a payload-wall fault. Wired from the runtime's
+   * `SelfhostedOpObserver` seam.
+   */
+  onSandboxOp?: (input: {
+    backend: string;
+    op: string;
+    outcome: "ok" | "failed";
+    code?: string;
+    healed: boolean;
+    retries: number;
+    durationSeconds: number;
+    replyBytes?: number;
+  }) => void;
 };

package/src/sandbox/capabilities.ts

@@ -35,20 +35,29 @@ export function assertDescriptorRegistryInvariants(): void {
 
     // DesktopStream implies a non-"none" port-exposure mechanism (split-plane B
     // needs a way to surface 6080 to a viewer).
-    if (descriptor.capabilities.DesktopStream.available && descriptor.portExposure.kind === "none") {
+    if (
+      descriptor.capabilities.DesktopStream.available &&
+      descriptor.portExposure.kind === "none"
+    ) {
       throw new Error(`"${backend}" claims DesktopStream but portExposure.kind=none`);
     }
 
     // DesktopStream implies a transport, and a desktop transport implies the
     // capability is available (no half-declared desktop rows).
-    if (descriptor.capabilities.DesktopStream.available && descriptor.capabilities.DesktopStream.transport === null) {
+    if (
+      descriptor.capabilities.DesktopStream.available &&
+      descriptor.capabilities.DesktopStream.transport === null
+    ) {
       throw new Error(`"${backend}" claims DesktopStream but transport is null`);
     }
 
     // Recording feasibility is the same Xvfb display as DesktopStream: a desktop
     // backend MUST be able to x11grab; a non-desktop backend MUST NOT claim it
     // (Recording.available == DesktopStream.available && os==linux — Part D).
-    if (descriptor.capabilities.DesktopStream.available !== descriptor.capabilities.Recording.available) {
+    if (
+      descriptor.capabilities.DesktopStream.available !==
+      descriptor.capabilities.Recording.available
+    ) {
       throw new Error(
         `"${backend}" Recording.available (${descriptor.capabilities.Recording.available}) must equal DesktopStream.available (${descriptor.capabilities.DesktopStream.available})`,
       );