Skip to content

Commit 40ba261

Browse files
committed
refactor: rename checkRuntimeHost to checkRuntime and update references
1 parent b96511c commit 40ba261

15 files changed

Lines changed: 130 additions & 46 deletions

File tree

docs/src/content/docs/fr/getting-started/index.mdx

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,5 @@
11
---
2-
title: Prise en main
2+
title: Commencer
33
sidebar:
44
order: 0
55
description: Commencez à développer avec l'extension GenAIScript pour VS Code

docs/src/content/docs/fr/index.mdx

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -7,7 +7,7 @@ hero:
77
file: ../../../assets/logo.svg
88
alt: GenAIScript logo A yellow square with genai text
99
actions:
10-
- text: Prise en main
10+
- text: Commencer
1111
link: /genaiscript/fr/getting-started/
1212
icon: right-arrow
1313
variant: primary

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

Lines changed: 4 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -98,7 +98,8 @@ Options:
9898
--fail-on-errors fails on detected annotation error
9999
--retry <number> number of retries (default: "10")
100100
--retry-delay <number> minimum delay between retries (default: "1000")
101-
--max-delay <number> maximum delay between retries (default: "10000")
101+
--max-delay <number> maximum delay between retries (default: "60000")
102+
--max-retry-after <number> maximum retry-after delay in milliseconds before giving up (default: "300000")
102103
-l, --label <string> label for the run
103104
-t, --temperature <number> temperature for the run
104105
--top-p <number> top-p for the run
@@ -568,6 +569,8 @@ Options:
568569
on the network
569570
--cors <string> Enable CORS and sets the allowed origin. Use
570571
'*' to allow any origin.
572+
--chat Enable OpenAI compatible chat completion routes
573+
(/v1/chat/completions)
571574
--dispatch-progress Dispatch progress events to all clients
572575
--github-copilot-chat-client Allow github_copilot_chat provider to connect
573576
to connected Visual Studio Code
Lines changed: 27 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,27 @@
1+
---
2+
title: AST Grep
3+
description: Utilisez le plugin ast-grep pour analyser et manipuler du code
4+
sidebar:
5+
order: 80
6+
7+
---
8+
9+
import { PackageManagers } from "starlight-package-managers";
10+
11+
Ces helpers d'exécution fournissent une interface conviviale autour de [ast-grep](https://ast-grep.github.io/).
12+
13+
## Installation
14+
15+
<PackageManagers pkg="@genaiscript/plugin-ast-grep" dev />
16+
17+
Si vous utilisez le plugin dans un environnement Node.JS, sans fichier d'entrée `.genai...`, vous devrez initialiser le [runtime](../../../reference/reference/runtime/) avant d'utiliser le plugin :
18+
19+
```ts
20+
import { initialize } from "@genaiscript/runtime";
21+
22+
await initialize();
23+
```
24+
25+
## Utilisation
26+
27+
Consultez le script [ast-grep](../../../reference/reference/scripts/ast-grep/) pour des exemples d'utilisation du plugin.

docs/src/content/docs/fr/reference/runtime/plugin-mdast.mdx

Lines changed: 13 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -10,16 +10,24 @@ import { PackageManagers } from "starlight-package-managers";
1010

1111
Ces assistants d'exécution fournissent une interface conviviale autour de l'écosystème [remark](https://github.com/remarkjs/remark), [mdast](https://github.com/syntax-tree/mdast), [unified](https://github.com/syntax-tree/unist) pour analyser et manipuler des documents Markdown.
1212

13-
Pour bénéficier de la complétion de type, vous devrez installer le paquet `@types/mdast` en tant que dépendance de développement.
13+
## Installation
14+
15+
<PackageManagers pkg="@genaiscript/plugin-mdast" dev />
1416

15-
<PackageManagers pkg="@types/mdast" dev />
17+
Si vous utilisez le plugin dans un environnement Node.JS, sans fichier d'entrée `.genai...`, vous devrez initialiser le [runtime](../../../reference/reference/runtime/) avant d'utiliser le plugin :
18+
19+
```ts
20+
import { initialize } from "@genaiscript/runtime";
21+
22+
await initialize()
23+
```
1624

1725
## Manipulation de Markdown
1826

1927
* charger les analyseurs
2028

2129
```typescript
22-
import { mdast } from "@genaiscript/runtime";
30+
import { mdast } from "@genaiscript/plugin-mdast";
2331

2432
const { parse, visit, stringify } = await mdast();
2533
```
@@ -43,3 +51,5 @@ const updated = visit(root, `code`, (node) => {
4351
```typescript
4452
const markdown = await stringify(updated);
4553
```
54+
55+
Pour bénéficier de la complétion de type, vous devrez installer le paquet `@types/mdast` en tant que dépendance de développement.

docs/src/content/docs/fr/reference/runtime/plugin-mermaid.mdx

Lines changed: 9 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,5 @@
11
---
2-
title: plugin-mermaid
2+
title: MermaidJs
33
description: Utilisez le plugin mermaid pour analyser les diagrammes mermaid
44

55
---
@@ -14,6 +14,14 @@ Le package [@genaiscript/plugin-mermaid](https://www.npmjs.com/package/@genaiscr
1414

1515
<PackageManagers pkg="@genaiscript/plugin-mermaid" dev />
1616

17+
Si vous utilisez le plugin dans un environnement Node.JS, sans fichier d'entrée `.genai...`, vous devrez initialiser le [runtime](../../../reference/reference/runtime/) avant d'utiliser le plugin :
18+
19+
```ts
20+
import { initialize } from "@genaiscript/runtime";
21+
22+
await initialize()
23+
```
24+
1725
## Utilisation
1826

1927
```ts

docs/src/content/docs/fr/reference/runtime/plugin-z3.mdx

Lines changed: 24 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -17,26 +17,42 @@ hero:
1717

1818
---
1919

20+
import { PackageManagers } from "starlight-package-managers";
21+
2022
[Z3](https://microsoft.github.io/z3guide/) est un prouveur de théorèmes haute performance développé par Microsoft Research. C'est un outil intégré de GenAIScript. Z3 est utilisé pour résoudre des formules logiques et peut être employé pour diverses applications, notamment la vérification de programmes, la résolution de contraintes et l'exécution symbolique.
2123

2224
GenAIScript utilise le paquet npm [z3-solver](https://www.npmjs.com/package/z3-solver) basé sur WebAssembly pour exécuter Z3.
2325

26+
## Installation
27+
28+
<PackageManagers pkg="@genaiscript/plugin-z3" dev />
29+
30+
Si vous utilisez le plugin dans un environnement Node.JS, sans fichier d'entrée `.genai...`, vous devrez initialiser le [runtime](../../../reference/reference/runtime/) avant d'utiliser le plugin :
31+
32+
```ts
33+
import { initialize } from "@genaiscript/runtime";
34+
35+
await initialize();
36+
```
37+
2438
## Instance Z3
2539

26-
La méthode `host.z3()` crée une nouvelle instance de Z3. L'instance peut être utilisée pour exécuter des commandes Z3 et obtenir les résultats. L'instance `z3` est un wrapper autour du paquet npm [z3-solver](https://www.npmjs.com/package/z3-solver). L'instance `z3` possède la méthode `run` qui exécute la formule SMTLIB2 donnée et retourne le résultat.
40+
La méthode `z3()` crée une nouvelle instance de Z3. L'instance peut être utilisée pour exécuter des commandes Z3 et obtenir les résultats.
41+
L'instance `z3` est un wrapper autour du package npm [z3-solver](https://www.npmjs.com/package/z3-solver).
42+
L'instance `z3` possède la méthode `run` qui exécute la formule SMTLIB2 fournie et retourne le résultat.
2743

2844
```js
29-
import { z3 } from "@genaiscript/plugin-z3"
45+
import { z3 } from "@genaiscript/plugin-z3";
3046

31-
const z3 = await z3()
47+
const z3 = await z3();
3248
const res = await z3.run(`
3349
(declare-const a Int)
3450
(declare-fun f (Int Bool) Int)
3551
(assert (< a 10))
3652
(assert (< (f a true) 100))
3753
(check-sat)
38-
`)
39-
console.log(res) // unsat
54+
`);
55+
console.log(res); // unsat
4056
```
4157

4258
## Outil Z3
@@ -65,16 +81,16 @@ Le script de l'agent `z3` (dans [system.agent-z3](../../../reference/reference/s
6581

6682
```js
6783
script({
68-
tools: ["agent_z3"],
69-
})
84+
tools: ["agent_z3"],
85+
});
7086
7187
$`Solve the following problems using Z3:
7288

7389
Imagine we have a number called 'a' that is smaller than 10.
7490
We also have a special machine called 'f' that takes a number and a 'true'/'false' answer,
7591
and it gives back another number.
7692
When we put the number 'a' and the answer “true” into this machine,
77-
the number it gives us is smaller than 100.`
93+
the number it gives us is smaller than 100.`;
7894
```
7995

8096
:::note

docs/src/content/docs/fr/reference/scripts/git.md

Lines changed: 23 additions & 15 deletions
Original file line numberDiff line numberDiff line change
@@ -25,63 +25,71 @@ L’assistant `git` fournit une fine couche d’abstraction autour de l’appel
2525
Résout la branche par défaut, généralement `main` ou `master`, dans le dépôt.
2626

2727
```typescript
28-
const df = await git.defaultBranch()
28+
const df = await git.defaultBranch();
2929
```
3030

3131
### lastTag
3232

3333
Récupère le dernier tag dans le dépôt.
3434

3535
```typescript
36-
const tag = await git.lastTag()
36+
const tag = await git.lastTag();
3737
```
3838

3939
### branch
4040

4141
Récupère la branche courante du dépôt.
4242

4343
```typescript
44-
const branchName = await git.branch()
44+
const branchName = await git.branch();
4545
```
4646

4747
### exec
4848

4949
Exécute une commande git dans le dépôt et retourne la sortie standard.
5050

5151
```typescript
52-
const output = await git.exec(["status"])
52+
const output = await git.exec(["status"]);
5353
```
5454

5555
### listBranches
5656

5757
Liste les branches du dépôt git.
5858

5959
```typescript
60-
const branches = await git.listBranches()
60+
const branches = await git.listBranches();
6161
```
6262

6363
### listFiles
6464

6565
Recherche des fichiers spécifiques dans le dépôt git.
6666

6767
```typescript
68-
const files = await git.listFiles("modified")
68+
const files = await git.listFiles("modified");
6969
```
7070

7171
### diff
7272

7373
Obtient le diff pour l’état actuel du dépôt.
7474

7575
```typescript
76-
const diffOutput = await git.diff({ staged: true })
76+
const diffOutput = await git.diff({ staged: true });
7777
```
7878

7979
### log
8080

81-
Liste les commits du dépôt git.
81+
Liste les commits avec divers filtres. Inclut le sha, l'auteur, la date, le message et les noms de fichiers.
8282

8383
```typescript
84-
const commits = await git.log()
84+
const commits = await git.log({ ... });
85+
```
86+
87+
### fichiersModifiés
88+
89+
Liste les fichiers modifiés lors du dernier commit.
90+
91+
```typescript
92+
const changedFiles = await git.changedFiles({ ... });
8593
```
8694

8795
## Configuration des ignores
@@ -100,24 +108,24 @@ La méthode `shallowClone` retourne une instance client `git`.
100108
Les clones sont créés dans le répertoire `.genaiscript/git/...` et sont mis en cache selon l’information `repository/branch/commit`.
101109

102110
```js
103-
const clone = await git.shallowClone("microsoft/genaiscript")
111+
const clone = await git.shallowClone("microsoft/genaiscript");
104112
```
105113

106114
Vous pouvez fournir des options pour forcer le clonage
107115
et/ou exécuter la commande `install` après le clonage.
108116

109117
```js
110118
const clone = await git.shallowClone("microsoft/genaiscript", {
111-
force: true,
112-
install: true,
113-
})
119+
force: true,
120+
install: true,
121+
});
114122
```
115123

116124
## Git dans d’autres dépôts
117125

118126
Utilisez `git.client` pour ouvrir un client git sur un autre répertoire de travail. Cela vous permet d’exécuter des commandes git sur un autre dépôt.
119127

120128
```js
121-
const other = git.client("/path/to/other/repo")
122-
const branch = await other.branch()
129+
const other = git.client("/path/to/other/repo");
130+
const branch = await other.branch();
123131
```

docs/translations/fr.json

Lines changed: 17 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -8388,7 +8388,7 @@
83888388
"7488F1ED2F90893B552C": "Neovim",
83898389
"4C1CD4854A9D61A5024A": "Extension Visual Studio Code <a id=\"visual-studio-code-extension\" href=\"\" />\n\nLe [Visual Studio Code Marketplace](https://marketplace.visualstudio.com/items?itemName=genaiscript.genaiscript-vscode)\ncontient la dernière version stable de l'[extension](https://marketplace.visualstudio.com/items?itemName=genaiscript.genaiscript-vscode).\n\n<Steps>\n <ol>\n <li>\n Installez [Visual Studio Code](https://code.visualstudio.com/Download).\n\n Visual Studio Code est un éditeur de code source léger mais puissant qui fonctionne sur votre bureau et est disponible pour Windows, macOS et Linux.\n </li>\n\n <li>\n Ouvrez le dossier de votre projet dans Visual Studio Code.\n </li>\n\n <li>\n Cliquez sur la vue **Extensions**\n\n <Image src={extensionViewSrc} alt={extensionViewAlt} />\n </li>\n\n <li>\n Recherchez **genaiscript** et cliquez sur **Installer**.\n\n <Image src={marketplaceSrc} alt={marketplaceAlt} />\n </li>\n\n <li>\n Si l'installation est réussie, vous verrez l'icône dans la vue **Extensions**.\n\n <Image src={vscodeViewSrc} alt={vscodeViewAlt} />\n </li>\n\n <li>\n (Facultatif) Cliquez sur l'icône ⚙️ sur la page de l'extension et sélectionnez **Ajouter aux recommandations de l'espace de travail**.\n </li>\n </ol>\n</Steps>\n\nPour installer une version spécifique de l'extension, nous recommandons de stocker le fichier `genaiscript.vsix`\ndans votre dépôt et d'utiliser les étapes d'installation manuelle.\n\n### Profil par défaut pour le terminal\n\nGenAIScript lance un serveur Node dans le terminal par défaut. Si le terminal par défaut n'est pas configuré\nou ne prend pas en charge Node.js, vous devrez peut-être le mettre à jour dans vos paramètres utilisateur/espace de travail.\n\n* Ouvrez la palette de commandes `Ctrl+Shift+P` et recherchez `Terminal: Sélectionner le profil par défaut`.\n* Sélectionnez le profil de terminal comme **Git Bash**",
83908390
"D729716A2DF6E7B14A5C": "Ligne de commande <a id=\"command-line\" href=\"\" />\n\nL'outil en ligne de commande [genaiscript](/genaiscript/reference/cli/) vous permet d'exécuter votre GenAIScript\ndepuis n'importe quel terminal.\n\n```sh\nnpx genaiscript run my-script some/path/*.pdf",
8391-
"4A5339853316F3D12027": "Prise en main",
8391+
"4A5339853316F3D12027": "Commencer",
83928392
"B59803282C64DBC3CD0B": "Commencez à développer avec l'extension GenAIScript pour VS Code afin de créer des scripts IA efficacement.",
83938393
"7CD15446D60D2DFAB9B4": "GenAIScript est un langage de script qui intègre les LLM dans le processus de script en utilisant une syntaxe JavaScript simplifiée.\nPris en charge par notre extension VS Code GenAIScript, il permet aux utilisateurs de créer, déboguer et automatiser des scripts basés sur LLM.",
83948394
"42FBD893AA9A93AD9F70": "Préambule",
@@ -10712,5 +10712,20 @@
1071210712
"B46718269052C5DF8347": "Exécution du solveur Z3 [@genaiscript/plugin-z3](/genaiscript/reference/runtime/plugin-z3/)",
1071310713
"DE6895455661A0BFFA5B": "Rationalisez votre processus de pull request avec des descriptions automatisées. Dans ce guide, vous apprendrez à créer un script qui génère des résumés de haut niveau des modifications apportées au code dans les pull requests. Le script peut être exécuté localement pour les tests et les ajustements, puis intégré avec GitHub Actions pour une automatisation transparente.\n\nPrincipaux points à retenir :\n\n- Utilisation de `git.diff` pour extraire les changements et résumer leur intention.\n- Ajout de mécanismes de sécurité pour éviter la génération de contenu nuisible.\n- Utilisation d’agents comme `fs_read_file` ou `agent_fs` pour une analyse contextuelle plus approfondie.\n- Automatisation du processus avec un workflow GitHub pour mettre à jour dynamiquement les descriptions de pull request.\n\nCette approche améliore non seulement l’efficacité des développeurs mais renforce aussi la clarté lors de la revue du code. Adaptez-la à votre manière de travailler et profitez d’une collaboration plus fluide.",
1071410714
"8AC090DFB30AD17329FA": "Passez vos revues de pull request au niveau supérieur grâce à l'automatisation. Ce guide vous accompagne pas à pas dans la création d'un script qui analyse les changements de code, identifie les erreurs (pas les avertissements) et fournit des suggestions concrètes directement sur GitHub. Apprenez à intégrer ce processus localement pour affiner votre workflow, à tirer parti des agents intégrés pour une analyse plus approfondie des fichiers et, enfin, à l'automatiser avec GitHub Actions. Des configurations de métadonnées aux mesures de sécurité, vous mettrez en place un flux de travail complet, efficace et sécurisé.",
10715-
"82BE6C3841DA855A2B56": "Vous cherchez à améliorer le workflow de votre équipe avec GitHub Actions ? Pensez à automatiser les tâches courantes telles que la vérification orthographique des fichiers markdown sur plusieurs branches, avec une grande précision. Cette méthode utilise `GenAIScript` et les GitHub Models pour corriger les principales erreurs de grammaire et d’orthographe, sans modifier les contenus essentiels comme le frontmatter, les blocs de code ou les URLs.\n\nDe la personnalisation du script à l’optimisation locale via des outils CLI, cette approche permet un traçage détaillé des erreurs tout en mettant l’accent sur la sécurité et la clarté du contenu. Une fois intégrée à GitHub Actions, cette procédure devient totalement automatisée, ce qui réduit les efforts manuels et garantit le contrôle qualité. Idéal pour maintenir les standards de la documentation technique dans des dépôts en constante évolution."
10715+
"82BE6C3841DA855A2B56": "Vous cherchez à améliorer le workflow de votre équipe avec GitHub Actions ? Pensez à automatiser les tâches courantes telles que la vérification orthographique des fichiers markdown sur plusieurs branches, avec une grande précision. Cette méthode utilise `GenAIScript` et les GitHub Models pour corriger les principales erreurs de grammaire et d’orthographe, sans modifier les contenus essentiels comme le frontmatter, les blocs de code ou les URLs.\n\nDe la personnalisation du script à l’optimisation locale via des outils CLI, cette approche permet un traçage détaillé des erreurs tout en mettant l’accent sur la sécurité et la clarté du contenu. Une fois intégrée à GitHub Actions, cette procédure devient totalement automatisée, ce qui réduit les efforts manuels et garantit le contrôle qualité. Idéal pour maintenir les standards de la documentation technique dans des dépôts en constante évolution.",
10716+
"76C61D10901221030690": "Si vous utilisez le plugin dans un environnement Node.JS, sans fichier d'entrée `.genai...`, vous devrez initialiser le [runtime](/genaiscript/reference/runtime) avant d'utiliser le plugin :",
10717+
"B6732A47543582072BA9": "La méthode `z3()` crée une nouvelle instance de Z3. L'instance peut être utilisée pour exécuter des commandes Z3 et obtenir les résultats.\nL'instance `z3` est un wrapper autour du package npm [z3-solver](https://www.npmjs.com/package/z3-solver).\nL'instance `z3` possède la méthode `run` qui exécute la formule SMTLIB2 fournie et retourne le résultat.",
10718+
"D703338B6EF6979B8C92": "AST Grep",
10719+
"A5E15E89BB5ED03054A2": "Utilisez le plugin ast-grep pour analyser et manipuler du code",
10720+
"66F74F6BDA90BBE72712": "Ces helpers d'exécution fournissent une interface conviviale autour de [ast-grep](https://ast-grep.github.io/).",
10721+
"0E1C55516EE16D530F52": "Consultez le script [ast-grep](/genaiscript/reference/scripts/ast-grep) pour des exemples d'utilisation du plugin.",
10722+
"952C1E913C4154A2B4A1": "Analyse et manipulation d’AST Markdown ",
10723+
"4942EAFCF6E164150D2A": "@genaiscript/plugin-mdast",
10724+
"7F9E583E0868D80FD4BF": "@genaiscript/plugin-ast-grep",
10725+
"7331773107CF6EB5BD64": "Analyse de diagrammes MermaidJS ",
10726+
"87A227AA6103F03E1B7C": "Exécution du solveur Z3 ",
10727+
"4956126B18489A2C3BD4": "@genaiscript/plugin-z3",
10728+
"184BBEC9B06552A68728": "Liste les commits avec divers filtres. Inclut le sha, l'auteur, la date, le message et les noms de fichiers.",
10729+
"9BDE4FB3D33A64AEA8FD": "fichiersModifiés",
10730+
"68CD65FEC47480DC6B8B": "Liste les fichiers modifiés lors du dernier commit."
1071610731
}

packages/cli/src/run.ts

Lines changed: 0 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -12,7 +12,6 @@ import {
1212
genaiscriptDebug,
1313
normalizeInt,
1414
createCancellationController,
15-
checkRuntimeHost,
1615
} from "@genaiscript/core";
1716
import { runScriptInternal } from "@genaiscript/api";
1817

@@ -43,7 +42,6 @@ export async function runScriptWithExitCode(
4342
) {
4443
dbg(`run %s`, scriptId);
4544
await ensureDotGenaiscriptPath();
46-
await checkRuntimeHost();
4745
const canceller = createCancellationController();
4846
const cancellationToken = canceller.token;
4947
const runRetry = Math.max(1, normalizeInt(options.runRetry) || 1);

0 commit comments

Comments
 (0)