Process a voice command for Splitwise.

Accepts base64-encoded audio (WAV or MP3 format), transcribes it using Deepgram, processes the intent using Gemini, and executes Splitwise actions.

Args: audio_base64: Base64-encoded audio data (WAV or MP3).

Returns: The result of the voice command (e.g., confirmation, clarification request, or error).

Process a text command for Splitwise.

Interprets natural language text using Gemini and executes Splitwise actions. Use this when you already have text (e.g., from a chat message) instead of audio.

Args: text: Natural language command (e.g., "Split 50 with Sumeet for dinner").

Returns: The result of the command (e.g., confirmation, clarification request, or error).

Configure the Splitwise client with API credentials. You must provide either (consumer_key AND consumer_secret) OR api_key.

Log in using an existing OAuth2 Access Token. Useful for integrations where authentication is handled externally (e.g. ChatGPT).

List all friends of the current user on Splitwise. Returns a formatted string list of friends.

Add an expense to Splitwise, supporting unequal splits, groups, and precise control.

Args: amount: The total cost (e.g., "70", "10.50"). description: A brief description. friend_names: Friends to split with. Can be empty if using group_name. split_map: Optional dict for unequal splits. Keys=Names (or 'me'), Values=Amount/Percentage. Example: {'me': '40%', 'Alice': '60%'} or {'me': '10', 'Bob': '20'} group_name: Optional group to add expense to. payer_name: Optional name of who paid. Defaults to 'me'. exclude_names: Optional list of names to exclude from a group split.

Delete an expense by its ID.