Search company policy documents for text relevant to a question.

Args: query: A self-contained search query. Conversation history is not available on this surface, so include whatever context the search needs directly in the query text.

Returns: Matching policy chunks (source, section, content, relevance score) when found; grounded=False when nothing relevant enough was retrieved.

Look up an order belonging to an authenticated customer.

Args: order_id: The order identifier, for example ORD-1002.

customer_id:
    The authenticated customer identifier, for example CUS-002.

Returns: Customer-safe order status and delivery information when the customer is authorized to access the order.

Retrieve the current status of a customer account.

This MCP-facing tool accepts a customer ID because an external MCP client does not share the local agent's AuthContext.

The calling client remains responsible for authenticating and authorizing the customer before invoking this tool.

List orders associated with a specific customer.

Use this when the customer wants to view their orders but has not provided one specific order ID.

The customer ID is required.

Check whether a product is currently available and return its available stock quantity.

Use this when a customer asks whether a particular product is in stock.

The product ID is required.

Cancel an order belonging to a specific customer.

This is a state-changing operation, gated the same way as the in-process agent: the order must exist, must belong to customer_id, and must be in a cancellable state (Pending or Processing). Call with confirmed=False first to preview the result without cancelling anything; call again with confirmed=True only after the customer has explicitly confirmed that specific order.

The calling client remains responsible for authenticating the customer before invoking this tool.