# @agoric/internal

> Externally unsupported utilities internal to agoric-sdk

Latest version **0.4.0** (published 2026-04-08) · Apache-2.0 license · 0 weekly downloads

## Install

```sh
npm install @agoric/internal
pnpm add @agoric/internal
yarn add @agoric/internal
bun add @agoric/internal
```

## Health

**Score 50/100 (C)** — status: active.

Positive: esm support; no vulnerabilities.

Warnings: low downloads; no types; pre 1.0.

## Facts

| | |
|---|---|
| Version | 0.4.0 |
| Published | 2026-04-08 |
| First published | 2022-08-22 |
| Weekly downloads | 0 |
| License | Apache-2.0 |
| TypeScript types | none |
| Module format | ESM + CommonJS |
| Node | ^20.9 \|\| ^22.11 |
| Dependencies | 15 |
| Unpacked size | 220.1 KB |
| Known vulnerabilities | 0 |
| Install scripts | no |
| Author | Agoric |
| Maintainers | warner, erights, mhofman, michaelfig, kriskowal, agoricbot, mujahidkay, gibson042, jimlarson, samsiegart |

## Links

- npm: https://www.npmjs.com/package/@agoric/internal
- npm.io page: https://npm.io/package/@agoric/internal

## Dependencies (15)

- [@endo/far](https://npm.io/package/@endo/far.md) ^1.1.14
- [@endo/nat](https://npm.io/package/@endo/nat.md) ^5.1.3
- [anylogger](https://npm.io/package/anylogger.md) ^0.21.0
- [jessie.js](https://npm.io/package/jessie.js.md) ^0.3.4
- [@endo/init](https://npm.io/package/@endo/init.md) ^1.1.12
- [@endo/common](https://npm.io/package/@endo/common.md) ^1.2.13
- [@endo/errors](https://npm.io/package/@endo/errors.md) ^1.2.13
- [@endo/stream](https://npm.io/package/@endo/stream.md) ^1.2.13
- [@endo/marshal](https://npm.io/package/@endo/marshal.md) ^1.8.0
- [@endo/patterns](https://npm.io/package/@endo/patterns.md) ^1.7.0
- [@endo/pass-style](https://npm.io/package/@endo/pass-style.md) ^1.6.3
- [@agoric/base-zone](https://npm.io/package/@agoric/base-zone.md) 0.2.0
- [@endo/promise-kit](https://npm.io/package/@endo/promise-kit.md) ^1.1.13
- [@endo/eventual-send](https://npm.io/package/@endo/eventual-send.md) ^1.3.4
- [@endo/compartment-mapper](https://npm.io/package/@endo/compartment-mapper.md) ^1.6.3

## Recent versions

- 0.4.0 (latest) — 2026-04-08
- 0.3.3-dev-8656b52.0.8656b52 (dev) — 2026-09-09
- 0.5.0-upgrade-23-dev-224776f.0.224776f (upgrade-23-dev) — 2026-08-12
- 0.5.0-u23.1 (agoric-upgrade-23) — 2026-07-20
- 0.4.1-upgrade-22-dev-0922d04.0.0922d04 (upgrade-22-dev) — 2026-04-08
- 0.3.3-other-dev-d15096d.0.d15096d (other-dev) — 2025-11-13
- 0.4.0-u22.2 (agoric-upgrade-22) — 2025-09-09
- 0.4.0-u21.0.1 (agoric-upgrade-21) — 2025-07-29
- 0.3.3-ymax-v0.2-alpha-dev-8e37faa.0 (ymax-v0.2-alpha-dev) — 2025-07-21
- 0.4.0-upgrade-21-dev-16519b2.0 (upgrade-21-dev) — 2025-06-19
- 0.4.0-u21.0 (community-dev) — 2025-06-19
- 0.4.0-upgrade-19-devnet-dev-5428c4d.0 (upgrade-19-devnet-dev) — 2025-04-24
- 0.4.0-upgrade-20-dev-ef71cfd.0 (upgrade-20-dev) — 2025-04-17
- 0.4.0-u20.0 (agoric-upgrade-20) — 2025-04-17
- 0.4.0-upgrade-19-dev-5428c4d.0 (upgrade-19-dev) — 2025-03-13
- … 2796 more at https://npm.io/package/@agoric/internal/versions

## README

**NOTE: unsupported**

# Usage

This package contains code that is required by agoric-sdk and not meant to be imported anywhere else.

Like all `@agoric` packages it follows Semantic Versioning. Unlike the others, it will never have a stable API. In terms of [SemVer spec item 4](https://semver.org/#spec-item-4), it will never reach 1.0:
> Major version zero (0.y.z) is for initial development. Anything MAY change at any time. The public API SHOULD NOT be considered stable.


# Design

It is meant to be a home for modules that have no dependencies on other packages in this repository, except for the following packages that do not theirselves depend upon any other @agoric packages and may be destined for migration elsewhere:

- [base-zone](../base-zone)
- [store](../store)
- [cosmic-proto](../cosmic-proto)

This package may not take dependencies on any others in this repository.

It must never export ambient types.

It should not be imported by deep imports. Eventually this will be enforced by [`exports`](https://nodejs.org/api/packages.html#exports) but the tooling isn't ready:
    - https://github.com/import-js/eslint-plugin-import/issues/1810
    - https://github.com/microsoft/TypeScript/issues/33079 (or some related problem with JSdoc types)

---
_Source: https://npm.io/package/@agoric/internal · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._