✨ Improve GenAIScript runtime documentation links

Updated broken documentation links for the runtime and helpers. Renamed files and improved descriptions to ensure clarity across pages.

Author: pelikhan

docs/src/content/docs/guides/make-it-better.mdx

@@ -7,7 +7,7 @@ description: "Ask the LLM to make your code better!"
 
 Surprising results happen when you repeatidely ask the LLM to "make it better" (see [blog post](https://minimaxir.com/2025/01/write-better-code/)).
 
-In this sample, we use the `makeItBetter` function from the [GenAIScript runtime](/genaiscript/reference/scripts/runtime)
+In this sample, we use the `makeItBetter` function from the [GenAIScript runtime](/genaiscript/reference/runtime)
 to acheive exaclty that: asking the LLM to make it better for a few rounds.
 
 ## Code Explanation

docs/src/content/docs/reference/runtime.mdx

@@ -1,15 +1,41 @@
 ---
 title: Runtime
+description: GenAIScript runtime files
 sidebar:
-  order: 1.2
-description: Learn how to run GenAIScript scripts in a Node.JS environment, including configuration
+  order: 80
+keywords: runtime, GenAIScript, JavaScript, TypeScript
+hero:
+  image:
+    alt: A simple, flat 2D illustration depicts an open package box with basic
+      digital script symbols, small code blocks, and algorithm icons rising from
+      it. Stylized arrows represent data flow around the box. The art uses five
+      solid corporate colors in an 8-bit, geometric, pixelated style. The image
+      is 128x128 pixels, transparent background, no text, no people, and no
+      shading.
+    file: ./runtime.png
 ---
 
-Scripts using the `.genai.mts` (or any `.genai.*` extension) are meant to be run through the [command line interfanece](/genaiscript/reference/cli).
+import { PackageManagers } from "starlight-package-managers";
 
-This page describes how to use the runtime in a Node.JS script without using the CLI.
+The GenAIScript runtime provides additional helpers and allows to use the runtime in any Node.JS application.
 
-## Import and configuration
+In order to use the runtime, you will need to install GenAIScript
+in your project.
+
+<PackageManagers pkg="genaiscript" dev />
+
+## Importing the runtime
+
+The runtime is available as a module. You can import it
+using the following code:
+
+```js
+import { cast } from "@genaiscript/runtime";
+```
+
+## Initialization
+
+If you are using GenAIScript without the CLI or Visual Studio Code extension, you need to initialize the runtime before using any global types or functions.
 
 ```js
 import { initialize } from "@genaiscript/runtime";
@@ -21,3 +47,10 @@ await initialize();
 ## globals
 
 The runtime installs global parsers and inline prompt types. However, the global `$`, `def`, etc... is not available, online inline prompts.
+
+## Helpers
+
+- [cast](/genaiscript/reference/scripts/cast), cast any data to structured outputs
+- [classify](/genaiscript/reference/scripts/classify), classify text
+- [makeItBetter](/genaiscript/guides/make-it-better), tell the LLM to improve its result
+- [pipeline](/genaiscript/guides/transformers-js), access to HuggingFace transformers

…ntent/docs/reference/scripts/runtime.png …s/src/content/docs/reference/runtime.pngdocs/src/content/docs/reference/scripts/runtime.png renamed to docs/src/content/docs/reference/runtime.png docs/src/content/docs/reference/scripts/runtime.png renamed to docs/src/content/docs/reference/runtime.png

@@ -22,7 +22,7 @@ It provides a simple interface to leverage the power of LLMs for extracting data
 
 ## Usage
 
-`cast` is defined in the [GenAIScript runtime](/genaiscript/reference/scripts/runtime) and needs to be imported. It takes the unstructured text (or files), a JSON schema
+`cast` is defined in the [GenAIScript runtime](/genaiscript/reference/runtime) and needs to be imported. It takes the unstructured text (or files), a JSON schema
 and returns the extract data (or error).
 
 ```js

docs/src/content/docs/reference/scripts/cast.md

@@ -21,7 +21,7 @@ It provides a simple interface to leverage the power of LLMs for classification
 
 ## Usage
 
-`classify` is defined in the [GenAIScript runtime](/genaiscript/reference/scripts/runtime) and needs to be imported. It takes the text to classify, a set of labels (and options for the LLM)
+`classify` is defined in the [GenAIScript runtime](/genaiscript/reference/runtime) and needs to be imported. It takes the text to classify, a set of labels (and options for the LLM)
 and returns the label provided by the LLM.
 
 ```js

docs/src/content/docs/reference/scripts/classify.md

@@ -160,7 +160,7 @@ File ./data.json:
 
 ### Native zod support
 
-The [GenAIScript runtime](/genaiscript/reference/scripts/runtime) exposes the `z` module.
+The [GenAIScript runtime](/genaiscript/reference/runtime) exposes the `z` module.
 
 A [Zod](https://zod.dev/) type can be passed in `defSchema` and it will be automatically converted to JSON schema.
 The GenAIScript also exports the `z` object from Zod for convenience.

docs/src/content/docs/reference/scripts/runtime.mdx

@@ -126,7 +126,7 @@ If you are looking to build a LLM-as-a-Judge and only looking for outputs in a s
 
 ## `cast`
 
-The [cast](/genaiscript/reference/scripts/cast) function is a [GenAIScript runtime helper](/genaiscript/reference/scripts/runtime) to convert unstructured text/images into structured data.
+The [cast](/genaiscript/reference/scripts/cast) function is a [GenAIScript runtime helper](/genaiscript/reference/runtime) to convert unstructured text/images into structured data.
 
 ```js "cast"
 import { cast } from "@genaiscript/runtime"