ToolRegistry

import { ToolRegistry } from '@frontmcp/sdk';

// Access via scope
const tools = scope.tools;

// List all tools
const allTools = tools.getTools();

// Find a specific tool
const tool = tools.findByName('my_tool');

getTools(includeHidden?: boolean): ReadonlyArray<ToolEntry>

// Get all visible tools
const tools = registry.getTools();

// Include hidden tools
const allTools = registry.getTools(true);

getToolsForListing(supportsElicitation?: boolean): ReadonlyArray<ToolEntry>

// For clients that support elicitation
const tools = registry.getToolsForListing(true);

// For clients that don't support elicitation
const tools = registry.getToolsForListing(false);

findByName(name: string): ToolEntry | undefined

const tool = registry.findByName('search');
if (tool) {
  console.log(`Found: ${tool.qualifiedId}`);
}

findByQualifiedName(qualifiedName: string): ToolEntry | undefined

// Find tool with owner prefix
const tool = registry.findByQualifiedName('my-app:search');

getExported(name: string, opts?: { ignoreCase?: boolean }): ToolEntry | undefined

// Case-sensitive lookup
const tool = registry.getExported('Search_Tool');

// Case-insensitive lookup
const tool = registry.getExported('search_tool', { ignoreCase: true });

exportResolvedNames(opts?: ExportResolvedNamesOptions): Map<string, ToolEntry>

const exportedNames = registry.exportResolvedNames();
for (const [name, tool] of exportedNames) {
  console.log(`${name} → ${tool.qualifiedId}`);
}
// Output:
// search → app1:search
// app2_search → app2:search (conflict resolved with prefix)

getInlineTools(): ReadonlyArray<ToolEntry>

listAllInstances(): ReadonlyArray<ToolEntry>

listByOwner(ownerPath: string): ReadonlyArray<ToolEntry>

// Get all tools owned by 'my-app'
const appTools = registry.listByOwner('my-app');

registerToolInstance(tool: ToolInstance): void

subscribe(
  opts: SubscribeOptions,
  cb: (event: ToolChangeEvent) => void
): () => void

const unsubscribe = registry.subscribe({}, (event) => {
  console.log(`Tool ${event.kind}:`, event.entry?.name);
});

// Later: stop listening
unsubscribe();

getCapabilities(): { listChanged: boolean }

const caps = registry.getCapabilities();
// { listChanged: true }

hasAny(): boolean

adoptFromChild(child: ToolRegistry, childOwner: Owner): void

interface ToolChangeEvent {
  kind: 'added' | 'updated' | 'removed' | 'reset';
  changeScope: 'global' | 'session';
  version: number;
  snapshot: ReadonlyArray<ToolEntry>;
  entry?: ToolEntry;
  sessionId?: string;
  relatedRequestId?: string;
}