@dexto/core

中文文档

1.17.0发布于 2026/11/10TypeScriptESM + CJS近 30 天下载 1.8万

The Dexto Agent SDK for building agentic applications programmatically. This package powers the Dexto CLI and lets you embed the same agent runtime in your own apps.

文档目录12 节

Installation
Optional Dependencies
Quick Start
Starting a Server
Session Management
LLM Management
MCP Manager
Agent-to-Agent Delegation
Telemetry
Logger
Links
License

@dexto/core

The Dexto Agent SDK for building agentic applications programmatically. This package powers the Dexto CLI and lets you embed the same agent runtime in your own apps.

Installation

npm install @dexto/core

Optional Dependencies

Some features require additional packages. Install only what you need:

# Telemetry (OpenTelemetry distributed tracing)
npm install @opentelemetry/sdk-node @opentelemetry/auto-instrumentations-node \
  @opentelemetry/resources @opentelemetry/semantic-conventions \
  @opentelemetry/sdk-trace-base @opentelemetry/exporter-trace-otlp-http

# For gRPC telemetry export protocol
npm install @opentelemetry/exporter-trace-otlp-grpc

# Storage backends
npm install better-sqlite3  # SQLite database
npm install pg              # PostgreSQL database
npm install ioredis         # Redis cache

# TypeScript plugin support
npm install tsx

If you configure a feature without its dependencies, you'll get a helpful error message with the exact install command.

Note: The dexto CLI package includes all optional dependencies. These are only needed when using @dexto/core directly as a library.

Quick Start

import { DextoAgent } from '@dexto/core';

// Create and start agent
const agent = new DextoAgent({
  llm: {
    provider: 'openai',
    model: 'gpt-5-mini',
    apiKey: process.env.OPENAI_API_KEY
  }
});
await agent.start();

// Create a session for the conversation
const session = await agent.createSession();

// Use generate() for simple request/response
const response = await agent.generate('What is TypeScript?', session.id);
console.log(response.content);

// Conversations maintain context within a session
await agent.generate('Write a haiku about it', session.id);
await agent.generate('Make it funnier', session.id);

// Multimodal: send images or files
await agent.generate([
  { type: 'text', text: 'Describe this image' },
  { type: 'image', image: base64Data, mimeType: 'image/png' }
], session.id);

// Streaming for real-time UIs
for await (const event of await agent.stream('Write a story', session.id)) {
  if (event.name === 'llm:chunk') process.stdout.write(event.content);
}

await agent.stop();

See the Dexto Agent SDK docs for multimodal content, streaming, MCP tools, and advanced features.

Starting a Server

Start a Dexto server programmatically to expose REST and SSE streaming APIs to interact and manage your agent backend.

import { DextoAgent } from '@dexto/core';
import { startHonoApiServer } from 'dexto';

// Create and configure agent
const agent = new DextoAgent({
  llm: {
    provider: 'openai',
    model: 'gpt-5-mini',
    apiKey: process.env.OPENAI_API_KEY
  },
  mcpServers: {
    filesystem: {
      type: 'stdio',
      command: 'npx',
      args: ['-y', '@modelcontextprotocol/server-filesystem', '.']
    }
  }
});

// Start server on port 3001
const { server } = await startHonoApiServer(agent, 3001);

console.log('Dexto server running at http://localhost:3001');
// Server provides REST API and SSE streaming endpoints
// POST /api/message - Send messages
// GET /api/sessions - List sessions
// See cli.dexto.ai/api/rest/ for all endpoints

This starts an HTTP server with full REST and SSE APIs, enabling integration with web frontends, webhooks, and other services. See the REST API Documentation for available endpoints.

Session Management

Create and manage multiple conversation sessions with persistent storage.

const agent = new DextoAgent(config);
await agent.start();

// Create and manage sessions
const session = await agent.createSession('user-123');
await agent.generate('Hello, how can you help me?', session.id);

// List and manage sessions
const sessions = await agent.listSessions();
const sessionHistory = await agent.getSessionHistory('user-123');
await agent.deleteSession('user-123');

// Search across conversations
const results = await agent.searchMessages('bug fix', { limit: 10 });

LLM Management

Switch between models and providers dynamically.

// Get current configuration
const currentLLM = agent.getCurrentLLMConfig();

// Switch models (provider inferred automatically)
await agent.switchLLM({ model: 'gpt-5-mini' });
await agent.switchLLM({ model: 'claude-sonnet-4-5-20250929' });

// Switch model for a specific session id 1234
await agent.switchLLM({ model: 'gpt-5-mini' }, '1234')

// Get supported providers and models
const providers = agent.getSupportedProviders();
const models = agent.getSupportedModels();
const openaiModels = agent.getSupportedModelsForProvider('openai');

MCP Manager

For advanced MCP server management, use the MCPManager directly.

import { MCPManager } from '@dexto/core';

const manager = new MCPManager();

// Connect to MCP servers
await manager.connectServer('filesystem', {
  type: 'stdio',
  command: 'npx',
  args: ['-y', '@modelcontextprotocol/server-filesystem', '.']
});

// Access tools, prompts, and resources
const tools = await manager.getAllTools();
const prompts = await manager.getAllPrompts();
const resources = await manager.getAllResources();

// Execute tools
const result = await manager.executeTool('readFile', { path: './README.md' });

await manager.disconnectAll();

Agent-to-Agent Delegation

Delegate tasks to other A2A-compliant agents using the built-in delegate_to_url tool.

import { builtinToolsFactory } from '@dexto/tools-builtins';

const tools = builtinToolsFactory.create({
  type: 'builtin-tools',
  enabledTools: ['delegate_to_url'],
});

const agent = new DextoAgent({
  llm: { /* ... */ },
  logger,   // provide a per-agent logger instance
  storage,  // provide cache/database/blob implementations
  tools,
  permissions: { mode: 'auto-approve' }
});
await agent.start();

const session = await agent.createSession();

// Delegate via natural language
await agent.generate(`
  Please delegate this task to the PDF analyzer agent at http://localhost:3001:
  "Extract all tables from the Q4 sales report"
`, session.id);

// Or call the tool directly
await agent.executeTool('delegate_to_url', {
  url: 'http://localhost:3001',
  message: 'Extract all tables from the Q4 sales report',
});

Configuration (YAML):

tools:
  - type: builtin-tools
    enabledTools:
      - delegate_to_url

What it provides:

Point-to-point delegation when you know the agent URL
A2A Protocol v0.3.0 compliant (JSON-RPC transport)
Session management for stateful multi-turn conversations
Automatic endpoint discovery (/v1/jsonrpc, /jsonrpc)
Timeout handling and error recovery

Use cases:

Multi-agent systems with known agent URLs
Delegation to specialized agents
Building agent workflows and pipelines
Testing agent-to-agent communication

Telemetry

Built-in OpenTelemetry distributed tracing for observability.

const agent = new DextoAgent({
  llm: { /* ... */ },
  telemetry: {
    enabled: true,
    serviceName: 'my-agent',
    export: {
      type: 'otlp',
      endpoint: 'http://localhost:4318/v1/traces'
    }
  }
});

Automatically traces agent operations, LLM calls with token usage, and tool executions. See src/telemetry/README.md for details.

Logger

Multi-transport logging system (v2) with console, file, and remote transports. Configure in agent YAML:

logger:
  level: info  # error | warn | info | debug | silly
  transports:
    - type: console
      colorize: true
    - type: file
      path: ./logs/agent.log
      maxSize: 10485760
      maxFiles: 5

CLI automatically adds per-agent file transport at ~/.dexto/logs/<agent-id>.log. See architecture in src/logger/v2/.

See the DextoAgent API reference for all methods: https://cli.dexto.ai/api/dexto-agent/

License

Elastic License 2.0. See the repository LICENSE for details.

版本与发布记录

@dexto/core 共发布 111 个版本，首次发布于 2025/09/12；过去 12 个月发布了 98 个版本。

版本	发布日期	距今
`1.17.0`latest	2026/11/10	2 天前
`1.16.6`	2026/11/09	3 天前
`1.16.5`	2026/11/09	3 天前
`1.16.4`	2026/11/09	3 天前
`1.16.3`	2026/11/09	3 天前
`1.16.2`	2026/11/09	3 天前

其他发布通道：next → 1.15.0-beta.4。

关于 @dexto/core 的常见问题

@dexto/core 是什么？

The Dexto Agent SDK for building agentic applications programmatically. This package powers the Dexto CLI and lets you embed the same agent runtime in your own apps.

如何安装 @dexto/core？

在项目目录运行 npm install @dexto/core，或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖：zod（^4.3.6）。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖，Yarn 需要手动安装。

@dexto/core 支持 TypeScript 吗？

支持。包内自带 TypeScript 类型声明（package.json 声明了 types 入口），安装后即可获得类型提示，无需再安装 @types 包。

@dexto/core 支持 ESM 还是 CommonJS？

同时提供 ES Module 与 CommonJS 入口，import 和 require() 都可以使用，打包工具会自动选择合适的版本。

@dexto/core 可以商用吗？

@dexto/core 使用未声明许可。package.json 没有声明许可证。没有许可证的代码默认保留全部权利，商用前请联系作者或查看仓库中的 LICENSE 文件。以上为概括，不构成法律意见，请以许可原文为准。

@dexto/core 的下载量有多少？

根据 npm 官方下载统计，@dexto/core 在 2026/10/12 – 2026/11/10 这 30 天内被下载 18,489 次，日均约 616 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。

@dexto/core 还在维护吗？

最新版本 1.17.0 发布于 2026/11/10（2 天前）；至今共发布 111 个版本，其中过去 12 个月发布了 98 个；首次发布于 2025/09/12。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。

npm install @dexto/core

pnpmpnpm add @dexto/core
yarnyarn add @dexto/core
bunbun add @dexto/core

peer 依赖pg ^8.15.4可选tsx ^4.23.15可选zod ^4.3.6ioredis ^5.7.0可选better-sqlite3 ^11.10.0可选@opentelemetry/core ^2.12.0可选@opentelemetry/sdk-node ^0.223.0可选@opentelemetry/resources ^2.12.0可选@opentelemetry/sdk-trace-base ^2.12.0可选@opentelemetry/instrumentation-http ^0.223.0可选@opentelemetry/semantic-conventions ^1.28.0可选@opentelemetry/instrumentation-undici ^0.33.0可选@opentelemetry/exporter-trace-otlp-grpc ^0.223.0可选@opentelemetry/exporter-trace-otlp-http ^0.223.0可选

npm 7+ 与 pnpm 8+ 会自动安装必需的 peer 依赖，Yarn 需手动安装。

在你的项目目录中运行此命令。

近 30 天下载

18,489

约 1.8万次日均 616 次

统计周期 2026/10/12 – 2026/11/10
数据来自 npm 官方下载统计，今天更新

最新版本1.17.0发布于 2 天前

开源许可未声明未声明

包体积4.2 MB1,062 个文件 · 解压后

运行依赖25 个另有 14 个 peer 依赖

模块格式ESM + CJS

TypeScript自带类型

发布版本111 个近 12 个月 98 个

首次发布2025/09/121.2 年前

元数据更新2026/11/10

每一个软件包背后，
都有分享与创造的人。

@dexto/core

@dexto/core

Installation

Optional Dependencies

Quick Start

Starting a Server

Session Management

LLM Management

MCP Manager

Agent-to-Agent Delegation

Telemetry

Logger

Links

License

版本与发布记录

关于 @dexto/core 的常见问题

@dexto/core 是什么？

如何安装 @dexto/core？

@dexto/core 支持 TypeScript 吗？

@dexto/core 支持 ESM 还是 CommonJS？

@dexto/core 可以商用吗？

@dexto/core 的下载量有多少？

@dexto/core 还在维护吗？