forge.tool

Python tool package; imports are explicit from this package.

Package contract

Field	Value
Language	python
Source version	0.1.0
Manifest	`forge-py/pyproject.toml`
Source files	5
Evidence	Source reference; registry publication and runtime conformance are separate checks

Import boundary

import forge.tool

Use a source checkout or your verified private registry. Manifest coordinates identify the package; they do not establish that a public registry release exists.

Download package reference JSON. Each original source file and generated declaration artifact has its own SHA-256 digest. Function bodies and constant values are omitted from downloads. These are source declaration inventories, not compiler-resolved rustdoc, TypeDoc, DocC, or Dokka output. Private modules can contain public declarations that are not reachable through the package boundary; consult the entry point before importing.

approval.py

Read declaration text · 4 declaration entries

class ApprovalHandler(ABC)

async def approve(self, tool_call: ToolCall, tool_definition: ToolDefinition) -> ToolApproval

class AutoApproveHandler(ApprovalHandler)

async def approve(self, tool_call: ToolCall, tool_definition: ToolDefinition) -> ToolApproval

definition.py

Read declaration text · 2 declaration entries

class ToolWithHandler()

def create_tool(name: str, description: str, parameters: JsonSchema, handler: ToolHandler, *, tier: ToolTier=ToolTier.EXTERNAL) -> ToolWithHandler

execution.py

Read declaration text · 3 declaration entries

class ToolExecutor()

def __init__(self, registry: ToolRegistry, approval_handler: ApprovalHandler | None=None) -> None

async def execute(self, tool_call: ToolCall) -> ToolResult

registry.py

Read declaration text · 10 declaration entries

class ToolRegistry()

def __init__(self) -> None

def register(self, tool: ToolWithHandler) -> None

def get(self, name: str) -> ToolWithHandler | None

def get_definition(self, name: str) -> ToolDefinition | None

def get_handler(self, name: str) -> ToolHandler | None

def definitions(self) -> list[ToolDefinition]

def names(self) -> list[str]

def is_empty(self) -> bool

def unregister(self, name: str) -> bool