@dex-ai/core-extensions

The minimum extension set every Dex agent needs. Pure TypeScript, zero native dependencies.

What's included

| Extension | Description | | ----------- | ------------------------------------------------------------ | | tools | File read/write/edit, search (grep + find), bash shell | | session | File-based session persistence (JSONL) | | skills | File-based skill loader (~/.dex/skills/) with get_skill tool |

Usage

import {
  allFsExtensions,
  bashExtension,
  sessionExtension,
  skillsExtension,
} from "@dex-ai/core-extensions";

const agent = await Agent.create({
  provider: "anthropic",
  model: "claude-sonnet-4-20250514",
  extensions: [
    ...allFsExtensions({ cwd: process.cwd() }),
    bashExtension({ cwd: process.cwd() }),
    sessionExtension({ dir: "~/.dex/sessions", sessionId: "abc-123" }),
    skillsExtension(),
  ],
});

Sub-path imports

For tree-shaking or clarity, you can import from specific sub-paths:

import { allFsExtensions, bashExtension } from "@dex-ai/core-extensions/tools";
import { sessionExtension } from "@dex-ai/core-extensions/session";
import { skillsExtension, loadSkill } from "@dex-ai/core-extensions/skills";

Package architecture

This is a facade package that re-exports from the underlying implementation packages:

• @dex-ai/tools-extension
• @dex-ai/session-extension
• @dex-ai/skills-extension

The implementation packages remain available for internal use but consumers should prefer @dex-ai/core-extensions as the public API.