Client-hosted tools

from harnest.agent import client_tool

@client_tool(permission="browser.open")
def browser_open(url: str) -> dict[str, str]:
    """Open a URL and return visible page data."""
    ...

from pydantic import BaseModel
from harnest.agent import client_input
from my_app.accounts import connect_account

class ConnectionInput(BaseModel):
    token: str

@client_input(
    input_schema=ConnectionInput,
    response={"status": "connected"},
    permission="accounts.connect",
)
async def connect(private: ConnectionInput, service: str) -> None:
    """Connect the requested service using credentials supplied by the client."""
    await connect_account(service, private.token)