@imagile-dev/toil 0.1.0-alpha.5 → 0.1.0-beta.1
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 +25 -22
- package/dist/api.d.ts +3 -1
- package/dist/toil-lib.js +22476 -1967
- package/package.json +4 -2
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/
|
|
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=
|
|
10
|
-
<a href="package.json"><img src="https://img.shields.io/badge/node-%E2%89%A5%2024.
|
|
11
|
-
<a href="https://imagile-dev.github.io/toil/how-it-works/"><img src="https://img.shields.io/badge/runtime%20dependencies-0-
|
|
12
|
-
<a href="LICENSE"><img src="https://img.shields.io/github/license/imagile-dev/toil?style=flat-square&labelColor=
|
|
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/
|
|
20
|
-
<a href="https://imagile-dev.github.io/toil/
|
|
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:**
|
|
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
|
|
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.
|
|
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
|
|
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/
|
|
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
|
|
193
|
-
| [
|
|
194
|
-
| [
|
|
195
|
-
| [
|
|
196
|
-
| [
|
|
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
|
|
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
|
-
**
|
|
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
|
/**
|