Skip to main content

Dependency maintenance

Reviewed on 2026-11-10 against npm stable dist-tags and official upstream releases. Prereleases are excluded. All 25 external direct dependencies are listed below; internal workspace package versions are unchanged. Root and standalone Monty/mascot lockfiles were refreshed, including compatible transitive updates. npm outdated --json is empty after the refresh.

The audit result from that refresh is historical. A later production-dependency audit found a low-severity documentation dependency advisory with no upstream patch; see the current readiness checkpoint.

DependencyBefore (installed)CurrentPurpose
@types/node24.19.226.6.6Node development types
@types/upng-js2.1.52.1.5APNG development types
@vitest/coverage-v85.1.05.1.0Coverage tooling
@xterm/xterm6.0.06.0.0Real PTY visual bench
git-cliff2.14.22.14.2Changelog tooling
playwright1.65.01.65.0Browser verification
tsx4.23.154.23.15Development TypeScript runner
typescript5.9.37.0.2Compiler/typechecking
vitest5.1.05.1.0Test runner
zod3.25.764.6.7Config, manifests and event validation
ajv8.20.08.20.0Plugin JSON Schema validation
marked17.0.618.1.3Terminal Markdown lexer
react-devtools-core8.0.08.0.0Ink development integration
string-width8.3.08.3.0Terminal cell measurement
jsonc-parser3.3.13.3.1Configuration parsing
undici7.30.28.12.4Model/tool proxy transport
ink8.0.08.0.0Terminal renderer
react19.3.119.3.1Renderer components
@types/react19.3.019.3.0React development types
ink-testing-library4.0.04.0.0Renderer tests
ignore7.0.147.0.14Ignore-aware search
omggif—1.0.10Bounded GIF89a frame decoder
@types/omggif—1.0.5GIF decoder development types
upng-js2.1.02.1.0Original APNG mascot decoding
@pydantic/monty1.5.01.5.0Replaceable native sandbox

Compatibility changes​

  • Node >=22.19.0 is required for development/source execution because Undici 8 raises its minimum. CI tests both the minimum and Node 26 LTS. The compiled core still includes its runtime; Monty retains its separate Node bridge.
  • TypeScript 7 requires explicit ambient Node types in the shared tsconfig. The repository uses its CLI, not the removed legacy compiler JavaScript API.
  • Zod 4 uses explicit record key/value schemas. Refined questionnaire schemas use safeExtend; uniqueness validation and defaults remain intact. Legacy omitted unknown event payloads remain explicitly optional. Public schema conversion replaces private introspection and opaque generated placeholders for all 83 events. Runtime-only refinements still require Zod validation.
  • Undici 8 changes HTTP proxy defaults. Explicit proxyTunnel: true preserves CONNECT for both model and tool traffic. HTTP fixture tests verify payloads, headers, bypass and streaming cancellation; Bun retains its native proxy path.
  • Marked 18 trims trailing block blank lines; existing terminal rendering tests and the real PTY presentation scenario verify the supported Markdown subset.
  • Compatible transitive updates include Vite 8.3.7 and Rolldown 1.2.18. Parent dependency constraints remain authoritative; unrelated transitive major versions are not forced through overrides.

See the Zod migration guide, TypeScript 7 announcement, Undici migration guide and Marked 18 release.

Native tools and CI​

Bun 1.4.4, Callix 1.7.0, git-cliff 2.14.2 and Monty 1.5.0 were already the latest stable releases. Callix keeps its verified platform archive hashes. Harness² upstream HEAD remains 6868817518876de8fd170c6a8354daca273b6191; its Python package is 0.1.0 with no runtime dependencies and requires Python

=3.12,<3.14. Its adapter was checked in an isolated Python 3.13 environment. System Git/ripgrep/Python/uv are host prerequisites, not vendored dependencies; this refresh does not mutate user-wide tool installations.

CI actions are pinned to immutable commits for checkout 7.0.1, setup-node 7.1.0, upload-artifact 7.0.2, download-artifact 8.0.2, setup-bun 2.2.0 and git-cliff-action 4.9.1. JavaScript actions use Node 24 internally and require Actions Runner >=2.327.1. Hosted runners satisfy this independently of the application Node matrix. Artifact digest mismatches fail release verification. See release maintenance for native platform constraints.

Verification​

  • Typechecking and the full suite: 518 passed, 3 optional native cases skipped in the generic run; 25 explicit native Callix tests passed separately.
  • Scripted evals 5/5 and tool-selection evals 3/3; marketplace validation and proxy smoke passed. These do not establish live provider reliability.
  • Event generation, all input/response schema samples and compatibility regressions passed. npm audit reports zero vulnerabilities (previously one high Zod advisory); this is an advisory database result, not a security proof.
  • The real PTY visual scenario passed layout, input, plugins and persistence; captured screenshots were visually inspected. OSC 22 behavior in this bench is browser emulation, not GNOME Terminal pointer support.
  • Linux x64 release build and installer smoke passed, including default plugins, bundled Callix edits, checksum rejection and workflow execution. Other native targets require their release runners. No release was published.

Upgrades should refresh all manifests and lockfiles together, inspect upstream migration notes, run these checks and review generated contracts. Keep exact native pins/checksums and do not use forced peer resolutions to hide conflicts.

The subsequent Ghost media integration adds omggif 1.0.10 and its types 1.0.5 (verified npm stable tags). Decoding is pure JavaScript and requires no FFmpeg binary in releases. See the media plugin for GIF compositing, decoder budgets, source-clock playback and SIXEL support.

Documentation toolchain — 2026-11-11​

The website workspace adds Docusaurus core/preset-classic 3.10.2, local search 0.55.3, Prism React Renderer and React DOM. It builds static documentation for GitHub Pages and does not become a native application runtime dependency. React remains shared with the monorepo where the peer ranges permit it.

Root overrides replace Docusaurus's older Tinypool with 2.2.0 or later, serialize-javascript with 7.1.4 or later, and SockJS's UUID with compatible CommonJS UUID 11.1.1 or later. Validate the site build, dev preview and search after updating those overrides; do not remove them without reviewing the upstream dependency ranges and advisories.

The installation audit after these changes reports no moderate, high or critical advisories. Five low-severity entries trace to deepmerge 4.3.1 through the build-time SVGR chain. Upstream has no patched stable deepmerge release at this review; the published static site does not execute that build dependency. Track GHSA-gcqx-w48m-w2h4 and recheck with npm audit when updating the documentation dependencies.