defaults

The Robota SDK's built-in default tool set. createDefaultTools() builds the tools an agent session gets when its composition root supplies no tool list of its own, using the tool factories from the neutral and ./node entries of @robota-sdk/agent-tools. It implements no tool itself. File tools that run on the host are contained by the cwd you pass; with a sandboxClient that has its own filesystem, file paths go to the sandbox and cwd does not confine them. Import it at a composition root (the place that assembles an agent), not from library code.

Installation

npm install @robota-sdk/agent-tools @robota-sdk/agent-core

The entry is Node only (browser: null).

Usage

import { ConversationAgent } from '@robota-sdk/agent-core';
import type { IAIProvider } from '@robota-sdk/agent-core';
import { createDefaultTools } from '@robota-sdk/agent-tools/defaults';
 
declare const provider: IAIProvider;
 
const agent = new ConversationAgent({
  name: 'DevAgent',
  aiProviders: [provider],
  defaultModel: { provider: 'anthropic', model: 'claude-sonnet-4-6' },
  tools: createDefaultTools({ cwd: process.cwd() }),
});

createDefaultTools() is synchronous and performs no I/O, and the same options always produce the same set of tools. Every tool is built fresh on each call.

The set holds only tools that need no external service, credential or adapter. A tool that does, such as CodebaseRetrieval or Computer, is built by the composition root that owns the adapter, with createRetrievalTool or createComputerTool from @robota-sdk/agent-tools.

Tools

Tool	Included when
`Shell`, `Bash`	Always
`Read`, `Write`, `Edit`	Always
`Glob`, `Grep`	Unless a `sandboxClient` with a separate filesystem is supplied
`WebFetch`	Always
`AskUserQuestion`	Always

With a sandboxClient, Shell and Bash run commands through the sandbox. When the sandbox has its own filesystem (the default for a client that does not declare filesystem: 'shared'), Read, Write and Edit also go through it, and Glob / Grep are left out because they have no sandbox path. File paths are then passed to the sandbox as given, and cwd does not confine them. When the sandbox shares the host filesystem, file tools stay on the host, contained by cwd.

Options

createDefaultTools(options: ICreateDefaultToolsOptions): FunctionTool[]

Option	Type	Description
`cwd`	`string`	Required. The root that host file tools are contained by (not file tools routed to a separate-filesystem sandbox), and the default working directory for `Shell` / `Bash`.
`sandboxClient`	`ISandboxClient`	Runs commands (and, on a separate filesystem, file tools) in a sandbox.
`shellExecutable`	`string`	Host-selected executable for `Shell` and `Bash`.

ISandboxClient is exported by the main @robota-sdk/agent-tools entry.

@robota-sdk/agent-tools: the tool factories, the tool registry and the sandbox clients.
@robota-sdk/agent-core: the ConversationAgent agent and the tool contract.

See SPEC.md for the package contract.

License

This package is dual-licensed under the GNU AGPL-3.0 or a commercial license. See LICENSING.md.