Metadata-Version: 2.4
Name: guidebridge
Version: 0.2.0
Summary: Give any Python agent eyes and hands inside your React app: semantic page observation, cursor-led actions, and guided-tour overlays.
License-Expression: MIT
Keywords: agent,ai,fastapi,guided-tour,langchain,react,ui-automation
Requires-Python: >=3.10
Requires-Dist: pydantic>=2.5
Provides-Extra: dev
Requires-Dist: fastapi>=0.110; extra == 'dev'
Requires-Dist: httpx>=0.27; extra == 'dev'
Requires-Dist: langchain-core>=0.2; extra == 'dev'
Requires-Dist: mcp>=1.2; extra == 'dev'
Requires-Dist: pytest-asyncio>=0.23; extra == 'dev'
Requires-Dist: pytest>=8; extra == 'dev'
Requires-Dist: uvicorn>=0.29; extra == 'dev'
Requires-Dist: websockets>=12; extra == 'dev'
Provides-Extra: fastapi
Requires-Dist: fastapi>=0.110; extra == 'fastapi'
Provides-Extra: langchain
Requires-Dist: langchain-core>=0.2; extra == 'langchain'
Provides-Extra: mcp
Requires-Dist: mcp>=1.2; extra == 'mcp'
Description-Content-Type: text/markdown

# guidebridge

Give any Python agent eyes and hands inside your React app: semantic page
observation, cursor-led actions (click, type, scroll, drag), and guided-tour
overlays (highlight, callout) — over a WebSocket to the user's live browser tab.

Pairs with the [`@guidebridge/react`](https://www.npmjs.com/package/@guidebridge/react)
frontend SDK.

```python
from fastapi import FastAPI
from guidebridge import AgentBridge

app = FastAPI()
bridge = AgentBridge()
app.include_router(bridge.router)      # mounts ws endpoint at /agent/ws

tools = bridge.as_langchain_tools()    # or bridge.as_openai_tools()
```

```python
# LangChain / LangGraph
tools = bridge.as_langchain_tools()

# OpenAI / Anthropic / Google ADK — JSON-schema specs + async dispatcher
toolset = bridge.as_openai_tools()
toolset.specs
await toolset.call("click", '{"target_id": "checkout"}')
```

The agent gets 11 tools — `observe_page`, `point_at`, `highlight`, `callout`, `click`,
`type_text`, `select_option`, `scroll_to`, `scroll_by`, `drag`, `app_action` — each
executed in the user's live tab with a visible cursor. Optional extras:
`guidebridge[fastapi]`, `guidebridge[langchain]`.

Full documentation, protocol reference, demo, and security model:
[github.com/pramodthe/guidebridge](https://github.com/pramodthe/guidebridge).

MIT © Pramod Thebe
