JSPM

  • ESM via JSPM
  • ES Module Entrypoint
  • Export Map
  • Keywords
  • License
  • Repository URL
  • TypeScript Types
  • README
  • Created
  • Published
  • Downloads 664
  • Score
    100M100P100Q96664F

Package Exports

  • @dexto/core
  • @dexto/core/package.json

Readme

@dexto/core

TypeScript 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

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();

// Run tasks
const response = await agent.run('List the 5 largest files in this repo');
console.log(response);

// Hold conversations
await agent.run('Write a haiku about TypeScript');
await agent.run('Make it funnier');

await agent.stop();

See the TypeScript SDK docs for full examples with MCP tools, sessions, and advanced features: https://docs.dexto.ai/api/category/typescript-sdk/

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.run('Hello, how can you help me?', undefined, 'user-123');

// 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.

const agent = new DextoAgent({
  llm: { /* ... */ },
  internalTools: ['delegate_to_url'] // Enable delegation tool
});
await agent.start();

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

// Or call the tool directly
const tools = await agent.getAllTools();
const delegateTool = tools.find(t => t.name === 'internal--delegate_to_url');
// The tool is prefixed with 'internal--' by the ToolManager

Configuration (YAML):

internalTools:
  - 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://docs.dexto.ai/api/dexto-agent/

License

Elastic License 2.0. See the repository LICENSE for details.