ariestools-sdk
Aries Tools shared TypeScript/JavaScript libraries published from the sdk-js monorepo. Covers the @ariestools/sdk umbrella (assert, delay, fetch, hex, promise, storage, zod helpers, and other modules), specialist packages (express, storage-adapters, threads, testing, telemetry, crypto-auth, eth-address, pixel, json-rpc-engine, sdk-meta), root-barrel import conventions, runtime peers (zod, OpenTelemetry), the Node 26 baseline, and migration from retired @xylabs/* names. Use when importing, installing, or choosing @ariestools/* packages published from sdk-js, wiring HTTP clients, storage adapters, workers, Express APIs, or Vitest matchers, or replacing @xylabs/* utilities.
How do I install this agent skill?
npx skills add https://github.com/ariestools/ariestools-skills --skill ariestools-sdkIs this agent skill safe to install?
- Gen Agent Trust Hubpass
The skill provides comprehensive documentation and usage patterns for the Aries Tools SDK, a collection of TypeScript/JavaScript libraries maintained by ariestools. It covers core utilities, HTTP clients, and specialized packages for storage adapters, worker threads, and telemetry. The analysis found no malicious behavior; the skill follows standard development practices, references the author's own repositories, and includes guidance on secure handling of credentials and network response policies.
- Socketpass
No alerts
- Snykpass
Risk: LOW · No issues
What does this agent skill do?
Aries Tools SDK
Authority. This skill is maintained only in ariestools/ariestools-skills; edit there, not in installed copies.
Use the active packages from ariestools/sdk-js under the @ariestools/* scope. Do not install retired @xylabs/* 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 @ariestools/sdk-react* belongs to ariestools-sdk-react. Actors, providers and their CLI and browser hosts (@ariestools/actor*, @ariestools/provider*, @ariestools/cli-kit*, @ariestools/browser-kit*) belong to ariestools-actor. Neither covers @ariestools/cli, the aries operator CLI. Toolchain and config packages belong to xy-toolchain.
Runtime. This skill describes sdk-js 9.x, whose packages declare engines.node >=26, 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 metadata.version, never from an example.
References
Overview and install
Read first when choosing the umbrella vs specialist packages, installing @ariestools/sdk (with zod and @opentelemetry/api, which the root barrel loads at runtime), checking the Node >= 26 runtime baseline, or replacing retired @xylabs/* and frozen 8.x @ariestools/* names via the migration map.
Umbrella modules
Read when picking a utility inside @ariestools/sdk (assert, delay, fetch, forget, hex, promise, retry, storage, typeof, logger, …), looking up a module's subpath or /model types, or using platform-conditional modules (platform, url, subtle).
Specialist packages
Read when you need Express helpers, IndexedDB/Mongo adapters, threads/workers, testing matchers, telemetry, crypto-auth, eth-address (EthAddressWrapper), 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 fetchJson / FetchClient, setting request options or handling results and FetchErrors, bounding or cancelling response reads (maxResponseBytes, signal, client timeout, readResponseText), 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, @ariestools/crypto, retired 8.x package names, API-level deprecations), how this monorepo relates to the xy 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
xyCLI, 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
@ariestools/sdk-react*, which imports this SDK's root barrel without declaring it and uses@ariestools/pixeland@ariestools/eth-address; 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
creatableand 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>.
How can the creator link this skill?
Add the canonical catalog link to the repository README so users can inspect current installs and available audits. The publishing guide covers the complete discovery path.
<a href="https://skillzs.dev/skills/ariestools/ariestools-skills/ariestools-sdk">View ariestools-sdk on skillZs</a>