Refactor: Rename "agent" domain to "operator" across client SDK

[jfrench9]

Summary

This PR performs a comprehensive domain terminology refactor, renaming all "agent" concepts to "operator" throughout the robosystems_client SDK. The change spans API endpoints, client classes, data models, and tests — affecting 36 files with a consistent, mechanical rename.

Key Accomplishments

• API layer: Renamed the api/agent/ module to api/operator/, including all endpoint functions:

  • auto_select_agent → auto_select_operator
  • execute_specific_agent → execute_specific_operator
  • get_agent_metadata → get_operator_metadata
  • list_agents → list_operators
  • recommend_agent → recommend_operator
  • batch_process_queries updated to use operator terminology

• Client layer: Renamed AgentClient to OperatorClient (agent_client.py → operator_client.py) with all method signatures and internal references updated. The facade client is updated to expose the new naming.

• Models layer: Renamed all 18+ model classes from Agent* to Operator* (e.g., AgentRequest → OperatorRequest, AgentResponse → OperatorResponse, AgentRecommendation → OperatorRecommendation, etc.), including nested/auxiliary types for context, metadata, error details, and tokens used.

• Public exports: Updated clients/__init__.py and models/__init__.py to export the renamed symbols.

• Extension operations: Updated references in op_auto_map_elements.py and op_create_mapping_association.py to align with the new operator terminology.

• Tests: Renamed test_agent_client.py to test_operator_client.py with all test cases updated to reference operator models and client methods.

Breaking Changes

⚠️ This is a breaking change for all consumers of the SDK.

• All Agent* model classes have been removed and replaced with Operator* equivalents.
• AgentClient no longer exists; consumers must migrate to OperatorClient.
• API module path changed from robosystems_client.api.agent to robosystems_client.api.operator.
• Any code importing agent-related symbols from robosystems_client.models or robosystems_client.clients will need to be updated.

Downstream services and integrations must be updated in coordination with this change.

Testing Notes

• All existing agent client tests have been migrated to test_operator_client.py with updated class/method/model references.
• Test coverage is preserved — this is a rename-only refactor with no behavioral changes to business logic.
• Verify that no downstream consumers still reference the old agent imports before merging.

Infrastructure Considerations

• Any CI/CD pipelines or configuration that reference the old module paths (api.agent, AgentClient) will need corresponding updates.
• If the SDK is published as a package, this constitutes a major version bump due to the breaking API surface change.
• Dependent services should be identified and coordinated for a synchronized rollout.

---

🤖 Generated with Claude Code

Branch Info:

• Source: refactor/ai-operator-agent
• Target: main
• Type: feature

Co-Authored-By: Claude noreply@anthropic.com