Merge branch 'dev' into copilot/fix-69c0c414-9e1f-41d3-80b9-aa53e2bdd047

Author: pelikhan

docs/package.json

@@ -2,7 +2,7 @@
   "name": "docs",
   "type": "module",
   "private": true,
-  "version": "2.3.15",
+  "version": "2.4.0",
   "license": "MIT",
   "scripts": {
     "build": "astro build",

docs/public/genaiscript.d.ts

@@ -94,30 +94,24 @@ dgb("This is a debug message!")
 
 By default, the debug logging is disabled. You need to turn it on with namespace patterns.
 
-The script messages are visible by running with `DEBUG=<scriptid>`.
-
-```sh "--dbg script"
-genaiscript run poem --dbg script
-```
-
-or using the `DEBUG` environment variable.
+The script messages are visible by running with `DEBUG=script`.
 
 ```sh
 DEBUG=script genaiscript run ...
 ```
 
-You can specify multiple categories by separating them with a comma.
-
-```sh "--dbg script"
-genaiscript run poem --dbg script file config modelalias
-```
-
 or
 
 ```sh
 DEBUG=script,genaiscript:* genaiscript run ...
 ```
 
+:::note
+
+You must set the DEBUG environment variable before loading the genaiscript cli. It will not work from the `.env` file.
+
+:::
+
 ### wildcards
 
 The `*` character may be used as a wildcard. Suppose for example your library has debuggers named `connect:bodyParser`,

docs/src/content/docs/guides/genaiscript.d.ts

@@ -821,6 +821,7 @@ system({
     description:
         "GitHub Actions workflows support annotations ([Read more...](https://docs.github.com/en/actions/using-workflows/workflow-commands-for-github-actions#setting-an-error-message)).",
     lineNumbers: true,
+    activation: ["annotation", "annotations", "warnings", "errors"],
 })
 
 export default function (ctx: ChatGenerationContext) {
@@ -926,6 +927,7 @@ Generate changelog formatter edits
 system({
     title: "Generate changelog formatter edits",
     lineNumbers: true,
+    activation: ["changelog"],
 })
 
 export default function (ctx: ChatGenerationContext) {
@@ -1074,6 +1076,7 @@ Generate diagrams
 `````js wrap title="system.diagrams"
 system({
   title: "Generate diagrams",
+  activation: ["diagram", "chart"],
   parameters: {
     repair: {
       type: "integer",
@@ -1357,6 +1360,7 @@ Teaches the file format supported by GenAIScripts
 system({
     title: "File generation",
     description: "Teaches the file format supported by GenAIScripts",
+    activation: ["file", "files"],
 })
 
 export default function (ctx: ChatGenerationContext) {
@@ -2130,6 +2134,7 @@ Git repository information
 `````js wrap title="system.git_info"
 system({
     title: "Git repository information",
+    activation: ["git"],
     parameters: {
         cwd: {
             type: "string",
@@ -2414,6 +2419,7 @@ General GitHub information.
 `````js wrap title="system.github_info"
 system({
     title: "General GitHub information.",
+    activation: ["github"],
 })
 
 export default async function (ctx: ChatGenerationContext) {
@@ -3985,6 +3991,7 @@ system({
   title: "Read resource content from a URL using MCP resource resolution",
   description:
     "Provides a tool that can read and return the content of resources from URLs using the host's resolveResource function. Supports various protocols including https, file, git, gist, and vscode.",
+  activation: ["resource", "resources"],
 });
 
 export default function (ctx: ChatGenerationContext) {
@@ -4734,6 +4741,7 @@ Today's date.
 `````js wrap title="system.today"
 system({
     title: "Today's date.",
+    activation: ["today"],
 })
 export default function (ctx: ChatGenerationContext) {
     const { $ } = ctx

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

@@ -4,7 +4,7 @@
   "author": "microsoft",
   "license": "MIT",
   "dependencies": {
-    "genaiscript": "2.3.15"
+    "genaiscript": "2.4.0"
   },
   "scripts": {
     "upgrade": "npx -y npm-check-updates -u && npm install && npm run fix",

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

@@ -2,7 +2,7 @@
   "name": "@genaiscript/monorepo",
   "displayName": "GenAIScript",
   "description": "Programmatically assemble prompts for LLMs using JavaScript. Orchestrate LLMs, tools, and data in code.",
-  "version": "2.3.15",
+  "version": "2.4.0",
   "license": "MIT",
   "private": true,
   "author": "microsoft",

examples/action/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@genaiscript/api",
   "private": false,
-  "version": "2.3.15",
+  "version": "2.4.0",
   "main": "./dist/commonjs/index.js",
   "module": "./dist/esm/index.js",
   "types": "./dist/commonjs/index.d.ts",

genaiscript.d.ts

@@ -1,6 +1,6 @@
 {
   "name": "genaiscript",
-  "version": "2.3.15",
+  "version": "2.4.0",
   "type": "module",
   "bin": "./dist/src/index.js",
   "files": [