*QjUdZddlmZ d5 d6dZedddd d d idged d dd dd idgedddd dd idgeddiedddd gdddigedddd dd idgedd d!d d"d id!ged#d$d%d&d d d'd d(d)ged*d+ig Zd,ed-<ed.eDZd/ed0<dd d1ddddd#d*d2 Zd3ed4<y)7uDevice-tool schemas — the tools the brain CALLS but the PHONE EXECUTES. These are exposed to the LLM exactly like the server-side tools in ``tools.py``, but they don't run in the gateway: when the brain calls one, the gateway resolves any saved state it needs (a place for ``navigate``, a contact number for ``call_contact``), emits a WS ``action`` frame to the connected phone, and waits for the matching ``action_result`` (see ``main.Session`` — the bridge — and APP_PLAN.md §3b for the wire protocol). The result string is fed back into the brain's tool loop. This module holds ONLY the schemas + the name set; the executor/bridge lives on ``main.Session`` because it needs the live WebSocket and the phone store. Keeping the schemas here lets ``main`` build the brain's toolset as ``tools.TOOL_SPECS + device_tools.DEVICE_TOOL_SPECS`` without a circular import. The ``action`` name each tool maps to on the wire (what the phone switches on): navigate -> "navigate" call_contact -> "call" play_music -> "play_music" take_screenshot -> "take_screenshot" open_camera -> "open_camera" open_app -> "open_app" open_url -> "open_url" set_timer -> "set_timer" get_location -> "get_location" ) annotationsNnamec$d||d||xsgdddS)Nfunctionobject)type propertiesrequired)r description parameters)rr)rr r r s B/Users/ahmed/devFolder/Ultron/claude-voice/gateway/device_tools.py_fnrs.& ($N   navigateuStart turn-by-turn navigation on Ahmed's phone. Give a saved place label (I'll resolve the address) or a raw destination. Use for 'take me to…', 'navigate to the office'. destinationstringz1A saved place label, an address, or a place name.)rr play_musicuAPlay music on Ahmed's phone. Use for 'play…', 'put on some…'.queryz(Song / artist / playlist / mood to play. call_contactuPlace a phone call to a SAVED contact by name (I resolve the number privately — you never see or say it). Use for 'call my father', 'ring Sara'. If no number is saved, say so and offer to save one.zThe saved contact's name.take_screenshotzWCapture a screenshot on Ahmed's phone. Use for 'take a screenshot', 'grab this screen'. open_cameraz_Open the camera on Ahmed's phone. Use for 'open the camera', 'take a selfie', 'record a video'.mode)photovideoselfiezCamera mode (default photo).)renumr open_appzHOpen an app on Ahmed's phone. Use for 'open WhatsApp', 'launch Spotify'.targetzApp name or package to open.open_urluKOpen a web link on Ahmed's phone. Use for 'open…', 'pull up the website'.urlzThe URL to open. set_timerudSet a countdown timer on Ahmed's phone. Resolve durations yourself ('five minutes' → 300 seconds).integerzDuration in seconds.zOptional label, e.g. 'pasta'.)secondslabelr$ get_locationzUGet Ahmed's current location from his phone. Use when you need where he is right now.z list[dict]DEVICE_TOOL_SPECSc#,K|] }|ddyw)rrNr ).0specs r r+bs.<):DV):szfrozenset[str]DEVICE_TOOL_NAMEScall) rrrrrrr r"r&zdict[str, str]TOOL_TO_ACTION)N) rstrr r/r dictr zlist[str] | Nonereturnr0) __doc__ __future__rrr'__annotations__ frozensetr,r.r rrr6s.#&* " .2 "  , )67 8  K 8"LN O    F (3NOP        % (,H!?A B     H#AC D      2DEF     ,&$:<#"AC D     c5!:5n%..<):.<%<><( " " r