@imagile-dev/toil 0.1.0-alpha.5 → 0.1.0-beta.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -5,20 +5,20 @@
5
5
  </p>
6
6
 
7
7
  <p align="center">
8
- <a href="https://www.npmjs.com/package/@imagile-dev/toil"><img src="https://img.shields.io/npm/v/@imagile-dev/toil/alpha?style=flat-square&label=npm&labelColor=16130f&color=ff6a3d" alt="npm version (alpha)"></a>
9
- <a href="https://github.com/imagile-dev/toil/actions/workflows/ci.yml?query=branch%3Amain"><img src="https://img.shields.io/github/actions/workflow/status/imagile-dev/toil/ci.yml?branch=main&style=flat-square&label=CI&labelColor=16130f" alt="CI status on main"></a>
10
- <a href="package.json"><img src="https://img.shields.io/badge/node-%E2%89%A5%2024.14-ffb84d?style=flat-square&labelColor=16130f" alt="Node.js 24.14 or later"></a>
11
- <a href="https://imagile-dev.github.io/toil/how-it-works/"><img src="https://img.shields.io/badge/runtime%20dependencies-0-ffb84d?style=flat-square&labelColor=16130f" alt="No runtime dependencies"></a>
12
- <a href="LICENSE"><img src="https://img.shields.io/github/license/imagile-dev/toil?style=flat-square&labelColor=16130f&color=b4a998" alt="Apache 2.0 license"></a>
8
+ <a href="https://www.npmjs.com/package/@imagile-dev/toil"><img src="https://img.shields.io/npm/v/@imagile-dev/toil/beta?style=flat-square&label=npm&labelColor=0f1115&color=8cc4ff" alt="npm version (beta)"></a>
9
+ <a href="https://github.com/imagile-dev/toil/actions/workflows/ci.yml?query=branch%3Amain"><img src="https://img.shields.io/github/actions/workflow/status/imagile-dev/toil/ci.yml?branch=main&style=flat-square&label=CI&labelColor=0f1115" alt="CI status on main"></a>
10
+ <a href="package.json"><img src="https://img.shields.io/badge/node-%E2%89%A5%2024.22.1-c2e0ff?style=flat-square&labelColor=0f1115" alt="Node.js 24.22.1 or later"></a>
11
+ <a href="https://imagile-dev.github.io/toil/about/how-it-works/"><img src="https://img.shields.io/badge/runtime%20dependencies-0-c2e0ff?style=flat-square&labelColor=0f1115" alt="No runtime dependencies"></a>
12
+ <a href="LICENSE"><img src="https://img.shields.io/github/license/imagile-dev/toil?style=flat-square&labelColor=0f1115&color=a7afba" alt="Apache 2.0 license"></a>
13
13
  </p>
14
14
 
15
15
  <p align="center">
16
16
  <a href="https://imagile-dev.github.io/toil/"><b>Website</b></a> ·
17
+ <a href="https://imagile-dev.github.io/toil/connect/"><b>Connect</b></a> ·
17
18
  <a href="https://imagile-dev.github.io/toil/docs/"><b>Docs</b></a> ·
18
- <a href="https://imagile-dev.github.io/toil/how-it-works/"><b>How it works</b></a> ·
19
- <a href="https://imagile-dev.github.io/toil/integrations/"><b>Integrations</b></a> ·
20
- <a href="https://imagile-dev.github.io/toil/principles/"><b>Principles</b></a> ·
21
- <a href="https://imagile-dev.github.io/toil/feedback/"><b>Feedback</b></a>
19
+ <a href="https://imagile-dev.github.io/toil/about/how-it-works/"><b>How it works</b></a> ·
20
+ <a href="https://imagile-dev.github.io/toil/about/principles/"><b>Principles</b></a> ·
21
+ <a href="https://imagile-dev.github.io/toil/about/feedback/"><b>Feedback</b></a>
22
22
  </p>
23
23
 
24
24
  The token-efficient alternative to MCP: one CLI that gives agents your enterprise
@@ -36,7 +36,7 @@ tools and your databases while spending as little of their context as it can.
36
36
  `toil mcp` serves the same commands as MCP tools for clients that want them. toil is
37
37
  plain JavaScript on Node, so it also runs where executables are blocked.
38
38
 
39
- > **Status:** Alpha: APIs and flags may change before 1.0
39
+ > **Status:** Beta: commands, flags and output are stable, and any breaking change comes with a migration note
40
40
 
41
41
  toil is published to npm as [`@imagile-dev/toil`](https://www.npmjs.com/package/@imagile-dev/toil),
42
42
  and documented at [imagile-dev.github.io/toil](https://imagile-dev.github.io/toil/). This
@@ -59,7 +59,7 @@ precise it is.
59
59
  ### Why toil
60
60
 
61
61
  <p align="center">
62
- <img src=".github/assets/crate-red-tape.webp" width="720" alt="A cardboard box in an amber-striped hard hat walks calmly through a maze of barrier tape and traffic cones, the tape parted neatly behind it, carrying a small parcel past an ignored filing cabinet and a rubber stamp.">
62
+ <img src=".github/assets/crate-red-tape.webp" width="720" alt="A blue cardboard box in a hard hat walks calmly through a maze of barrier tape and traffic cones, the tape parted neatly behind it, carrying a small parcel past an ignored filing cabinet and a rubber stamp.">
63
63
  </p>
64
64
 
65
65
  <table>
@@ -81,7 +81,8 @@ point it at. Windows, macOS and Linux are all first-class.
81
81
  ## Quick start
82
82
 
83
83
  There are two ways to run toil: install it from npm, or run it from a clone. Both
84
- need Node.js 24.14 or later, on Windows, macOS or Linux. There is no executable, no
84
+ need Node.js 24.22.1 or later on 24.x, or 26.12.1 or later (the releases that fix
85
+ CVE-2026-111497), on Windows, macOS or Linux. There is no executable, no
85
86
  native module and no install script.
86
87
 
87
88
  ### From npm
@@ -93,7 +94,7 @@ toil deps scan # inventory the npm, Maven and NuGet packages in this folder
93
94
  toil mcp # serve toil to an agent over stdio
94
95
  ```
95
96
 
96
- Releases are alpha and published under npm's `alpha` tag, which `latest` follows
97
+ Releases are beta and published under npm's `beta` tag, which `latest` follows
97
98
  until 1.0 ([npm](https://www.npmjs.com/package/@imagile-dev/toil)). Setup, connections and every command are on the
98
99
  [site](https://imagile-dev.github.io/toil/docs/).
99
100
 
@@ -185,25 +186,27 @@ Code the clone is also a plugin marketplace: `claude plugin marketplace add
185
186
 
186
187
  | Area | What it covers |
187
188
  |------|----------------|
188
- | [`db`](https://imagile-dev.github.io/toil/docs/databases/) | SQLite, PostgreSQL, MySQL / MariaDB, SQL Server and Oracle: list schemas and tables, describe a table, preview rows, read-only queries with paging |
189
+ | [`db`](https://imagile-dev.github.io/toil/connect/db/) | SQLite, PostgreSQL, MySQL / MariaDB, SQL Server, Oracle, Teradata, Hive and Impala: list schemas and tables, describe a table, preview rows, read-only queries with paging |
189
190
  | [`util`](https://imagile-dev.github.io/toil/docs/utilities/) | Local commands with no connection or network: JWTs, dependency inventories, encodings and hashes, certificates, test and coverage reports, logs, secret scans, time and versions, Jira and Confluence markup, OpenAPI |
190
191
  | [`skills`](https://imagile-dev.github.io/toil/docs/skills/) | Add a git-hosted skills marketplace, install its plugins for Codex, GitHub Copilot or Claude Code, switch them on and off |
191
192
  | [The toil skill](https://imagile-dev.github.io/toil/docs/) | toil's own command reference for agents, one file per area |
192
- | [Work tracking and source](https://imagile-dev.github.io/toil/integrations/) (9) | Jira, Confluence and Bitbucket (Data Center and Cloud), GitHub & GitHub Enterprise, Azure DevOps Server, local git |
193
- | [Build, release and runtime](https://imagile-dev.github.io/toil/integrations/) (5) | JFrog Artifactory, Jenkins, OpenShift / Kubernetes, Sauce Labs, Split.IO |
194
- | [Security and quality](https://imagile-dev.github.io/toil/integrations/) (7) | Checkmarx One, Contrast Security, SD Elements, SonarQube, Sonatype IQ Server, Sonatype OSS Index, OSV.dev |
195
- | [Observability](https://imagile-dev.github.io/toil/integrations/) (4) | Dynatrace, Elasticsearch, Kibana, Falcon LogScale |
196
- | [Design and data](https://imagile-dev.github.io/toil/integrations/) (2) | Figma, Alation |
193
+ | [Work tracking](https://imagile-dev.github.io/toil/connect/#trackers) (4) | Jira (Data Center and Cloud), Azure DevOps Server and Services |
194
+ | [Source and review](https://imagile-dev.github.io/toil/connect/#source) (4) | GitHub & GitHub Enterprise, Bitbucket (Data Center and Cloud), local git |
195
+ | [CI/CD and runtime](https://imagile-dev.github.io/toil/connect/#cicd) (3) | Jenkins, JFrog Artifactory, OpenShift / Kubernetes |
196
+ | [Testing and flags](https://imagile-dev.github.io/toil/connect/#testing) (2) | Sauce Labs, Split.IO |
197
+ | [Security and quality](https://imagile-dev.github.io/toil/connect/#security) (7) | Checkmarx One, Contrast Security, SD Elements, SonarQube, Sonatype IQ Server, Sonatype OSS Index, OSV.dev |
198
+ | [Observability](https://imagile-dev.github.io/toil/connect/#observability) (4) | Dynatrace, Elasticsearch, Kibana, Falcon LogScale |
199
+ | [Docs and design](https://imagile-dev.github.io/toil/connect/#docs) (4) | Confluence (Data Center and Cloud), Figma, Alation |
197
200
 
198
201
  Every integration that needs a credential signs in with a long-lived token you
199
202
  generate once in the vendor's UI. Every integration records how far it has been
200
203
  verified: `unit`, `live` or `stable`. Each one's
201
- page on the [integrations board](https://imagile-dev.github.io/toil/integrations/)
202
- says what its level means.
204
+ page under [Connect](https://imagile-dev.github.io/toil/connect/), where the
205
+ database engines sit beside the integrations, says what its level means.
203
206
 
204
207
  ## Toil UI
205
208
 
206
- **Alpha, local only.** Toil UI (`@imagile-dev/toil-ui`, in [`ui/`](ui/)) is a
209
+ **Beta, local only.** Toil UI (`@imagile-dev/toil-ui`, in [`ui/`](ui/)) is a
207
210
  separate package: a local web app with one dashboard per dossier, syncing through
208
211
  toil into a local cache with your own connections, read-only. It binds loopback and opens only from
209
212
  the one URL it prints when it starts. Installing toil never installs it.
package/dist/api.d.ts CHANGED
@@ -865,7 +865,9 @@ declare const registry: Registry;
865
865
  * Runs one command, as `toil <name>` would, and returns its envelope. Never
866
866
  * throws: an unknown command, a bad option or a failure inside is an envelope
867
867
  * with `ok: false`, like every other. `input` is the command's MCP fields
868
- * (`{ jql: "project = PAY", limit: 50 }`), checked strictly.
868
+ * (`{ jql: "project = PAY", limit: 50 }`), checked strictly. On a Node toil
869
+ * refuses (`src/core/runtime.ts`, CVE-2026-111497) every call is the CLI's
870
+ * `UNSUPPORTED_NODE` envelope, before anything runs or fetches.
869
871
  */
870
872
  declare function execute(command: string, input?: Record<string, unknown>, options?: ExecuteOptions): Promise<Envelope>;
871
873
  /**