@orkestrel/toolbox

Concrete, LLM-callable tools for the @orkestrel line — workflow authoring, workspace editing, sub-agent delegation, terminal-mediated prompting, database and relation access, schema inference, and endpoint wrapping — over the @orkestrel/tool runtime, with pluggable stores.

The runtime envelope and registry (ToolInterface, ToolCall, ToolResult, createTool, and createToolManager) live in @orkestrel/tool. This package supplies the concrete handlers that plug into that runtime, including workspace operations over @orkestrel/workspace and agent delegation over @orkestrel/agent.

Install

npm install @orkestrel/toolbox

Example

import { createToolManager } from '@orkestrel/tool'
import { createWorkspaceTool } from '@orkestrel/toolbox'

const tools = createToolManager()
tools.add(createWorkspaceTool())

const result = await tools.execute({
	id: 'write-1',
	name: 'workspace',
	arguments: {
		operation: 'write',
		path: 'notes.txt',
		content: 'hello',
	},
})

Core tools are published from @orkestrel/toolbox; terminal route integration is published from @orkestrel/toolbox/server.

Requirements

• Node.js >= 22
• Dual ESM and CommonJS builds

Guide

See guides/toolbox.md. The vendored guides/tool.md and guides/workspace.md document the runtime dependencies.

License

MIT © Orkestrel — see LICENSE.