Update dependencies, add API key support, and enhance code execution

.vscode/settings.json

@@ -7,6 +7,7 @@
         "Automatable",
         "bitindex",
         "cmds",
+        "codelion",
         "Codespaces",
         "compactable",
         "demux",

THIRD_PARTY_LICENSES.md

@@ -1037,7 +1037,7 @@ The following npm packages may be included in this product:
  - @types/[email protected]
  - @types/[email protected]
  - @types/[email protected]
- - @types/[email protected].4
+ - @types/[email protected].5
  - @types/[email protected]
  - @types/[email protected]
 
@@ -1099,7 +1099,7 @@ MIT License
 
 The following npm package may be included in this product:
 
- - [email protected].5
+ - [email protected].8
 
 This package contains the following license and notice below:
 
@@ -2814,20 +2814,20 @@ CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
 
 The following npm packages may be included in this product:
 
- - @inquirer/checkbox@2.5.0
- - @inquirer/confirm@3.2.0
- - @inquirer/core@9.1.0
- - @inquirer/editor@2.2.0
- - @inquirer/expand@2.3.0
- - @inquirer/[email protected].5
- - @inquirer/input@2.3.0
- - @inquirer/number@1.1.0
- - @inquirer/password@2.2.0
- - @inquirer/prompts@5.5.0
- - @inquirer/rawlist@2.3.0
- - @inquirer/search@1.1.0
- - @inquirer/select@2.5.0
- - @inquirer/type@1.5.3
+ - @inquirer/checkbox@3.0.1
+ - @inquirer/confirm@4.0.1
+ - @inquirer/core@9.2.1
+ - @inquirer/editor@3.0.1
+ - @inquirer/[email protected].1
+ - @inquirer/[email protected].6
+ - @inquirer/[email protected].1
+ - @inquirer/number@2.0.1
+ - @inquirer/password@3.0.1
+ - @inquirer/prompts@6.0.1
+ - @inquirer/[email protected].1
+ - @inquirer/search@2.0.1
+ - @inquirer/select@3.0.1
+ - @inquirer/type@2.0.0
 
 These packages each contain the following license and notice below:
 
@@ -3347,7 +3347,7 @@ http://github.com/mscdex/buildcheck/raw/master/LICENSE
 
 The following npm package may be included in this product:
 
- - ssh2@1.15.0
+ - ssh2@1.16.0
 
 This package contains the following license and notice below:
 
@@ -4188,9 +4188,9 @@ The following npm packages may be included in this product:
  - @tokenizer/[email protected]
  - [email protected]
  - [email protected]
- - [email protected].5
- - [email protected].5
- - [email protected].5
+ - [email protected].8
+ - [email protected].8
+ - [email protected].8
  - [email protected]
  - [email protected]
  - [email protected]
@@ -4781,7 +4781,7 @@ SOFTWARE.
 
 The following npm package may be included in this product:
 
- - [email protected].2
+ - [email protected].3
 
 This package contains the following license and notice below:
 
@@ -4871,7 +4871,7 @@ SOFTWARE.
 
 The following npm package may be included in this product:
 
- - [email protected].1
+ - [email protected].3
 
 This package contains the following license and notice below:
 
@@ -5124,10 +5124,9 @@ The following npm packages may be included in this product:
  - @sindresorhus/[email protected]
  - @sindresorhus/[email protected]
  - [email protected]
- - [email protected]
  - [email protected]
  - [email protected]
- - execa@9.3.1
+ - execa@9.4.0
  - [email protected]
  - [email protected]
  - [email protected]
@@ -5143,7 +5142,7 @@ The following npm packages may be included in this product:
  - [email protected]
  - [email protected]
  - [email protected]
- - npm-run-path@5.3.0
+ - npm-run-path@6.0.0
  - [email protected]
  - [email protected]
  - [email protected]
@@ -5154,6 +5153,7 @@ The following npm packages may be included in this product:
  - [email protected]
  - [email protected]
  - [email protected]
+ - [email protected]
  - [email protected]
  - [email protected]
  - [email protected]
@@ -5479,8 +5479,8 @@ IN THE SOFTWARE.
 
 The following npm packages may be included in this product:
 
- - [email protected].0
- - [email protected].0
+ - [email protected].1
+ - [email protected].1
 
 These packages each contain the following license and notice below:
 
@@ -6854,11 +6854,11 @@ The following npm packages may be included in this product:
 
  - @azure/[email protected]
  - @azure/[email protected]
- - @azure/core-auth@1.7.2
+ - @azure/core-auth@1.8.0
  - @azure/[email protected]
- - @azure/core-rest-pipeline@1.16.3
+ - @azure/core-rest-pipeline@1.17.0
  - @azure/[email protected]
- - @azure/core-util@1.9.2
+ - @azure/core-util@1.10.0
  - @azure/[email protected]
  - @azure/[email protected]
 

docs/package.json

@@ -20,12 +20,12 @@
   },
   "dependencies": {
     "@astrojs/check": "^0.9.3",
-    "@astrojs/starlight": "^0.27.0",
-    "astro": "^4.15.4",
+    "@astrojs/starlight": "^0.28.1",
+    "astro": "^4.15.7",
     "typescript": "5.6.2"
   },
   "devDependencies": {
     "starlight-blog": "^0.12.0",
-    "zx": "^8.1.5"
+    "zx": "^8.1.7"
   }
 }

docs/src/content/docs/blog/creating-release-notes-with-genai.md

@@ -2,16 +2,15 @@
 title: Creating Release Notes with GenAI
 date: 2024-08-26
 tags:
-  - release notes
-  - automation
-  - scripting
-  - software development
-  - AI
+    - release notes
+    - automation
+    - scripting
+    - software development
+    - AI
 authors: genaiscript
 canonical_url: https://microsoft.github.io/genaiscript/blog/creating-release-notes-with-genai
 description: Learn how to automate the creation of engaging software release
-  notes using GenAI and GenAIScript.
-
+    notes using GenAI and GenAIScript.
 ---
 
 ## Automating Your Release Notes with GenAI
@@ -51,47 +50,25 @@
 ```javascript
 const pkg = await workspace.readJSON("package.json")
 const { version } = pkg
-const { stdout: tag } = await host.exec("git", [
-    "describe",
-    "--tags",
-    "--abbrev=0",
-    "HEAD^",
-])
+const { stdout: tag } = await host.exec("git describe --tags --abbrev=0 HEAD^")
 ```
 
 We are reading the current version from `package.json` and using Git to find the previous release tag in the repository.
 
 #### Step 4: Gathering Commits
 
 ```javascript
-const { stdout: commits } = await host.exec("git", [
-    "log",
-    "--grep='skip ci'",
-    "--invert-grep",
-    "--no-merges",
-    `HEAD...${tag}`,
-])
+const { stdout: commits } = await host.exec(`git log --grep='skip ci' --invert-grep --no-merges HEAD...${tag}`)
+
 ```
 
 This block runs a Git command to retrieve the list of commits that will be included in the release notes, excluding any with 'skip ci' in the message.
 
 #### Step 5: Obtaining the Diff
 
 ```javascript
-const { stdout: diff } = await host.exec("git", [
-    "diff",
-    `${tag}..HEAD`,
-    "--no-merges",
-    "--",
-    ":!**/package.json",
-    ":!**/genaiscript.d.ts",
-    ":!**/jsconfig.json",
-    ":!docs/**",
-    ":!.github/*",
-    ":!.vscode/*",
-    ":!*yarn.lock",
-    ":!*THIRD_PARTY_NOTICES.md",
-])
+const { stdout: diff } = await host.exec(`git diff ${tag}..HEAD --no-merges -- ':!**/package.json' ':!**/genaiscript.d.ts' ':!**/jsconfig.json' ':!docs/**' ':!.github/*' ':!.vscode/*' ':!*yarn.lock' ':!*THIRD_PARTY_NOTICES.md'`)
+
 ```
 
 Next, we get the diff of changes since the last release, excluding certain files and directories that aren't relevant to the user-facing release notes.

docs/src/content/docs/case-studies/release-notes.mdx

@@ -36,9 +36,12 @@
 (This magic was mostly found using a GitHub Copilot Chat session).
 
 ```js title="git-release-notes.genai.mjs" wrap
-const { stdout: tag } = await host.exec("git", ["describe", "--tags", "--abbrev=0", "HEAD^",])
-const { stdout: commits } = await host.exec("git", ["log", `HEAD...${tag}`,])
-const { stdout: diff } = await host.exec("git", ["diff", `${tag}..HEAD`,])
+const { stdout: tag } = await host.exec(`git describe --tags --abbrev=0 HEAD^`)
+
+const { stdout: commits } = await host.exec(`git log HEAD...${tag}`)
+
+const { stdout: diff } = await host.exec(`git diff ${tag}..HEAD`)
+
 ```
 
 We use the `def` function with `maxTokens` to inline this information without exceeding the content window

docs/src/content/docs/reference/cli/commands.md

@@ -283,8 +283,9 @@
 Start a GenAIScript local server
 
 Options:
-  -p, --port <number>  Specify the port number, default: 8003
-  -h, --help           display help for command
+  -p, --port <number>     Specify the port number, default: 8003
+  -k, --api-key <string>  API key to authenticate requests
+  -h, --help              display help for command
 ```
 
 ## `parse`

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

@@ -34,7 +34,28 @@
 By default, the container uses the [python:alpine](https://hub.docker.com/_/python/) image, which provides a minimal python environment. You can change the image using the `image` option.
 
 ```js 'image: "python:3"'
-const container = await host.container({ image: "python:3" })
+const container = await host.container({ image: "node:20" })
+```
+
+### Building images
+
+Use [docker build](https://docs.docker.com/build/) to create reusable images.
+
+You can build a custom image from a GitHub repository with a single command in your scripts.
+
+```js
+const repo = "codelion/optillm" // GitHub repository = image name
+const branch = "main"
+const dir = "."
+await host.exec(
+    `docker build -t ${repo} https://github.com/${repo}.git#${branch}:${dir}`
+)
+```
+
+then use repo as your image name
+
+```js
+const container = await host.container({ image: repo, ... })
 ```
 
 ### Disable auto-purge