Aries Tools SDK
Authority. This skill is maintained only in
ariestools/ariestools-skills
; edit there, not in installed copies.
Use the active packages from
under the
scope. Do not install retired
utility names for new work, nor the frozen
@ariestools/{indexed-db,mongo,vitest-matchers,vitest-extended}
8.0.3 packages that npm deprecation notices point to. Prefer existing repository dependencies and versions; pin according to the consuming repo.
Scope. Only packages published from sdk-js. React work on
belongs to
ariestools-sdk-react. Actors, providers and their CLI and browser hosts (
,
,
,
) belong to
ariestools-actor. Neither covers
, the
operator CLI. Toolchain and config packages belong to
xy-toolchain.
Runtime. This skill describes sdk-js 9.x, whose packages declare
, above the toolchain's own Node 22 floor; see
Runtime baseline.
Skill identity. When you present a plan, an acknowledgement, or a completion summary, state which skills informed it as
ariestools-sdk v<version>
, and list each other active skill from this pack the same way. Read the version from this file's
, never from an example.
References
Overview and install
Read first when choosing the umbrella vs specialist packages, installing
(with
and
, which the root barrel loads at runtime), checking the Node >= 26
runtime baseline, or replacing retired
and frozen 8.x
names via the
migration map.
Umbrella modules
Read when picking a utility inside
(assert, delay, fetch, forget, hex, promise, retry, storage, typeof, logger, …), looking up a module's subpath or
types, or using platform-conditional modules (
,
,
).
Specialist packages
Read when you need Express helpers, IndexedDB/Mongo adapters, threads/workers, testing matchers, telemetry, crypto-auth, eth-address (
), pixel, json-rpc-engine, or sdk-meta (server-side HTML head / OpenGraph / Twitter meta) — packages that are
not fully replaced by the main umbrella install alone. Also covers each package's runtime (Node, browser, or both) and dependency placement.
Fetch and HTTP
Read when calling
/
, setting request options or handling results and
s, bounding or cancelling response reads (
,
, client
,
), injecting a custom fetcher, or configuring Node HTTP caching with Undici (consumer-owned).
Conventions
Read for import style (root barrel vs subpaths), ESM only, tree-shaking, deprecations (telemetry re-exports,
, retired 8.x package names, API-level deprecations), how this monorepo relates to the
toolchain (including the monolith layout for maintainers), testing consumers, and the checklist for new code.
Related skills
- xy-development — TypeScript, Git, testing principles and the Definition of Done; this skill builds on it. Install:
npx skills add ariestools/ariestools-skills --skill xy-development
.
- xy-toolchain — the CLI, configs, Vitest, deplint and package policy that sdk-js packages and their consumers build with; this skill builds on it. Install:
npx skills add ariestools/ariestools-skills --skill xy-toolchain
.
- ariestools-sdk-react — React UI on , which imports this SDK's root barrel without declaring it and uses and ; it builds on this skill. Install:
npx skills add ariestools/ariestools-skills --skill ariestools-sdk-react
.
- ariestools-actor — actors, providers and the actor engine from actor-kit, hosted by cli-kit or browser-kit, which build on this SDK's and logger utilities; it builds on this skill. Install:
npx skills add ariestools/ariestools-skills --skill ariestools-actor
.
If a linked skill is not installed, add it with
npx skills add ariestools/ariestools-skills --skill <name>
.