@qvac/sdk 0.15.0 → 0.17.0

package/dist/schemas/profiling.d.ts

@@ -15,10 +15,209 @@ export declare const OPERATION_EVENT_KEY: unique symbol;
  * Symbol key for attaching model execution timing.
  */
 export declare const MODEL_EXECUTION_KEY: unique symbol;
+export declare const BACKEND_DIAGNOSTICS_KEY: unique symbol;
 export declare const profilerModeSchema: z.ZodEnum<{
     summary: "summary";
     verbose: "verbose";
 }>;
+export declare const profilerGPUResourceGaugeSchema: z.ZodObject<{
+    id: z.ZodString;
+    compute: z.ZodDiscriminatedUnion<[z.ZodObject<{
+        status: z.ZodLiteral<"supported">;
+        value: z.ZodNumber;
+        provenance: z.ZodObject<{
+            source: z.ZodString;
+            scope: z.ZodOptional<z.ZodEnum<{
+                device: "device";
+                system: "system";
+                process: "process";
+                budget: "budget";
+                "shared-system": "shared-system";
+            }>>;
+        }, z.core.$strip>;
+    }, z.core.$strip>, z.ZodObject<{
+        status: z.ZodLiteral<"unavailable">;
+        reason: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>, z.ZodObject<{
+        status: z.ZodLiteral<"unverified">;
+        reason: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>, z.ZodObject<{
+        status: z.ZodLiteral<"failed">;
+        reason: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>], "status">;
+    memoryUsedBytes: z.ZodDiscriminatedUnion<[z.ZodObject<{
+        status: z.ZodLiteral<"supported">;
+        value: z.ZodNumber;
+        provenance: z.ZodObject<{
+            source: z.ZodString;
+            scope: z.ZodOptional<z.ZodEnum<{
+                device: "device";
+                system: "system";
+                process: "process";
+                budget: "budget";
+                "shared-system": "shared-system";
+            }>>;
+        }, z.core.$strip>;
+    }, z.core.$strip>, z.ZodObject<{
+        status: z.ZodLiteral<"unavailable">;
+        reason: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>, z.ZodObject<{
+        status: z.ZodLiteral<"unverified">;
+        reason: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>, z.ZodObject<{
+        status: z.ZodLiteral<"failed">;
+        reason: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>], "status">;
+}, z.core.$strip>;
+export declare const profilerResourceGaugeSchema: z.ZodObject<{
+    origin: z.ZodEnum<{
+        local: "local";
+        provider: "provider";
+    }>;
+    sampledAt: z.ZodNumber;
+    cpu: z.ZodDiscriminatedUnion<[z.ZodObject<{
+        status: z.ZodLiteral<"supported">;
+        value: z.ZodNumber;
+        provenance: z.ZodObject<{
+            source: z.ZodString;
+            scope: z.ZodOptional<z.ZodEnum<{
+                device: "device";
+                system: "system";
+                process: "process";
+                budget: "budget";
+                "shared-system": "shared-system";
+            }>>;
+        }, z.core.$strip>;
+    }, z.core.$strip>, z.ZodObject<{
+        status: z.ZodLiteral<"unavailable">;
+        reason: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>, z.ZodObject<{
+        status: z.ZodLiteral<"unverified">;
+        reason: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>, z.ZodObject<{
+        status: z.ZodLiteral<"failed">;
+        reason: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>], "status">;
+    memory: z.ZodObject<{
+        usedBytes: z.ZodDiscriminatedUnion<[z.ZodObject<{
+            status: z.ZodLiteral<"supported">;
+            value: z.ZodNumber;
+            provenance: z.ZodObject<{
+                source: z.ZodString;
+                scope: z.ZodOptional<z.ZodEnum<{
+                    device: "device";
+                    system: "system";
+                    process: "process";
+                    budget: "budget";
+                    "shared-system": "shared-system";
+                }>>;
+            }, z.core.$strip>;
+        }, z.core.$strip>, z.ZodObject<{
+            status: z.ZodLiteral<"unavailable">;
+            reason: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>, z.ZodObject<{
+            status: z.ZodLiteral<"unverified">;
+            reason: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>, z.ZodObject<{
+            status: z.ZodLiteral<"failed">;
+            reason: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>], "status">;
+        totalBytes: z.ZodDiscriminatedUnion<[z.ZodObject<{
+            status: z.ZodLiteral<"supported">;
+            value: z.ZodNumber;
+            provenance: z.ZodObject<{
+                source: z.ZodString;
+                scope: z.ZodOptional<z.ZodEnum<{
+                    device: "device";
+                    system: "system";
+                    process: "process";
+                    budget: "budget";
+                    "shared-system": "shared-system";
+                }>>;
+            }, z.core.$strip>;
+        }, z.core.$strip>, z.ZodObject<{
+            status: z.ZodLiteral<"unavailable">;
+            reason: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>, z.ZodObject<{
+            status: z.ZodLiteral<"unverified">;
+            reason: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>, z.ZodObject<{
+            status: z.ZodLiteral<"failed">;
+            reason: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>], "status">;
+    }, z.core.$strip>;
+    gpus: z.ZodDiscriminatedUnion<[z.ZodObject<{
+        status: z.ZodLiteral<"supported">;
+        value: z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            compute: z.ZodDiscriminatedUnion<[z.ZodObject<{
+                status: z.ZodLiteral<"supported">;
+                value: z.ZodNumber;
+                provenance: z.ZodObject<{
+                    source: z.ZodString;
+                    scope: z.ZodOptional<z.ZodEnum<{
+                        device: "device";
+                        system: "system";
+                        process: "process";
+                        budget: "budget";
+                        "shared-system": "shared-system";
+                    }>>;
+                }, z.core.$strip>;
+            }, z.core.$strip>, z.ZodObject<{
+                status: z.ZodLiteral<"unavailable">;
+                reason: z.ZodOptional<z.ZodString>;
+            }, z.core.$strip>, z.ZodObject<{
+                status: z.ZodLiteral<"unverified">;
+                reason: z.ZodOptional<z.ZodString>;
+            }, z.core.$strip>, z.ZodObject<{
+                status: z.ZodLiteral<"failed">;
+                reason: z.ZodOptional<z.ZodString>;
+            }, z.core.$strip>], "status">;
+            memoryUsedBytes: z.ZodDiscriminatedUnion<[z.ZodObject<{
+                status: z.ZodLiteral<"supported">;
+                value: z.ZodNumber;
+                provenance: z.ZodObject<{
+                    source: z.ZodString;
+                    scope: z.ZodOptional<z.ZodEnum<{
+                        device: "device";
+                        system: "system";
+                        process: "process";
+                        budget: "budget";
+                        "shared-system": "shared-system";
+                    }>>;
+                }, z.core.$strip>;
+            }, z.core.$strip>, z.ZodObject<{
+                status: z.ZodLiteral<"unavailable">;
+                reason: z.ZodOptional<z.ZodString>;
+            }, z.core.$strip>, z.ZodObject<{
+                status: z.ZodLiteral<"unverified">;
+                reason: z.ZodOptional<z.ZodString>;
+            }, z.core.$strip>, z.ZodObject<{
+                status: z.ZodLiteral<"failed">;
+                reason: z.ZodOptional<z.ZodString>;
+            }, z.core.$strip>], "status">;
+        }, z.core.$strip>>;
+        provenance: z.ZodObject<{
+            source: z.ZodString;
+            scope: z.ZodOptional<z.ZodEnum<{
+                device: "device";
+                system: "system";
+                process: "process";
+                budget: "budget";
+                "shared-system": "shared-system";
+            }>>;
+        }, z.core.$strip>;
+    }, z.core.$strip>, z.ZodObject<{
+        status: z.ZodLiteral<"unavailable">;
+        reason: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>, z.ZodObject<{
+        status: z.ZodLiteral<"unverified">;
+        reason: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>, z.ZodObject<{
+        status: z.ZodLiteral<"failed">;
+        reason: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>], "status">;
+}, z.core.$strip>;
 /**
  * Server-side timing breakdown (server → client).
  * Attached to profiling response when includeServerBreakdown is enabled.
@@ -51,6 +250,196 @@ export declare const operationEventSchema: z.ZodObject<{
     ms: z.ZodNumber;
     profileId: z.ZodOptional<z.ZodString>;
     gauges: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodNumber>>;
+    resources: z.ZodOptional<z.ZodObject<{
+        origin: z.ZodEnum<{
+            local: "local";
+            provider: "provider";
+        }>;
+        sampledAt: z.ZodNumber;
+        cpu: z.ZodDiscriminatedUnion<[z.ZodObject<{
+            status: z.ZodLiteral<"supported">;
+            value: z.ZodNumber;
+            provenance: z.ZodObject<{
+                source: z.ZodString;
+                scope: z.ZodOptional<z.ZodEnum<{
+                    device: "device";
+                    system: "system";
+                    process: "process";
+                    budget: "budget";
+                    "shared-system": "shared-system";
+                }>>;
+            }, z.core.$strip>;
+        }, z.core.$strip>, z.ZodObject<{
+            status: z.ZodLiteral<"unavailable">;
+            reason: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>, z.ZodObject<{
+            status: z.ZodLiteral<"unverified">;
+            reason: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>, z.ZodObject<{
+            status: z.ZodLiteral<"failed">;
+            reason: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>], "status">;
+        memory: z.ZodObject<{
+            usedBytes: z.ZodDiscriminatedUnion<[z.ZodObject<{
+                status: z.ZodLiteral<"supported">;
+                value: z.ZodNumber;
+                provenance: z.ZodObject<{
+                    source: z.ZodString;
+                    scope: z.ZodOptional<z.ZodEnum<{
+                        device: "device";
+                        system: "system";
+                        process: "process";
+                        budget: "budget";
+                        "shared-system": "shared-system";
+                    }>>;
+                }, z.core.$strip>;
+            }, z.core.$strip>, z.ZodObject<{
+                status: z.ZodLiteral<"unavailable">;
+                reason: z.ZodOptional<z.ZodString>;
+            }, z.core.$strip>, z.ZodObject<{
+                status: z.ZodLiteral<"unverified">;
+                reason: z.ZodOptional<z.ZodString>;
+            }, z.core.$strip>, z.ZodObject<{
+                status: z.ZodLiteral<"failed">;
+                reason: z.ZodOptional<z.ZodString>;
+            }, z.core.$strip>], "status">;
+            totalBytes: z.ZodDiscriminatedUnion<[z.ZodObject<{
+                status: z.ZodLiteral<"supported">;
+                value: z.ZodNumber;
+                provenance: z.ZodObject<{
+                    source: z.ZodString;
+                    scope: z.ZodOptional<z.ZodEnum<{
+                        device: "device";
+                        system: "system";
+                        process: "process";
+                        budget: "budget";
+                        "shared-system": "shared-system";
+                    }>>;
+                }, z.core.$strip>;
+            }, z.core.$strip>, z.ZodObject<{
+                status: z.ZodLiteral<"unavailable">;
+                reason: z.ZodOptional<z.ZodString>;
+            }, z.core.$strip>, z.ZodObject<{
+                status: z.ZodLiteral<"unverified">;
+                reason: z.ZodOptional<z.ZodString>;
+            }, z.core.$strip>, z.ZodObject<{
+                status: z.ZodLiteral<"failed">;
+                reason: z.ZodOptional<z.ZodString>;
+            }, z.core.$strip>], "status">;
+        }, z.core.$strip>;
+        gpus: z.ZodDiscriminatedUnion<[z.ZodObject<{
+            status: z.ZodLiteral<"supported">;
+            value: z.ZodArray<z.ZodObject<{
+                id: z.ZodString;
+                compute: z.ZodDiscriminatedUnion<[z.ZodObject<{
+                    status: z.ZodLiteral<"supported">;
+                    value: z.ZodNumber;
+                    provenance: z.ZodObject<{
+                        source: z.ZodString;
+                        scope: z.ZodOptional<z.ZodEnum<{
+                            device: "device";
+                            system: "system";
+                            process: "process";
+                            budget: "budget";
+                            "shared-system": "shared-system";
+                        }>>;
+                    }, z.core.$strip>;
+                }, z.core.$strip>, z.ZodObject<{
+                    status: z.ZodLiteral<"unavailable">;
+                    reason: z.ZodOptional<z.ZodString>;
+                }, z.core.$strip>, z.ZodObject<{
+                    status: z.ZodLiteral<"unverified">;
+                    reason: z.ZodOptional<z.ZodString>;
+                }, z.core.$strip>, z.ZodObject<{
+                    status: z.ZodLiteral<"failed">;
+                    reason: z.ZodOptional<z.ZodString>;
+                }, z.core.$strip>], "status">;
+                memoryUsedBytes: z.ZodDiscriminatedUnion<[z.ZodObject<{
+                    status: z.ZodLiteral<"supported">;
+                    value: z.ZodNumber;
+                    provenance: z.ZodObject<{
+                        source: z.ZodString;
+                        scope: z.ZodOptional<z.ZodEnum<{
+                            device: "device";
+                            system: "system";
+                            process: "process";
+                            budget: "budget";
+                            "shared-system": "shared-system";
+                        }>>;
+                    }, z.core.$strip>;
+                }, z.core.$strip>, z.ZodObject<{
+                    status: z.ZodLiteral<"unavailable">;
+                    reason: z.ZodOptional<z.ZodString>;
+                }, z.core.$strip>, z.ZodObject<{
+                    status: z.ZodLiteral<"unverified">;
+                    reason: z.ZodOptional<z.ZodString>;
+                }, z.core.$strip>, z.ZodObject<{
+                    status: z.ZodLiteral<"failed">;
+                    reason: z.ZodOptional<z.ZodString>;
+                }, z.core.$strip>], "status">;
+            }, z.core.$strip>>;
+            provenance: z.ZodObject<{
+                source: z.ZodString;
+                scope: z.ZodOptional<z.ZodEnum<{
+                    device: "device";
+                    system: "system";
+                    process: "process";
+                    budget: "budget";
+                    "shared-system": "shared-system";
+                }>>;
+            }, z.core.$strip>;
+        }, z.core.$strip>, z.ZodObject<{
+            status: z.ZodLiteral<"unavailable">;
+            reason: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>, z.ZodObject<{
+            status: z.ZodLiteral<"unverified">;
+            reason: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>, z.ZodObject<{
+            status: z.ZodLiteral<"failed">;
+            reason: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>], "status">;
+    }, z.core.$strip>>;
+    backend: z.ZodOptional<z.ZodObject<{
+        selectedBackend: z.ZodString;
+        selectedDevice: z.ZodEnum<{
+            gpu: "gpu";
+            cpu: "cpu";
+        }>;
+        graphicsApi: z.ZodOptional<z.ZodEnum<{
+            vulkan: "vulkan";
+            metal: "metal";
+            opencl: "opencl";
+            cuda: "cuda";
+            opengl: "opengl";
+            webgpu: "webgpu";
+            direct3d11: "direct3d11";
+            direct3d12: "direct3d12";
+            levelZero: "levelZero";
+            rocm: "rocm";
+        }>>;
+        driver: z.ZodOptional<z.ZodObject<{
+            name: z.ZodString;
+            version: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>;
+        gpuId: z.ZodOptional<z.ZodString>;
+        fallback: z.ZodOptional<z.ZodObject<{
+            requestedBackend: z.ZodOptional<z.ZodString>;
+            requestedDevice: z.ZodOptional<z.ZodEnum<{
+                gpu: "gpu";
+                cpu: "cpu";
+            }>>;
+            reason: z.ZodString;
+        }, z.core.$strip>>;
+        probe: z.ZodOptional<z.ZodObject<{
+            status: z.ZodEnum<{
+                unknown: "unknown";
+                compatible: "compatible";
+                incompatible: "incompatible";
+            }>;
+            backend: z.ZodString;
+            reason: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>;
+    }, z.core.$strip>>;
     tags: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
     count: z.ZodOptional<z.ZodNumber>;
 }, z.core.$strip>;
@@ -58,6 +447,11 @@ export declare const profilingRequestMetaSchema: z.ZodObject<{
     enabled: z.ZodOptional<z.ZodBoolean>;
     id: z.ZodOptional<z.ZodString>;
     includeServer: z.ZodOptional<z.ZodBoolean>;
+    includeResources: z.ZodOptional<z.ZodBoolean>;
+    resourceOrigin: z.ZodOptional<z.ZodEnum<{
+        local: "local";
+        provider: "provider";
+    }>>;
     mode: z.ZodOptional<z.ZodEnum<{
         summary: "summary";
         verbose: "verbose";
@@ -87,6 +481,196 @@ export declare const profilingResponseMetaSchema: z.ZodObject<{
         ms: z.ZodNumber;
         profileId: z.ZodOptional<z.ZodString>;
         gauges: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodNumber>>;
+        resources: z.ZodOptional<z.ZodObject<{
+            origin: z.ZodEnum<{
+                local: "local";
+                provider: "provider";
+            }>;
+            sampledAt: z.ZodNumber;
+            cpu: z.ZodDiscriminatedUnion<[z.ZodObject<{
+                status: z.ZodLiteral<"supported">;
+                value: z.ZodNumber;
+                provenance: z.ZodObject<{
+                    source: z.ZodString;
+                    scope: z.ZodOptional<z.ZodEnum<{
+                        device: "device";
+                        system: "system";
+                        process: "process";
+                        budget: "budget";
+                        "shared-system": "shared-system";
+                    }>>;
+                }, z.core.$strip>;
+            }, z.core.$strip>, z.ZodObject<{
+                status: z.ZodLiteral<"unavailable">;
+                reason: z.ZodOptional<z.ZodString>;
+            }, z.core.$strip>, z.ZodObject<{
+                status: z.ZodLiteral<"unverified">;
+                reason: z.ZodOptional<z.ZodString>;
+            }, z.core.$strip>, z.ZodObject<{
+                status: z.ZodLiteral<"failed">;
+                reason: z.ZodOptional<z.ZodString>;
+            }, z.core.$strip>], "status">;
+            memory: z.ZodObject<{
+                usedBytes: z.ZodDiscriminatedUnion<[z.ZodObject<{
+                    status: z.ZodLiteral<"supported">;
+                    value: z.ZodNumber;
+                    provenance: z.ZodObject<{
+                        source: z.ZodString;
+                        scope: z.ZodOptional<z.ZodEnum<{
+                            device: "device";
+                            system: "system";
+                            process: "process";
+                            budget: "budget";
+                            "shared-system": "shared-system";
+                        }>>;
+                    }, z.core.$strip>;
+                }, z.core.$strip>, z.ZodObject<{
+                    status: z.ZodLiteral<"unavailable">;
+                    reason: z.ZodOptional<z.ZodString>;
+                }, z.core.$strip>, z.ZodObject<{
+                    status: z.ZodLiteral<"unverified">;
+                    reason: z.ZodOptional<z.ZodString>;
+                }, z.core.$strip>, z.ZodObject<{
+                    status: z.ZodLiteral<"failed">;
+                    reason: z.ZodOptional<z.ZodString>;
+                }, z.core.$strip>], "status">;
+                totalBytes: z.ZodDiscriminatedUnion<[z.ZodObject<{
+                    status: z.ZodLiteral<"supported">;
+                    value: z.ZodNumber;
+                    provenance: z.ZodObject<{
+                        source: z.ZodString;
+                        scope: z.ZodOptional<z.ZodEnum<{
+                            device: "device";
+                            system: "system";
+                            process: "process";
+                            budget: "budget";
+                            "shared-system": "shared-system";
+                        }>>;
+                    }, z.core.$strip>;
+                }, z.core.$strip>, z.ZodObject<{
+                    status: z.ZodLiteral<"unavailable">;
+                    reason: z.ZodOptional<z.ZodString>;
+                }, z.core.$strip>, z.ZodObject<{
+                    status: z.ZodLiteral<"unverified">;
+                    reason: z.ZodOptional<z.ZodString>;
+                }, z.core.$strip>, z.ZodObject<{
+                    status: z.ZodLiteral<"failed">;
+                    reason: z.ZodOptional<z.ZodString>;
+                }, z.core.$strip>], "status">;
+            }, z.core.$strip>;
+            gpus: z.ZodDiscriminatedUnion<[z.ZodObject<{
+                status: z.ZodLiteral<"supported">;
+                value: z.ZodArray<z.ZodObject<{
+                    id: z.ZodString;
+                    compute: z.ZodDiscriminatedUnion<[z.ZodObject<{
+                        status: z.ZodLiteral<"supported">;
+                        value: z.ZodNumber;
+                        provenance: z.ZodObject<{
+                            source: z.ZodString;
+                            scope: z.ZodOptional<z.ZodEnum<{
+                                device: "device";
+                                system: "system";
+                                process: "process";
+                                budget: "budget";
+                                "shared-system": "shared-system";
+                            }>>;
+                        }, z.core.$strip>;
+                    }, z.core.$strip>, z.ZodObject<{
+                        status: z.ZodLiteral<"unavailable">;
+                        reason: z.ZodOptional<z.ZodString>;
+                    }, z.core.$strip>, z.ZodObject<{
+                        status: z.ZodLiteral<"unverified">;
+                        reason: z.ZodOptional<z.ZodString>;
+                    }, z.core.$strip>, z.ZodObject<{
+                        status: z.ZodLiteral<"failed">;
+                        reason: z.ZodOptional<z.ZodString>;
+                    }, z.core.$strip>], "status">;
+                    memoryUsedBytes: z.ZodDiscriminatedUnion<[z.ZodObject<{
+                        status: z.ZodLiteral<"supported">;
+                        value: z.ZodNumber;
+                        provenance: z.ZodObject<{
+                            source: z.ZodString;
+                            scope: z.ZodOptional<z.ZodEnum<{
+                                device: "device";
+                                system: "system";
+                                process: "process";
+                                budget: "budget";
+                                "shared-system": "shared-system";
+                            }>>;
+                        }, z.core.$strip>;
+                    }, z.core.$strip>, z.ZodObject<{
+                        status: z.ZodLiteral<"unavailable">;
+                        reason: z.ZodOptional<z.ZodString>;
+                    }, z.core.$strip>, z.ZodObject<{
+                        status: z.ZodLiteral<"unverified">;
+                        reason: z.ZodOptional<z.ZodString>;
+                    }, z.core.$strip>, z.ZodObject<{
+                        status: z.ZodLiteral<"failed">;
+                        reason: z.ZodOptional<z.ZodString>;
+                    }, z.core.$strip>], "status">;
+                }, z.core.$strip>>;
+                provenance: z.ZodObject<{
+                    source: z.ZodString;
+                    scope: z.ZodOptional<z.ZodEnum<{
+                        device: "device";
+                        system: "system";
+                        process: "process";
+                        budget: "budget";
+                        "shared-system": "shared-system";
+                    }>>;
+                }, z.core.$strip>;
+            }, z.core.$strip>, z.ZodObject<{
+                status: z.ZodLiteral<"unavailable">;
+                reason: z.ZodOptional<z.ZodString>;
+            }, z.core.$strip>, z.ZodObject<{
+                status: z.ZodLiteral<"unverified">;
+                reason: z.ZodOptional<z.ZodString>;
+            }, z.core.$strip>, z.ZodObject<{
+                status: z.ZodLiteral<"failed">;
+                reason: z.ZodOptional<z.ZodString>;
+            }, z.core.$strip>], "status">;
+        }, z.core.$strip>>;
+        backend: z.ZodOptional<z.ZodObject<{
+            selectedBackend: z.ZodString;
+            selectedDevice: z.ZodEnum<{
+                gpu: "gpu";
+                cpu: "cpu";
+            }>;
+            graphicsApi: z.ZodOptional<z.ZodEnum<{
+                vulkan: "vulkan";
+                metal: "metal";
+                opencl: "opencl";
+                cuda: "cuda";
+                opengl: "opengl";
+                webgpu: "webgpu";
+                direct3d11: "direct3d11";
+                direct3d12: "direct3d12";
+                levelZero: "levelZero";
+                rocm: "rocm";
+            }>>;
+            driver: z.ZodOptional<z.ZodObject<{
+                name: z.ZodString;
+                version: z.ZodOptional<z.ZodString>;
+            }, z.core.$strip>>;
+            gpuId: z.ZodOptional<z.ZodString>;
+            fallback: z.ZodOptional<z.ZodObject<{
+                requestedBackend: z.ZodOptional<z.ZodString>;
+                requestedDevice: z.ZodOptional<z.ZodEnum<{
+                    gpu: "gpu";
+                    cpu: "cpu";
+                }>>;
+                reason: z.ZodString;
+            }, z.core.$strip>>;
+            probe: z.ZodOptional<z.ZodObject<{
+                status: z.ZodEnum<{
+                    unknown: "unknown";
+                    compatible: "compatible";
+                    incompatible: "incompatible";
+                }>;
+                backend: z.ZodString;
+                reason: z.ZodOptional<z.ZodString>;
+            }, z.core.$strip>>;
+        }, z.core.$strip>>;
         tags: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
         count: z.ZodOptional<z.ZodNumber>;
     }, z.core.$strip>>;
@@ -94,6 +678,7 @@ export declare const profilingResponseMetaSchema: z.ZodObject<{
 export declare const perCallProfilingSchema: z.ZodObject<{
     enabled: z.ZodOptional<z.ZodBoolean>;
     includeServerBreakdown: z.ZodOptional<z.ZodBoolean>;
+    includeResourceGauges: z.ZodOptional<z.ZodBoolean>;
     mode: z.ZodOptional<z.ZodEnum<{
         summary: "summary";
         verbose: "verbose";
@@ -106,4 +691,6 @@ export type ServerBreakdown = z.infer<typeof serverBreakdownSchema>;
 export type DelegationBreakdown = z.infer<typeof delegationBreakdownSchema>;
 export type PerCallProfiling = z.infer<typeof perCallProfilingSchema>;
 export type OperationEvent = z.infer<typeof operationEventSchema>;
+export type ProfilerGPUResourceGauge = z.infer<typeof profilerGPUResourceGaugeSchema>;
+export type ProfilerResourceGauge = z.infer<typeof profilerResourceGaugeSchema>;
 //# sourceMappingURL=profiling.d.ts.map

package/dist/schemas/profiling.js

@@ -1,4 +1,5 @@
 import { z } from 'zod';
+import { gpuResourceSampleSchema, inferenceBackendDiagnosticsSchema, resourceMetricSchema, systemResourceSampleSchema } from '../schemas/system-resources.js';
 /** Internal envelope key for profiling metadata in RPC payloads */
 export const PROFILING_KEY = '__profiling';
 /** Marker key for profiling-only trailer frames in streaming responses */
@@ -15,7 +16,20 @@ export const OPERATION_EVENT_KEY = Symbol.for('@qvac/sdk:operation-event');
  * Symbol key for attaching model execution timing.
  */
 export const MODEL_EXECUTION_KEY = Symbol.for('@qvac/sdk:model-execution');
+export const BACKEND_DIAGNOSTICS_KEY = Symbol.for('@qvac/sdk:backend-diagnostics');
 export const profilerModeSchema = z.enum(['summary', 'verbose']);
+export const profilerGPUResourceGaugeSchema = z.object({
+    id: z.string(),
+    compute: gpuResourceSampleSchema.shape.compute,
+    memoryUsedBytes: gpuResourceSampleSchema.shape.memoryUsedBytes
+});
+export const profilerResourceGaugeSchema = z.object({
+    origin: z.enum(['local', 'provider']),
+    sampledAt: systemResourceSampleSchema.shape.sampledAt,
+    cpu: systemResourceSampleSchema.shape.cpu,
+    memory: systemResourceSampleSchema.shape.memory,
+    gpus: resourceMetricSchema(z.array(profilerGPUResourceGaugeSchema))
+});
 /**
  * Server-side timing breakdown (server → client).
  * Attached to profiling response when includeServerBreakdown is enabled.
@@ -48,6 +62,8 @@ export const operationEventSchema = z.object({
     ms: z.number(),
     profileId: z.string().optional(),
     gauges: z.record(z.string(), z.number()).optional(),
+    resources: profilerResourceGaugeSchema.optional(),
+    backend: inferenceBackendDiagnosticsSchema.optional(),
     tags: z.record(z.string(), z.string()).optional(),
     count: z.number().optional()
 });
@@ -55,6 +71,8 @@ export const profilingRequestMetaSchema = z.object({
     enabled: z.boolean().optional(),
     id: z.string().optional(),
     includeServer: z.boolean().optional(),
+    includeResources: z.boolean().optional(),
+    resourceOrigin: z.enum(['local', 'provider']).optional(),
     mode: profilerModeSchema.optional()
 });
 export const profilingResponseMetaSchema = z.object({
@@ -72,6 +90,10 @@ export const perCallProfilingSchema = z.object({
         .boolean()
         .optional()
         .describe('Include server-side timing breakdown in the profiling payload.'),
+    includeResourceGauges: z
+        .boolean()
+        .optional()
+        .describe('Attach one local CPU, memory, and GPU resource sample to the operation event.'),
     mode: profilerModeSchema
         .optional()
         .describe('Profiling detail level: `"summary"` aggregates only, `"verbose"` retains recent events.')