@dex-ai/core-extensions 0.1.5

package/README.md

@@ -0,0 +1,53 @@
+# @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
+
+```typescript
+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:
+
+```typescript
+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.

package/package.json

@@ -0,0 +1,51 @@
+{
+  "name": "@dex-ai/core-extensions",
+  "version": "0.1.5",
+  "description": "Core extensions for @dex-ai/sdk — tools (read/write/edit/search/bash), session persistence, and skills loader. Always shipped.",
+  "type": "module",
+  "exports": {
+    ".": {
+      "types": "./src/index.ts",
+      "default": "./src/index.ts"
+    },
+    "./tools": {
+      "types": "./src/tools.ts",
+      "default": "./src/tools.ts"
+    },
+    "./session": {
+      "types": "./src/session.ts",
+      "default": "./src/session.ts"
+    },
+    "./skills": {
+      "types": "./src/skills.ts",
+      "default": "./src/skills.ts"
+    },
+    "./tasks": {
+      "types": "./src/tasks.ts",
+      "default": "./src/tasks.ts"
+    },
+    "./ask": {
+      "types": "./src/ask.ts",
+      "default": "./src/ask.ts"
+    }
+  },
+  "files": [
+    "src"
+  ],
+  "scripts": {
+    "typecheck": "tsc --noEmit",
+    "test": "echo \"(no tests — covered by sub-packages)\""
+  },
+  "dependencies": {
+    "@dex-ai/tools-extension": "^0.1.2",
+    "@dex-ai/session-extension": "^0.1.2",
+    "@dex-ai/skills-extension": "^0.2.2",
+    "@dex-ai/tasks-extension": "^0.1.0",
+    "@dex-ai/ask-extension": "^0.1.0"
+  },
+  "sideEffects": false,
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
+  }
+}

package/src/ask.ts

@@ -0,0 +1,16 @@
+/**
+ * @dex-ai/core-extensions/ask — direct sub-path for ask only.
+ */
+export { askExtension } from "@dex-ai/ask-extension";
+export type {
+	AskOption,
+	AskTab,
+	AskRequest,
+	AskTabResult,
+	AskResult,
+	AskResultSubmit,
+	AskResultEject,
+	AskResultCancel,
+	AskExtensionOptions,
+} from "@dex-ai/ask-extension";
+export { ASK_REQUEST_KEY, ASK_RESULT_KEY } from "@dex-ai/ask-extension";

package/src/index.ts

@@ -0,0 +1,87 @@
+/**
+ * @dex-ai/core-extensions — the minimum every Dex agent needs.
+ *
+ * Re-exports:
+ *   - tools (read, write, edit, search, bash)
+ *   - session persistence (file-based JSONL)
+ *   - skills loader (file-based skill catalog)
+ *
+ * All pure TypeScript, zero native dependencies.
+ *
+ * Usage:
+ *   import {
+ *     allFsExtensions, bashExtension,
+ *     sessionExtension,
+ *     skillsExtension,
+ *   } from '@dex-ai/core-extensions';
+ */
+
+// --- Tools ---
+export {
+	readFileExtension,
+	writeFileExtension,
+	editFileExtension,
+	searchExtension,
+	bashExtension,
+	allFsExtensions,
+	resolveInCwd,
+	PathOutsideCwdError,
+	resolveCwd,
+	resolveRoots,
+} from "@dex-ai/tools-extension";
+export type {
+	ReadFileExtensionOptions,
+	WriteFileExtensionOptions,
+	EditFileExtensionOptions,
+	SearchExtensionOptions,
+	SearchMatch,
+	BashExtensionOptions,
+	AllFsExtensionOptions,
+	CwdProvider,
+	RootsProvider,
+	ResolveOptions,
+} from "@dex-ai/tools-extension";
+
+// --- Session ---
+export { sessionExtension } from "@dex-ai/session-extension";
+export type { SessionExtensionOptions } from "@dex-ai/session-extension";
+
+// --- Skills ---
+export { skillsExtension, loadSkill } from "@dex-ai/skills-extension";
+export type {
+	SkillsExtensionOptions,
+	ParsedSkill,
+} from "@dex-ai/skills-extension";
+
+// --- Tasks ---
+export { tasksExtension } from "@dex-ai/tasks-extension";
+export type { Task, TaskStatus, TaskEvent } from "@dex-ai/tasks-extension";
+export {
+	TASKS_STATE_KEY,
+	computeHeader,
+	computeVisibleItems,
+	statusIcon,
+} from "@dex-ai/tasks-extension";
+export type {
+	TaskPanelHeader,
+	TaskPanelItem,
+	TaskPanelList,
+} from "@dex-ai/tasks-extension";
+
+// --- Ask ---
+export {
+	askExtension,
+	ASK_REQUEST_KEY,
+	ASK_RESULT_KEY,
+} from "@dex-ai/ask-extension";
+export type {
+	AskOption,
+	AskTab,
+	AskRequest,
+	AskTabResult,
+	AskResult,
+	AskResultSubmit,
+	AskResultEject,
+	AskResultCancel,
+	AskExtensionOptions,
+} from "@dex-ai/ask-extension";

package/src/session.ts

@@ -0,0 +1,5 @@
+/**
+ * @dex-ai/core-extensions/session — direct sub-path for session only.
+ */
+export { sessionExtension } from "@dex-ai/session-extension";
+export type { SessionExtensionOptions } from "@dex-ai/session-extension";

package/src/skills.ts

@@ -0,0 +1,8 @@
+/**
+ * @dex-ai/core-extensions/skills — direct sub-path for skills only.
+ */
+export { skillsExtension, loadSkill } from "@dex-ai/skills-extension";
+export type {
+	SkillsExtensionOptions,
+	ParsedSkill,
+} from "@dex-ai/skills-extension";

package/src/tasks.ts

@@ -0,0 +1,18 @@
+/**
+ * @dex-ai/core-extensions/tasks — direct sub-path for tasks only.
+ */
+export { tasksExtension } from "@dex-ai/tasks-extension";
+export type {
+	Task,
+	TaskStatus,
+	TaskEvent,
+	TaskPanelHeader,
+	TaskPanelItem,
+	TaskPanelList,
+} from "@dex-ai/tasks-extension";
+export {
+	TASKS_STATE_KEY,
+	computeHeader,
+	computeVisibleItems,
+	statusIcon,
+} from "@dex-ai/tasks-extension";

package/src/tools.ts

@@ -0,0 +1,20 @@
+/**
+ * @dex-ai/core-extensions/tools — direct sub-path for tools only.
+ */
+export {
+	readFileExtension,
+	writeFileExtension,
+	editFileExtension,
+	searchExtension,
+	bashExtension,
+	allFsExtensions,
+} from "@dex-ai/tools-extension";
+export type {
+	ReadFileExtensionOptions,
+	WriteFileExtensionOptions,
+	EditFileExtensionOptions,
+	SearchExtensionOptions,
+	SearchMatch,
+	BashExtensionOptions,
+	AllFsExtensionOptions,
+} from "@dex-ai/tools-extension";