1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
|
"""Registry of tools exposed to the LLM."""
from __future__ import annotations
import json
from collections.abc import Callable, Sequence
from dataclasses import dataclass, field
from .scrape import scrape_url
from .search import web_search
@dataclass
class ToolRegistry:
"""A simple registry mapping tool names to callable implementations."""
_tools: dict[str, Callable[..., object]] = field(default_factory=dict)
def register(self, func: Callable[..., object]) -> Callable[..., object]:
"""Register a callable under its ``__name__``."""
self._tools[func.__name__] = func
return func
@property
def names(self) -> list[str]:
return list(self._tools.keys())
@property
def callables(self) -> list[Callable[..., object]]:
return list(self._tools.values())
def get(self, name: str) -> Callable[..., object] | None:
return self._tools.get(name)
def execute(self, name: str, arguments: dict[str, object] | str) -> str:
"""Execute a named tool and return a JSON-encoded string result.
Args:
name: The tool function name.
arguments: Either a dict of keyword arguments or a JSON string that
decodes to one.
Returns:
A JSON string representation of the tool's return value, or an error
object when the tool is unknown or raises.
"""
func = self.get(name)
if func is None:
return json.dumps({"error": f"Unknown tool: {name}"})
if isinstance(arguments, str):
try:
arguments = json.loads(arguments) if arguments else {}
except json.JSONDecodeError:
return json.dumps({"error": f"Invalid JSON arguments for {name}: {arguments}"})
try:
result = func(**arguments)
except Exception as exc: # noqa: BLE001
return json.dumps({"error": f"{type(exc).__name__}: {exc}"})
if isinstance(result, str):
return result
try:
return json.dumps(result, ensure_ascii=False, default=str)
except (TypeError, ValueError):
return str(result)
def default_registry() -> ToolRegistry:
"""Build a registry pre-loaded with the built-in tools."""
reg = ToolRegistry()
reg.register(web_search)
reg.register(scrape_url)
return reg
def all_tool_callables(registry: ToolRegistry | None = None) -> Sequence[Callable[..., object]]:
"""Return the list of callables suitable for ``ollama`` ``tools`` argument."""
reg = registry or default_registry()
return reg.callables
|
