>> */ private array $tools = []; public function __construct(private readonly Container $container) {} /** * Register one or more tool classes under a namespace. * * @param class-string ...$tools */ public function register(string $namespace, string ...$tools): void { if (! preg_match('/^[a-z][a-z0-9_]*$/', $namespace)) { throw new InvalidArgumentException( "Tool namespace [{$namespace}] must be lower snake case, for example 'landing_page'." ); } foreach ($tools as $tool) { if (! is_subclass_of($tool, Tool::class)) { throw new InvalidArgumentException( "[{$tool}] must implement ".Tool::class.' to be registered as a tool.' ); } } $this->tools[$namespace] = [...$this->tools[$namespace] ?? [], ...$tools]; } /** @return list */ public function namespaces(): array { return array_keys($this->tools); } /** * Resolve every registered tool, each wrapped so the model sees a * namespaced name. * * @param list|null $only limit to these namespaces * @return list */ public function resolve(?array $only = null): array { $resolved = []; foreach ($this->tools as $namespace => $classes) { if ($only !== null && ! in_array($namespace, $only, true)) { continue; } foreach ($classes as $class) { $resolved[] = new NamespacedTool($namespace, $this->container->make($class)); } } return $resolved; } public function count(): int { return array_sum(array_map('count', $this->tools)); } }