|
| 1 | +/** |
| 2 | + * @license |
| 3 | + * Copyright 2025 Autohand AI LLC |
| 4 | + * SPDX-License-Identifier: Apache-2.0 |
| 5 | + */ |
| 6 | +import type { ToolsRegistry } from '../core/toolsRegistry.js'; |
| 7 | + |
| 8 | +export interface ToolsCommandContext { |
| 9 | + toolsRegistry?: ToolsRegistry; |
| 10 | +} |
| 11 | + |
| 12 | +function renderUsage(): string { |
| 13 | + return [ |
| 14 | + 'Usage: /tools [list|show|doctor|disable|enable|rename|delete]', |
| 15 | + '', |
| 16 | + 'Commands:', |
| 17 | + ' /tools list', |
| 18 | + ' /tools show <name>', |
| 19 | + ' /tools doctor', |
| 20 | + ' /tools disable <name>', |
| 21 | + ' /tools enable <name>', |
| 22 | + ' /tools rename <name> <new_name>', |
| 23 | + ' /tools delete <name>', |
| 24 | + ].join('\n'); |
| 25 | +} |
| 26 | + |
| 27 | +function renderToolList(registry: ToolsRegistry): string { |
| 28 | + const tools = registry.listMetaTools({ includeDisabled: true }); |
| 29 | + if (tools.length === 0) { |
| 30 | + return 'No meta-tools are installed.'; |
| 31 | + } |
| 32 | + return tools |
| 33 | + .map((tool) => { |
| 34 | + const state = tool.disabled ? 'disabled' : 'enabled'; |
| 35 | + return `${tool.name} ${tool.scope} ${state} ${tool.description}`; |
| 36 | + }) |
| 37 | + .join('\n'); |
| 38 | +} |
| 39 | + |
| 40 | +function renderTool(registry: ToolsRegistry, name: string): string { |
| 41 | + const tool = registry.listMetaTools({ includeDisabled: true }).find((candidate) => candidate.name === name); |
| 42 | + if (!tool) { |
| 43 | + return `Meta-tool "${name}" not found.`; |
| 44 | + } |
| 45 | + return [ |
| 46 | + `${tool.name}`, |
| 47 | + `Description: ${tool.description}`, |
| 48 | + `Scope: ${tool.scope}`, |
| 49 | + `State: ${tool.disabled ? 'disabled' : 'enabled'}`, |
| 50 | + `Source: ${tool.source}`, |
| 51 | + `Created: ${tool.createdAt}`, |
| 52 | + `Updated: ${tool.updatedAt ?? tool.createdAt}`, |
| 53 | + `Handler: ${tool.handler}`, |
| 54 | + `Parameters: ${JSON.stringify(tool.parameters, null, 2)}`, |
| 55 | + ].join('\n'); |
| 56 | +} |
| 57 | + |
| 58 | +function renderDiagnostics(registry: ToolsRegistry): string { |
| 59 | + const diagnostics = registry.getDiagnostics(); |
| 60 | + if (diagnostics.length === 0) { |
| 61 | + return 'No meta-tool diagnostics.'; |
| 62 | + } |
| 63 | + return diagnostics.map((diagnostic) => `${diagnostic.file}: ${diagnostic.reason}`).join('\n'); |
| 64 | +} |
| 65 | + |
| 66 | +export async function tools(ctx: ToolsCommandContext, args: string[] = []): Promise<string> { |
| 67 | + const registry = ctx.toolsRegistry; |
| 68 | + if (!registry) { |
| 69 | + return 'Tools registry not available.'; |
| 70 | + } |
| 71 | + |
| 72 | + const subcommand = (args[0] ?? 'list').toLowerCase(); |
| 73 | + switch (subcommand) { |
| 74 | + case 'list': |
| 75 | + case 'ls': |
| 76 | + return renderToolList(registry); |
| 77 | + case 'show': |
| 78 | + case 'inspect': { |
| 79 | + const name = args[1]; |
| 80 | + return name ? renderTool(registry, name) : renderUsage(); |
| 81 | + } |
| 82 | + case 'doctor': |
| 83 | + case 'diagnostics': |
| 84 | + return renderDiagnostics(registry); |
| 85 | + case 'disable': { |
| 86 | + const name = args[1]; |
| 87 | + if (!name) return renderUsage(); |
| 88 | + await registry.setMetaToolDisabled(name, true); |
| 89 | + return `Disabled ${name}`; |
| 90 | + } |
| 91 | + case 'enable': { |
| 92 | + const name = args[1]; |
| 93 | + if (!name) return renderUsage(); |
| 94 | + await registry.setMetaToolDisabled(name, false); |
| 95 | + return `Enabled ${name}`; |
| 96 | + } |
| 97 | + case 'rename': { |
| 98 | + const [name, newName] = args.slice(1); |
| 99 | + if (!name || !newName) return renderUsage(); |
| 100 | + await registry.renameMetaTool(name, newName); |
| 101 | + return `Renamed ${name} to ${newName}`; |
| 102 | + } |
| 103 | + case 'delete': |
| 104 | + case 'remove': |
| 105 | + case 'rm': { |
| 106 | + const name = args[1]; |
| 107 | + if (!name) return renderUsage(); |
| 108 | + await registry.deleteMetaTool(name); |
| 109 | + return `Deleted ${name}`; |
| 110 | + } |
| 111 | + default: |
| 112 | + return renderUsage(); |
| 113 | + } |
| 114 | +} |
| 115 | + |
| 116 | +export const metadata = { |
| 117 | + command: '/tools', |
| 118 | + description: 'List, inspect, disable, rename, or delete persisted meta-tools', |
| 119 | + implemented: true, |
| 120 | + subcommands: [ |
| 121 | + { name: 'list', description: 'List installed meta-tools' }, |
| 122 | + { name: 'show', description: 'Show one meta-tool definition' }, |
| 123 | + { name: 'doctor', description: 'Show skipped or invalid meta-tool diagnostics' }, |
| 124 | + { name: 'disable', description: 'Disable a meta-tool without deleting it' }, |
| 125 | + { name: 'enable', description: 'Re-enable a disabled meta-tool' }, |
| 126 | + { name: 'rename', description: 'Rename a persisted meta-tool' }, |
| 127 | + { name: 'delete', description: 'Delete a persisted meta-tool' }, |
| 128 | + ], |
| 129 | +}; |
0 commit comments